ArubaOS 8.6.0.0 Help Center
You are here: Home > IoT > Configuring IoT

Configuring IoT

ArubaOS allows you to create and apply IoTInternet of Things. IoT refers to the internetworking of devices that are embedded with electronics, software, sensors, and network connectivity features allowing data exchange over the Internet. transport profiles through the CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions..

Creating an IoT Transport Profile

The following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command creates an IoTInternet of Things. IoT refers to the internetworking of devices that are embedded with electronics, software, sensors, and network connectivity features allowing data exchange over the Internet. transport profile:

(host) [mynode] (config) #iot transportProfile test-IoT

Applying an IoT Transport Profile

The following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command applies an IoTInternet of Things. IoT refers to the internetworking of devices that are embedded with electronics, software, sensors, and network connectivity features allowing data exchange over the Internet. transport profile:

(host) [mynode] (config) #iot useTransportProfile test-IoT

Viewing an IoT Transport Profile

To view the list of IoTInternet of Things. IoT refers to the internetworking of devices that are embedded with electronics, software, sensors, and network connectivity features allowing data exchange over the Internet. transport profiles, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) [mynode] (config) #show iot transportProfile

 

IoT Data Profile List

---------------------

Name References Profile Status

---- ---------- --------------

test-IoT 0

 

Total:1

To view the status of an IoTInternet of Things. IoT refers to the internetworking of devices that are embedded with electronics, software, sensors, and network connectivity features allowing data exchange over the Internet. transport profile, issue the following command:

(host) [mynode] (config) #show iot transportProfile test-IoT

 

IoT Data Profile "test-IoT"

--------------------------

Parameter Value

--------- -----

Server Type Meridian-Beacon-Management

Server URL N/A

Access Token N/A

Client Id N/A

Username N/A

Password N/A

Reporting interval 600

Device Class Filter aruba-sensors

UUID Filter N/A

Movement Filter 0

Vendor Filter 0

Cell Size Filter 0

Age Filter 0

Authentication URL N/A

UID Namespace Filter N/A

URL Filter N/A

Access ID N/A

RSSI Reporting Format average

choose an environment type office

Custom Fading Factor 20

Iot Proxy Server N/A

Iot Proxy User N/A

AP Group N/A

Enable BLE on Controller Disabled

Send device counts only Disabled

RTLS Destination MAC Address N/A

Example

To create an IoTInternet of Things. IoT refers to the internetworking of devices that are embedded with electronics, software, sensors, and network connectivity features allowing data exchange over the Internet. profile for managing Meridian beacons, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) [mynode] (config) #iot transportProfile Sample-Beacons-Management

To create an IoTInternet of Things. IoT refers to the internetworking of devices that are embedded with electronics, software, sensors, and network connectivity features allowing data exchange over the Internet. profile for tracking Meridian assets, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) [mynode] (config) #iot transportProfile Sample-Meridian-Asset-Tracking

To create an IoTInternet of Things. IoT refers to the internetworking of devices that are embedded with electronics, software, sensors, and network connectivity features allowing data exchange over the Internet. profile for Aruba telemetry HTTPSHypertext Transfer Protocol Secure. HTTPS is a variant of the HTTP that adds a layer of security on the data in transit through a secure socket layer or transport layer security protocol connection., run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) [mynode] (config) #iot transportProfile Sample-Aruba-Telemetry-Https

To create an IoTInternet of Things. IoT refers to the internetworking of devices that are embedded with electronics, software, sensors, and network connectivity features allowing data exchange over the Internet. profile for Aruba telemetry Websocket, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) [mynode] (config) #iot transportProfile Sample-Aruba-Telemetry-Websocket

To apply the IoTInternet of Things. IoT refers to the internetworking of devices that are embedded with electronics, software, sensors, and network connectivity features allowing data exchange over the Internet. transport profile for tracking Meridian beacons, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) [mynode] (config) #iot useTransportProfile Sample-Meridian-Asset-Tracking

Viewing BLE Status

To view the BLEBluetooth Low Energy. The BLE functionality is offered by Bluetooth® to enable devices to run for long durations with low power consumption. relay status, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) [mynode] #show ble_relay iot-profile

To view the BLEBluetooth Low Energy. The BLE functionality is offered by Bluetooth® to enable devices to run for long durations with low power consumption. configuration of an AP, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) [mynode] #show ap debug ble-config

To view the BLEBluetooth Low Energy. The BLE functionality is offered by Bluetooth® to enable devices to run for long durations with low power consumption. relay log, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) [mynode] #show ble_relay log

To view the BLEBluetooth Low Energy. The BLE functionality is offered by Bluetooth® to enable devices to run for long durations with low power consumption. relay report, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) [mynode] #show ble_relay report

To view the BLEBluetooth Low Energy. The BLE functionality is offered by Bluetooth® to enable devices to run for long durations with low power consumption. relay jobs, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) [mynode] #show ble_relay jobs

To view the BLEBluetooth Low Energy. The BLE functionality is offered by Bluetooth® to enable devices to run for long durations with low power consumption. relay status for websockets transport, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) [mynode] #show ble_relay disp-attr

To view list of BLEBluetooth Low Energy. The BLE functionality is offered by Bluetooth® to enable devices to run for long durations with low power consumption. relay tag report, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) [mynode] #show ble_relay tag-report

To view list of BLEBluetooth Low Energy. The BLE functionality is offered by Bluetooth® to enable devices to run for long durations with low power consumption. relay WS log, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) [mynode] #show ble_relay ws-log

To view third-party devices in the BLEBluetooth Low Energy. The BLE functionality is offered by Bluetooth® to enable devices to run for long durations with low power consumption. table, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) [mynode] #show ap debug ble-table generic

Configuring ZF Openmatics

The ZF tag data scans and provides feedback to the ZF server if a ZF endpoint is configured in an IoTInternet of Things. IoT refers to the internetworking of devices that are embedded with electronics, software, sensors, and network connectivity features allowing data exchange over the Internet. transport profile.

 

The beaconing mode must be enabled on the BLEBluetooth Low Energy. The BLE functionality is offered by Bluetooth® to enable devices to run for long durations with low power consumption. radio of the AP.

Create an IoTInternet of Things. IoT refers to the internetworking of devices that are embedded with electronics, software, sensors, and network connectivity features allowing data exchange over the Internet. transport profile by using the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) [mynode] (config) #iot transportProfile Sample-ZF

Configure the end point type for ZF tags by using the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) [mynode] (IoT Data Profile "Sample-ZF") #endpointtype ZF

Configure the end point URLUniform Resource Locator. URL is a global address used for locating web resources on the Internet. for ZF tags by using the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) [mynode] (IoT Data Profile "Sample-ZF") # endpointURL https://app.detagtive.com/backend

 

The URLUniform Resource Locator. URL is a global address used for locating web resources on the Internet. https://appShort form for application. It generally refers to the application that is downloaded and used on mobile devices..detagtive.com/backend is only an example. For final URLUniform Resource Locator. URL is a global address used for locating web resources on the Internet., refer to ZF company’s latest update.

Configure the username for ZF tags by using the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) [mynode] (IoT Data Profile "Sample-ZF") #username admin

Configure the password for ZF tags by using the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) [mynode] (IoT Data Profile "Sample-ZF") #password <password

Configure the reporting interval for ZF tags by using the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) [mynode] (IoT Data Profile "Sample-ZF") #reportingInterval 60

 

The default is 300 seconds. The recommended value for ZF is 60 seconds.

Configure the payload content for ZF tags by using the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) [mynode] (IoT Data Profile "Sample-ZF") #deviceClassFilter ZF-Tag

Apply the IoTInternet of Things. IoT refers to the internetworking of devices that are embedded with electronics, software, sensors, and network connectivity features allowing data exchange over the Internet. transport profile by using the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) [mynode] (config) #iot useTransportProfile Sample-ZF

Creating a ZigBee-Based IoT Transport Profile

Create a ZigBee-based IoTInternet of Things. IoT refers to the internetworking of devices that are embedded with electronics, software, sensors, and network connectivity features allowing data exchange over the Internet. transport profile by using the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) (config) #iot transportProfile Sample-Zigbee-Transport

Configure the ZigBee end point type by using the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) (config) (IoT Data Profile "Sample-Zigbee-Transport") #endpointtype sbeacon

Configure the ZigBee end point URLUniform Resource Locator. URL is a global address used for locating web resources on the Internet. by using the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) [mynode] (IoT Data Profile "Sample-Zigbee-Transport") # endpointURL https://192.168.1.200

Configure the ZigBee username by using the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) [mynode] (IoT Data Profile "Sample-Zigbee-Transport") #username admin

Configure the ZigBee password by using the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) [mynode] (IoT Data Profile "Sample-Zigbee-Transport") #password <password>

Configure the ZigBee device class fitler by using the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) [mynode] (IoT Data Profile "Sample-Zigbee-Transport") #deviceClassFilter sbeacon

Applying a ZigBee-Based IoT Transport Profile

To apply a ZigBee-based IoTInternet of Things. IoT refers to the internetworking of devices that are embedded with electronics, software, sensors, and network connectivity features allowing data exchange over the Internet. transport profile, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) (config) #iot useTransportProfile Sample-Zigbee-Transport

Sample Configuration

iot transportProfile "Sample-Zigbee-Transport"

endpointType sbeacon

endpointURL "https://192.168.1.200"

username "admin"

password 68aff6619d3c408d3f8133d4f2de78bfa92ee6c882e36180

deviceCLassFilter sbeacon

!

iot useTransportProfile "Sample-Zigbee-Transport"

!

Configuring a ZigBee-Based IoT Radio Profile

To create a ZigBee-based IoTInternet of Things. IoT refers to the internetworking of devices that are embedded with electronics, software, sensors, and network connectivity features allowing data exchange over the Internet. radio profile, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) (config) #iot radio-profile Sample-Zigbee-Radio

 

An AP supports up to 4 endpoint types or IoTInternet of Things. IoT refers to the internetworking of devices that are embedded with electronics, software, sensors, and network connectivity features allowing data exchange over the Internet. radio profiles. The IoTInternet of Things. IoT refers to the internetworking of devices that are embedded with electronics, software, sensors, and network connectivity features allowing data exchange over the Internet. radio profile name can be up to 32 characters.

To enable the radio, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) (config) (IoT Radio Profile "Sample-Zigbee-Radio") #radio-enable

To configure the ZigBee radio mode, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) (config) (IoT Radio Profile "Sample-Zigbee-Radio") #radio-mode zigbee

 

The default radio mode is not configured and ZigBee is disabled for all devices bound to the endpoint type of a ZigBee-based IoTInternet of Things. IoT refers to the internetworking of devices that are embedded with electronics, software, sensors, and network connectivity features allowing data exchange over the Internet. radio profile.

The following table summarizes the relationship between radio-mode and radio-enable:

Table 1: Relationship between radio-mode and radio-enable

Radio Mode

Radio Enable

Result

ZigBee

Enabled

ZigBee is enabled

ZigBee

Disabled

ZigBee is disabled

Not Configured

Enabled

ZigBee is enabled and reset to default configuration and discovered devices are reset

To configure the ZigBee co-ordinator operation mode, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) (config) (IoT Radio Profile "Sample-Zigbee-Radio") #zigbee-opmode coordinator

 

Only coordinator ZigBee operation mode is supported.

To configure the ZigBee channel, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) (config) (IoT Radio Profile "Sample-Zigbee-Radio") #zigbee-channel 11

 

Allowed ZigBee channels are auto and 11 through 26. The default ZigBee channel is auto.

To configure the ZigBee PAN ID type, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) (config) (IoT Radio Profile "Sample-Zigbee-Radio") #zigbee-panid-type static

 

Allowed ZigBee PAN ID types are auto and static. The default ZigBee PAN ID type is auto.

To configure the ZigBee PAN ID, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) (config) (IoT Radio Profile "Sample-Zigbee-Radio") #zigbee-panid 0x0000

 

Allowed ZigBee PAN IDs are 0x0000 through 0xFFFF. A ZigBee PAN ID is effective only when the ZigBee PAN ID type is static. The default ZigBee PAN ID is 0x0000.

To allow ZigBee joining, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) (config) (IoT Radio Profile "Sample-Zigbee-Radio") #zigbee-permit-joining on

 

The default ZigBee joining is off.

To configure the ZigBee joining duration, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) (config) (IoT Radio Profile "Sample-Zigbee-Radio") #zigbee-permit-joining-duration 300

 

The ZigBee joining duration is effective only when ZigBee joining is on.

Sample Configuration

iot radio-profile "Sample-Zigbee-Radio"

radio-instance external

radio-mode zigbee

zigbee-channel 11

zigbee-permit-joining on

zigbee-permit-joining-duration 300

!

Viewing ZigBee-Based IoT Radio Profile

To view the list of ZigBee-based IoTInternet of Things. IoT refers to the internetworking of devices that are embedded with electronics, software, sensors, and network connectivity features allowing data exchange over the Internet. radio profiles, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) [mynode] #show iot radio-profile

To view the status of a ZigBee-based IoTInternet of Things. IoT refers to the internetworking of devices that are embedded with electronics, software, sensors, and network connectivity features allowing data exchange over the Internet. radio profile, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) [mynode] #show iot radio-profile Sample-Zigbee-Radio

To view the ZigBee radio configuration of an AP, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) [mynode] #show ap debug ble-table ap-name <ap-name> zigbee-radio

To view the list of ZigBee configuration of an AP, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) [mynode] #show ap debug ble-table ap-name <ap-name> zigbee

Configuring a ZigBee-USB External Dongle

To configure a ZigBee-USBUniversal Serial Bus. USB is a connection standard that offers a common interface for communication between the external devices and a computer. USB is the most common port used in the client devices.  external dongle, create an IoTInternet of Things. IoT refers to the internetworking of devices that are embedded with electronics, software, sensors, and network connectivity features allowing data exchange over the Internet. radio profile, apply the IoTInternet of Things. IoT refers to the internetworking of devices that are embedded with electronics, software, sensors, and network connectivity features allowing data exchange over the Internet. radio profile, create a service profile, and apply the service profile.

To create an IoTInternet of Things. IoT refers to the internetworking of devices that are embedded with electronics, software, sensors, and network connectivity features allowing data exchange over the Internet. radio profile, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) (config) #iot radio-profile zigbee-usb

(host) (IoT Radio Profile "zigbee-usb") #radio-mode zigbee

(host) (IoT Radio Profile "zigbee-usb") #radio-instance external

(host) (IoT Radio Profile "zigbee-usb") #zigbee-channel auto

(host) (IoT Radio Profile "zigbee-usb") #zigbee-opmode cordinator

To check if the IoTInternet of Things. IoT refers to the internetworking of devices that are embedded with electronics, software, sensors, and network connectivity features allowing data exchange over the Internet. radio profile is created, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) #show iot radio-profile zigbee-usb

Name :zigbee-usb

References :1

Instance :external

Mode :zigbee

BLE Opmode :scanning beaconing

BLE Console :

BLE TxPower (dBm) :0

Zigbee Mode :coordinator

Zigbee Channel(s) :auto

To apply the IoTInternet of Things. IoT refers to the internetworking of devices that are embedded with electronics, software, sensors, and network connectivity features allowing data exchange over the Internet. radio profile, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) (config) #iot use-radio-profile zigbee-usb

To create a service profile, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. commands:

(host) (config) # zigbee service-profile zigbee-usb-test

(host) (Zigbee Service Profile “zigbee-usb-test") # radio-instance external

(host) (Zigbee Service Profile “zigbee-usb-test") # permit-joining on

(host) (Zigbee Service Profile “zigbee-usb-test") # security disable

(host) (Zigbee Service Profile “zigbee-usb-test") # panid auto

To apply the service profile, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) (config) #zigbee use-service-profile zigbee-usb-test

To check if the service profile is applied, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. command:

(host) #show zigbee service-profile zigbee-usb-test

Name :zigbee-usb-test

Instance :external

PAN ID :auto

Security :Disable

Permit Joining :on

References :1

If the number of references is more than one, then the service profile is applied.

To check if Zigbee support is onboard or an external USBUniversal Serial Bus. USB is a connection standard that offers a common interface for communication between the external devices and a computer. USB is the most common port used in the client devices. dongle, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. commands:

(host) #show ap debug zigbee radio-table

Zigbee Radio Table

------------------

IEEE Address Profile Onboard Security Permit Joining Channel Extended PANID PANID RSSI Num of Clients Uptime

------------ ------- ------- -------- -------------- ------- -------------- ----- ---- -------------- ------

20:4c:03:ff:fe:8f:46:02 zigbee No Disabled 267s 25 204c03fffe8f4602 5a99 -- 0 43s

----------------

Total Zigbee radio(s):1

To check the firmware of the ZigBee-USBUniversal Serial Bus. USB is a connection standard that offers a common interface for communication between the external devices and a computer. USB is the most common port used in the client devices.  external dongle, run the following CLICommand-Line Interface. A console interface with a command line shell that allows users to execute text input as commands and convert these commands to appropriate functions. commands:

(host) #show ap debug ble-config

Radio Configuration

-------------------

Radio Information NORDIC USB External BLE Zigbee

----------------- ------------------------------

Radio Profile Type 1

Zigbee Supported Yes

APB MAC Address 20:4c:03:8f:46:02

APB Radio Profile 0x0002

APB Radio TxPower 0

Bundled BluOS Images DFU BL(/aruba/bin/beacon_usb_dfu-sdbl_1.3-44.bin) DFU APP(/aruba/bin/beacon_usb_dfu-app_1.3-44.bin)

/*]]>*/