SMARTbox IO Agent User Guide Cloud Fieldbus PSSYSTEC GMBH HEINBERGSTR. 27 86 356 NEUSÄSS WWW.PSSYSTEC-GMBH.DE
PSsystec SMARTbox IO Agent User s Guide Contents Overview...4 Interface...5 Connect the Smartbox to your Cumulocity Account...5 Use the biult-in IOs...6 Manage Software...7 Use the built-in location functionality...7 Use the built-in tracking functionality...8 Change Tenant and URL by SMS...9 Remotely execute text commands via device shell...9 Debug the device...10 Connect Modbus devices with Cloud fieldbus...10 Help for setup the items in device database...12 PSsystec SMARTbox IO Agent User Guide 3
Overview 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 20 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 Smartrest protocol the terminal comes up with a low traffic solution for decentralized applications. For the Smartbox there is a customized user interface available made for easy handling the sensors and showing graphs for consumption and temperatures. For further information: please refer to the datasheet provided by PSsystec www.pssystec.de/downloads For installing the agent and SW releases, please refer to Release notes folder of device guide in Cumulocity or go to www.pssystec.de/downloads For getting the device please contact Cumulocity Hardware support or Pssystec (kontakt@pssystecgmbh.de) 4 PSsystec SMARTbox IO Agent User Guide
Interface Connect SMARTbox IO to the power supply 24VDC. The start-up of the unit will take 60 seconds: Wire your network: Wire the sensors: Connect the Smartbox to your Cumulocity Account Configure the terminal: By default the terminal supports cloud fieldbus from Cumulocity. To use it you should: Subscribe your account to the Cloud Fieldbus app by contacting support. Configure the terminal: 1. Power on the Terminal. 2. Configure the Terminal s APN by sending an SMS to Terminal s SIM card with the following syntax: GPRS=APN,username,password (e.g. GPRS==public4.m2minternet.com,,) PSsystec SMARTbox IO Agent User Guide 5
Registering the Terminal in Cumulocity: In the cumulocity Cloud Fieldbus app go to the menu and there find Devices Registration. Enter the Terminal s IMEI as an ID. The IMEI is printed on the devices itself: After accepting the device you should be able to see it in the All Devices list within 30 seconds. Use the biult-in IOs Sensors - max. 10: IO Board V1 U1/ U2 DIN [voltage free] / 0-20mA [supplied by Smartbox] / 0-10V U3/ U4/ U5/ U6 DIN [voltage free] / 0-20mA [supplied by Smartbox] U7/ U8/ U9/ U10 PT1000 IO Board V2 U1...U6 DIN [voltage free] /NTC/PT100/PT1000/ 0-10V OR 0..20mA U7..U10 DIN [voltage free] /NTC/PT100/PT1000 Relay Switch 1 x 230V - 2A U1...U10 Input sensor type NTC PT1000 0-1V 0-10V 4-20mA (incl. power supply input) DIN 0-5V (incl. power supply input) PTC PT500 6 PSsystec SMARTbox IO Agent User Guide
Relay Switch PT100 DIN_COUNT DIN_FREQ Output 0-10V PWM @100Hz PWM @2 KHz 1 x 230V - 2A To activate the specific sensorboard proceed as follows: 1. Upload the sensor-model in device database. Download the sensorboard model Type A here 2. Edit the model if you need it (refer to Configuring Fieldbus device types) but keep the addresses 3. Connect the sensor board in Modbus tab on adress 1 4. Include the fieldbus widget in the cockpit related to the device and activate all items. You can now configure the inputs as Temperature sensor or Digitalinputs- as described in the table above Manage Software 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 get the latest Software version in the Release notes folder of Device guide in Cumulocity or go to: https://www.pssystec.de/downloads/ Since version 2.0 or higher all version are up compatible. Use the built-in location 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. 3. Activate a regular identification of the location. In Configuration tab you can set: 1. c8y.locationcycle=60; define in min, how often the location should be checked. 0 means the cycled checking is disabled. If a value >0 is set, also the tracking is enabled PSsystec SMARTbox IO Agent User Guide 7
Use the built-in 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. 8 PSsystec SMARTbox IO Agent User Guide
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. Change Tenant and URL by SMS Change tenant Change URL Note: To change tenant: https://pssystec.cumulocity.com. Send an SMS to the SMARTbox by typing DELETE. The device will delete the stored crediantels and performs an restart. After this you will be able to register the device in an other tenant but with same Url (.ram.m2m.telekom.com). To change URL: https://pssystec.cumulocity.com. Send an SMS to the SMARTbox by typing URL=<newurl> e.g. URL=test-ram.m2m.telekom.com. Note: By executing this command, also the crediantels will be deleted from the device. don t forget to delete the device in your registered tenant to prevent scrap in your tenant. Remotely execute text 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 AT commands:: https:// www.pssystec.de/downloads Frequently used commands are available by clicking the Get predefined button. Multiple get, set and execute commands can be sent using a semicolon as separator. PSsystec SMARTbox IO Agent User Guide 9
Debug the device For debug service: Install the Telit USB driver on your PC: https://www.pssystec.de/downloads/. The PC will recognize 6 new USB Ports Open an Terminal program Connect your PC on Telit High Speed Modem USB Port with USB port on the Smartbox You will get details of the running machine. Connect Modbus devices with Cloud fieldbus Support Modbus RTU: Type Baudrate Parity Stopbits Functioncodes Datapoints Polling Rate on Bus Modbus RTU (Master) 4800, 9600, 19200, 38400, 115200 (Change during Runtime possible) Even, ODD, NONE (Change during Runtime possible) 2,1 (Change during Runtime possible) 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) Max 10 Slaves with each 100 datapoints 300ms To connect a Modbus/RTU device: Physically wire the Modbus/RTU device through RS/485 to the terminal. 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). 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. Navigate to the terminal in Cumulocity and click on the Modbus tab. Change the communication settings shown in the section Serial Communication to match the settings on the bus, if needed. 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. Click Save changes if you made changes. To start communication between the terminal and the Modbus device, click Add new device. 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. 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. 10 PSsystec SMARTbox IO Agent User Guide
PSsystec SMARTbox IO Agent User Guide 11
Help for setup the items in device database 12 PSsystec SMARTbox IO Agent User Guide
PSsystec SMARTbox IO Agent User Guide 13
PSSYSTEC GMBH HEINBERGSTR. 27 86 356 NEUSÄSS WWW.PSSYSTEC-GMBH.DE