IOx Gateway 2021¶

Description¶

IOx Gateway 2021 is a Cisco IOx application running the Meshtech Gateway Host. Combined with the Raytac MDBT50Q-RX 0040 extender dongle this enables access to the Meshtech network and uplink connectivity to the customer backend. The IOx application communicates via the Cisco Access Point to ensure secure and reliable network connectivity.

Configuration and monitoring of the gateway is available through Meshtech Device Management Portal.

• Firmware Model Number: 0x2021

• Downlinks: Up to 18

Properties¶

Measurements¶

Events¶

Supported Targets¶

Most access points from the Cisco Catalyst 9100 Family are supported, for example Cisco Catalyst 9120.

Hosting Requirements:

• CPU Architecture: ARM 64 bit

• CPU: 4800 Units

• Memory: 100 MB

• Disk: 10 MB

Installation¶

This section describes how to install using the ioxclient command line tool from Cisco. The ioxclient tool is primarily to be used by developers and is used to manage IOx applications on Cisco devices.

The installation process consists of two main parts:

• Installation of app on Cisco device.

• Claiming and Activation of gateway in Meshtech Device Management Portal.

To start the installation you need:

• A Cisco device supporting Cisco Application Hosting.

• A Raytac MDBT50Q-RX 0040 dongle.

• A user login (customer) at Meshtech Device Management Portal.

Before installing the app, ioxclient must be installed on the PC/server. ioxclient can be downloaded from Cisco at https://developer.cisco.com/docs/iox/#!iox-resource-downloads.

When you have installed ioxclient you need to create a profile where you specify the connection details for your device. To create a new profile run the following command:

ioxclient profiles create

You will be asked to enter various configuration settings. After you have answered the questions, the profile will be created and activated.

Installation of the app is done in 4 steps:

1. Download IOx Application Firmware

2. Install

3. Activate

4. Start

Download IOx Application Firmware

• Log into Meshtech Device Management at iot.meshtech.no

• Go to the Firmware section and expand IOx Gateway 2021

• Download the .tar installation file by clicking the Download button for the latest version.

Install

To install the application to the Cisco device, run the following command:

ioxclient app install IOx_Gateway_2021 <application filename>

This will install the IOx Gateway 2021 application to your device with the name IOx_Gateway_2021. This name is used later to refer to this application instance.

Activate

To activate the application, you need to prepare an activation.json file with the following content:

{
  "resources": {
    "profile": "custom",
    "cpu": 4800,
    "memory": 100,
    "disk": 10,
    "network": [
      {
        "interface-name": "eth0"
      }
    ],
    "devices": [
      {
        "type": "serial",
        "label": "HOST_DEV_BLEGW",
        "device-id": "/dev/ttyiote0",        
        "usage": "Raytac MDBT50Q-RX 0040 (BLE GW)"
      }
    ]
  }
}

Then, run the following command:

ioxclient app activate --payload activation.json IOx_Gateway_2021

Start

Now, you can start the application with the following command:

ioxclient app start IOx_Gateway_2021

With the app installed and running, the gateway can be claimed and activated.

Claim and Activate¶

With the IOx application running, insert the Raytac MDBT50Q-RX 0040 dongle into the USB port of the Cisco device. Within a few seconds, the IOx app will now detect the dongle is present and register the gateway at iot.meshtech.no. To claim the gateway, log in at iot.meshtech.no and click the Claim button. Enter the serial number (SN) of the Cisco device to claim the gateway.

Upon successful claim, the gateway should be available from iot.meshtech.no and assigned to the customer that claimed it. The ID of the gateway is the MAC Address (lowercase) of the Raytac MDBT50Q-RX 0040 BLE adapter (BLE GW).

To use the gateway, it must first be activated. Go to the Activation tab and click Activate. Now, the gateway is scanning and will start to build the sensor network.

Typically, you would also want to set a backend configuration in order to interact with the sensor network.

Upgrading¶

To upgrade the application, use the following commands:

1. Stop - ioxclient app stop IOx_Gateway_2021

2. Deactivate - ioxclient app deactivate IOx_Gateway_2021

3. Upgrade - ioxclient app upgrade IOx_Gateway_2021 IOxGateway_2021_7_1_0.tar

4. Activate - ioxclient app activate --payload activation.json IOx_Gateway_2021

5. Start - ioxclient app start IOx_Gateway_2021

During upgrade, when asked to preserve configuration, select ‘y’ (yes).

Root Certificates Management¶

Additional root certificates (in PEM format) can be added using 0x8030 - Add Root Certificate or removed using 0x8031 - Remove Root Certificate.
The current set of additional root certificates can be read using 0x8032 - Root Certificates and 0x8033 - Root Certificate Fingerprints.

Root Certificates are needed for accessing HTTPS endpoints that present a certificate not signed by an official trusted certificate authority (CA).

History¶

Release Notes¶

Licenses¶