eEEPROM_TempSensorOff

Macro Disable serial EEPROM and temperature sensor

Purpose To switch serial EEPROM and temperature sensor off to reduce power consumption Syntax void eEEPROM_TempSensorOff()

Parameters – Return value –

Output values Serial EEPROM and temperature sensor are disconnected from power supply

Preconditions Because OS uses serial EEPROM to store some networking information, e.g. during Discovery, it is recommended to utilize such power management for non-networking applications only.

Remarks Side effects –

See also eEEPROM_TempSensorOn Example eEEPROM_TempSensorOn();

waitDelay(30); // 300 ms delay required

getTemperature();

eEEPROM_TempSensorOff(); // Recommended in non-networking applications only temperature = param3;

IQRF OS

4.5 RAM

4.5.1 writeToRAM

Macro Write one byte to specified location in RAM Purpose Indirect access to RAM registers

Syntax void writeToRAM(uns16 address, uns8 value) Parameters • address: traditional or linear memory location address

• value: value to be written Return value –

Output values –

Preconditions Avoid writing to RAM areas dedicated to OS and to PIC special function registers otherwise OS can collapse. See RAM map [2].

Remarks RAM can be accessed either directly (using common C commands like X = Y;) or indirectly. But indirect writng to the INDFx registers is not allowed. Due to security reasons all instructions writng to INDFx are removed during Upload. To avoid unintended behavior, all constructions writng to INDFx (either by the user or by the compiler) should be omitted. Instead of this IQRF OS provides complete support for indirect RAM addressing using extra system functions readFromRAM, writeToRAM and copyMemoryBlock. See Example E06–RAM [9].

Side effects FSR0 register is modified.

See also readFromRAM, copyMemoryBlock, setINDF0, setINDF1

Example 1 // Not allowed. The compiler uses INDFx in such cases.

Macro Set control register FSR0 to access the beginning of specified OS buffer via indirect addressing Purpose

Syntax uns8 setFSR0(buffer)

Parameters buffer: _FSR_NINFO Set FSR to networkInfo _FSR_INFO Set FSR to bufferINFO _FSR_COM Set FSR to bufferCOM _FSR_AUX Set FSR to bufferAUX _FSR_RF Set FSR to bufferRF _FSR_ntwADDR Set FSR to ntwADDR

Return value 64 Constant value to optimize possible subsequent work with buffers Output values • FSR0 addresses byte[0] of specified OS buffer

• WREG = 64 Preconditions –

Remarks See IQRF OS User’s guide [1], chapter Data memory (RAM).

Side effects –

See also setFSR1, setFSR01

Example setFSR0(_FSR_COM); // FSR0 addresses bufferCOM[0]

X = INDF0; // X = bufferCOM[0]

IQRF OS

4.5.3 setFSR1

Macro Set control register FSR1 to access the beginning of specified OS buffer via indirect addressing Purpose

Syntax uns8 setFSR1(buffer)

Parameters buffer: _FSR_NINFO Set FSR to networkInfo _FSR_INFO Set FSR to bufferINFO _FSR_COM Set FSR to bufferCOM _FSR_AUX Set FSR to bufferAUX _FSR_RF Set FSR to bufferRF _FSR_ntwADDR Set FSR to ntwADDR

Return value 64 Constant value to optimize possible subsequent work with buffers Output values • FSR1 addresses byte[0] of specified OS buffer

• WREG = 64 Preconditions –

Remarks See IQRF OS User’s guide [1], chapter Data memory (RAM).

Side effects –

See also setFSR0, setFSR01

Example setFSR1(_FSR_RF); // FSR1 addresses bufferRF[0]

X = INDF1; // X = bufferRF[0]

4.5.4 setFSR01

Macro Set control registers FSR0 and FSR1 to access the beginning of specified OS buffers via indirect addressing

Purpose

Syntax uns8 setFSR01(buffer0, buffer1) Parameters buffer0, buffer1:

_FSR_NINFO Set FSR to networkInfo _FSR_INFO Set FSR to bufferINFO _FSR_COM Set FSR to bufferCOM _FSR_AUX Set FSR to bufferAUX _FSR_RF Set FSR to bufferRF _FSR_ntwADDR Set FSR to ntwADDR

Return value 64 Constant value to optimize possible subsequent work with buffers Output values • FSR0 and FSR1 address bytes[0] of specified OS buffers

• WREG = 64 Preconditions –

Remarks See IQRF OS User’s guide [1], chapter Data memory (RAM).

Side effects –

See also setFSR0, setFSR1

Example setFSR0(_FSR_COM); // FSR0 addresses bufferCOM[0]

IQRF OS

4.6 Data blocks

4.6.1 appInfo

Macro Store Application information from EEPROM to bufferINFO Purpose Get information about user application

Syntax void appInfo() Parameters –

Return value –

Output values bufferINFO[0 to 31]

Preconditions –

Remarks See IQRF OS User's guide [1], chapter Identification and Appendix Memory maps.

Side effects –

See also moduleInfo

Example 1 appInfo(); // Copy Application info from EEPROM to bufferINFO copyBufferINFO2RF(); // and then to bufferRF

Example 2 #pragma packedCdataStrings 0 // Application data to EEPROM after compilation

#pragma cdata[__EEAPPINFO] = "Application data, I'm user #01 "

...

eeWriteByte(__EEAPPINFO+29, '2'); // #01 changed to #02

appInfo(); // "Application data, I'm user #02 " is read

IQRF OS

4.7 Others

4.7.1 setFRCparams

Macro Set FRC parameters

Purpose Preparing the Node for sending Local FRC command with specified FRC response time (from 40 ms to 20.52 s)

Syntax setFRCparams(params)

Parameters uns8 params: See table Constants, for setFRCparams(params).

Default: _FRC_RESPONSE_TIME_40_MS (setFRCparams call is not necessary in this case.) Input values –

Return value –

Output values • Specified FRC parameters are stored into configFRC variable for the subsequent Local FRC command. It is internally used within the DpaApiLocalFrc() function.

• Specified FRC response time is valid until TR reset or another setFRCparams call.

Preconditions For DPA only.

Remarks See DPA Framework technical guide, chapter DpaApiLocalFrc and CustomDpaHandler-LocalFRC.c example in IQRF Startup package.

Side effects –

See also sendFRC, getFRCparams

Example LOCAL_FRC_CMD = 0x83; // FRC_MemoryReadPlus1

RFpower = 6; // Select RF output power for FRC response

setFRCparams(_FRC_RESPONSE_TIME_360_MS); // Prepared for 360 ms FRC response time if (DpaApiLocalFrc(LOCAL_FRC_CMD, RFpower) != param2) // Local FRC

pulsingLEDG(); // Error indication

IQRF OS

4.8 Compatibility

Macros in this chapter are intended for compatibility with older TR and/or OS versions.

Name Interpretation Remarks

setTXpower(level) setRFpower(level) OS function renamed in history

reset() softReset() Just an alias for MCU machine instruction Reset and CC5X native function

breakpoint(wValue) debugW(wValue) Renamed in history.

IQRF OS