Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Panel
panelIconId1f6e0
panelIcon:tools:
panelIconText🛠️
bgColor#F4F5F7

Please be patient with those steps, start up the gateway and actions with FTP can take a long time

...

Note

Warning the response time of µWiotys' FTP can be a little bit long, especially on fixed IP.
If necessary, you should extend your FTP Client timeout to 60 seconds, see Application Example

Don’t forget to refresh in order to see your current files

Contact your seller for user/password

End device configuration

LoRaWAN device provisioning on µWiotys can be done by FTP transfer.
First, create the configuration file with proper parameters and format then connect to µWiotys with FTP and copy the configuration file into the proper directory.

Take care of the LoRa Band used in the JSON when you add a sensor on a gateway not European (different from 868MHz)

Configuration file

File name

...

  1. Copy the devices configuration file into the directory: /uwiotys/update_config/

  2. Create an empty file named "reboot" in directory "/update/". You can reboot with this method or with the reboot web interface button

Note

An electric reboot can corrupt the update process !

Info

Few milliseconds after, a "reboot_processed_ok" file will be created. You can log out of your GW and move on to the next step.

  1. After few minutes

    1. If the update failed, you will find information into the file: devices_updates_$DATE_ERROR.log

    2. If the update success, the file the devices configuration file is deleted and you will find the file: devices_updates_$DATE_SUCCESS.log

  2. The devices current configuration of µWiotys is available in the directory: /uwiotys/current_config/

The file format is the same as the devices configuration file, it can be used to remove device for µWiotys config by simply changing "state" from "active" to "remove" for one or several devices and then follow the regular update procedure.

Output configuration

Configuration file

Modify/Delete your fleet

If you want to modify or delete sensors that added on µWiotys, please, follow these steps:

  • Delete :

    • With configurator

      • In the configurator you can select the action to Add/Delete a sensor → image-20240726-140115.pngImage Added
        Don’t forget to write all informations that you noticed in the current config of your GW.
        When you generated the update file with deleted elements, push and reboot the GW like the process above.

    • In edit file directly

      • By retrieve the curent config file in /uwiotys/current_config/
        Then Replace the field “state” by delete
        Don’t forget to write all informations that you noticed in the current config of your GW.
        You have to rename the update file with deleted elements (devices_update.json), push and reboot the GW like the process above.

  • Modify :

    • You have to Delete and Add again the update file to Modify a sensor (Modbus slave adress, reference…)

Output configuration

Configuration file

File name

The name of the output configuration file can be: output_update.json or output_update_XXXXXXXX.json

...

Field

Mandatory

description

Possible value

http_data_server.active

yes

activation 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 Url of the external server, it must be accessible from the network of the GW

valid URL

http_data_server.headers

yes

header Header information for the server

valid key / value list

csv.active

yes

activation 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 Activation status of the mqtt output. This does impact modbus output

true / false

mqtt.host

yes

External Mqtt Broker

valid host

...

mqtt.topic

no

The topic to subscribe from the MQTT broker. By default the topic is #/DEVEUI
(ex: if you enter “/MyTopic/uwiotys”, the data will be published to the topic “/MyTopic/uwiotys/DEVEUI”)

valid topic

HTTP output support both http HTTP and https HTTPS protocols. Mqtt

MQTT output support both mqtt MQTT and mqtts MQTTS protocols.

Panel
panelIconIdatlassian-warning
panelIcon:warning:
bgColor#DEEBFF

IN both cases, auto signed certificate are not

...

supported.

File format

The file format should be as the following examples:

...

Code Block
languagejson
{
  "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

The new output configuration of µWiotys should be upload to the directory: /uwiotys/update_config/

...

Upload the configuration file

...

  • "No license found, µWiotys will not start. Please configure a valid license for your µWiotys gateway XXXXXXXX" when NO license is present.

  • "The license is VALID. µWiotys will start." when the product HAS a license.

How to know the license's type and state

...

Code Block
languagecpp
License allow user to activate the following output:
Modbus output:  true/false
Csv output:     true/false
Http output:    true/false
Mqtt output:    true/false
Bacnet output:    true/false

Software Update

...