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 CANedge2 supports multiple access points. The device periodically scans for WiFi access points. If known SSIDs are found, the device will sequentially attempt to connect to one at a time (in prioritized order). If unable to connect to a known access point or if the signal strength is below the minimum RSSI, the device attempts the next known found SSID from the list of configured access points.
Using an RSSI of 0% (default) means that the device attempts to connect to the AP, even if the signal strength is practically non-existent.
Note
During a WiFi password migration, multiple identical SSIDs with different passwords can be entered in the configuration file. The device will attempt to connect to all in prioritized order.