.Settxpower Method

Top  Previous  Next

 

Function:

Causes the Wi-Fi interface to commence the adjustment of TX power to the level specified by the level argument.

Syntax:

wln.settxpower(level as byte) as accepted_rejected

Returns:

One of accepted_rejected constants:

0- ACCEPTED.

1- REJECTED.

See Also:

Setting TX Power, Wln Tasks

 


Details

Part

Description

level

Specified in 255 arbitrary steps that do not directly correspond to any standard measurement unit.

Adjusting TX power is a task. As such, the wln.settxpower will be rejected (return 1- REJECTED) if another task is currently in progress. The task will also be rejected if the Wi-Fi hardware is not online (wln.enabled= 0- NO). The method will return 0- ACCEPTED if the task is accepted for processing.

The task is completed when the wln.task R/O property becomes 0- PL_WLN_TASK_IDLE. The on_wln_task_complete event will also be generated at that time.