PreviousNext
Write TR Configuration byte
Help > Peripherals > OS > Write TR Configuration byte

Writes multiple bytes (or just bits) to the TR Configuration memory. This command is for advanced users only. The Acknowledged broadcast is recommended for writing configuration values to all or selected Nodes as it also confirms which Nodes performed the configuration write. Please note that the device should be restarted for some configuration changes to take effect. See TR Configuration for details.

 

Request

 

NADR

PNUM

PCMD

HWPID

0

1

2

n × 3

n × 3 + 1

n × 3 + 2

NADR

0x02

0x09

?

Address0

Value0

Mask0

Addressn

Valuen

Maskn

 

n [0,17]          Number of configuration items to write minus 1.

Address           Address of the item at configuration memory block. The valid address range is 0x00-0x1F for configuration values. Also, address 0x20 is a valid value for RFPGM settings. See the parameter of setupRFPGM IQRF OS function.

Value                Value of the configuration item to write.

Mask                Specifies bits of the configuration item (i.e. byte) to be modified by the corresponding bits of the Value parameter. Only bits that are set at the Mask will be written to the configuration byte i.e. when Mask equals 0xFF then the whole Value will be written to the configuration byte. For example, when Mask equals 0x12 then only bit.1 and bit.4 from Value will be written to the configuration byte.

 

Response

 

The general response to writing request with STATUS_NO_ERROR Error code.

 

Error codes

ERROR_DATA      Address is out of range.