- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
02-LoRaWAN commands | 104.48 KB |
LoRaWAN commands
The following compatibility matrix shows the support of hardware platforms for LoRaWAN:
Hardware series |
Model |
Product code |
LoRaWAN compatibility |
WX1800H series |
WX1804H-PWR |
EWP-WX1804H-PWR-CN |
Yes |
WX2500H series |
WX2508H-PWR-LTE WX2510H-PWR WX2510H-F-PWR WX2540H WX2540H-F WX2560H |
EWP-WX2508H-PWR-LTE EWP-WX2510H-PWR EWP-WX2510H-F-PWR EWP-WX2540H EWP-WX2540H-F EWP-WX2560H |
Yes |
MAK series |
MAK204 MAK206 |
EWP-MAK204 EWP-MAK206 |
No |
WX3000H series |
WX3010H WX3010H-X-PWR WX3010H-L-PWR WX3024H WX3024H-L-PWR WX3024H-F |
EWP-WX3010H EWP-WX3010H-X-PWR EWP-WX3010H-L-PWR EWP-WX3024H EWP-WX3024H-L-PWR EWP-WX3024H-F |
Yes |
WX3500H series |
WX3508H WX3508H WX3510H WX3510H WX3520H WX3520H-F WX3540H WX3540H |
EWP-WX3508H EWP-WX3508H-F EWP-WX3510H EWP-WX3510H-F EWP-WX3520H EWP-WX3520H-F EWP-WX3540H EWP-WX3540H-F |
Yes |
WX5500E series |
WX5510E WX5540E |
EWP-WX5510E EWP-WX5540E |
Yes |
WX5500H series |
WX5540H WX5560H WX5580H |
EWP-WX5540H EWP-WX5560H EWP-WX5580H |
Yes |
Access controller modules |
LSUM1WCME0 EWPXM1WCME0 LSQM1WCMX20 LSUM1WCMX20RT LSQM1WCMX40 LSUM1WCMX40RT EWPXM2WCMD0F EWPXM1MAC0F |
LSUM1WCME0 EWPXM1WCME0 LSQM1WCMX20 LSUM1WCMX20RT LSQM1WCMX40 LSUM1WCMX40RT EWPXM2WCMD0F EWPXM1MAC0F |
Yes |
Hardware series |
Model |
Product code |
LoRaWAN compatibility |
WX1800H series |
WX1804H-PWR WX1810H-PWR WX1820H WX1840H |
EWP-WX1804H-PWR EWP-WX1810H-PWR EWP-WX1820H EWP-WX1840H-GL |
No |
WX3800H series |
WX3820H WX3840H |
EWP-WX3820H-GL EWP-WX3840H-GL |
No |
WX5800H series |
WX5860H |
EWP-WX5860H-GL |
No |
channel-group
Use channel-group to specify a working channel group.
undo channel-group to restore the default.
Syntax
channel-group group-number
undo channel-group
Default
No working channel group is specified.
Views
LoRa radio view
Predefined user roles
network-admin
Parameters
group-number: Specifies a working channel group number. The value range for this argument is 1 to 12.
Usage guidelines
This command enables a LoRa radio interface to select a working channel group that has less interference to communicate with LoRa end nodes.
Table 1 shows the center frequencies of different working channel groups.
Table 1 Center frequencies of working channel groups (unit: MHz, channel bandwidth: 125 KHz)
Working channel group |
Channel 1 |
Channel 2 |
Channel 3 |
Channel 4 |
Channel 5 |
Channel 6 |
Channel 7 |
Channel 8 |
1 |
470.3 |
470.5 |
470.7 |
470.9 |
471.1 |
471.3 |
471.5 |
471.7 |
2 |
471.9 |
472.1 |
472.3 |
472.5 |
472.7 |
472.9 |
473.1 |
473.3 |
3 |
473.5 |
473.7 |
473.9 |
474.1 |
474.3 |
474.5 |
474.7 |
474.9 |
4 |
475.1 |
475.3 |
475.5 |
475.7 |
475.9 |
476.1 |
476.3 |
476.5 |
5 |
476.7 |
476.9 |
477.1 |
477.3 |
477.5 |
477.7 |
477.9 |
478.1 |
6 |
478.3 |
478.5 |
478.7 |
478.9 |
479.1 |
479.3 |
479.5 |
479.7 |
7 |
479.9 |
480.1 |
480.3 |
480.5 |
480.7 |
480.9 |
481.1 |
481.3 |
8 |
481.5 |
481.7 |
481.9 |
482.1 |
482.3 |
482.5 |
482.7 |
482.9 |
9 |
483.1 |
483.3 |
483.5 |
483.7 |
483.9 |
484.1 |
484.3 |
484.5 |
10 |
484.7 |
484.9 |
485.1 |
485.3 |
485.5 |
485.7 |
485.9 |
486.1 |
11 |
486.3 |
486.5 |
486.7 |
486.9 |
487.1 |
487.3 |
487.5 |
487.7 |
12 |
487.9 |
488.1 |
488.3 |
488.5 |
488.7 |
488.9 |
489.1 |
489.3 |
Examples
# Specify working channel group 11 for LoRa radio 1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA5320X-L
[Sysname-wlan-ap-ap1] lora-radio 1
[Sysname-wlan-ap-ap1-LoRa-Radio-1] channel-group 11
display iot lora ap
Use display iot lora ap to display LoRa information about an AP.
Syntax
display iot lora ap ap-name
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
ap-name: Specifies an AP by its name, a case-sensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).
Usage guidelines
This command displays LoRa information about an AP only when the AP supports the LoRa module.
Examples
# Display LoRa information about an AP.
<Sysname> display iot lora ap ap1
Server domain : N/A
Domain IP : N/A
Server IP : 10.99.43.107
Destination port : 1680
Destination push port : 1690
Keepalive interval : 15 seconds
Statistics report interval : 90 seconds
Encryption : Enabled
Encrypted destination port : 1702
CRC forwarding-policy : CRC correct
GWMP version : 2
Radio 1:
Channel group : 11
Tx power : 20 dBm
Aging time : 60 minutes
End node info learning : Disabled
Table 2 Command output
Field |
Description |
Server domain |
Domain name of the LoRa server. |
Domain IP |
IP address resolved from the domain name of the LoRa server. |
Server IP |
IP address of the LoRa server. |
Destination port |
Port number of the LoRa server. |
Destination push port |
Push port number of the LoRa server. |
Keepalive interval |
Interval (in seconds) at which the LoRa gateway sends keepalive packets to the LoRa server. |
Statistics report interval |
Interval (in seconds) at which the LoRa gateway sends statistics information to the LoRa server. |
Encryption |
Link encryption state: Enabled or Disabled. |
Encrypted destination port |
Port number that the LoRa server uses to establish the encrypted link. |
CRC forwarding-policy |
CRC-based packet forwarding policy: · CRC all—Forwards all packets. · CRC correct, No CRC—Forwards packets that have passed CRC and packets without CRC. · CRC correct, CRC error—Forwards packets that have passed or failed CRC. · CRC correct—Forwards packets that have passed CRC. |
GWMP version |
GWMP version number. |
Radio |
LoRa radio number. |
Channel group |
Working channel group of the LoRa radio. This field is available only when the 470 MHz frequency band is used. This field displays N/A if no working channel group is specified. |
Tx power |
Transmit power of the LoRa radio. |
Aging time |
Aging time of end node entries in minutes. |
End node info learning |
End node entry learning state: Enabled or Disabled. |
display iot lora join-info
Use display iot lora join-info to display join request information about end nodes learnt by the LoRa gateway.
Syntax
display iot lora join-info
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display join request information about end nodes learnt by the LoRa gateway.
<Sysname> display iot lora join-info
Total join nodes: 2
DevEUI Last time Interface Aged After
38AD8EFFFE618ACD 11-12 15:11 LoRa-Radion1/0/1 00:26:23
38AD8EFFFE618AE2 11-12 15:08 LoRa-Radion1/0/1 00:24:57
Table 3 Command output
Field |
Description |
Total join nodes |
Total number of end node join requests. |
DevEUI |
End node identifier. |
Last time |
Time when the gateway received the most recent join request from an end node. |
Interface |
LoRa radio interface that received the end node join request. |
Aged after |
Remaining aging time for the end node join request, in the format of hh:mm:ss. |
Related commands
node-info aging
node-info learning enable
reset iot lora join-info
display iot lora node-info ap
Use display iot lora node-info ap to display LoRa end node entries learnt by an AP after the end nodes join the network.
Syntax
display iot lora node-info ap ap-name
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
ap-name: Specifies an AP by its name, a case-sensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).
Usage guidelines
This command displays the LoRa end node entries learnt by an AP only when the AP supports the LoRa module.
Examples
# Display LoRa end node entries learnt by an AP after the end nodes join the network.
<Sysname> display iot lora node-info ap ap1
Total end nodes: 2
Node IP FPort ADR FCnt LRID Aged after
0.0.0.38 3 Disabled 7680 1 00:59:34
0.0.141.35 3 Disabled 44294 1 00:19:10
Table 4 Command output
Field |
Description |
Total end nodes |
Total number of end node entries after the end nodes join the network. |
Node IP |
IP address of the end node. |
FPort |
Port number in the frame sent by the end node. |
ADR |
ADR state in the frame sent by the end node: Enabled or Disabled. |
FCnt |
ID of the frame sent by the end node. |
LRID |
LoRa radio that received the end node frame. |
Aged after |
Remaining aging time for the end node entry after an end node joins the network, in the format of hh:mm:ss. |
Related commands
node-info aging
node-info learning enable
reset iot lora node-info ap
iot lora encrypt
Use iot lora encrypt to enable link encryption.
Use undo iot lora encrypt to disable link encryption.
Syntax
iot lora encrypt [ port port-number ]
undo iot lora encrypt
Default
Link encryption is disabled. Packets between the LoRa gateway and the LoRa server are transmitted unencrypted through the port number specified by the iot lora server-address or iot lora server-domain command.
Views
AP view
Predefined user roles
network-admin
Parameters
port-number: Specifies the port number of the LoRa server, in the range of 1025 to 65535. The default port number is 1702.
Usage guidelines
Use this command to enable packets between the LoRa gateway and the LoRa server to be transmitted encrypted through the specified port number.
Modification of LoRa server settings will clear the encryption configuration on the LoRa gateway. To have packets transmitted encrypted, re-enable link encryption for the LoRa gateway.
Examples
# Enable link encryption and specify the port number of the LoRa server as 5000.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA5320X-L
[Sysname-wlan-ap-ap1] iot lora encrypt port 5000
Related commands
display iot lora ap
iot lora forwarding-policy
Use iot lora forwarding-policy to specify a CRC-based packet forwarding policy.
Use undo iot lora forwarding-policy to restore the default.
Syntax
iot lora forwarding-policy { all | crc-error | no-crc }
undo iot lora forwarding-policy
Default
Only packets that have passed CRC are forwarded.
Views
AP view
Predefined user roles
network-admin
Parameters
all: Forwards all packets.
crc-error: Forwards packets that have passed or failed CRC.
no-crc: Forwards packets that have passed CRC and packets without CRC.
Examples
# Configure the LoRa gateway to forward packets that have passed or failed CRC.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA5320X-L
[Sysname-wlan-ap-ap1] iot lora forwarding-policy crc-error
Related commands
display iot lora ap
iot lora gwmp-version
Use iot lora gwmp-version to specify the GWMP version.
Use undo iot lora gwmp-version to restore the default.
Syntax
iot lora gwmp-version version
undo iot lora gwmp-version
Default
GWMP version 2 is used.
Views
AP view
Predefined user roles
network-admin
Parameters
version: Specifies the GWMP version. The value can be 1 or 2.
Usage guidelines
The LoRa gateway sends Tx ACK packets to the LoRa server only when GWMP version 2 is used.
Examples
# Configure the LoRa gateway to use GWMP version 1.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA5320X-L
[Sysname-wlan-ap-ap1] iot lora gwmp-version 1
Related commands
display iot lora ap
iot lora keepalive interval
Use iot lora keepalive interval to set the interval at which the LoRa gateway sends keepalive packets to the LoRa server.
Use undo iot lora keepalive interval to restore the default.
Syntax
iot lora keepalive interval interval
undo iot lora keepalive interval
Default
The LoRa gateway sends keepalive packets to the LoRa server at intervals of 10 seconds.
Views
AP view
Predefined user roles
network-admin
Parameters
interval: Specifies the interval at which the LoRa gateway sends keepalive packets to the LoRa server. The value range for this argument is 5 to 100 seconds.
Usage guidelines
The LoRa gateway sends keepalive packets to the LoRa server at the specified intervals. If the LoRa gateway fails to receive a response from the LoRa server within three intervals, it tears down the link to the LoRa server.
As a best practice, set the interval for sending keepalive packets shorter than the interval for NAT session timeout to avoid packet loss in a NAT-enabled network.
Examples
# Configure the LoRa gateway to send keepalive packets to the LoRa server at intervals of 15 seconds.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA5320X-L
[Sysname-wlan-ap-ap1] iot lora keepalive interval 15
Related commands
display iot lora ap
iot lora server-address
Use iot lora server-address to specify the IP address and port number of the LoRa server.
Use undo iot lora server-address to restore the default.
Syntax
iot lora server-address ip ipv4-address port port-number [ push-port push-port-number ]
undo iot lora server-address
Default
The IP address and port number of the LoRa server are not specified.
Views
AP view
Predefined user roles
network-admin
Parameters
ip ipv4-address: Specifies the IPv4 address of the LoRa server.
port port-number: Specifies the port number of the LoRa server, in the range of 1025 to 65535.
push-port push-port-number: Specifies the push port number of the LoRa server, in the range of 1025 to 65535. The default push port number is the port number specified by the port port-number option.
Usage guidelines
The LoRa gateway can communicate with a LoRa server only after you specify the LoRa server on the LoRa gateway.
If you do not specify a push port number, the pull port number is also used as the push port number.
For an H3C LoRa server, the push port number cannot be the same as the pull port number.
The domain name configuration takes precedence over the IP address configuration. If you specify the IP address and then the domain name, the IP address is cleared and the Lora gateway will use the domain name to reestablish a link with the Lora server.
If you execute this command multiple times, the most recent configuration takes effect.
Examples
# Specify the IPv4 address and port number of the LoRa server as 192.168.1.1 and 1680, respectively.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA5320X-L
[Sysname-wlan-ap-ap1] iot lora server-address ip 192.168.1.1 port 1680
Related commands
display iot lora ap
iot lora server-domain
Use iot lora server-domain to specify the domain name and port number of the LoRa server.
Use undo iot lora server-domain to restore the default.
Syntax
iot lora server-domain domain-name ip port port-number [ push-port push-port-number ]
undo iot lora server-domain
Default
The domain name and port number of the LoRa server are not specified.
Views
AP view
Predefined user roles
network-admin
Parameters
domain-name: Specifies the domain name of the LoRa server, a case-sensitive string of 1 to 253 characters.
ip: Resolves the domain name to an IPv4 address.
port port-number: Specifies the port number of the LoRa server, in the range of 1025 to 65535.
push-port push-port-number: Specifies the push port number of the LoRa server, in the range of 1025 to 65535. The default push port number is the port number specified by the port port-number option.
Usage guidelines
The LoRa gateway can communicate with the LoRa server only after you specify the LoRa server on the LoRa gateway.
If you do not specify a push port number, the pull port number is also used as the push port number.
For an H3C LoRa server, the push port number cannot be the same as the pull port number.
The domain name configuration takes precedence over the IP address configuration. If you specify the IP address and then the domain name of the LoRa server, the IP address is cleared and the Lora gateway will use the domain name to reestablish a link with the Lora server.
If you execute this command multiple times, the most recent configuration takes effect.
Examples
# Specify the domain name and port number of the LoRa server as server.com and 1680, respectively.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA5320X-L
[Sysname-wlan-ap-ap1] iot lora server-domain server.com ip port 1680
Related commands
display iot lora ap
iot lora statistics-report interval
Use iot lora statistics-report interval to set the interval at which the LoRa gateway sends statistics information to the LoRa server.
Use undo iot lora statistics-report interval to restore the default.
Syntax
iot lora statistics-report interval interval
undo iot lora statistics-report interval
Default
The LoRa gateway sends statistics information to the LoRa server at intervals of 30 seconds.
Views
AP view
Predefined user roles
network-admin
Parameters
interval: Specifies the interval at which the LoRa gateway sends statistics information to the LoRa server. The value range for this argument is 20 to 600 seconds.
Examples
# Configure the LoRa gateway to send statistics information to the LoRa server at intervals of 45 seconds.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA5320X-L
[Sysname-wlan-ap-ap1] iot lora statistics-report interval 45
Related commands
display iot lora ap
lora-radio
Use lora-radio to enter LoRa radio view.
Syntax
lora-radio lora-radio-id
Views
AP view
Predefined user roles
network-admin
Parameters
lora-radio-id: Specifies the LoRa radio number.
Examples
# Enter LoRa radio view.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA5320X-L
[Sysname-wlan-ap-ap1] lora-radio 1
[Sysname-wlan-ap-ap1-loRa-Radio-1]
node-info aging
Use node-info aging to set the aging time for end node entries.
Use undo node-info aging to restore the default.
Syntax
node-info aging aging-time
undo node-info aging
Default
The aging time for end node entries is 60 minutes.
Views
LoRa radio view
Predefined user roles
network-admin
Parameters
aging-time: Specifies the aging time for end node entries, in the range of 10 to 1440 minutes.
Usage guidelines
After learning the information about an end node, the device generates an entry or refreshes the existing entry for the end node.
Perform this task to set the aging time for end node entries. If an end node entry is not refreshed within the aging time, it will be deleted.
Set an appropriate aging time based on the actual network conditions. A short aging time results in frequent entry generation and removal. A long aging time consumes massive device resources.
Examples
# Specify the aging time as 20 minutes for end node entries.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA5320X-L
[Sysname-wlan-ap-ap1] lora-radio 1
[Sysname-wlan-ap-ap1-LoRa-Radio-1] node-info timer aging 20
Related commands
node-info learning enable
display iot lora node-info ap
node-info learning enable
Use node-info learning enable to enable end node entry learning.
Use undo node-info learning enable to restore the default.
Syntax
node-info learning enable
undo node-info learning enable
Default
End node entry learning is disabled.
Views
LoRa radio view
Predefined user roles
network-admin
Usage guidelines
This command enables the device to learn end node entries in real time.
When the number of end node entries that the device learns reached the limit, the device stops learning end node entries.
Examples
# Enable end node entry learning.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA5320X-L
[Sysname-wlan-ap-ap1] lora-radio 1
[Sysname-wlan-ap-ap1-LoRa-Radio-1] node-info learning enable
Related commands
node-info aging
display iot lora node-info ap
reset iot lora join-info
Use reset iot lora join-info to clear join request information about end nodes learnt by the LoRa gateway.
Syntax
reset iot lora node-info
Views
User view
Predefined user roles
network-admin
Examples
# Clear join request information about end nodes learnt by the LoRa gateway.
<Sysname> reset iot lora join-info
Related commands
display iot lora join-info
node-info aging
node-info learning enable
reset iot lora node-info ap
Use reset iot lora node-info ap to clear end node entries learnt by an AP after the end nodes join the network.
Syntax
reset iot lora node-info ap ap-name
Views
User view
Predefined user roles
network-admin
Parameters
ap-name: Specifies an AP by its name, a case-sensitive string of 1 to 64 characters. The string can contain letters, digits, underscores (_), dots (.), left brackets ([), right brackets (]), forward slashes (/), and hyphens (-).
Examples
# Clear end node entries learnt by AP ap1 after the end nodes join the network.
<Sysname> reset iot lora node-info ap ap1
Related commands
display iot lora node-info ap
node-info aging
node-info learning enable
tx-power
Use tx-power to set a transmit power.
Use undo tx-power to restore the default.
Syntax
tx-power { power-value | max }
undo tx-power
Default
The transmit power of a LoRa radio is 17 dBm.
Views
LoRa radio view
Predefined user roles
network-admin
Parameters
power-value: Specifies a transmit power in dBm. The value of this argument can be -6, -3, 0, 3, 6, 10, 11, 12, 13, 14, or 17.
max: Specifies the maximum transmit power.
Usage guidelines
Configure this command to manually specify a transmit power.
Examples
# Set the transmit power of LoRa radio lora-radio 1 to 10 dBm.
<Sysname> system-view
[Sysname] wlan ap ap1 model WA5320X-L
[Sysname-wlan-ap-ap1] lora-radio 1
[Sysname-wlan-ap-ap1-LoRa-Radio-1] tx-power 10
Related commands
display iot lora ap