Network

network.arp.lock_enabled

Abbreviation

ne a l

Access

get/set

Description

Lock destination ARP entry to avoid streaming delays due to address resolution.

Before an IP packet can be transmitted/received the network stack needs to resolve the IP address into a MAC address. This is done with Address Resolution Protocol (ARP).

When the IP is resolved it is cached in the ARP table. Due to RAM limitations, the ARP table can store only a limited number of entries. Old entries are replaced by new ones.

This can cause intermittent delays when streaming data via TCP/UDP. During TCP/UDP transmission, if the socket's destination MAC is replaced in the ARP cache, ARP needs to resolve the destination MAC address before the next TCP/UDP packet can go out. ARP can take 100s of ms.

To avoid these intermittent delays, you can lock the destination ARP entry when streaming by setting network.arp.lock_enabled to true.

If network.arp.lock_enabled is true, after a TCP client/server, UDP client/server, or websocket client/server stream is opened, the remote side's ARP entry is stored in a static part of the ARP cache.

When the stream is closed, the static entry is removed.

The socket then streams without ARPs.

Note: It is recommended to increase the value of network.arp.table_size when using this feature.

Arguments

1|true|on/0|false|off

Default

0

Platforms

Properties

Gecko OS Plugin

Set example

> set ne a l true
R000008
Set OK

Get example

> get ne a l
R000003
0

network.arp.table_size

Abbreviation

ne a t

Access

get/set

Description

Configures the maximum number of entries to cache in the ARP table. See network.arp.lock_enabled.

Arguments

<max_entries>

where <max_entries> is an integer from 3 to 16.

Default

8

Platforms

Properties

Gecko OS Plugin

Set example

> set ne a t 5
R000008
Set OK

Get example

> get ne a t
R000003
3

network.bridge.auto_start

Abbreviation

nb a

Access

get/set

Description

Start network bridge automatically when device boots up.

See:

Arguments

0|false|off/1|true|on

Default

0

Platforms

Gecko OS Plugin

Get example

> get network.bridge.auto_start
0

Set example

> set nb a true
Set OK

network.bridge.info

Abbreviation

nb o

Access

get

Description

Show network bridge softAP status. Parameters include state (up/down), SSID, channel and clients.

See:

Arguments

None

Default

None

Platforms

Gecko OS Plugin

Get example

> get network.bridge.info
state: down
SSID: Gecko_OS_Bridge-#
channel: 0
clients: 0

network.bridge.interface_1

Abbreviation

nb i 1

Access

get/set

Description

Set the first interface for network bridging.

See:

Arguments

<interface>

Where:

Default

None

Platforms

Gecko OS Plugin

Get example

> get network.bridge.interface_1
None

Set example

> set nb i 1 ethernet
Set OK

network.bridge.interface_2

Abbreviation

nb i 2

Access

get/set

Description

Set the second interface for network bridging.

See:

Arguments

<interface>

Where:

Default

None

Platforms

Gecko OS Plugin

Get example

> get network.bridge.interface_2
None

Set example

> set nb i 2 softap
Set OK

network.buffer.control_size

Abbreviation

ne b c

Access

get/set

Description

Configure the size of the network buffer used for control packets. This buffer is typically used for I/O control packets to the Wi-Fi chip, TCP fragment buffers, and TCP ACK/NAK packets. If data writes are sufficiently large (of the order of hundreds of bytes), 4K (the default 4096 bytes) is sufficient for the control buffer.

The control buffer may become depleted if data writes are small (of the order of several bytes).

Note: network.buffer.rxtx_ratio has no effect on this buffer.

Arguments

<bytes>

where <bytes> is in the range 2048 to 32768

Default

8192

Platforms

Properties

Gecko OS Plugin

Set example

> set ne b c 22528
R000008
Set OK

Get example

> get ne b c
R000006
4096

network.buffer.rxtx_ratio

Abbreviation

ne b r

Access

get/set

Description

The percentage of the network buffer allocated to Rx.
Rx buffer pool size = network.buffer.size x (network.buffer.rxtx_ratio / 100)
Tx buffer pool size = network.buffer.size x ((100 - network.buffer.rxtx_ratio) / 100)
Value limits (%): Min: 10 Max: 90.

Arguments

<percent_rx>

Default

50

Platforms

Properties

Gecko OS Plugin

Set example

> set ne b r 20
R000008
Set OK

Get example

> get ne b r
R000004
20

network.buffer.size

Abbreviation

ne b s

Access

get/set

Description

The total size of the network buffers, in bytes.

This is important for applications that have asymmetric data throughput requirements. If your app is heavily Tx (or Rx) centric, you can adjust the Tx and Rx buffer sizes accordingly to achieve maximum throughput.

This buffer is divided between the RX/TX buffers based on the network.buffer.rxtx_ratio variable.

This value is the amount of memory allocated from the dynamic memory section. The larger this value, the less memory available for other features.

This is an advanced feature. Take care when adjusting this value. The system may become unstable with certain values in certain applications.

Value limits and defaults (KB = 1024 bytes):

Module Min (bytes)Min (KB)Max (bytes)Max (KB)Default (bytes)Default (KB)
WGM160P100009.8KB300000293.0KB6144060.0 KB

Arguments

<bytes>

where:

Default

61440

Platforms

Properties

Gecko OS Plugin

Set example

> set ne b s 22528
R000008
Set OK

Get example

> get ne b s
R000007
22528

network.buffer.usage

Abbreviation

ne b u

Access

get

Description

The approximate usage of the network TX and RX buffers as an integer percentage.

Arguments

None

Default

None

Platforms

Gecko OS Plugin

Get example

> get ne b u
R000013
RX:13,TX:78

network.default_interface

Abbreviation

ne f

Access

get/set

Description

The default network interface used by various network commands and variables.

Commands:

Variables:

Arguments

wlan/softap

Default

wlan

Platforms

Properties

Gecko OS Plugin

Get example

> get ne f
R000006
wlan

Set example

> set ne f softap
R000008
Set OK

network.dns.timeout

Abbreviation

ne d t

Access

get

Description

This variable controls the amount of time the device will wait while it attempts to resolve a hostname via DNS.

Note: This timeout is applied to all hostname resolutions, i.e. it is applied to TCP/UDP/HTTP and so on.

See Networking and Security, DNS Client.

Arguments

<timeout ms>

where:

Default

6000

Platforms

Gecko OS Plugin

Get example

> get ne d t
R000006
6000

Set example

> set ne d t 8000
R000008
Set OK

network.tcp.delivery_type

Abbreviation

ne c d

Access

get/set

Description

Choose optimization strategy for TCP timers.

This variable configures the internal TCP timers for the required application.

In applications other than real-time streaming applications, the strategy is set to normal, to balance reliability, low latency, and throughput. For example, for cloud/internet applications the normal delivery type optimization is appropriate.

For real-time streaming applications, it may be preferable to optimize for low latency, with some sacrifice in reliability. For example, streaming TCP data via a softAP connection may require the realtime delivery type optimization.

Note: This configures the delivery type for all TCP connections that are opened after this value is set.

Arguments

normal/realtime

where:

Default

normal

Platforms

Properties

Gecko OS Plugin

Get example

> get ne c d
R000008
normal

Set example

> set ne c d realtime
R000008
Set OK

network.tls.ca_cert

Abbreviation

ne t a

Access

get/set

Description

The default CA TLS certificate used with TLS network streams.

Note: PEM file format requires Unix format line termination: LF (\n), not Windows format: CR-LF (\r\n). Some terminal applications may append unwanted end-of-line characters. Incorrect line termination may result in TLS connection failure.

Arguments

<CA TLS cert filename>

Default

globalsign_ca.pem

Platforms

Properties

Gecko OS Plugin

Get example

> get ne t a
R000017
geotrust_ca.pem

Set example

> set ne t a globalsign_ca.pem
R000008
Set OK

network.tls.ca_cert_verify_enabled

Abbreviation

ne t e

Access

get/set

Description

This variable allows optional disabling of TLS server certificate verification. By default verification is required.

When network.tls.ca_verify_enabled is true, if the server certificate is invalid, TLS connection is aborted.

When network.tls.ca_verify_enabled is false, if the server certificate is invalid, TLS connection continues with a warning.

Arguments

0|off|false/1|on|true

Default

1

Platforms

Gecko OS Plugin

Get example

> get ne t e
R000017
1

Set example

> set ne t a 0
R000003
Set OK

network.tls.client_cert

Abbreviation

ne t c

Access

get/set

Description

The filename of the TLS client cert.

Arguments

<TLS cert filename>

Default

null

Platforms

Properties

Gecko OS Plugin

Get example

> get ne t c

Set example

> set ne t c client_cert.pem
R000008
Set OK

network.tls.client_key

Abbreviation

ne t k

Access

get/set

Description

The filename of the TLS client cert key.

Arguments

<TLS cert key filename>

Default

null

Platforms

Properties

Gecko OS Plugin

Get example

> get ne t k

Set example

> set ne t k client_cert_key_filename
R000008
Set OK

network.tls.handshake_timeout

Abbreviation

ne t h

Access

get/set

Description

This specifies the maximum amount of time in seconds between handshake packets to wait before aborting the connection.

Arguments

<seconds>

where:

Default

15

Platforms

Gecko OS Plugin

Get example

> get ne t h
15

Set example

> set ne t v 20
R000008
Set OK

network.tls.version

Abbreviation

ne t v

Access

get/set

Description

Specifies the maximum TLS version used. By default the client/server negotiates which TLS version/cipher to use but sometimes it is necessary to force a maximum version.

Arguments

10/12

where:

Default

12

Platforms

Properties

Gecko OS Plugin

Get example

> get ne t v
12

Set example

> set ne t v 10
R000008
Set OK