Page Comparison

The FTP interface can be used for:

• Updating the Software

• Updating the configuration *

• Support

Setup FTP client

Connect to µWiotys using a FTP client (ex:filezilla)

...

Host: $UWIOTYS_IP_ADDRESS

: Filezilla)

• Host: $IP_Address_µWiotys (by default: 192.168.1.100)

• Port: 2222

• Protocol: SFTP (SSH File Transfer Protocol)

End device configuration

LoraWan 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

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

Configuration file will be rejected at first error, missing field or wrong parameters.

...

The file format should be as follow, several device can be listed in the sensors table.

{
  "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",
  },       "spnapp_eui": {"70B3D5E75F600000",
        "activationapp_typekey": "OTAA78FF2CDE6D2C657F09981C3332096DF9",
        "dev_euiaddr": "70B3D5E75E008888",
        "appnwks_euikey": "70B3D5E75F600000",
        "appapps_key": "78FF2CDE6D2C657F09981C3332096DF9",
        "devend_device_addrparameters": {
          "rx_window": 3,
          "nwksrx_keyfrequency": "", 869525000,
          "appsrx_keydatarate": ""0,
        "end_device_parameters  "class": {"A"
        }
      "rx_window": 3,}
    }
      "rx_frequency": 869525000,
          "rx_datarate": 0,
          "class": "A"
        }
      }
    }
  ]
}

Upload configuration

Upload the configuration file

...

]
}

Upload configuration

Image Added

Upload the configuration file

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

3. 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 the devices configuration file is deleted and you will find the file: devices_updates_$DATE_SUCCESS.log

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

...

3. current_config/

You need to reboot to process the device update, you can reboot the gateway by two ways:

• With ftp :

  • Create a file named "reboot" in directory "/update/".

  • A file XXXXXXXX_reboot_processed_yy is created once command processed.

  • Command reboot is processed if XXXXXXXX_reboot_processed_yy does not exist and each time the command file is edited.

• With Kerlink gateway button:

  • iFemToCell: Press the reset button located on the side of the gateway.

  • iStation: Press once (and only once) the On/Off button.

Warning: an electric reboot can corrupt the update process

After a few seconds the LEDs stop blinking, wait another minute then it's possible to reconnect to the FTP. The status file will created in: /uwiotys/update_config/

• 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

Current configuration

...

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

...

“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

...

HTTP output support both HTTP and HTTPS protocols.

MQTT output support both MQTT and MQTTS protocols.

...

File format

The file format should be as follow.the following examples:

{
  "http_data_server": {
    "active": true,
    "url": "https://webhook.site/102211e8-f30f-4117-82fa-999e1fd47caa",
    "headers": {}
  },
  "csv":{
    "active": true,
    "nb_week": 15
  },
  "mqtt":{
    "active": true,
    "host": "mqtt.uWiotys.io",
    "port": 1883,
    "topic": "MyTopic",
    "login": "",
    "password": "",
    "secure(TLS)": false
  }
}

{
  "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,

   "topicmqtt": "MyTopic",{
    "loginactive": "MyLogin"true,
    "passwordhost": "MyPassmqtt.uWiotys.io",
    "secure(TLS)port": true8883,
  } }

Upload configuration

Upload the configuration file

Once connected to FTP server, copy the output configuration file into the directory: /uwiotys/update_config/

You need to reboot to process the device update, you can reboot the gateway by two ways:

• With ftp :

  • Create a file named "reboot" in directory "/update/".

  • A file XXXXXXXX_reboot_processed_yy is created once command processed.

  • Command reboot is processed if XXXXXXXX_reboot_processed_yy does not exist and each time the command file is edited.

• With Kerlink gateway button:

  • iFemToCell: Press the reset button located on the side of the gateway.

  • iStation: Press once (and only once) the On/Off button.

...

 "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

See the process to add sensors for more details

To test the HTTP configuration, µwiotys will send a test request with information about the Gateway (EUI, IP and MAC) and wait for a 200 OK response.

{
    "EUI": "7076FF0056050190",
    "IP": "192.168.100.143",
    "MAC": "70:76:ff:03:02:e1"
}

After a few seconds the LEDs stop blinking, wait another minute then reconnect you to the FTP. The status of the output configuration update can be found in /uwiotys/log/uwiotys_functionnal.log

Current configuration

The output current configuration of µWiotys is available in the directory: /uwiotys/current_config/

License Configuration

Configuration file

Where to get the license

See with Wi6labs if not already provided with the product.

File name

The license's file's name look like : license_XXXXXXXX.json. With "XXXXXXXX" as the hardware serial number.

Upload configuration

Upload the license

To give or update a license, the license's file has to be put in the following folder using FTP : /uwiotys/update_config/
After that step, a reboot is needed to take this license into account. You can reboot by two ways:

• With ftp :

  • Create a file named "reboot" in directory "/update/".

  • A file XXXXXXXX_reboot_processed_yy is created once command processed.

  • Command reboot is processed if XXXXXXXX_reboot_processed_yy does not exist and each time the command file is edited.

• With Kerlink gateway button:

  • iFemToCell: Press the reset button located on the side of the gateway.

  • iStation: Press once (and only once) the On/Off button.

See How to know if the product has a license to know if the license is correctly added.

...

ff:03:02:e1"
}

After a few seconds the LEDs stop blinking, wait another minute then reconnect you to the FTP. The status of the output configuration update can be found in /uwiotys/log/uwiotys_functionnal.log

Current configuration

The output current configuration of µWiotys is available in the directory: /uwiotys/current_config/

License Configuration

Configuration file

Where to get the license

See with Wi6labs if not already provided with the product.

File name

The license's file's name look like : license_XXXXXXXX.json. With "XXXXXXXX" as the hardware serial number.

Upload configuration

Upload the license

Same process than before, see Upload configuration and replace with the license_XXXXXXXX.json

How to know if the product has a license

Logs can be :

• "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 have HAS a license.

How to know the license's type and state

...

Logs can contain :

• "Check license success. license type SIMPLE - C license in use, out of M [

  Status
  colour Green title current

  ] license in use, out of [

  Status
  colour Red title MAX

  ] license." for the SIMPLE license.

• "Check license success. license type: LISTED : L[

  Status
  colour Purple title tYPE

  ] " for the LISTED license.

...

Where

Status
colour Green title current

is the currently used number of sensors, M as the maximum possible sensors' number.
And L as

Status
colour Red title MAX

is the maximum possible sensors' number.
And

Status
colour Purple title tYPE

is the list of authorized references.

How to know what outputs can be used with the current license

...

license

...

Logs contain :

Code Block
language cpp
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

It is possible to update the installation of µwiotys to benefit from recent evolutions.

...

1. Replace the XXXXXXX of the provided file : XXXXXXXX_data.json to be the 8 lasts digits of µwiotys' EUI.

2. Push the renammed renamed file to the configuration folder.

3. Check that a file (XXXXXXXX_set_configuration_processed_ok) is created in the configuration folder. (TIPS: Don't forget to refresh, if the file isn't created please reboot the GW and restart from step 1)

4. Push the file : uwiotys-update_1.3.0_klkgw.ipk to the update folder.

5. Push the update file to the update folder.

6. Check that a file (XXXXXXXX_update_processed_ok) is created in the update folder. (TIPS: Don't forget to refresh)

7. Push the reboot file to the update folder.

8. Check that a file (XXXXXXXX_reboot_processed_yy) is created in the update folder. (TIPS: Don't forget to refresh)

9. Wait. (Take arround around 5 minutes to complete)

10. If everything is ok, you must find in uwiotys/devices_current_config the following file : devices_date-time.json

...

1. Push the file : uwiotys-update_2.x.x.xxxx.ipk to the update folder.

2. Push the update file to the update folder.

3. Check that a file (XXXXXXXX_update_processed_ok) is created in the update folder. (TIPS: Don't forget to refresh, if the file isn't created please reboot the GW and restart from step 1)

4. Push the reboot file to the update folder.

5. Check that a file (XXXXXXXX_reboot_processed_yy) is created in the update folder. (TIPS: Don't forget to refresh)

6. Wait. (Take arround around 5 minutes to complete)

7. Push the license to µwiotys, see how to in : Upload the license chapter.

8. If everything is ok, you must find in the last part of uwiotys/log/uwiotys_functional.log the following line : The license is VALID. µWiotys will start.

From 2.x to 2.x and 3.x to 3.x

Warning upgration upgrade from 2.x to 3.x is not supported !

1. Push the file : uwiotys-update_2.x.x.xxxx.ipk to the update folder.

2. Push the update file to the update folder.

3. Check that a file (XXXXXXXX_update_processed_ok) is created in the update folder. (TIPS: Don't forget to refresh, if the file isn't created please reboot the GW and restart from step 1)

4. Push the reboot file to the update folder.

5. Check that a file (XXXXXXXX_reboot_processed_yy) is created in the update folder. (TIPS: Don't forget to refresh)

6. Wait. (Take arround around 5 minutes to complete)

7. If everything is ok, you must find in the last part of uwiotys/log/uwiotys_functional.log the following line : The license is VALID. µWiotys will start.

...