Networks

For each project, you can save multiple LTE and Wi-Fi profiles for use across various devices through the Networks tab. This eliminates the need to repeatedly enter settings such as Wi-Fi passwords or LTE APNs during device provisioning.

Furthermore, you can implement these profiles remotely and manage your device’s network settings remotely through Ctrl.

Note

Network settings through Ctrl are only enabled for SG devices at the moment.

Manage Network Profiles

A network profile is a set of network configurations that can be implemented to multiple devices in the project.

Note

If your device is provisioned via ZTP, an LTE profile will be automatically added for you, with name “1NCE”.

Create new network profile

  1. In the side menu, click “Networks”, then “Add network profile”.

    Add network profile
  2. Choose “Wi-Fi” or “LTE”, and enter the required network credentials.

    Wi-Fi and LTE network profile options
  3. Click “Add network profile” once it’s done. Your new network profile will be available under the corresponding tab.

Edit network profile

  1. In the side menu, click “Networks”.

  2. Click the “…” icon on the right-most column of the target network, then “Edit”.

    Edit network profile option
  3. Make changes to the network credentials as needed. Note that SSID is not editable for Wi-Fi profiles while name is not editable for LTE profiles.

    Edit network credentials
  4. Click “Save” to apply changes.

Note

In order to implement the changes on your devices, you need to deploy the changes through each device’s network tab.

Delete network profile

A network can only be deleted if it is not being used by an existing device.

  1. In the side menu, click “Networks”, then choose the target network.

  2. Click the “…” icon on the right-most column of the target profile, then “Delete”.

    Delete network profile

Manage Device Network Settings

The F1 Starter Kit supports multiple network types that can be adjusted according to your need. You can enable or disable particular network types AND adjust the network type priority of your Starter Kit through Ctrl.

Accessing the device network settings

  1. In the side menu, click “Devices”. Then, click on the target device.

  2. Click on the device’s “Networks” tab.

Activate or deactivate a network

  1. Click on the arrow icon on the target network.

    Device network settings
  2. Press the toggle on the top right corner.

    Toggle network activation
  3. If you are activating the network, choose the preferred network profile before saving the update.

  4. The activated networks are displayed under the “Activated networks” section, while the non-active networks are displayed under “Other networks” section.

Ctrl LoRaWAN integration

LoRa connectivity activation

Since Ctrl is integrated with SG Wireless TTN LoRaWAN, it will automatically register and connect your devices upon LoRa activation through Ctrl.

  1. First, ensure you have a LoRaWAN gateway within accessible range of your device. Identify the region setting of the gateway and make sure that it’s also connected to the internet.

  2. Once you activate the LoRa profile toggle, you will need to select the LoRaWAN region that matches with your LoRaWAN gateway region. Upon clicking the save button, Ctrl will automatically generate TTN device activation information, such as JoinEUI, DevEUI, AppKey, and NwkKey. This information is currently not visible by user in Ctrl. But it can be accessed by calling ctr.print_config() Ctrl Client endpoint through any IDE of your choice.

Enable lora network
  1. This device activation information will be passed to the device when you deploy the network profile.

If you wish to use your own LoRaWAN setup, you can use the programming resources on this page to configure the LoRa connection: Network Interfaces

LoRa Connectivity Limitations

  1. Downlink data is not real-time. As a LoRa Class A device, F1 Starter Kit always initiates communication from the device side and operates fully asynchronously, so downlink messages are not delivered instantly.

  2. LoRa’s long-range, low-power design limits the size of data packets, so that these capabilities are not supported over LoRa:
    1. Linking / unlinking sensors

    2. OTA firmware update

    3. OTA file content update

    4. OTA network settings update

Rejoining SGW LoRaWAN TTN Network

Supposedly, you only need to register your device to SG Wireless TTN network once during activation. However if your device looses connectivity from activities like firmware reflashing, the device needs to rejoin the network. While the device activation credentials remain unchanged, you might encounter errors like ‘DevNonce is too small’. In this case, kindly contact us at info@sgwireless.com for support. We will help you to reset the DevNonce.

Adjust the device network priority

In the list of activated networks, click and hold the three lines on the left of the target network, and drag it to its desired priority.

Adjust network priority

Note

This priority will only be used during the first-time connection. Automatic network switching is not supported after connection has been established.

Deploy the network setting

To implement the updated settings on your device, deploy it using one of the following approaches:

  • If your device is currently online: press the “Deploy profiles” button to deploy the update over the air.

    Deploy profiles over the air
  • If your device is currently offline:

    1. Generate an activation key by clicking the button under the “…” icon of the device’s network tab.

      Generate activation key
    2. Copy the resulting activation code.

    3. Deploy the code through the CtrlR Visual Studio plugin.