TCP Client

tcp.client.auto_interface

Abbreviation

tc c i

Access

get/set

Description

Interface to auto-start TCP client connection.

See TCP Client .

Arguments

default

Default

default/wlan/softap

Platforms

• WGM160P

Properties

• save and reboot to apply change

Gecko OS Plugin

• protocols.tcp.client

Get example

> get tcp.client.auto_interface
default

Set example

> set tc c i wlan
Set OK

tcp.client.auto_retries

Abbreviation

tc c e

Access

get/set

Description

Determines number of attempts to reconnect after remote server disconnects client.

• 0 - disables feature (i.e. don't reconnect after server disconnects)
• 255 - infinite retries (i.e. continuously try to reconnect after server disconnects)
• 1-254 - retry specified number of times then stop

Note : This counter is reset when the interface is brought down.

To control how the client connects to the server, use tcp.client.retries , tcp.client.connect_timeout and tcp.client.retry_period .

See TCP Client .

Arguments

0-255

Default

0

Platforms

• WGM160P

Properties

• save and reboot to apply change

Gecko OS Plugin

• protocols.tcp.client

Get example

> get tcp.client.auto_retries
0

Set example

set tc c e 20
Set OK

tcp.client.auto_start

Abbreviation

tc c a

Access

get/set

Description

Enable/disable TCP client auto-start feature. If enabled, TCP client automatically connects to remote server when interface is brought up.

To enable TLS, see tcp.client.tls_enabled .

See TCP Client .

Arguments

1|true|on/0|false|off

where

• 0 or false or off : auto start disabled
• 1 or true or on : auto start enabled

Default

0

Platforms

• WGM160P

Properties

• save and reboot to apply change

Gecko OS Plugin

• protocols.tcp.client

Get example

> get tcp.client.auto_start
0

Set example

> set tc c a 1
Set OK

tcp.client.connect_timeout

Abbreviation

tc c t

Access

get/set

Description

TCP client connect timeout in milliseconds.

This variable controls timeout for the following commands:

• http_download
• http_get
• http_head
• http_post
• http_upload
• tcp_client
• tls_client

See TCP Client .

Arguments

<milliseconds>

Default

5000

Platforms

• WGM160P

Properties

• takes effect immediately
• available in Safe Mode
• preserved by NVM Backup

Gecko OS Plugin

• kernel_commands

Get example

> get tc c t
R000006
5000

Set example

> set tc c t 6500
R000008
Set OK

tcp.client.local_port

Abbreviation

tc c p

Access

get/set

Description

TCP client local port. 0 = automatic.

If you set this value, the first connection is made using the specified local port.

Subsequent additional TCP client connections determine the port by incrementing the last port used. If the specified port is X , the first subsequent connection uses port X+1 . The next TCP client connection uses port X+2 , and so on.

To reset the local port back to X , reboot the client.

See TCP Client .

Arguments

<port>

Default

0

Platforms

• WGM160P

Properties

• takes effect immediately
• available in Safe Mode
• preserved by NVM Backup

Gecko OS Plugin

• kernel_commands

Get example

> get tc c p
R000003
0

Set example

> set tc c p 30009
R000008
Set OK

tcp.client.remote_host

Abbreviation

tc c h

Access

get/set

Description

Domain or IP address of remote tcp server to auto connect.

See TCP Client .

Arguments

<domain/ip address>

Default

None

Platforms

• WGM160P

Properties

• takes effect immediately

Gecko OS Plugin

• protocols.tcp.client

Get example

> get tcp.client.remote_host
mydomain.com

Set example

> set tc c h mydomain.com
Set OK

tcp.client.remote_port

Abbreviation

tc c o

Access

get/set

Description

Port of remote tcp server to auto connect.

See TCP Client .

Arguments

<port>

Default

3000

Platforms

• WGM160P

Properties

• takes effect immediately

Gecko OS Plugin

• protocols.tcp.client

Get example

> get tcp.client.remote_port

Set example

> set tc c o 5000
Set OK

tcp.client.retries

Abbreviation

tc c r

Access

get/set

Description

Maximum TCP client connection retry attempts.

See TCP Client .

Arguments

<max #retries>

Range: 1 - 255

Default

3

Platforms

• WGM160P

Properties

• takes effect immediately
• available in Safe Mode
• preserved by NVM Backup

Gecko OS Plugin

• kernel_commands

Get example

> get tc c r
R000003
3

Set example

> set tc c r 5
R000008
Set OK

tcp.client.retry_period

Abbreviation

tc c w

Access

get/set

Description

TCP client wait time between connection retry attempts.

See TCP Client .

Arguments

<milliseconds>

Range: 0 - 65535

Default

1000

Platforms

• WGM160P

Properties

• takes effect immediately
• available in Safe Mode
• preserved by NVM Backup

Gecko OS Plugin

• kernel_commands

Get example

> get tc c w
R000006
1000

Set example

> set tc c w 2000
R000008
Set OK

tcp.client.tls_enabled

Abbreviation

tc c s

Access

get/set

Description

Enables TLS for the [ tcp.client.auto_start feature.

The TLS certs are configured with the following variables:

• network.tls.ca_cert
• network.tls.client_cert
• network.tls.client_key

See TLS Client .

Arguments

1|true|on/0|false|off

where

• 0 or false or off : TLS disabled
• 1 or true or on : TLS enabled

Default

0

Platforms

• WGM160P

Properties

• takes effect immediately

Gecko OS Plugin

• protocols.tcp.client

Get example

> get tc c s
0

Set example

> set tc c s 1
Set OK