Datasheet

Page 116 of 161
nRF8001 Product Specification
Revision 1.2
24.17 SetTxPower (0x12)
SetTxPower sets the output power level of the Bluetooth low energy radio.
See the operating mode during which this command can be used in Table 31. on page 92
. The command
will return a command response event with status ACI_STATUS_ERROR_DEVICE_STATE_INVALID
when it is used in the incorrect mode.
24.17.1 Functional description
This command is used to change the radio transmitter ouput power setting in runtime operation and
overwrites the the transmit power setting set in the configuration settings. The transmit power setting set
by the
SetTxPower command will be used for all radio transmissions until set to a different value. In the
event of device reset or power cycling, nRF8001 will reset the transmit power to the original configuration
data setting. The
ReadDynamicData command will extract the the transmit power setting set by the
SetTxPower command as part of the dynamic data.
24.17.2 Message format
Table 56. ACI message structure for SetTxPower
24.17.3 Accepted values
Table 57. Accepted values for parameters, SetTxPower
24.17.4 Returned events
This command returns a CommandResponseEvent. Data returned in the event is:
• Command code:
SetTxPower
• Status: Success / Error code
• Response data: None
24.17.5 Bluetooth low energy procedures used
None
Message field/parameter
Value size
(bytes)
Data value Description
Header
Length 1 2 Packet length
Command 1 0x12
SetTxPower
Content
RadioTransmitPowerLevel 1 Device output power setting.
Radio output power is set to
the default value if
SetTxPower command is not
issued.
Parameter Data value Description
RadioTransmitPowerLevel
0x00 -18 dBm
0x01 -12dBm
0x02 -6 dBm
0x03 0 dBm (Default value)