| Table of Contents | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
The FTP interface can be used for:
...
The name of the devices configuration file can be: devices_update.json or devices_update_XXXXXXXX.json
where “XXXXXXXX” is the hardware serial number of the board (8 digits, upper case), it can be found on the web interface in the Overview ⇒ Information menu.
...
Parameters for each device
Field | Mandatory | description | Possible value |
|---|---|---|---|
uwiotys.state | yes | Required action | "add"/"delete"/"active" |
uwiotys.reference | yes | End device manufacturer reference | Manufacturer reference : see |
uwiotys.output_protocols.modbus.@modbus | yes | Modbus slave ID | 1 to 200 |
spn.activation_type | yes | End device activation type, only OTAA supported | "OTAA" |
spn.dev_eui | yes | String of 16 hexadecimal characters | "70B3D5E75E008888" |
spn.app_eui | yes | String of 16 hexadecimal characters | "70B3D5E75F600000" |
spn.app_key | yes | String of 32 hexadecimal characters | "78FF2CDE6D2C657F09981C3332096DF9" |
spn.dev_addr | no | For future use | |
spn.nwks_key | no | For future use | |
spn.apps_key | no | For future use | |
spn.end_device_parameters.rx_window | yes | End device rx windows | This parameters cannot be change |
spn.end_device_parameters.rx_frequency | yes | End device rx frequency | This parameters cannot be change |
spn.end_device_parameters.rx_datarate | yes | End device data rate | This parameters cannot be change |
spn.end_device_parameters.class | yes | End device class | A or C |
Configuration file will be rejected at first error, missing field or wrong parameters.
...
| Code Block | ||
|---|---|---|
| ||
{
"sensors": [
{
"uwiotys": {
"state": "add",
"reference": "50-70-139",
"output_protocols": {
"modbus": {
"@modbus": 1
}
}
},
"spn": {
"activation_type": "OTAA",
"dev_eui": "70B3D5E75E008D35",
"app_eui": "70B3D5E75F600000",
"app_key": "725070411F8720932F4A56B6117D0638",
"dev_addr": "",
"nwks_key": "",
"apps_key": "",
"end_device_parameters": {
"rx_window": 3,
"rx_frequency": 869525000,
"rx_datarate": 0,
"class": "A"
}
}
},
{
"uwiotys": {
"state": "add",
"reference": "50-70-053",
"output_protocols": {
"modbus": {
"@modbus": 2
}
}
},
"spn": {
"activation_type": "OTAA",
"dev_eui": "70B3D5E75E008888",
"app_eui": "70B3D5E75F600000",
"app_key": "78FF2CDE6D2C657F09981C3332096DF9",
"dev_addr": "",
"nwks_key": "",
"apps_key": "",
"end_device_parameters": {
"rx_window": 3,
"rx_frequency": 869525000,
"rx_datarate": 0,
"class": "A"
}
}
}
]
} |
Upload configuration
Upload the configuration file
Copy the devices configuration file into the directory: /uwiotys/update_config/
Create an empty file named "reboot" in directory "/update/". You can reboot with this method or with the reboot web button web’s interface.
| Note |
|---|
An electric reboot can corrupt the update process ! |
After few minutes
If the update failed, you will find information into the file: devices_updates_$DATE_ERROR.log
If the update success, the file the devices configuration file is deleted and you will find the file: devices_updates_$DATE_SUCCESS.log
The devices current configuration of µWiotys is available in the directory: /uwiotys/current_config/
...
“XXXXXXXX” is the hardware serial number of the board (8 digits, upper case), it can be found on web interface in the Overview ⇒ Information menu.
Parameters
Field | Mandatory | description | Possible value |
|---|---|---|---|
http_data_server.active | yes | activation status of the HTTP output, if activated all device data will be sent to HTTP server, if not no messages will be sent. This does impact modbus output | true / false |
http_data_server.url | yes | url of the external server, it must be accessible from the network of the GW | valid URL |
http_data_server.headers | yes | header information for the server | valid key / value list |
csv.active | yes | activation status of the csv output, if activated all device data be stored in csv files. This does impact modbus output | true / false |
csv.nb_week | yes | Number of week the csv files will be keep. Be careful not to keep the files too long so as not to saturate the storage space | [1:52] |
mqtt.active | yes | activation status of the mqtt output. This does impact modbus output | true / false |
mqtt.host | yes | External Mqtt Broker | valid host |
Http output support both http and https protocols. Mqtt output support both mqtt and mqtts protocols. IN both cases, auto signed certificate are not suppoerted.
...
| Code Block | ||
|---|---|---|
| ||
{
"http_data_server": {
"active": false,
"url": "http://MyHTTPServer:8080",
"headers": {
"Content-Type": "application/x-www-form-urlencoded",
"Authorization": "Bearer eyJhbGciOiJSUzI1NiIsInR5cCIgOiAiSldUIiwia2lkIiA6ICJBTDBERmROLW1DNFpMTFJCVXh4OFdxN1RNZTVmQ3NNSE1FV1FsUklNYmRjIn"
}
},
"csv":{
"active": true,
"nb_week": 15
},
,
"mqtt":{
"active": true,
"host": "mqtt.uWiotys.io",
"port": 8883,
"topic": "MyTopic",
"login": "MyLogin",
"password": "MyPass",
"secure(TLS)": true
}
} |
Upload configuration
...
Upload the configuration file
...