WiFi
This page documents the wifi configuration
Table of Contents
Configuration file fields
This section is autogenerated from the Rule Schema file.
Mode connect.wifi.mode
In station mode, the device can use either active or passive scanning to find APs. Using active scan, the radio transmits a probe request and listens for responses. Using passive scan, the radio listens on each channel for beacons sent periodically by APs.
Type |
Default |
Options |
---|---|---|
integer |
0 |
Station mode (active scanning): |
Key format connect.wifi.keyformat
The format of the password(s). Can be used to hide the sensitive credentials stored on the device.
Type |
Default |
Options |
---|---|---|
integer |
0 |
Plain: |
Access points connect.wifi.accesspoint
List of access points. Connects to the first available AP in list.
Type |
Max items |
---|---|
array |
4 |
Item connect.wifi.accesspoint.item
SSID connect.wifi.accesspoint.item.ssid
Access point SSID (name of access point)
Type |
Min length |
Max length |
---|---|---|
string |
0 |
32 |
Password connect.wifi.accesspoint.item.pwd
Type |
Default |
Max length |
---|---|---|
string |
64 |
Minimum RSSI (received signal strength indicator), 0-100% connect.wifi.accesspoint.item.minrssi
Sets a minimum required access point signal strength. The device will not connect to the access point if the measured signal strength is below the value of this field.
Type |
Default |
Minimum |
Maximum |
---|---|---|---|
integer |
0 |
0 |
100 |
Configuration explained
This section contains additional information and examples.
The CANedge2 is able to connect to a WiFi access point (AP). The device expects to be assigned an IP-address by a DHCP service running on the AP.
The unique device ID becomes the device host name.
The CANedge is able to connect to access-points (AP) as illustrated below.
Station mode scan modes (mode
)
The device supports active and passive scan modes to find available access points (APs).
Active mode
The device actively transmits a probe request on each channel when searching for APs. Active scan is the fastest way to find and connect to an AP.
Passive mode
The device passively listens for beacons on each channel. Passive scan is silent, but it takes additional time to find and connect to an AP.
Multiple WiFi access points (accesspoint
)
The device supports multiple access points. The device will attempt to connect to the access points in the prioritized order in which they are entered in the configuration file. If unable to connect to an access point or if the signal strength is below the minimum RSSI, the device will attempt the next one from the list. Every time the device initiates a new WiFi connection, it will cycle through the list in this manner, starting from the top.
Using an RSSI of 0% (default) means that the device will attempt to connect to the AP, even if the signal strength is practically non-existent.