Docs
mobileIoT Hardware
Documentation

Wireless settings

The next section is the setup of the Wireless interface.

ℹ Note
The Wireless settings and profiles are only valid and processed by the device if the ETH-WiFi Brigde is disabled.


Enable or disable the wireless interface

Options: ON/OFF

Default: ON

WiFi regulatory domain

Default: DE

Allowed values: AT, BE, BG, CA, CH, CY, CZ, DE, DK, EE, ES, FI, FR, GB, GR, HR, HU, IE, IT, JP, LT, LV, LU, MT, NL, NO, PL, PT, RO, SE, SI, SK, US

Description: WiFi regulatory domain setting


Wireless Settings Connection Profile



Connection name

Type: string

Default: Wireless connection

Description: Wireless connection profile name, must be globally unique regardless of the interface.

Connect automatically when resources available

Default: ON

Description: Connect this profile automatically when the resources for this connection become available. When disabled the profile will be “*parked*” in the configuration, but not actively used.

Auto-connect priority

Type: int32

Default: 0

Description: Priority for profiles that are configured to auto connect, this setting spans over all profiles of all interfaces where the auto-connect setting is set to true. A higher number means higher priority.

The number of times to auto-connect

Type: int32

Default: -1

Description: Number of times to retry to connect the profile automatically before giving up. When autoconnection fails after the given number of retries, the next highest priority profile will be used. A value of zero means retry forever.

Channel

Type: int32

Default: 0 , currently no other option is possible

Description: Wireless channel to use for this connection, the value of zero means, that the channel will be chosen automatically. Explicitly setting this option will ensure that the device only joins a network on the specified channel.

Band

Available options: auto, A (5GHz), B/G (2.4GHz)

Default: auto

Description: This option configures the 802.11 frequency band of the network, i.e. the device will not join the network if the band does not match, even if all other options are compatible.

Hide SSID

Options: ON, OFF

Default: OFF

Description: This option controls if the SSID of the Wi-Fi network is hidden or visible.

SSID

Type: string

Default: CR3171_<XXXX> with the xxxx as th last four digits of the LAN MAC address.

Description: WiFi network name

BSSID

Type: string

Default: <empty>

Description: Basic Service Set Identifier

Mode

Available options: hotspot, client, ad-hoc

Default: hotspot

Description: Wireless network mode. The options are:

  • hotspot ; In Hotspot mode, the device acts as WiFi Hotspot or also known Access Point, client; In Wi-Fi
  • client , the wifi interface will try to connect to the configured WiFi network,
  • ad-hoc In WiFi Ad-hoc mode, also known as peer-to-peer. In this mode, wireless devices communicate directly with each other without the need for a central access point or network infrastructure. [ Source ]

Key management

Available options: unencrypted, WPA/PSK, SAE, OWE, WPA/EAP

Default: WPA/PSK

Description: Key management configuration for the WiFi connection.

ℹ Note
Depending on the chosen value, other options like passphrase and alike also need to be set.
In case of WPA/PSK, the Pre-Shared Key or also knonw as password is used for a WPA secured connection.
In case of security type SAE, the password will be handeled according to the SAE Authentication method.
When the WPA/EAP (*Extinsible Authentication Protocol*) option is chosen, more settings has to be entered, these will be discussed in the following paragraphs.

Pre shared key

Type: string

Default: <ETH MAC without semicolon, eg 112233445566>

Description: In case of WPA/PSK, the Pre-Shared Key or also known as password is used for a WPA secured connection.

In case of security type SAE, the password will be handled according to the SAE Authentication method.



Anonymous identity

Default: <empty>

Description: Used in some authentication protocols (e.g., EAP-TTLS) to provide an anonymous identity during the initial authentication phase. Typically grayed out if not required by the network.

Domain

Default: <empty>

Description: The domain name is often used in enterprise networks for authentication or network identification. Grayed out if domain-based login is not supported or required.

CA certificate

Default: <empty>

Description: The Certificate Authority (CA) certificate used to verify the identity of the server during secure communication. Grayed out if certificates are not used for authentication.

Username

Default: <empty>

Description: The user’s identity for network authentication, typically used in enterprise networks. Grayed out if not required or controlled by another setting.

Password

Default: <empty>

Description: The password associated with the username for network authentication. Grayed out if not required or managed by other security mechanisms (e.g., certificate-based authentication).

IPv4 address of DNS server(s)

Default: <empty>

Description: The address of the Domain Name System (DNS) server used to resolve domain names to IP addresses. Multiple entries represent primary, secondary, and tertiary DNS servers.

IPv4 address

Default: 192.168.82.1/24

Description: IP address used for either static IP, when method is set to manual or DHCP server configurations when the shared method is selected. The CIRD notation is used to define the subnet mask.

ℹ Info
By using e.g. 192.168.82.1/24 the device will be part of the 192.168.82.0 network and will allow access or communication from IPs in the range of 192.168.82.1-192.168.82.254
⚠ Important
As security measure it is advisable to tighten the allowed IPs on the network as possible, for instance to use /29 or 255.255.255.248 subnet to only allow (only) 6 address on the network, with 192.168.82.0 is the network address and 192.168.82.7 is the broadcast address and 192.168.82.1 - 192.168.82.6 remains available.
Shared

In the shared mode the Network Manager will configure the DHCP server to provide a static IP range for static IPs which is 10% of the range with a max of 8 IPs. The remaining IP in the range are for dynamic assignment.

Manual

In manual mode, the IPV4 Address defines the network and mask, the device IP is set through IPV4 Gateway, which is described below.

IP configuration method

Available options:

  • auto the interface will be configured as DHCP client and therefore will be assigned a IP address from an external DHCP router.
  • manual , or also called static IP mode. In manual mode, the IPV4 Address defines the network and mask, the device IP is set through IPV4 Gateway , which is described below.
  • link-local , a link-local address is a network address that is valid only for communications on a local link, i.e. within a subnetwork that a host is connected to. The device will auto-negotiate a IP address in the 169.254.0.0/16 network.
  • shared , in the shared mode the device is setup as DHCP Server.

    In this mode, the Network Manager will configure the DHCP server to provide a static IP range for static IPs which is 10% of the range with a max of 8 IPs. The remaining IP in the range are for dynamic assignment.

Default: link-local

Description: IP configuration method, by default the interface is set to use link-local, i.e. auto-ip configuration which makes sure that the device does not disrupt an existing network when plugged in.

The gateway associated with this configuration

Type: string in DNN format.

Default: <empty>

Description: Gateway IP address, usually only needs to be set when manual , i.e. static-ip network configuration method was selected. Keep in mind this should be in the given subnet range.

Routing metric used to make a routing decision

Type: int32

Default: -1

Description: Routing metric, lower values have higher priority. Set to -1 for automatic assignment based on interface type. This option will allow you to prioritize one interface over the other when accessing the internet, depending on interface or connection availability.

First IPv4 address in DHCP range

This option is only available if the IP configuration method is set to shared .

Type: string

Default: <configured automatically>

Description: First IP address of the DHCP range, which the DHCP server will hand-out in a lease.

Last IPv4 address in DHCP range

This option is only available if the IP configuration method is set to shared .

Type: string

Default: <configured automatically>

Description: Last IP address of the DHCP range, which the DHCP server will hand-out in a lease.