Component: TestEEPROMM

This application serves as a test of off-chip EEPROM functionality. The application is meant to be used with net/tinyos/tools/TestEEPROM.java application; it provides interfaces for testing the reading and writing functions of the EEPROM. The mote running this code should turn on the red LED on initialization; from that point on the LEDs toggle. Green LED is toggled when the app receives the command to either read or write to EEPROM; red LED toggles when the app attempt to send a response, and yellow LED toggles when the app thinks that the response transmission was successful. Contents of the response can be displayed with GenericBase and ForwarderListen tools.

Author: tinyos-help@millennium.berkeley.edu

Required Interfaces

StdControl EEPROMControl
EEPROMRead
EEPROMWrite
Leds
StdControl CommControl
ReceiveMsg ReceiveTestMsg
SendMsg SendResultMsg

Provided Interfaces

StdControl

Variables

TOS_Msg buffer
TOS_MsgPtr msg
bool bufferInuse

Function Index

command result_t StdControl.init (void) Application initialization code.
command result_t StdControl.start (void)
command result_t StdControl.stop (void)
event result_t SendResultMsg.sendDone (TOS_MsgPtr data, result_t success) When a message has been sent, the app marks the message buffer as available for further use.
void sendAnswer (uint8_t code) Helper function used to produce the final response of the app to the command fron the network.
event result_t EEPROMRead.readDone (uint8_t *buf, result_t success) This event is called when the eeprom read command succeeds; it sends a message indicating the success or failure of the operation.
event result_t EEPROMWrite.writeDone (uint8_t *buf) This event is invoked when EEPROM finishes transfering data into its temporary buffer.
event result_t EEPROMWrite.endWriteDone (result_t success) This event is invoked when EEPROM finishes transfering data into its nonvolatile storage.
task void processPacket(void) Decode the message buffer: pull out operation (0 for read, 2 for write), code, decode the address, and execute the operation.
event TOS_MsgPtr ReceiveTestMsg.receive (TOS_MsgPtr data) When the command message has been received, this handler check if the previous operation was completed, and if so it will dispatch the incoming message to processPacket task.

Function Descriptions

StdControl.init

command result_t StdControl.init (void)

Application initialization code. Initializes subcomponents: the eeprom driver and the communication stack.

Returns:

always SUCCESS

SendResultMsg.sendDone

event result_t SendResultMsg.sendDone (TOS_MsgPtr data, result_t success)

When a message has been sent, the app marks the message buffer as available for further use. The buffer will be used in processing further directives from the network.

Returns:

Always SUCCESS.

sendAnswer

void sendAnswer(uint8_t code)

Helper function used to produce the final response of the app to the command fron the network. The first byte of the message is the success code; the remainder is the response specic data. The return codes are as follows:

0x80 -- READ command was not accepted by the driver
0x82 -- WRITE command was not accepted by the driver
0x84 -- READ command failed
0x85 -- WRITE command failed to write data into the temporary buffer
0x86 -- WRITE command failed to flush the temporary buffer into nonvolatile storage.
0x90 -- READ command succeeded
0x91 -- WRITE command succeeded

EEPROMRead.readDone

event result_t EEPROMRead.readDone (uint8_t *buf, result_t success)

This event is called when the eeprom read command succeeds; it sends a message indicating the success or failure of the operation. If read succeeded the data read will be located in the response buffer, starting at the 3rd byte.

Returns:

Always SUCCESS

EEPROMWrite.writeDone

event result_t EEPROMWrite.writeDone (uint8_t *buf)

This event is invoked when EEPROM finishes transfering data into its temporary buffer. In this app the temporary buffer is immediately flushed to nonvolatile storage. If a transfer to the temporary buffer failed, this handler will send a response code over the radio.

Returns:

Always SUCCESS.

EEPROMWrite.endWriteDone

event result_t EEPROMWrite.endWriteDone (result_t success)

This event is invoked when EEPROM finishes transfering data into its nonvolatile storage. The handler signals the success of the write operation or the failure of commit operation, and sends that status to the application.

Returns:

Always SUCCESS.