SMARTbox Cube IO Agent User Guide. Cloud Fieldbus PSSYSTEC GMBH HEINBERGSTR NEUSÄSS

Transcription

1 SMARTbox Cube IO Agent User Guide Cloud Fieldbus PSSYSTEC GMBH HEINBERGSTR NEUSÄSS

2 SMARTbox CubeIO Smartbox, based on the Telit Chipset HE910 is a ready to use solution for connecting Modbus devices to the Cumulocity Fieldbus Cloud. It provides a Master Slave Communication on RS485 for connecting up to 10 devices as well as 10 Sensors (Current,Temperature, Pressure). Easy configure the SetUp of building automation fielddevices like pumps, e-meters, Airhandling units in the Cumulocity Fieldbus cloud or connect different sensortypes to the box. Using the MQTT protocol the terminal comes up with a low traffic solution for decentralized applications. 2nd Modbus Master/Slave/ Custom RS485 interface 2G - global 3G - EMEA, APAC, NA, Global LTE - EMEA, APAC, Americas Modbus RTU RS485 on Board Up to 10 Devices Alarming, Auslesen, Steuern, Monitoren aller modbusfähiger Geräte 2FF Sim Format Montage 70mm x 70mm Robustes Aluminiumgehäuse Hutschienenhalterung Edge Processing Deploy remotely own Business Logic Sensoren (Typ freiwählbar) Schaltkontakte Türkontakte Flusswaechter Frequency Input Fuellstandssensor Drucksensoren mA mA Ratiometrisch V Ratiometrisch 0...5V Temperatur PT C 600 C Strom ST A ST A ST A Feuchte V mA SMARTbox CubeIO - Overview - 2G - global - 3G - EMEA, APAC, NA, Global - LTE - EMEA, APAC, Americas - GNSS Default: 3G EMEA / APAC Fieldbus - Modbus RTU (RS232/RS485) Sensors - Digital Input (DIN) - AIN (NTC,0..20mA) - 10 x Universal inputs (NTC, PT100, PT1000, 0..10V, DIN) - 1 x RelayOutput 2

3 MQTT Agent for Cumulocity IoT, T-Systems- Cloud der Dinge - For further information: please refer to the datasheet provided by PSsystec - For installing the agent and SW releases, pls refer to Release notes folder of Device guide in Cumulocity or go to: - For getting the device pls contact Cumulocity Hardware support or Pssystec Kontakt@pssystec-gmbh.de - The full product overview pls download it Wire your Smartbox with IOs GPS (opt.) GSM flashing: Registerd in Network RUN flashing: Server Exchange GSM Antenna Powersupply 24VDC Modbus RTU Master IO Sensors DI DI/O NTC AI/O 0..20mA AI/P+ Programming Debug SIM Card 2FF Link flashing: Sensordata are processing Act flashing: Sebsor Board Ready RS485 Interface / Digital Output 10 Universal Analogue Inputs You have available: a) Hardware: The analogue inputs and the Output U1 to U10 and +/-/GND b) Hardware: And the AIN and DIN on the Upperline Configure and Wire a) U1/U2 U3/U4/U5/U6 U7/U8/U9/U10 Output DIN NO [voltage free] / DIN NC [voltage free] /0..20mA/4 20mA/0..10V/2..10V/0..5V DIN NO [voltage free] / DIN NC [voltage free] /0..20mA/4 20mA PT VDC Digital Output. Note: Either the Output or the 2 nd Fieldbusinterface can be selected during production Following specification and wiring DESCRIPTION IN1 IN2 IN3 IN4 IN5 IN6 IN7 IN8 IN9 IN10 Low-Side Input Normal x x x x x x Low-Side Input Invert x x x x x x High-Side Input Normal x x High-Side Input Invert x x Current Input 0 20mA x x x x x x 3

4 Current Input 4 20mA x x x x x x Voltage Input 0 10V x x Voltage Input 2 10V x x Voltage Input 0 5V x x PT Wire x x x x The connection diagram of the sensors is as follows: 1) Connect 0..20mA Sensors Note Scaling, Offset you can manage in the the Cloud mask Active Mode: 2) Passive Mode: 4

5 3) Connect LowSide Digital Input 4) Connect High Side Digital Input 5) Connect 0..10V Input Note Scaling, Offset you can manage in the the Cloud mask 5

6 6) Connect Temperaturesensor PT1000 to it Note: offset you can define in the Cloud, Scaling is not required 7) Connect Digital OutPut Note: This is an assembly Option Please ask if you need this option 8) Manage the IOs in Cloud As first Step, add the SMARTbox_CubeIO model in Cumulocity in the modbus Folder As shown here. Add address 1 and IP Address

7 As second step (after you assigned the Terminal to a goup) switch to Cockpit. Add an Fieldbus Widget and click all relevant Settings which you need to configure your Ios Here is an example how it looks like: Configure and Wire b) 1) Connect Low Side Digital Input Note: To enable this input, pls assign this request at ordering, since it must be anabled in Hardware. To finally configure the Digital Input as an event you need to set following in configuration tab in your terminal in devicemanagement: c8y.configdin=1 to enable c8y.ditext=<name> Text of event c8y.ditype=<name> Type of event c8y.dinlogic=0 0 = NO, 1 = NC Put your single statements always in a new line and press save at the end. 2) Temperaturesensor NTC Note: To enable this input, pls assign this request at ordering, since it must be anabled in Hardware. 7

8 To finally configure the NTC Temperaturesensor as a measurement you need to set following in configuration tab in your terminal in devicemanagement: c8y.configain=1 to enable NTC c8y.adcseries=<name> Series form your measurment c8y.adctype=<name> Type form your measurment c8y.cycle=900 transmitrate in seconds c8y.unit=c define the unit Put your single statements always in a new line and press save at the end. The sensorvalue will be sent with 1 decimalplace accuracy 3) Pressuresensor/0..20mA Note: To enable this input, pls assign this request at ordering, since it must be anabled in Hardware. To finally configure the 0..20mA Signal as a measurement you need to set following in configuration tab in your terminal in devicemanagement: c8y.configain=2 to enable 0..20mA c8y.adcseries=<name> Series form your measurment c8y.adctype=<name> Type form your measurment c8y.cycle=900 transmitrate in seconds c8y.unit=bar define the unit c8y.min=20.0 define the Min c8y.max=80.5 define the Max Put your single statements always in a new line and press save at the end. The sensorvalue will be sent with 1 decimalplace accuracy 4) Voltageinput 0..5V or 0..24V 8

9 Note: To enable this input, pls assign this request at ordering, since it must be anabled in Hardware. To finally configure the 0..5V or 0..24V as a measurement you need to set following in configuration tab in your terminal in devicemanagement: c8y.configain=2 to enable 0..5V/0..24V c8y.adcseries=<name> Series form your measurment c8y.adctype=<name> Type form your measurment c8y.cycle=900 transmitrate in seconds c8y.unit=v define the unit c8y.min=20.0 define the Min c8y.max=80.5 define the Max Put your single statements always in a new line and press save at the end. The sensorvalue will be sent with 1 decimalplace accuracy Connect the SMARTbox to your Cumulocity Account Prepare the Cloud and APN By default the SMARTbox supports cloud fieldbus from Cumulocity. To use it you should: 1. Subscribe your account to the Cloud Fieldbus app by contacting Cumulocity support.after this the device Database will be visible in the root folder of Device management. Refer also here: 2. Power on the Terminal and wait until the RUN LED is flashing 2xflash-pause- 2xflash- 3. Configure the Terminal's APN by sending a SMS to Terminal's SIM card with the following syntax: GPRS=APN,username,password For example, if you have no User and Password then you have to type in your SMS GPRS=<APN>,, Register the device In the cumulocity Devicemanagement, go to the menu Device Registration. Enter the Terminal's IMEI as an ID. The IMEI is printed on the devices itself: After accepting the device (this process may take 30 seconds) you should be able to see it in the All Devices list after a short delay 9

10 Configuration The SMARTbox supports the configuration tab to set specific properties, independent of Fieldbus connectivity features. You can get an actual snapshot or set a property in the Configuration window. Following Configurations are supported: c8y.configdin=0 c8y.configain=0 0 = disabled 1 = NTC Sensor 2 = 0..20mA c8y.dinlogic=0 c8y.cycle=900 Enable the extra digital input Note: - Jumper must be set on the Smartbox (during production) - It creates an event Enable the extra analogue Input Note: - Jumper must be set on the Smartbox for NTC and different Jumpersetting for 0..20mA (during production) - It creates and measurement Define the Logic of DIN Input 0 = NO 1 = NC Define the send measurement cycle of the extra analogue Input Valid for Product Mini,DP, CubeIO Mini,DP, CubeIO Mini,DP, CubeIO Mini,DP, CubeIO c8y.ditext=<name> Define the Text of the event by DIN Mini,DP, CubeIO c8y.ditype=<name> Define the type of the event by DIN Mini,DP, CubeIO c8y.adcseries=<name> Define the Series of Measurement by AIN Mini,DP, CubeIO c8y.adctype=<name> Define the Type of Measurement by AIN Mini,DP, CubeIO 10

11 c8y.locationcycle=0 c8y.min=0 c8y.max=0 c8y.gps=0 C8y.Unit=C Define the Location update in min If it is set to 0, then Location is derived only at startup. Define the Min of AIN Value conversion (if AIN is set to 0 20mA by jumper) Define the Max of AIN Value conversion (if AIN is set to 0 20mA by jumper) If GPS Hardware option is available you can enable the GPS function by setting 1 and disable by settings 0. Note: - The locationcycle is also valid for GPS enabled. - If GPS=0, the cellular location determination is active Set the unit of your measurment all Mini,DP, CubeIO Mini,DP, CubeIO All with GPS Option Note: All other configuration settings which you will get with the Snapshot are only for Information and refers to internal settings. Connect a Modbus Device to the SMARTbox The Smartbox supports Modbus RTU all Connections paramters are configurable in the Cloud. Type Modbus RTU (Master) Cloud Baudrate 4800, 9600, 19200, 38400, (Change during Runtime possible) Modbus Tab Parity Even, ODD, NONE (Change during Runtime possible) Modbus Tab Stopbits 2,1 (Change during Runtime possible) Modbus Tab Functioncodes Funct.1 (Read Single Coils) Funct.2 (Read Input Status) Funct.3 (Read Holding Registers) Funct.4 (Read Input Registers) Funct.5 (Write Coil) Funct.6 (Write Holding Register) Datapoints Slaves with each 100 datapoints fix Polling Rate on 500ms fix Bus Device database (model) We assume that you already defined your Modbus device(s) which you want to connect in the device database. In this exemplary SetUp you need 4 Models in the device database, which can and should be defined offline in the Cloud (see also chapter Help Device database) Device1: Chiller on Address1 Device2: Energy Meter on Address2 Device3: Frontcooler for Serverline1 on Address5 Device4: Frontcooler for Serverline2 on Address6 11

12 To connect 1 Modbus Device to the RTU network: a. Physically wire the Modbus/RTU device through RS485 to the terminal. b. Give the device a unique Modbus address according to the instructions provided with the Modbus device (e.g. by setting a jumper on the device). c. Check the serial communication settings of the device according to the instructions provided with the device (i.e. baud rates and communication protocol). These have to match with all devices on the bus. d. Navigate to the terminal in Cumulocity and click on the "Modbus" tab. e. Change the communication settings shown in the section "Serial Communication" to match the settings on the bus, if needed. f. Change the transmit rate and the polling rate according to your requirements. The polling rate is the frequency at which the Modbus devices are polled for changes. The transmit rate is the frequency where measurements are sent to Cumulocity. g. Click "Save changes" if you made changes. h. To start communication between the terminal and the Modbus device, click "Add new device". i. Enter a name for the device and select the type of the device from the drop-down box. To add new device types, see "Configuring Fieldbus device types" below. Set the Modbus address of the connected device. j. Click "Add". Cumulocity will now send a notification to the Modbus terminal that a new device is ready to be managed. This may take a few seconds. 12

13 Use the built-in Location and Tracking functionality The terminal features cell location and is available in Location tab on terminal level. Devices are shown as "pins" that you can click to see the name of the device. Clicking the name of the device takes you to the detailed view of the device. In Smartbox Mini you have 3 Options: 1. Using the built in Cell Location. The terminal identifies 3 cells in the near environment and derives the location (default) 2. Using the hardware Option with a built in- GPS (this is an extra option). Set c8y.gps=1 then GPS is enabled. Setting c8y.gps=0 Cell location is enabled (default) 3. Activate a regular identification of the location. In Configuration tab you can set: c8y.locationcycle=60; define in min, how often the location should be checked. 0 means the cycled checking is disabled. If a value >0 ist set, also the tracking is enabled 13

14 Use the built-in Location and Tracking functionality Devices can record the history of their movements in Cumulocity. Using the tracking tab, you can select a time period and visualize the movements of the device during this time period. Movements are shown as red lines on the map. Next to the map, the individual recordings with their time are listed ("location update events"). When you click a recording, a "pin" on the map will show the location at the time of the recording. Activate a regular identification of the location. In Configuration tab you can set. If the value of c8y.locationcycle is greater 0 then tracking is enabled. Depending on the type of device and the integration into Cumulocity, you can also configure device-side geo-fencing and motion detection. Additionally, when the feature is activated, Cell ID information can be used to determine the position of the device. Currently, the services from Combain and Google are supported. The user can see the tracks based on both data, or filter out GPS based data or Cell ID based data. Manage the Agent The installed software on the SMARTbox can be remotely managed using the standard software and management feature from Cumulocity, as described in the Device management user's guide. You can also install the agent manually, follow the instructions here: You can get the latest Software version in the Release notes folder of Device guide in Cumulocity or go to: 14

15 Remotely Manage APN, Tenant, Reboot DELETE RESET GPRS=<APN>,<User>,<Password> deletes the registration in CC and you can register on a new tenant Restarts the device Change APN, if no User or Password is required, the fields free Operate the Device by SMS Since Agent Version This service allowing the user to run on the module itself AT Commands sent from a mobile via SMS messages. You will get the answer from the SMARTbox directly on your mobile phone. This allows you, to make troubleshooting in any case of error. Example: Type AT+COPS? Result on your mobile Phone: +COPS: 0,0,"Vodafone.de",2 OK All AT command supported are listed here: à supported AT commands and includes a huge amount of different AT commands. Operate AT commands via device shell The device shell enables you to read and write configuration parameters to interactively work with remote devices. You can send AT commands in the respective language of the device and view the results of the commands. You can sent any At Command. Check here in Chapter supported AT commands : Frequently used commands are available by clicking the "Get predefined" button 15

16 Local Debug and operate the device 1. Install the Telit USB driver on your PC: The PC will recognize 6 new USB Ports For debug service: 1. Open an Terminal program 2. Connect your PC on Telit High Speed Modem USB Port with USB port on the Smartbox 3. you will get details of the running machine. For setting generic AT commands: 1. Open an Terminal program 2. Connect your PC on USB4 Port with USB port on the Smartbox 3. you can set now at commands Note: Using Agent Versions <2.3.x you have to connect to USB3 Help for Setting up the Device database All devices which are connected to the SMARTbox are needed to define in Device Database. The definition includes all supported datapoints of this connected device. Even more, you can not only define the physical datapoint like register address, you can also define if this datapoint comes in the cloud as a measurement, event, alarm or write value. In addition some control field per datapoint are available which includes metadata like the Unit or Display Category. 16

17 17

18 18