An IoT AP manages IoT modules and communicates with an IoT server on behalf of the modules. The modules connect things to the Internet for intelligent identification, locating, tracking, monitoring, and management of the things.

IoT AP application scenarios

You can deploy IoT APs in different fields of the IoT by connecting them to the following IoT modules:

· RFID modules—Medical. For example, the IoT APs can provide the following medical services through identifying RFID devices:

¡ Infant protection through identifying mother and infant tags.

¡ Patients' body temperature monitoring through identifying temperature tags.

· BLE modules—Managing iBeacon devices or acting as iBeacon devices. The iBeacon technology developed by Apple enables an iBeacon device to broadcast a unique identifier to nearby application software. After receiving the identifier, the application software takes actions according to the identifier to fulfill software functions.

· Zigbee modules—Smart home or environment monitoring. A Zigbee network includes the following components:

¡ Coordinator—IoT modules installed with Zigbee cards, responsible for PAN formation and communication in the network.

¡ Zigbee router—Forwards information between devices.

¡ Standard Zigbee device—Collects and uploads data.

IoT AP types

An IoT AP can be an AP that has IoT modules installed in dedicated slots or an AP that has IoT modules connected to it through network cables.

Restrictions and guidelines: IoT AP configuration

You can configure APs by using the following methods:

· Configure APs one by one in AP view.

· Assign APs to an AP group and configure the AP group in AP group view.

· Configure all APs in global configuration view.

For an AP, the settings made in these views for the same parameter take effect in descending order of AP view, AP group view, and global configuration view.

IoT AP tasks at a glance

To configure an IoT AP, perform the following tasks:

1. Configuring basic features for IoT modules

a. (Optional.) Configuring auto module and auto module conversion

This feature takes effect only when modules connect to an IoT AP through network cables.

b. Specifying a serial number for a module

This task is required for manually configured modules, and optional for auto modules.

c. (Optional.) Configuring a module description

d. Specifying the supported module type

e. (Optional.) Specifying an IoT server

f. (Optional.) Specifying an IoT server by its IP address and port number for the specified type of IoT modules

g. (Optional.) Specifying an IoT server by its domain name and port number for the specified type of IoT modules

h. Enabling a module

i. (Optional.) Setting the transmit power level for a module

2. (Optional.) Changing the interface type of an IoT interface

This task is supported only on IoT APs that have IoT modules connected to them through network cables.

3. Configuring port reassignment

Perform this task as required by the IoT server.

4. (Optional.) Managing and maintaining modules

¡ Specifying the report mode for packets sent to IoT APs

¡ Specifying the report mode for packets sent to the IoT server

¡ Specifying the format for packets sent to the IoT server

¡ Configuring BLE active scanning

¡ Configuring iBeacon transmission for a BLE module

¡ Configuring IoT location

¡ Setting an RSSI threshold to filter location packets in IoT location

¡ Setting the value for the length field of IoT packets

¡ Specifying the packet format supported by an IoT module

¡ Configuring bracelet location

¡ Configuring location packet sampling

¡ Configuring LED lighting

This task is supported only for specific modules that connect to IoT APs through network cables.

¡ Setting the CAN link rate for an IoT module

Only specific external IoT modules support this feature.

¡ Setting the UART baud rate for an IoT module

Only specific external IoT modules support this feature.

¡ Reporting endpoint version information to the cloud platform

¡ Connecting an AP to Alibaba Cloud IoT Platform

¡ Restoring the factory settings for a module

¡ Restarting a module

¡ Upgrading the firmware of a module

5. (Optional.) Configuring a Zigbee network

¡ Specifying an access period for Zigbee devices

¡ Specifying a Zigbee PAN ID

¡ Specifying a Zigbee endpoint identifier and profile ID

¡ Specifying a Zigbee working channel

¡ Configuring packet encryption

¡ Specifying the interval at which an AP sends a keepalive packet to the ZigBee server

Configuring basic features for IoT modules

Configuring auto module and auto module conversion

About this task

The auto module feature enables modules to associate with an AP without manual module configuration. This feature simplifies configuration when you deploy a large number of modules on an AP.

To configure an auto module, you must convert the auto module to a manual module or configure it through an AP group.

When auto module conversion is enabled, subsequent auto modules will automatically convert to manual modules upon coming online and each converted module will be assigned a serial number. The existing online auto modules will not be affected.

Restrictions and guidelines

Auto module and auto module conversion take effect only when IoT modules connect to an IoT AP through network cables.

Procedure

1. Enter system view.

system-view

2. Enter AP view or AP group view.

¡ Enter AP view.

wlan ap ap-name

¡ Enter AP group view.

wlan ap-group group-name

3. Configure the auto module feature.

iot auto-module { disable | enable }

By default:

¡ In AP view, an AP uses the configuration in AP group view.

¡ In AP group view, the auto module feature is disabled.

4. (Optional.) Configure auto module conversion.

iot auto-module persistent { disable | enable }

By default:

¡ In AP view, an AP uses the configuration in AP group view.

¡ In AP group view, the auto module conversion feature is disabled.

5. (Optional.) Convert all online auto modules to manual APs.

iot auto-module persistent all

Specifying a serial number for a module

About this task

You must specify a serial number for a module on an IoT AP when the module connects to the IoT AP through a network cable. The module can come online on the AP only when the specified serial number is the same as the actual serial number of the module. A module installed on an IoT AP can come online directly no matter whether the configured serial number is the same as the module's serial number or not.

Restrictions and guidelines

Deleting the serial number or specifying a different serial number than the actual serial number of an online module logs off the module if the module connects to an IoT AP through network cables.

Procedure

1. Enter system view.

system-view

2. Enter AP view.

wlan ap ap-name

3. Enter module view.

module module-id

4. Specify a serial number for the module.

serial-number serial-number

By default, no serial number is specified for a module.

Configuring a module description

About this task

To manage modules installed on or connected to an IoT AP efficiently, configure descriptions for them based on their models, locations, and functions.

Procedure

1. Enter system view.

system-view

2. Enter AP view.

wlan ap ap-name

3. Enter module view.

module module-id

4. Configure a description for the module.

description text

By default, a module does not have a description.

Specifying the supported module type

About this task

For a module on an AP to operate correctly, make sure the supported module type is the same as the physical module type of the module.

The following module types are available:

· H3C-developed modules:

¡ BLE—Supports the Bluetooth protocol.

¡ RFID—Supports the RFID protocol.

¡ Zigbee—Supports the Zigbee protocol.

· Third-party modules:

¡ RFID—Supports the RFID protocol.

¡ UWB—Supports the UWB protocol.

Procedure

1. Enter system view.

system-view

2. Enter AP view or an AP group's AP model view.

¡ Enter AP view.

wlan ap ap-name

¡ Execute the following commands in sequence to enter an AP group' s AP model view:

wlan ap-group group-name

ap-model ap-model

3. Enter module view.

module module-id

4. Specify the supported module type.

type { ble | rfid | uwb | zigbee }

By default:

¡ In module view, a module uses the configuration in an AP group's module view.

¡ In an AP group's module view, no supported module type is specified.

Specifying an IoT server

About this task

This task allows you to specify an IoT server with which modules on an AP can communicate.

Procedure

1. Enter system view.

system-view

2. Enter AP view, AP group view, or global configuration view.

¡ Enter AP view.

wlan ap ap-name

¡ Enter AP group view.

wlan ap-group group-name

¡ Enter global configuration view.

wlan global-configuration

3. Specify an IoT server.

¡ Specify an IoT server for BLE modules:

rfid-tracking ble engine-address engine-address engine-port engine-port

For information about this command, see WLAN Advanced Features Command Reference.

¡ Specify an IoT server for IoT modules:

iot engine-address engine-address engine-port engine-port

By default:

¡ In AP view, an AP uses the configuration in AP group view. If no configuration exists in AP group view, the AP uses the configuration in global configuration view.

¡ In AP group view, an AP uses the configuration in global configuration view.

¡ In global configuration view, no server is specified.

Specifying an IoT server by its IP address and port number for the specified type of IoT modules

About this task

The IoT modules on an AP can communicate with an IoT server only after you specify the IP address and port number of the server on the AP.

Procedure

1. Enter system view.

system-view

2. Enter AP view or AP group view.

¡ Enter AP view.

wlan ap ap-name

¡ Enter AP group view.

wlan ap-group group-name

3. Specify an IoT server by its IP address and port number for the specified type of IoT modules.

iot module-model { ew100-r | t100-a | t300bp0r | t300er0r | t300pb0u | t300rt0r | tp100-r} engine-address ip ipv4-address engine-port engine-port

iot module-model { t300-r| t300-z} engine-address { ip ipv4-address | ipv6 ipv6-address } engine-port engine-port

By default, no IoT server is specified for IoT modules.

Specifying an IoT server by its domain name and port number for the specified type of IoT modules

About this task

The IoT modules on an AP can communicate with an IoT server only after you specify the domain name and port number of the server on the AP.

Procedure

1. Enter system view.

system-view

2. Enter AP view or AP group view.

¡ Enter AP view.

wlan ap ap-name

¡ Enter AP group view.

wlan ap-group group-name

3. Specify an IoT server by its domain name and port number for the specified type of IoT modules.

iot module-model { T300-R | T300-Z } engine-domain { ip | ipv6 } domain-name engine-port engine-port

By default, no IoT server is specified for IoT modules.

Enabling a module

1. Enter system view.

system-view

2. Enter AP view or an AP group's AP model view.

¡ Enter AP view.

wlan ap ap-name

¡ Execute the following commands in sequence to enter an AP group' s AP model view:

wlan ap-group group-name

ap-model ap-model

3. Enter module view.

module module-id

4. Enable the module.

module enable

By default:

¡ In module view, a module uses the configuration in an AP group's module view.

¡ In an AP group's module view, a module is disabled.

Setting the transmit power level for a module

About this task

You can set the transmit power for a module to the following levels:

· Level 1 (4 dBm).

· Level 2 (–1 dBm).

· Level 3 (–5 dBm).

· Level 4 (–9 dBm).

Procedure

1. Enter system view.

system-view

2. Enter AP view or an AP group's AP model view.

¡ Enter AP view.

wlan ap ap-name

¡ Execute the following commands in sequence to enter an AP group' s AP model view:

wlan ap-group group-name

ap-model ap-model

3. Enter module view.

module module-id

4. Set the transmit power level for the module.

tx-power power

By default:

¡ In module view, a module uses the configuration in an AP group's module view.

¡ In an AP group's module view, the transmit power level is 1, which indicates a transmit power of 4 dBm.

Changing the interface type of an IoT interface

NOTE:

Support for this feature depends on the AP model.

‌

About this task

You can change the interface type of an IoT interface among auto, IoT, and GigabitEthernet for connecting the AP to a module or to an Ethernet as required. An IoT interface of the auto type can automatically identify the downlink network and switch the interface type accordingly.

Procedure

1. Enter system view.

system-view

2. Enter AP view or an AP group's AP model view.

¡ Enter AP view.

wlan ap ap-name

¡ Execute the following commands in sequence to enter an AP group' s AP model view:

wlan ap-group group-name

ap-model ap-model

3. Change the interface type of an IoT interface.

port-type switch number port-number { auto | gigabitethernet | iot }

By default:

¡ In AP view, an AP uses the configuration in an AP group's AP model view.

¡ In an AP group's AP model view, the interface type of an IoT interface is auto.

Configuring port reassignment

About this task

This feature enables an IoT AP to periodically send port reassignment requests to the IoT server to obtain a new port until a response is received.

Restrictions and guidelines

This feature is required when the IoT server requires its connected IoT APs to use new ports for packet exchange.

If a new port becomes invalid for a specific reason, such as powerdown or reboot of the IoT server or IoT AP, disable this feature first and then enable this feature to obtain another port.

Procedure

1. Enter system view.

system-view

2. Enter AP view, AP group view, or global configuration view.

¡ Enter AP view.

wlan ap ap-name

¡ Enter AP group view.

wlan ap-group group-name

¡ Enter global configuration view.

wlan global-configuration

3. Configure port reassignment for the AP.

iot engine port-redistribute { disable | enable }

By default:

¡ In AP view, an AP uses the configuration in AP group view. If no configuration exists in AP group view, the AP uses the configuration in global configuration view.

¡ In AP group view, an AP uses the configuration in global configuration view.

¡ In global configuration view, port reassignment is disabled.

Specifying the report mode for packets sent to IoT APs

About this task

A module can use the following modes to send packets to the connected IoT AP:

· Parse mode—Parses and examines received packets before sending them to the IoT AP.

· Transparent mode—Directly sends received packets to the IoT AP without any extra operations.

Restrictions and guidelines

This feature takes effect only on IoT APs that have IoT modules connected to it through network cables.

Configure modules to use transparent mode if a third-party IoT server is deployed and modules are not allowed to parse received packets.

Procedure

1. Enter system view.

system-view

2. Enter AP view.

wlan ap ap-name

3. Enter module view.

module module-id

4. Specify the report mode for packets sent to the IoT AP.

iot module report-mode { parse | transparent }

By default, a module uses parse mode to send packets to the connected IoT AP.

Specifying the report mode for packets sent to the IoT server

About this task

An IoT AP uses the following report modes to send packets after encapsulation:

· Centralized mode—Sends packets to the AC first, and the AC forwards the packets to the IoT server or the cloud server.

· Local mode—Directly sends packets to the IoT server.

Procedure

1. Enter system view.

system-view

2. Enter AP view, AP group view, or global configuration view.

¡ Enter AP view.

wlan ap ap-name

¡ Enter AP group view.

wlan ap-group group-name

¡ Enter global configuration view.

wlan global-configuration

3. Specify the packet report mode.

iot report-mode { central | local }

By default:

¡ In AP view, an AP uses the configuration in AP group view. If no configuration exists in AP group view, the AP uses the configuration in global configuration view.

¡ In AP group view, an AP uses the configuration in global configuration view.

¡ In global configuration view, an IoT AP uses local mode to report IoT packets.

Specifying the format for packets sent to the IoT server

Restrictions and guidelines

Select a format based on the module type. For example, an AP uses general format to report ANT packets and transparent format to report Ewell packets.

Procedure

1. Enter system view.

system-view

2. Enter AP view, AP group view, or global configuration view.

¡ Enter AP view.

wlan ap ap-name

¡ Enter AP group view.

wlan ap-group group-name

¡ Enter global configuration view.

wlan global-configuration

3. Specify the IoT packet format.

iot report-format { general | transparent }

By default:

¡ In AP view, an AP uses the configuration in AP group view. If no configuration exists in AP group view, the AP uses the configuration in global configuration view.

¡ In AP group view, an AP uses the configuration in global configuration view.

¡ In global configuration view, an AP reports IoT packets in transparent format.

Configuring BLE active scanning

1. Enter system view.

system-view

2. Enter AP view or AP group's AP model view.

¡ Enter AP view.

wlan ap ap-name

¡ Execute the following commands in sequence to enter AP group's AP model view:

wlan ap-group group-name

ap-model ap-model

3. Enter module view.

module module-id

4. Specify BLE as the supported module type.

type ble

By default:

¡ In module view, a module uses the configuration in an AP group's module view.

¡ In an AP group's module view, no supported module type is specified.

5. Configure the BLE active scanning feature.

rfid-tracking ble active-scan { disable | enable }

By default:

¡ In module view, a module uses the configuration in an AP group's module view.

¡ In an AP group's module view, the BLE active scanning feature is disabled.

6. Specify the BLE active scanning period.

rfid-tracking ble active-scan time-range start-time to end-time

By default:

¡ In module view, a module uses the configuration in an AP group's module view.

¡ In an AP group's module view, BLE active scanning works from 00:00 to 24:00.

Configuring iBeacon transmission for a BLE module

About this task

This feature enables a BLE module to periodically broadcast iBeacon advertisements. An iBeacon advertisement contains a UUID, a Major ID, a Minor ID, and measured power. Application software that receives the iBeacon advertisement will take specific actions according to the advertisement information to fulfill software functions.

Procedure

1. Enter system view.

system-view

2. Enter AP view or an AP group's AP model view.

¡ Enter AP view.

wlan ap ap-name

¡ Execute the following commands in sequence to enter an AP group' s AP model view:

wlan ap-group group-name

ap-model ap-model

3. Enter module view.

module module-id

4. Specify BLE as the supported module type.

type ble

By default:

¡ In module view, a module uses the configuration in an AP group's module view.

¡ In an AP group's module view, no supported module type is specified.

5. Configure iBeacon transmission for a BLE module.

rfid-tracking ble advertisement { disable | enable }

By default:

¡ In module view, a module uses the configuration in an AP group's module view.

¡ In an AP group's module view, iBeacon transmission is disabled for a BLE module.

6. Configure the advertisement information.

rfid-tracking ble advertisement { major-id major-id | measured-power measured-power | minor-id minor-id | uuid uuid }

By default:

¡ In module view, a module uses the configuration in an AP group's module view.

¡ In an AP group's module view, the UUID is E1CC5B618C06428E8720FE619DB80193, Major ID is 1, Minor ID is 1, and measured power is –58 dBm in an iBeacon advertisement.

7. Set the interval for the BLE module to broadcast iBeacon advertisements.

rfid-tracking ble advertisement interval interval

By default:

¡ In module view, a module uses the configuration in an AP group's module view.

¡ In an AP group's module view, a BLE module broadcasts iBeacon advertisements every 100 centiseconds (1 second).

Configuring IoT location

About this task

For an IoT AP to scan channels and receive packets, you must enable IoT location.

This feature enables an IoT AP to perform the following operations:

· Identifies all packets from bracelets through the RFID modules installed on or connected to the IoT AP and forwards the packets to the cloud server.

The cloud server calculates the rough locations of the bracelets based on the reported packets.

· Identifies all packets from standard Zigbee devices through the Zigbee modules connected to the IoT AP and forwards the packets to the cloud server where packets are parsed and saved.

Procedure

1. Enter system view.

system-view

2. Enter AP view, AP group view, or global configuration view.

¡ Enter AP view.

wlan ap ap-name

¡ Enter AP group view.

wlan ap-group group-name

¡ Enter global configuration view.

wlan global-configuration

3. Configure IoT location.

rfid-tracking iot { disable | enable }

By default:

¡ In AP view, an AP uses the configuration in AP group view. If no configuration exists in AP group view, the AP uses the configuration in global configuration view.

¡ In AP group view, an AP uses the configuration in global configuration view.

¡ In global configuration view, IoT location is disabled.

Setting an RSSI threshold to filter location packets in IoT location

About this task

After you configure this feature, IoT location packets with an RSSI lower than the specified RSSI threshold are ignored to improve processing efficiency.

Procedure

1. Enter system view.

system-view

2. Enter AP view or an AP group's AP model view.

¡ Enter AP view.

wlan ap ap-name

¡ Execute the following commands in sequence to enter an AP group's AP model view:

wlan ap-group group-name

ap-model ap-model

3. Enter module view.

module module-id

4. Set an RSSI threshold to filter location packets in IoT location.

rfid-tracking iot rssi threshold rssi-threshold

By default:

¡ In module view, a module uses the configuration in an AP group's module view.

¡ In an AP group's module view, no RSSI threshold is set to filter location packets in IoT location.

Setting the value for the length field of IoT packets

About this task

The supported IoT packet length varies by IoT terminal models. Set the value of the length field as required by your IoT terminal model.

Restrictions and guidelines

Only RFID modules support this feature.

Procedure

1. Enter system view.

system-view

2. Enter AP view or an AP group's AP model view.

¡ Enter AP view.

wlan ap ap-name

¡ Execute the following commands in sequence to enter an AP group's AP model view.

wlan ap-group group-name

ap-model ap-model

3. Enter module view.

module module-id

4. Set the value for the length field of IoT packets.

iot packet length-field { 8 | 6 }

By default:

¡ In module view, a module uses the configuration in an AP group's module view.

¡ In an AP group's module view, the value for the length field of IoT packets is 8 bits.

Specifying the packet format supported by an IoT module

Restrictions and guidelines

Only RFID IoT modules support this feature.

Procedure

1. Enter system view.

system-view

2. Enter AP view.

wlan ap ap-name

3. Enter IoT module view.

module module-id

4. Specify the packet format supported by the IoT module.

iot packet format { h3c | hik | marktrace }

By default, an IoT module supports the H3C packet format.

Configuring bracelet location

1. Enter system view.

system-view

2. Enter AP view.

wlan ap ap-name

3. Specify inside-campus IoT modules and outside-campus IoT modules.

iot location module module-id-list1&<1-2> inside module-id-list2&<1-2> outside

By default, no inside-campus or outside-campus IoT modules are specified.

4. Set RSSI parameters for bracelet location.

iot location rssi period period valid-rssi value diff-rssi value

Configuring location packet sampling

About this task

This feature prevents location packets sent by bracelets whose location does not change or changes very little within a long period from affecting the overall performance of the AC. With this feature enabled, an IoT AP sends only the packet with the highest RSSI from a bracelet within each sampling interval to the AC.

Restrictions and guidelines

The location packet sampling feature is unavailable if the value for the length field of IoT packets is 6 bits.

Procedure

1. Enter system view.

system-view

2. Enter AP view.

wlan ap ap-name

3. Enable the IoT AP to sample location packets from all IoT modules or a specified IoT module.

rfid-tracking iot sampling module { all | module-id1 [ to module-id2 ] }

By default, location packet sampling is disabled.

4. Set a location packet sampling interval.

rfid-tracking iot sampling interval interval

By default, the location packet sampling interval is 10 seconds.

Configuring LED lighting

About LED lighting

This feature helps locate a module connected to an IoT AP through a cable by controlling the flash rate or lighting mode of the LEDs on the module.

Setting a LED lighting mode for a module

Restrictions and guidelines

If you do not want the LEDs to flash, set the LED lighting mode of the module to quiet.

Procedure

1. Enter system view.

system-view

2. Enter AP view or an AP group's AP model view.

¡ Enter AP view.

wlan ap ap-name

¡ Execute the following commands in sequence to enter an AP group' s AP model view:

wlan ap-group group-name

ap-model ap-model

3. Enter module view

module module-id

4. Set a LED lighting mode.

iot module led-mode { normal | quiet }

By default:

¡ In module view, a module uses the configuration in an AP group's module view.

¡ In an AP group's module view, the LED lighting mode of a module is normal.

Triggering regular LED flashing for a module

About this task

To locate a module connected to an IoT AP, perform this task to trigger all LEDs on the module to flash 20 seconds at a rate of one flash per second.

Procedure

1. Enter system view.

system-view

2. Trigger regular LED flashing for a module.

wlan execute module led-flash ap ap-name module module-id

Setting the CAN link rate for an IoT module

About this task

In a network where an AP is connected to IoT modules through wired links, the IoT module directly connected to the AP is the primary node, and all the IoT modules connected to the primary node (both directly and indirectly) are secondary nodes. The primary node communicates with the secondary nodes through a Controller Area Network (CAN) link. You can perform this task to set the data transmission rate for the CAN link.

Restrictions and guidelines

As a best practice, use the default CAN link rate, and do not improve the CAN link rate unless necessary.

The length of the CAN link cannot exceed 40 meters when the CAN link operates at 1000 kbps.

Only the primary node supports this feature. The secondary nodes can automatically adapt to the CAN link rate configured on the primary node.

Procedure

1. Enter system view.

system-view

2. Enter AP view.

wlan ap ap-name

3. Enter module view.

module module-id

4. Set the CAN link rate for the IoT module.

can speed { 500 | 1000 }

By default, the CAN link rate is 500 kbps.

Setting the UART baud rate for an IoT module

About this task

The Universal Asynchronous Receiver/Transmitter (UART) baud rate of an IoT module represents the serial port communication rate of the IoT module.

Restrictions and guidelines

As a best practice, use the auto-adaptive UART baud rate. If the baud rate of the card installed on the IoT module is known, set the UART baud rate of the IoT module to the baud rate of the card.

Procedure

1. Enter system view.

system-view

2. Enter AP view.

wlan ap ap-name

3. Enter module view.

module module-id

4. Set the UART baud rate for the IoT module.

uart baudrate { auto | 115200 | 921600 }

By default, the auto-adaptive UART baud rate is used. The IoT module automatically adapts to the baud rate of the card installed on the module.

Reporting endpoint version information to the cloud platform

About this task

Because IoT modules operate in simplex mode, you must specify an RFID module for packet receiving and another RFID module for packet transmission. The signal coverage areas of the two RFID modules must overlap. When the packet receiving module receives a keepalive packet from an endpoint, the packet transmission module broadcasts the endpoint version reporting instruction. Then, the endpoint reports its version information to the cloud platform.

Procedure

1. Enter system view.

system-view

2. Enter AP view.

wlan ap ap-name

3. Report endpoint version information to the cloud platform.

iot report-version rx-module rx-module-id tx-module tx-module-id endpoint-type { smart-card | tag | watch | wristband }

Connecting an AP to Alibaba Cloud IoT Platform

About this task

After you configure this feature on an AP, the AP sends a connection request to Alibaba Cloud IoT Platform. Alibaba Cloud IoT Platform authenticates the AP by using the product identifier and product key. If the AP passes the authentication, it connects to Alibaba Cloud IoT Platform successfully.

When an AP connects to Alibaba Cloud IoT Platform for the first time, Alibaba Cloud IoT Platform issues a device key to the AP.

Procedure

1. Enter system view.

system-view

2. Enter AP view, AP group view, or global configuration view.

¡ Enter AP view.

wlan ap ap-name

¡ Enter AP group view.

wlan ap-group group-name

¡ Enter global configuration view.

wlan global-configuration

3. Connect an AP to Alibaba Cloud IoT Platform.

iot connect-aliyun productkey key productsecret secret

By default:

¡ In AP view, an AP uses the configuration in AP group view. If no configuration exists in AP group view, the AP uses the configuration in global configuration view.

¡ In AP group view, an AP uses the configuration in global configuration view.

¡ In global configuration view, an AP is not connected to Alibaba Cloud IoT Platform.

Restoring the factory settings for a module

NOTE:

Support for this feature depends on the module model.

‌

About this task

This feature clears the settings of a module and restores the factory settings for the module.

This feature clears only settings that are already used by a module, and it does not clear settings configured for the module in module view on the AC. When the module restarts, all the settings in module view will be assigned to the module again.

Procedure

1. Enter system view.

system-view

2. Restore the factory settings for a module.

wlan execute module restore-factory ap ap-name module module-id

Restarting a module

1. Enter system view.

system-view

2. Restart a module.

wlan execute module reset ap ap-name module module-id

Upgrading the firmware of a module

About module firmware upgrade

You can use the following methods to upgrade the firmware of a module:

· Manual upgrade—Use the specified image file to manually upgrade the module's firmware.

· Automatic upgrade—Configure the automatic firmware upgrade feature to enable the module to immediately upgrade its firmware if its firmware version is different from the version stored in the AP's image file. After you enable this feature for a module, this feature takes effect every time the IoT AP where the module is installed restarts.

Restrictions and guidelines for module firmware upgrade

If you want the module's firmware version to be consistent with the version stored in the AP's image file, use automatic upgrade. In other cases, use manual upgrade.

During the module firmware upgrade process, do not use the shutdown command to shut down the interface that connects the module to the IoT AP.

When you perform a manual upgrade, follow these restrictions and guidelines:

· Save the module's image file to the AC's local folder.

· Make sure the automatic firmware upgrade feature is disabled for the module. The automatic firmware upgrade feature upgrades the module's firmware to the version stored in AP' image file every time the IoT AP where the module is installed restarts.

Configuring automatic firmware upgrade for a module

1. Enter system view.

system-view

2. Enter AP view or an AP group's AP model view.

¡ Enter AP view.

wlan ap ap-name

¡ Execute the following commands in sequence to enter an AP group' s AP model view:

wlan ap-group group-name

ap-model ap-model

3. Enter module view.

module module-id

4. Configure automatic firmware upgrade for the module.

module firmware-upgrade { disable | enable }

By default:

¡ In module view, a module uses the configuration in an AP group's module view.

¡ In an AP group's module view, automatic module firmware upgrade is enabled for a module.

Manually upgrading the firmware of a module

1. Enter system view.

system-view

2. Manually upgrade the firmware of a module.

wlan execute module firmware-upgrade ap ap-name module module-id firmware-path filepath

Configuring a Zigbee network

Restrictions and guidelines for Zigbee network configuration

As a best practice, configure the Zigbee network parameters for a Zigbee module before enabling the module.

Specifying an access period for Zigbee devices

About this task

Perform this task to specify a period during which a Zigbee device can access the specified Zigbee module.

Procedure

1. Enter system view.

system-view

2. Enter AP view.

wlan ap ap-name

3. Enter module view

module module-id

4. Specify a period during which a Zigbee device can access the Zigbee module.

zigbee permit-join duration time

By default, a Zigbee device cannot access a Zigbee module.

Specifying a Zigbee PAN ID

About this task

A Personal Area Network Identifier (PAN ID) uniquely identifies a Zigbee network. For a Zigbee module to connect to a standard Zigbee device, specify the PAN ID of the Zigbee device for the Zigbee module.

Restrictions and guidelines

To avoid conflicts, the PAN IDs for signal overlapped Zigbee networks must be different.

Procedure

1. Enter system view.

system-view

2. Enter AP view.

wlan ap ap-name

3. Enter module view

module module-id

4. Specify a Zigbee PAN ID.

zigbee pan-id pan-id

By default, the Zigbee PAN ID is a unique random number in the range of 0 to 65534.

Specifying a Zigbee endpoint identifier and profile ID

About this task

Each Zigbee application, such as building automation and furniture automation, has a profile ID, which is vendor specific or public.

An endpoint identifier defines the port number used by the Zigbee application layer for receiving and sending data.

Restrictions and guidelines

For a Zigbee module to communicate with a standard Zigbee device, make sure they are configured with the same endpoint identifier and profile ID.

Procedure

1. Enter system view.

system-view

2. Enter AP view or an AP group's AP model view.

¡ Enter AP view.

wlan ap ap-name

¡ Execute the following commands in sequence to enter an AP group' s AP model view:

wlan ap-group group-name

ap-model ap-model

3. Enter module view.

module module-id

4. Specify a Zigbee endpoint identifier and profile ID.

zigbee endpoint identifier profile-id profile-id

By default:

¡ In module view, a module uses the configuration in an AP group's module view.

¡ In an AP group's module view, the Zigbee endpoint identifier and profile ID are both 1.

Specifying a Zigbee working channel

Restrictions and guidelines

For a Zigbee module to connect to a standard Zigbee device, make sure they use the same working channel.

Procedure

1. Enter system view.

system-view

2. Enter AP view or an AP group's AP model view.

¡ Enter AP view.

wlan ap ap-name

¡ Execute the following commands in sequence to enter an AP group' s AP model view:

wlan ap-group group-name

ap-model ap-model

3. Enter module view.

module module-id

4. Specify a Zigbee working channel.

zigbee channel channel-number

By default:

¡ In module view, a module uses the configuration in an AP group's module view.

¡ In an AP group's module view, a Zigbee module uses channel 11 as the working channel.

Configuring packet encryption

About this task

Perform this task to enable or disable packet encryption for a Zigbee module. After you enable packet encryption, the Zigbee module and standard Zigbee devices use the AES-128 algorithm to encrypt packets exchanged.

A Zigbee module can connect only to standard Zigbee devices that have the same packet encryption state as the Zigbee module.

Procedure

1. Enter system view.

system-view

2. Enter AP view.

wlan ap ap-name

3. Enter module view

module module-id

4. Enable or disable packet encryption.

zigbee encryption { disable | enable }

By default, the packet encryption feature is disabled.

5. Specify a ZigBee connection key.

zigbee link-key { cipher | simple } string

By default, the ZigBee connection key is ZigBeeAlliance0' in plain text.

6. Specify a ZigBee network layer key.

zigbee network-key { cipher | simple } string

By default, the ZigBee network layer key is 0x01-0x03-0x05-0x07-0x09-0x0B-0x0D-0x0F-0x00-0x02-0x04-0x06-0x08-0x0A-0x0C-0x0D in plain text.

Specifying the interval at which an AP sends a keepalive packet to the ZigBee server

About this task

After an AP connects to a ZigBee server, it sends keepalive packets to the server. You can perform this task to specify the interval at which the AP sends a keepalive packet to the ZigBee server.

Procedure

1. Enter system view.

system-view

2. Enter AP view, AP group view, or global configuration view.

¡ Enter AP view.

wlan ap ap-name

¡ Enter AP group view.

wlan ap-group group-name

¡ Enter global configuration view.

wlan global-configuration

3. Specify the interval at which an AP sends a keepalive packet to the ZigBee server.

iot zigbee keepalive interval interval

By default:

¡ In AP view, an AP uses the configuration in AP group view. If no configuration exists in AP group view, the AP uses the configuration in global configuration view.

¡ In AP group view, an AP uses the configuration in global configuration view.

¡ In global configuration view, an AP sends a keepalive packet to the ZigBee server every 15 seconds.

Display and maintenance commands for IoT APs

The AP models and serial numbers in this document are used only as examples. Support for AP models and serial numbers depends on the AC model.

Execute display commands in any view.

Task	Command
Display information about IoT APs that have IoT interfaces and the connected modules.	display iot module { all \| name ap-name }
Display firmware upgrade information for modules.	display wlan module firmware-upgrade history { all \| ap ap-name module module-id }
Display module information for an AP.	display wlan module-information { all \| ap ap-name module { all \| module-id } [ online ] }

‌

21-Internet of Things Configuration Guide

Configuring IoT APs

Configuring basic features for IoT modules

About this task

Restrictions and guidelines

Procedure

Specifying a serial number for a module

About this task

Restrictions and guidelines

Procedure

About this task

Procedure

About this task

Procedure

About this task

Procedure

About this task

Procedure

About this task

Procedure

About this task

Procedure

Procedure

Configuring port reassignment

About this task

Restrictions and guidelines

Procedure

Specifying the report mode for packets sent to IoT APs

About this task

Restrictions and guidelines

Procedure

Specifying the report mode for packets sent to the IoT server

About this task

Procedure

Specifying the format for packets sent to the IoT server

Restrictions and guidelines

Procedure

About this task

Procedure

About this task

Procedure

About this task

Procedure

About this task

Restrictions and guidelines

Procedure

Restrictions and guidelines

Procedure

Configuring bracelet location

About this task

Restrictions and guidelines

Procedure

Setting a LED lighting mode for a module

Restrictions and guidelines

Procedure

About this task

Procedure

About this task

Restrictions and guidelines

Procedure

About this task

Restrictions and guidelines

Procedure

About this task

Procedure

About this task

Procedure

About this task

Procedure

About this task

Procedure

About this task

Restrictions and guidelines

Procedure

About this task

Restrictions and guidelines

Procedure

Restrictions and guidelines

Procedure

About this task