IOx Gateway 2021
Under Development
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
Supported Device Modes
- Connected
Properties
Note
Scan Window range is 5 - 95 %
Measurements
| Measurement | From Version |
|---|---|
| 0x8410 - Upstream Packets Sent | |
| 0x8411 - Upstream Packets Lost | |
| 0x8412 - Downstream Packets Sent | |
| 0x8413 - Downstream Packets Lost |
Supported Targets
| Target | Confirmed |
|---|---|
| Cisco Catalyst 9130 | Supported |
| Cisco Catalyst 9120 | Tested and Supported |
| Cisco Catalyst 9117 | Supported |
| Cisco Catalyst 9115 | Supported |
| Cisco Catalyst 9105 | Supported |
Note
IOx Gateway 2021 must be upgraded via Cisco DNA Center or the ioxclient command line tool provided as part of Cisco IOx SDK.
Installation using ioxclient
- Insert the Raytac MDBT50Q-RX 0040 dongle into the USB port of the Cisco Access Point.
- Install ioxclient
ioxclient is a command line tool used to manage IOx applications on Cisco devices. This tool is primarily to be used by developers.
The program 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.
You can create as many profiles as you want and switch between them with the command:
ioxclient profiles activate <profilename>
Installation of the app is done in five steps:
- Download IOx application
- Install
- Activate
- Start
Download IOx Application Firmware
- Log into Meshtech Device Management at iot.meshtech.no
- Go to the Firmware section and expand IOx Gateway 2021
- Click the download button for the version you want to download to download the .tar file.
Install
To install the application to the Cisco Access Point, 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_DEV1",
"device-name": "async2",
"device-id": "/dev/ttyACM0",
"usage": "UART interface for external BLE Gateway USB dongle"
}
]
}
}
You can download the file here: activation.json
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
When the IOx Gateway 2021 application starts up, it will automatically establish a connection to Meshtech Device Management.
The gateway should now be available from iot.meshtech.no.
Upgrade
To upgrade the application use the following commands:
- Stop:
ioxclient app stop IOx_Gateway_2021 - Deactivate:
ioxclient app deactivate IOx_Gateway_2021 - Upgrade:
ioxclient app upgrade IOx_Gateway_2021 IOxGateway_2021_6_1_0.tar
When asked to preserve configuration, select 'y' (yes).
- Activate:
ioxclient app activate --payload activation.json IOx_Gateway_2021 - Start:
ioxclient app start IOx_Gateway_2021
Installation using DNA server
One must plug in the dongle and provide the license during installation. The license consists of 3 parts. These parts can be copy-pasted from our Management System.
Please, refer to the Cisco Deployment Guide
Licenses
The app uses the following licenses.