New SMARTbox DP Agent User Guide - PSsystec GmbH · 2019. 1. 16. · c8y.GPS=1 then GPS is enabled. Setting c8y.GPS=0 Cell location is enabled (default) 3. Activate a regular identification

Cloud Fieldbus

SMARTbox DPAgent User Guide

PSSYSTEC GMBH • HEINBERGSTR. 27 • 86 356 NEUSÄSS • WWW.PSSYSTEC-GMBH.DE

2 PSsystec SMARTbox DP Agent User Guide

SMARTbox DP ____________Smartbox DP, based on the Telit Chipset xE910 is a ready to use solution for connecting Profibus devices to Cloud der Dinge. It provides a Slave Communication on RS485 for connecting to a PLC which runs Profibus master protocol. Easy configure the data exchange (Read and Write) to Any PLC by using the Cloudfieldbus feature. Using the MQTT protocol the terminal comes up with a low traffic solution.

Connectivity

I/O(Sensors)

Radio/Cloud

2G-global3G-EMEA,APAC,NA,GlobalLTE-EMEA,APAC,Americas


SMARTbox DP - Overview ____________

- 2G - global - 3G - EMEA, APAC, NA, Global - LTE - EMEA, APAC, Americas - GPS

Fieldbus - Modbus RTU (RS232/RS485)

Sensors - Digital Input (DIN)

- AIN (NTC,0..20mA) MQTT Agent for T-Systems- Cloud der Dinge

- For further information: please refer to the datasheet provided by PSsystec

https://www.pssystec.de/downloads/ - For installing the agent and SW releases, pls refer to:

http://www.pssystec.de/smartbox/smartbox-agent/ - For getting the device pls contact Telekom Hardware support or Pssystec

[email protected] - The full product overview pls download it https://www.pssystec.de/downloads/

Wire your Smartbox DP ____________ - Connect your sensors and Modbus Devices to the terminal block - You can use external 24VDC (400mA) or the with the delivered PowerSupply

Powersupply24VDC

IOSensorsDIDI/ONTCAI/O0..20mAAI/P+

ModbusRTUMaster

ProgrammingDebug

ProfibusDP-V0

ProfibusBustermination

Link–steady:CommunicationestablisedAct–flashing:ProfibusBoardReady

GSM–flashing:RegisterdinNetworkRUN–flashing:ServerExchangeGPS(opt.)

GSMAntenna

SIMCard2FF

TLS Support ____________ Agent Version 1.x support TLS 1.0 Agent Version 2.4.x support TLS 1.2


Connect the SMARTbox to your Cloud der Dinge Account ____________ Power on the Terminal and wait until the RUN LED is flashing 2xflash-pause-2xflash- In the CoT 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

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: Valid for Product Agent c8y.ConfigDin=0 Enable the extra digital input

Note: - Jumper must be set on the

Smartbox (during production) - It creates an event

Mini,DP, CubeIO >2.3.x

c8y.ConfigAin=0 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 The settings are as follows: 0 – disabled 1 – NTC 2 – 0…20mA


c8y.DinLogic=0 Define the Logic of DIN Input 0 = NO 1 = NC


c8y.cycle=900 Define the send measurement cycle of the extra analogue Input


c8y.ditext=<Name> Define the Text of the event by DIN Mini,DP, CubeIO >2.3.x c8y.ditype=<Name> Define the type of the event by DIN Mini,DP, CubeIO >2.3.x c8y.adcseries=<Name> Define the Series of Measurement by AIN Mini,DP, CubeIO >2.3.x c8y.adctype=<Name> Define the Type of Measurement by AIN Mini,DP, CubeIO >2.3.x c8y.LocationCycle=0 Define the Location update in min

If it is set to 0, then Location is derived only at startUp.

all >2.3.x

c8y.min=0 Define the Min of AIN Value conversion (if AIN is set to 0…20mA by jumper)


c8y.max=0 Define the Max of AIN Value conversion (if AIN is set to 0…20mA by jumper)


c8y.GPS=0 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

All with GPS Option

>1.3.4

DeleteTenant >1.3.4


Note: All other configuration settings which you will get with the Snapshot are only for Information and refers to internal settings. Note: To set a configuration proceed as follows, put all statements in a new line e.g. c8y.DinLogic=1 c8y.min=1 press save Use the Built-In IOs ____________1. Note that the SMARTbox Mini supports:

- 1 x Digital Input (DIN) - 1 x AIN (NTC,0..20mA)

Note the activation of NTC or 0..20mA must be defined during production And need to be set also in configuration settings.

Connect a Modbus Device to the SMARTbox ____________ The Smartbox supports Modbus RTU – all Connections parameters are configurable in the Cloud.

Type Modbus RTU (Master) Cloud Baudrate 4800, 9600, 19200, 38400, 115200 (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)

Device database (model)

Datapoints 1.. 10 Slaves with each 100 datapoints fix Polling Rate on Bus

500ms fix

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


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 CoT.

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 www.youtube.com/watch?v=99dj4PDMwQQ below. Set the Modbus address of the connected device.

j. Click "Add". CoT will now send a notification to the SMARTbox that a new device is ready to be managed. This may take a few seconds.


Use the built-in Location and Tracking functionality (>2.3.x) ____________ 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. 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


Devices can record the history of their movements in CoT. 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 CoT, 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: http://www.pssystec.de/smartbox/smartbox-agent/ Remotely Manage APN, Tenant, Reboot (OnRequest) ____________ DELETE deletes the registration in CC and you can

register on a new tenant RESET Restarts the device


GPRS=<APN>,<User>,<Password> Change APN, if no User or Password is required,

the fields free Operate the Device by SMS (OnRequest)____________ Since Agent Version 2.3.x. 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: http://www.pssystec.de/downloads/ à supported AT commands and includes a huge amount of different AT commands. Operate AT commands via device shell (>V2.3.x)____________ 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”: https://www.pssystec.de/downloads/. Frequently used commands are available by clicking the "Get predefined" button

Local Debug and operate the device____________

1. Install the Telit USB driver on your PC: https://www.pssystec.de/downloads/. 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.


Connect Profibus Device to the SMARTbox ____________ The Smartbox supports Profibus DPV0 – the Smartbox interacts as a Slave connecting to any PLC or device which runs the Profibus Master protocol. The Specification is as follows: Fieldbus Profibus

Type Profibus Slave Standard DP-V0 Baudrate Automatic Baudrate Detection

Supported Baudrate: | 9,6kbit | 19,2kbit | 45,45kbit | 93,75kbit | 187,5kbit | 500kbit | 1500kbit | 3000kbit | 6000kbit | 12000kbit

GSD File ID Number : 1023 HEX GSD file : PSYS1023.GSD

Input Register 16 (16bit) Output Register 16 (16 bit) Profibus Slave address

Selectable by Cloud, Default: 24

ASIC VPC3+S (Profichip)

To connect the SMARTbox DP to a Profibus Network, proceed as follows:

1. Install GSD file (see download page on PSsystec)


Integrate SMARTbox DP GSD File into your PLC Engineering System. Here is the workflow described for integration into TIA Portal. It is the standard workflow, but for any doubts it is described here again:

You can skip this chapter, if this process is clear to you

1.1 Put “PSYS1023.gsd” and “PSYS1023.dib” in some folder, in our example it is “D:\PSYS1023_gsd”.

1.2 Start TIA Portal and open menu Options – Manage general station description files (GSD):

1.3 Type the folder path in “Source path” field, or select it using the “...” button on the right. Check the checkbox next to “PSYS1023.gsd” and click “Install”:

1.4 Wait until the GSD files has been installed and click “Close” in the next window:


2. Configure Smartbox as Profibus Slave.

2.1 Create a new project or open an existing one. In case of a new project, add a PLC with Profibus Master capability. In our example it will be CPU 1214C plus communication module CM 1243-5:

2.2 Switch to “Network view” and open “Other field devices – Profibus DP – Gateways – Pssystec GmbH – PSsystec – SmartBoxProfibusDP-V0 – SmartBoxProfibusDP-V0 PSYS1023” or just search for “psys”. Double-click on the second “SmartBoxProfibusDP-V0 PSYS1023”, which will insert Smartbox Profibus Slave to the project:


2.3 Click on “Not assigned” and select the PLC, which will be Master. Alternatively, you can drag the purple square at the PLC to the purple square at the Smartbox, or in the opposite direction. This will create Profibus Master-Slave connection between the PLC and Smartbox:

2.4 If you need to change Profibus address of Smartbox, click on the respective purple square, open Properties tab, and proceed to “Profibus address” menu item:


2.5 In order to change the network transmission speed, click on the purple line and open “Network settings” item in Properties tab:

2.6 Double-click on Smartbox, which will open “Device view” for that device. Open “Device overview” by clicking on vertical text “Device data” to the left of Hardware catalog. Alternatively you can click on the little triangle pointing to the left, or drag the vertical border to the left.


2.7 Double-click on “State”, “Data to Cloud” and “Data from Cloud” in the Hardware catalog. This will insert the respective data modules “State_1”, “Data to Cloud_1” and “Data from Cloud_1”:

2.8 Change I and Q addresses if needed:


2.9 Access inputs-outputs using %IW and %QW addresses. For the sake of convenience, you can assign PLC tags.

Now your ToCloud and FromCloud datapoints are available in your PLC and you can assign datapoints to it according to your program needs.


2. Physically connect SMARTbox DP to the PLC

k. Physically wire the SMARTbox to the PLC by the RS485 Port (1)

l. Be note on the Termination ports: Normally PLC is not terminated and all Slaves (including Smartbox DP) are terminated. For this you can set the termination on SMARTbox Directly (2) if the connector does not foresee this option, the internal wiring is as follows:

3. Access the ToCloud and FromCloud Variables in Cloud der Dinge

a. Load the ToCloud and from Cloud Parameters to the device database. (Take the predefined Model, which you can download from pssystec.de/downloads in the SMARTbox DP folder. Afterwards, you can edit the Model to your requirements like defining measurements, bit decoding. Note: this device Model reflects the content of the GSD File. So, you cannot edit the addresses, but you can edit scaling, and interpretation settings of each datapoint to configure your cloud visualization.

b. Set the Profibus Tab:

(1) After StartUp the Profibus Tab must be visible in the terminal/Devicemanagement

(2) Add the Profibusdevice (previously stored in the device database) (3) Set the Slave Adresse of the SMARTbox in the Profibus network (4) Set the transmit rate for measurements (5) The Baudrate is automatically detected from the SMARTbox; therefore this

is only ready only. The Value is expressed in Baud. All other mechanismen are aligned with Cloud fieldbus Logic.


Documents

New SMARTbox DP Agent User Guide - PSsystec GmbH · 2019. 1. 16. · c8y.GPS=1 then GPS is enabled. Setting c8y.GPS=0 Cell location is enabled (default) 3. Activate a regular identification