Home

User Guide (for ScatterWeb)

1. lif defined eGate include lib egate programming h include lib egate flasher h ndif include ScatterWeb Configuration h include ScatterWeb Data h include ScatterWeb Timers h include ScatterWeb Time h include ScatterWeb IO h include ScatterWeb Comm h ScatterWeb inside include ScatterWeb Net h include ScatterWeb Messaging h include ScatterWeb Threading h include ScatterWeb String h include ScatterWeb Synchronisation h ndif The ScatterWeb System contains fundamental functions that define commonly used value and reference data types events and event handlers attributes and processing exceptions ADC Starting enabling disabling and ISR for ADU The main function of the ADU is to sample the unfiltered radio receive output and provide a carrier detect see interrupt routine ADC12ISR and rxReceiveLimit in Configuration Look for defines in ScatterWeb System h to access other ADC readings CLOCK Methods for interfacing DS1629 RTC with temperature and LM71 temperature sensor For both devices the function getTemperature is implemented It returns the temperature in fixed point 9 7 2s complement format 051629 initClock should be called at startup to check for the correct setting in the status register of the RTC Most function
2. UINT16 interval UINT16 range UINT16 diff UINT16 spd bool Data temperatureOff bool Data vibrationOn UINT16 delay bool Data vibrationOff bool Data greenLed bool Data redLed bool Data yellowLed bool Data RC5SendPHI int data bool Data RC5Enable bool Data RC5Disable bool Data RC5SendNEC UINT16 datal UINT16 data2 bool Data sensorHandler void Data RC5ReceiveHandler void Data RC5EventHandler The ScatterWeb Data consists mostly of the functions that constitute the sensors architecture The sensors architecture enables you to build components that efficiently manage data from multiple data sources It provides the tools to initialize enable and disable data in this multiple tier system To get sensor events you must set a callback function in System_callbacks C_SENSOR for disabling that set System_callbacks C_SENSOR NULL Each sensor is separately enabled and disabled with its enable disable function The enable function takes some sensor specific arguments The first argument is the interval or debounce delay for reading the sensor internally it can also be seen as a reaction time for example for Vib If Vibration has been signaled how long the sensor must stay silent to signal NoVibration 22 ScatterWeb inside For temperature 4 arguments are needed to specify a funnel function Data_temperatureOn Interval StartRange Diff
3. 6 ScatterWeb inside 1 3 Embedded EYE EYE The camera module has a serial connector to connect itto the ESB ScatterWeb inside 1 4 eGate USB Flash Transceiver Antenna Serial Connector USB Second Flash Connector to flash a further node The eGate USB has additionally a red a yellow and a green LED and a 64 Kbytes EEPROM Notice You need an appropriate flash cable obtainable on order and the JTAG also obtainable on order to flash the eGate USB 8 ScatterWeb inside 1 5 eGate WEB Transceiver Antenna Web server Flash The eGate WEB has additionally a red a yellow and a green LED and a 64 Kbytes EEPROM Notice You need an appropriate flash cable obtainable on order and the JTAG also obtainable on order to flash the eGate WEB ScatterWeb inside 9 2 Radio communiction Agilent 12 41 41 12 Jul 2005 Marker Ref 188 mH Atten 40 dB VBH 3 MHz Sweep 8 10 ScatterWeb inside 3 Agilent 12 43 29 12 Jul 2005 Marker Mkr2 a 13 Atten 40 dB select Marker 1 2 2 4 Delta Pair Tracking Ref Ref Delta Marker Span 13 5 5000 MHz y B H 3 MHz ScatterWeb inside 11 3 ScatterWeb API As the name already implies sensor networks need sensors typically lots of sensors to collect data from their environment All sensor nodes may form an ad hoc network with some nodes acting as data sources some as relays and some as data s
4. ied Ex Rete redis 56 3 11 64 3 12 ScatterWeb Timers ara N ae 67 M 70 41 The EMPTY 70 4 2 Howto instal ee t A t d d d dE 74 4 3 HOWIO USC RT M tats 5 COImplle sodio ep rio te 76 4 5 NOW RORIS en ehe TET 77 Appendix A Terminal Command Listing 78 Appendix Terminal Command Availability 82 ScatterWeb inside 3 1 Platforms 1 1 Embedded Chip Radio ECR Antenna Transceiver Flash Controller VIB Sensor Digital N 2 Digital IO Ports The ECR has additionally a Temperature Sensor a red LED and a 64 Kbytes EEPROM Notice You need an appropriate flash cable obtainable on order and the JTAG also obtainable on order to flash the ECR ScatterWeb inside 5 1 2 Embedded Sensor Board ESB Transceiver i M Antenna PIR Sensor 21 MERC Serial Flash Beeper Reset Button The ESB has additionally a Temperature Sensor a VIB Sensor IR to send and to receive a Microphone and a 64 Kbytes EEPROM The ESB supports the RC5 infrared standard Notice You need the JTAG obtainable on order to flash the ESB and an appropriate serial cable also obtainable on order to interconnect the ESB and the PC PDA
5. define EEPROMADDRESS 0x00 define EEPROMPAGEMASK 0 7 bool IO erase UINT16 adr UINT16 size 2022 SEO ac UNG C m a cH ONES a GI 58 2607 TO weree CENE se 16112228 LO ndif The ScatterWeb IO contains functions that allow reading and writing to the EEPROM Most important functions for writing reading the EEPROM are IO write IO read The EEPROM offers 64k memory 100000 write cycles and is accessed with an I2C like bus Currently use is storing configuration data see ScatterWeb Configuration c and temporary storage of a new software image before it gets flashed DEVICE ADDRESSING Start 1 0 1 0 A2 AO R W EEPROM memory map Region Usage o 0 0000 OxOCFF Free for use o 0 0000 OxODFF Application config EADR_APPCONFIG o OxOEOO0 OxOEFF Used by flasher c EADR FLASHERBUF Free for use only if flasher state IDLE OxOFOO OxOFFF Never change something here Used for configuration data ScatterWeb Configuration c EADR CONFIG and some reprogramming variables o 0 1000 OxFFFF Programming image storage or other big data Use according to EEPROM EADR IMAGESTATE 32 ScatterWeb inside bool IO_erase UINT16 e_adr UINT16 size Function Parameter Return value Erase several bytes from EEPROM means set them to OxFF e adr st
6. sid sir slb slg slo slr sly spf ssm stp swg swr swy tim tis tiz web ScatterWeb inside 83
7. WATCHDOQG Hardware amp Software watchdog reset reason stack check and panics This module contains two macros to control the hardware watchdog Furthermore it supports determining the reset source a simple stack checker to avoid stack overflows and a panic function Hardware amp Software Watchdog The macro System startWatchdog allows starting or resetting both watchdogs System_stopWatchdog stops it These macros are mostly for firmware internal use In the perfect case noone should call System_stopWatchdog and the only place to call System_startWatchdog repeatedly would be the main loop However some software parts need a long time or must run exclusively then also disabling the interrupts together with System_stopWatchdog interrupt was used to implement software watchdog with a timer interrupt running together with the built in hardware watchdog because an interrupt offers the possibility to recover the address where the watchdog timeout occurred This address gets written in a panic message when 1 Interrupt fires what means watchdog timeout Putting the hardware watchdog into interrupt mode what is possible with the 5 430 is not a good idea because then it can t recover the MCU a case where it is not running at all for example MSP430s known startup problems with a slow or noisy voltage rise which lead to such a situation Reset source The function wd_init runs at the v
8. Freie Universit t Berlin User Guide for ScatterWeb A platform for teaching amp prototyping wireless sensor networks scatterweb mi fu berlin de Computer Systems amp Telematics Freie Universit t Berlin Germany Content 1 iiiv 5 1 1 Embedded Chip Badio anne 5 1 2 Embedded Sensor Board 6 1 3 Embedded EYE YE YE Eee 7 124 elo USB acie 8 1 9 1 WEB ao 9 2 Radiocommiu niCliOn oisi stone cosas asinus cuoco ka usan 10 3 SCatterWeb sAP lai 12 341 Scatter Web Comm 254 501 565 Ernie 16 3 2 19 3 3 ScatterWeb Data oco 21 9 4 75 32 3 5 34 3 6 5 8 0 37 3 7 ScatterWeb String 41 3 8 ScatterWeb Synchronisation 44 44 3 9 46 3 10
9. Return value code True code if packet is successfully buffered lt code gt False lt code gt otherwise bool Net rxHandler Function This member supports the ScatterWeb infrastructure and is not intended to be used directly from your code Parameter Return value 40 ScatterWeb inside bool Net txHandler Function This member supports the ScatterWeb infrastructure and is not intended to be used directly from your code Parameter Return value char Net esend packet t packet fp char t callback Function This member supports the ScatterWeb infrastructure and is not intended to be used directly from your code Parameter Return value 3 7 ScatterWeb String ScatterWeb 2 x System src ScatterWeb String h ifndef ScatterWeb_String define ScatterWeb_String int String_writeUlnt fp_char_t writer UINT16 number UINT16 length int String writeULongInt fp char t writer UINT32 number UINT16 length bool String fromByteToHex UINT8 b UINT8 cs UINT8 String fromHexToByte const UINT8 cs bool String writeTemperature fp char t writer temp t temp bool String abstractWrite fp char t writer const char fmt wet lisc oco 8 GG TOS NET 151642 UINT32 String_parseLongInt const UINT8 c UINT8 ptr MCHE The
10. SENSOR MICROPHONE 02 2 SENSOR TEMPERATURE ssm X 04 SENSOR RC5 ScatterWeb Event 08 SENSOR MOVEMENT 10 SENSOR VIBRATION 40 SENSOR VOLTAGE 80 SENSOR BUTTON or a combination of this values stp X set transmit power to x ScatterWeb Messaging SWg toggle green led ScatterWeb Messaging swr toggle red led ScatterWeb Messaging toggle yellow led ScatterWeb Messaging tim read system time ScatterWeb Messaging tis x set system time to x seconds ScatterWeb Messaging tiz x set system time to x milliseconds ScatterWeb Messaging tmr read timers ScatterWeb Timers web xy write y atx of eeprom ScatterWeb IO ScatterWeb inside 81 Appendix B Terminal Command Availability Command ECR ESB EYE eGate USB eGate WEB app x x x x x brt x x x x x dco X X X x x dea x x X x x dsr X X X x x esr x x x x x est flx x x x x x fst x x x x x Ist x x x x x mem x x x x x pan x x x x x pel x x x x x png x x x x x p r x x x x x raf x x x x x rbu x x rcf x x x x x rer x x x x x rff x x x x x rfl x x x x x rfr x x x x x rid x x x x x rib x x x x x x x x x rlo x x x x x x x x x x rly x x x x mm x x 82 ScatterWeb inside 150 rsp RST rtp rtt rvb saf sbp scf SCO sff sfr
11. The IR Receiver is handled in file ScatterWeb Data c A good example for using the sensors is ScatterWeb Event c EMPTY ESB project It s controlling the beeper It s receiving RC5 via IR Receiving Diode ScatterWeb inside 23 RC5 1780us bit length Manchester encoded so half bit length of 890us is important Transferred packet 2 start toggle bit 5 address bits 6 command bits 1515 A2 A1 A0 5 C4 C2 C1 irdata format 1212 error newData 4 2 AO C5 C4 C2 Some common addresses and commands Address 0 1 5 6 17 18 20 Device TV1 TV2 VCR1 VCR2 Tuner Audio Tape CD Player Command 0 9 Numbers 0 9 channel select 12 16 17 18 19 50 52 53 54 55 Standby Master Volume Master Volume Brightness Brightness Fast rewind Fast run forward Play Stop Recording It supports methods for sending with IR diode These methods are timed to the system clock 4505600 MHz and disable all interrupts and so will halt the system timer for some milliseconds Radio packet transmission amp reception are also disrupted 24 ScatterWeb inside bool Data init Function Parameter Return value Initializes the sensors None code True code if sensors available lt code gt False lt code gt otherwise bool Data batteryOn UINT16 interval
12. the function doCommand can easily loop through this segment going from term start term end also provide by the linker script and search for the command This even makes it possible to declare terminal commands where needed not only in ScatterWeb Messaging c The firmware commands will still stay centralized in ScatterWeb Messaging c to have code amp documentation of the firmware commands in one place The needed modifications of the linker script can be seen in System ldscript x dontinclude Idscript x skip text until gt text All commands must write their answer to term_reply and it should not be longer than TERM_BUFSIZE If nothing is written to term_reply automatically an OK is generated The only exception to that is when the bit SERIALONLY in the flag field is set That means that the terminal command uses the serial functions directly not writing its answer to term_reply and can t be called over radio ScatterWeb inside 35 bool Messaging_on Function Enables the Messaging started by system Parameter None Return value lt code gt True lt code gt always void Messaging serialHandler Function This member supports the ScatterWeb infrastructure and is not intended to be used directly from your code Parameter Return value bool Messaging requestHandler Function This member supports the ScatterWeb infrastructure and is not intended to be used directly from your code
13. Function This member supports the ScatterWeb infrastructure and is not intended to be used directly from your code Parameter Return value ScatterWeb inside 61 bool Threading_packetHandler Function This member supports the ScatterWeb infrastructure and is not intended to be used directly from your code Parameter Return value bool Threading_sentPacketHandler UINT16 p UINT16 success Function This member supports the ScatterWeb infrastructure and is not intended to be used directly from your code Parameter Return value bool Threading_recv UINT16 sender UINT16 type UINT16 timeout Function This member supports the ScatterWeb infrastructure and is not intended to be used directly from your code Parameter Return value bool Threading_recvp UINT16 sender UINT16 type UINT16 timeout Function This member supports the ScatterWeb infrastructure and is not intended to be used directly from your code Parameter Return value bool Threading_send UINT16 to UINT16 type UINT8 h UINT16 hl UINT8 UINT16 dl Function This member supports the ScatterWeb infrastructure and is not intended to be used directly from your code Parameter Return value 62 ScatterWeb inside bool Threading_esend UINT16 to UINT16 type UINT8 h UINT16 hl UINT16 UINT16 dl Function This member supports the ScatterWeb infrastructure and is not intended
14. Parameter Return value bool Messaging answerHandler Function This member supports the ScatterWeb infrastructure and is not intended to be used directly from your code Parameter Return value bool Messaging requestDataHandler UINT8 data Function This member supports the ScatterWeb infrastructure and is not intended to be used directly from your code Parameter Return value 36 ScatterWeb inside 3 6 ScatterWeb Net ScatterWeb 2 x System src ScatterWeb Net h ifndef ScatterWeb_Net define ScatterWeb_Net include ScatterWeb System h define BROADCAST OxFFFF define UNKNOWN 0x0000 define ACK_PACKET 0 00 define SYNC_PACKET 0 01 define PING_PACKET 0x02 define PONG_PACKET 0x03 define MESSAGING REQ PACKET 0x04 define MESSAGING_ANS_PACKET 0x05 define SCAN_PACKET 0x06 define SCAN_REPLY_PACKET 0x07 define SENSOR_PACKET 0x08 define FLASH_HEADER 05 4 define FLASH_HEADER_REPLY 0x12 define FLASH_DATA 0x14 define FLASH_REO 0x15 define 0 16 define PICTURE_ANS_PACKET 0x17 define ROUTING_INFO 0x20 define ROUTING_REQUEST 0x22 define ROUTING_ACCEPT 0x23 define ROUTING_DENY 0x24 define ROUTI
15. StepsPerDiff Interval How often is the temperature read in systems ticks 1ms StartRange How much must the temperature differ from the last value to get signaled Diff How much the Range is decreased every DiffStep measures StepsPerDiff How much measures until Range is decremented with Diff Attention Temperature data is in fixed point 2s complement format This approach also includes simple standard evaluation methods Periodic Reading To signal every x ms do Data_temperatureOn x 0 0 0 Reading To signal only on temperature changes greater than x temperature is read every y ms do Data_temperatureOn y x 0 0 Periodic amp On Change combined To signal on every change greater than x or after a time y z has passed temperature is read every z ms do Data_temperatureOn z x x y Examples Data temperatureOn 5120 0 0 0 Every 5 seconds Data temperatureOn 2048 0x0080 0 0 Only on change greater 1 C temperature is read every 2 seconds Data temperatureOn 6144 0x0080 0x0080 20 Every 20 6s 2min or if changed more than 1 C temperature is read every 6 seconds Data temperatureOn 6144 0x0200 0x0040 10 Funnel function Measure every 6 seconds and decrease range from 2 C for 0 5 C every 10 6s 1min temperature is read every 6 seconds Power for sensors and RS232 voltage converter must be enabled see System powerOn System powerOff
16. UINT8 h UINT16 hl UINT8 d UINT16 d1 hreading esend UINT16 to UINT16 type UINT8 h UINT16 hl UINT16 d UINT16 dl The ScatterWeb Threading provides functions that enable multithreaded programming ScatterOS This file implements a simple cooperative scheduling mechanism which allows to run task functions with OS like blocking calls which in fact do not block the processor but return control to the system and get later resumed The OS primitives at the moment are Threading doEvents Simply returns control to the system As this is a cooperative scheduler long tasks or tasks which make no other Threading calls must interrupt themselves with Threading doEvents Threading sleep Makes the task wait a specified amount of system ticks may get longer if system is busy Threading wait Makes the task wait for a flag set 56 ScatterWeb inside Threading recv Threading recvp Makes the task wait for a packet of a given type and a given sender if wanted A timeout can be set and Threading_recvp works in promiscuous mode Threading_send Threading esend A synchronous send task will continue after the packet was sent or lost removed from radio rx ring buffer Threading_esend is for sending data from EEPROMm These are not many but suit the needs at the moment Constraints The goal was to write a task switching mechanism with minimal memory require
17. in registers also register content is undefined after a Threading_ call Secondly it means that blocking Threading_ functions are only allowed to call within your top level task function not in functions called from your top level task function The reason for that is again the stack which is undefined after a Threading_ call and so will thrash the return address for Threading_ calls anywhere outside from your top level task function How it works A task is initialized with Threading add which gets a pointer to the task function If a task can run like a newly added task sooner or later scos call ScatterWeb inside 57 with the id of the task in the task table and a value is called scos_call saves the current stack pointer sets currentTask and calls the next to continue address of the task like a function with an int argument Then the task runs until it calls a Threading_ function These functions save the return address of the task on the stack as the next to continue address in the task table change the state of the task and call scos_exit scos_exit now just restores the stack pointer to the value scos_call saved and does a return which now is like the return of scos_call and so the system is again in clean state Related The System Stack Pointer SP The system stack pointer must always be aligned to even addresses because the stack is accessed with word data during an interrupt request service The system SP is used by
18. ACK_PACKET break case MESSAGING_REQ PACKET Messaging requestHandler break case MESSAGING ANS PACKET Messaging answerHandler break case PING PACKET break case PONG PACKET break default break The COMMAND app 0 approves other nodes to check which application on this node is running COMMAND app 0 String_write term_reply EMPTY First of all the Process will be called by the System when the complete core is initialized void Process init System registerCallback C RADIO Process radioHandler 002 Comm log LOW Application s initialized r n r n imageData versionName ScatterWeb inside 71 This is the Software header see programming h for description Theses variables are defined by the linker script they are needed in the software header extern int __image_start extern int __image_end extern UINT16 prog reprogram attribute section imagedata const imageData t imageData X UINT16 amp image start UINT16 amp image eng UINT16 prog reprogram ISIS 5 2 xe DATE TIME ndif ScatterWeb Event The ScatterWeb Event module presents methods for handling and forwarding sensor data events Special commands of ScatterWeb Event dsr set flags to print no sensor data to none esr set flags to
19. B make 1 Leaving directory msp430 gee Wl1 Map out out cygdrive c ScatterWVeb 2 2 System bin ESB msp430 gee Wall nmcu smsp430x149 fno defer pop D ESB g O c src ScatterWeb Process c o bin ScatterWeb Process o map cref W1 T System ldscript x Wall mmcu msp430x149 g O o out out elf System bin ESB Scatti msp430 objcopy O ihex out out elf out out hex dec hex filename 34872 4 1391 36267 Sdab out out elf ROM usage is text data RAM usage is data bss I 15 1 15 1363 zm P 80 50 005 make flash ScatterWeb inside 77 Appendix Terminal Command Listing Command Parameter Description Location app read the name of the application ScatterWeb Process init Comm with x bps Valid values are 01 BPS 2400 brt x 02 BPS 14400 ScatterWeb Comm 03 BPS_19200 04 BPS_38400 05 BPS_57600 06 BPS_115200 dco X if x set dco if x set dco ScatterWeb Messaging dea erase eeprom ScatterWeb IO dsr set flags to print no sensor data to none ScatterWeb Event esr set flags to print sensor data to radio ScatterWeb Event est prints software header of image ScatterWeb System flx x y broadcasting a userapp from x to ScatterWeb System fst prints running software header ScatterWeb System Ist list commands ScatterWeb Messaging mem read free stack bytes ScatterWeb Messa
20. DCO TimerA TimerB and software timer table This method first calls SetDCO and initializes variables for timers Timer A is initialized to run from the divided 32 768 Hz Crystal at 4096 Hz Timer B is initialized to run from the self regulated DCO at 4 505600 MHz Timer 0 is used to generate an interrupt every 4 ticks once a 1024 second near to a millisecond Timer A1 3 is used by watchdog c to implement a software watchdog Timer BO is used by recir c to capture RC5 signals every 890 us Timer 1 6 is used to measure the DCO continously with TB6 None code True code always bool Timers add UINT16 ticks fp timer fp UINT16 data Function Parameter Return value Strictly adds a timer also if it exists already If ticks are passed the given functions is called ticks ticks for elapse fp function to call if expired data parameter to call function without use OXFFFF code True code if successful lt code gt False lt code gt otherwise 68 ScatterWeb inside bool Timers_reset UINT16 t fp_timer fp UINT16 data Function Adds or if it already exists resets a timer Parameter ticks ticks for elapse fp function to call if expired data parameter to call function without use OxFFFF Return value lt code gt True lt code gt if successful lt code gt False lt code gt otherwise bool Timers_remove fp timer fp 01 16 data Function Removes timer if data is
21. Parameter None Return value code True code always 20 ScatterWeb inside 3 3 ScatterWeb Data ScatterWeb 2 x System src ScatterWeb Data h ifndef ScatterWeb_Data define ScatterWeb_Data include ScatterWeb Time h define REDSTATE Data redLed define YELLOWSTATE yellowLed define GREENSTATE greenLed define SENSOR MOVEMENT 0x08 define SENSOR VIBRATION 0x10 define SENSOR BUTTON 0x80 define SENSOR MICROPHONE 0x01 define SENSOR TEMPERATURE 0x02 define SENSOR RC5 0x04 define SENSOR VOLTAGE 0x40 typedef struct UINEIG Lel UINT8 sensor time_t timeStamp UINT16 value jc extern UINT8 sensorFlags DOSL Deica Gylen y bool Data batteryOn UINT16 interval 01 16 thresh bool Data batteryOff bool Data beeperOn bool Data beeperOff bool Data beeperToggle bool Data buttonOn UINT16 delay bool Data buttonOff bool Data greenOn bool Data greenOff bool Data greenToggle bool Data redOn bool Data redOff bool Data redToggle bool Data 11 ScatterWeb inside 21 bool Data yellowOff bool Data yellowToggle bool Data microphoneOn UINT16 delay UINT16 diff bool Data microphoneOff bool Data movementOn UINT16 delay bool Data movementOff bool Data temperatureOn
22. Return value code True code always bool System powerOn Function Enables the sensor and serial power Parameter None Return value code True code always 54 ScatterWeb inside bool System powerOff Function Disables the sensor and serial power Parameter None Return value code True code always UINT16 System reprogram Function This member supports the ScatterWeb infrastructure and is not intended to be used directly from your code Parameter Return value bool System startConversion Function This member supports the ScatterWeb infrastructure and is not intended to be used directly from your code Parameter Return value ScatterWeb inside 55 3 10ScatterWeb Threading ScatterWeb 2 x System src ScatterWeb Threading h ifnd defin ScatterWeb_Threading ScatterWeb_Threading extern volatile UINT16 Threading_currentThread bool bool bool bool bool bool bool bool bool bool bool bool Threading_init hreading add void address Threading_doEvents hreading_sleep UINT16 ticks Threading_wait UINT8 adr UINT8 bitmask hreading eventHandler Threading packetHandler Threading sentPacketHandler UINT16 p UINT16 success Threading recv UINT16 sender UINT16 type UINT16 timeout hreading recvp UINT16 sender UINT16 type UINT16 timeout Threading send UINT16 to UINT16 type
23. ScatterWeb String represents text that is a series of Unicode characters ScatterWeb inside 41 int String_writeUInt fp_char_t writer UINT16 number UINT16 length Function Converts int to String Parameter witer function to write number number to write length length to write Return value position in output out pos int String writeULongInt fp char t writer UINT32 number UINT16 length Function Converts long int to String Parameter writer function to write number number to write length length to write Return value position in output out pos bool String fromByteToHex UINT8 b UINT8 cs Function Converts the byte b into the string cs 0 cs 1 Parameter b byte CS string Return value code True code always UINT8 String fromHexToByte const UINT8 cs Function Converts the string at cs 0 cs 1 into a byte at b Parameter cs string Return value value to convert into bool String writeTemperature fp char t writer temp t temp Function Writes a temperature according to the format described in System getTemperature xxx x Parameter writer function to write temp temperature Return value lt code gt True lt code gt always 42 ScatterWeb inside bool String_abstractWrite fp_char_t writer const char fmt va_list argp Function Simple printf implementation for RS232 output Supports amongst others c Prints a character 96i Pr
24. UINT16 thresh Function Parameter Return value Enables the battery sensor interval interval of measurement thresh thresh of measurement code True code if battery sensor available lt code gt False lt code gt otherwise bool Data batteryOff Function Parameter Return value Disables the battery sensor None code True code if battery sensor available lt code gt False lt code gt otherwise bool Data beeperOn Function Parameter Return value Enables the beeper None code True code if beeper sensor available lt code gt False lt code gt otherwise bool Data beeperOff Function Parameter Return value Disables the beeper None code True code if beeper sensor available lt code gt False lt code gt otherwise ScatterWeb inside 25 bool Data beeperToggle Function Toggles the beeper Parameter None Return value code True code if beeper sensor available lt code gt False lt code gt otherwise bool Data buttonOn UINT16 delay Function Enables the button Parameter delay delay of measurement Return value code True code if button sensor available lt code gt False lt code gt otherwise bool Data buttonOff Function Disables the button Parameter None Return value code True code if button sensor available lt code gt False lt code gt otherwise bool Data greenOn Fun
25. conditions are amp 3 05 met Scatterweb Comm c Scatterweb Comm h Redistributions of source code must retain the above copyright ScatterWeb Configuration c notice this list of conditions and the following disclaimer Scatterweb Configuration h ScatterWeb Data c Redistributions in binary form must reproduce the above copyright Scatterweb Data h notice this list of conditions and the following disclaimer in the ScatterWeb ID c documentation and or other materials provided with the distribution ScatterWeb lO h ScatterWeb Messaging c Scatterweb Messaging h ScatterWeb Net c ScatterWeb Net h Scatterweb String c Neither the name of Freie Universitaet Berlin FUB nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission ScatteiWeb Stiingh This software is provided by FUB and the contributors on an as is ScalteiWeb Synchronisation c basis without any representations or warranties of any Kind express ScatterWeb Synchronisation h or implied including but not limited to representations or ScatterWeb System c warranties of non infringement merchantability or fitness for a Scatterweb System h particular purpose In no event shall FUB or contributors be liable Scatterweb Threading c for any direct indirect incidental special exemplary or Scatterweb Threading h consequential damages including but not limited to procurement of ScatterWeb Tim
26. from __noinit_end OxO9FF with OxABCD so the procedure simply checks the four ints from __noinit_end for the value OxABCD If they are not there the stack must have gone that low and possibly lower The procedure will panic then Panic System_panic is a function to call when some bad condition was detected for example low stack full timers System_panic writes a small info msg into second info memory segment 0x1080 0x10FF and then resets the controller Multiple panic messages can be written until the segment is full One could go further and implement a complete memory dump into flash what would give the possibility to examine the complete system state later for debugging ScatterWeb inside 51 LPM Power saving The sensor board features low power modes to reduce power consumption This increases battery powered lifetime up to years and makes it even possible to run the sensor board solely with a gold cap solar cell combo Following units can be switched off to reduce power consumption Unit Power consumption Corresponding function Comments ScatterWeb Net 4 7 5 2mA Net Net on ScatterWeb Data 2 9mA System_powerOff System powerOn The MSP430 itself goes to sleep when nothing more has to be done see super loop in main Power consumption with everything disabled Radio Sensor goes below 1mA This file contains special definitions amp configuration options for the firmware and includes a
27. matching Parameter fp function to call if expired data parameter to call function without use OxFFFF Return value lt code gt True lt code gt if successful lt code gt False lt code gt otherwise bool Timers_eventHandler Function This member supports the ScatterWeb infrastructure and is not intended to be used directly from your code Parameter Return value ScatterWeb inside 69 4 Usage 4 1 The EMPTY application The EMPTY application presents the body to develop your own applications ScatterWeb Process The ScatterWeb Process module enables you to initialize and start your application ScatterWeb 2 x Applications lt application gt lt platform gt ScatterWeb Process c Special commands of ScatterWeb Process app read the name of the application You are able to include all needed files like ScatterWeb Event h include ScatterWeb Event h You in a position to include the core of the ScatterWeb API include System src ScatterWeb System h The Process_interceptRadioHandler handles all packets which are addressed to other nodes void Process_interceptRadioHandler 70 ScatterWeb inside The Process_radioHandler handles all packets void Process_radioHandler if rxPacket to BROADCAST rxPacket to Configuration id 4 Process interceptRadioHandler else switch rxPacket type case
28. print sensor data to radio raf read announce flags rsm read sensor mask saf set announce flags o Valid values are 01 AF_SERIAL 02 AF RADIO combination of this values ssm set sensor mask to x o Valid values are 01 2 SENSOR MICROPHONE 02 SENSOR TEMPERATURE 04 SENSOR RC5 08 SENSOR MOVEMENT 102 SENSOR VIBRATION 40 SENSOR VOLTAGE 80 SENSOR BUTTON or a combination of this values 72 ScatterWeb inside ScatterWeb 2 x Applications lt application gt lt platform gt ScatterWeb Event h ifndef ScatterWeb_Event define ScatterWeb_Event include System src ScatterWeb System h define AF SERIAL 0x01 define AF RADIO 0x02 typedef struct UINT8 announceFlags UINT8 sensorMask aite loxoXoxlL 18st atiaiibu 09 ndif Processes events according to sensorMask and announceFlags appconfig t sensorMask contains what sensors will be processed commands rsm ssm 0x10 SENSOR_VIBRATION Vibration sensor 0x08 SENSOR_MOVEMENT sensor 0x80 SENSOR_BUTTON Button 0x01 SENSOR_MICROPHONE Microphone 0x02 SENSOR TEMPERATURE Temperature 0x04 SENSOR RC5 RC5 Receiving 0x40 SENSOR VOLTAGE Battery Voltage appconfig t announceFlags contains what will be done with sensor events commands raf saf 0x01 AF SERIAL Prints events to serial port 0x02 AF RA
29. timers numberTimers The entry at position 0 will always contain the next timer to expire The ticks in the timer entries are not decreased with every system tick but first accumulated into _ticks until one of two things happen ticks becomes greater than timers O ticks what means that at least timers 0 has elapsed if no timer is running timers O ticks is set to OxFFFF so this will never happen then The interrupt routine sets calllimer to 1 and eventHandler will execute It calls consolidate and all elapsed timers where ticks 0 An overflow when adding a new timer is detected For example a timer with 50000 ticks was added ticks has run up to 30000 and then a new timer with 40000 ticks comes in To get the correct offset for the timer it has to be added internally with 30000 40000 70000 ticks but that is greater than maximum integer value 65535 consolidate is called which decreases first timer to 20000 ticks to 0 the second timer is then added with 40000 ticks ScatterWeb inside 67 _consolidate reads ticks and subtracts the value from all timers i ticks or sets them to 0 if they are already smaller and ticks itself This is a safe way to synchronize with the interrupt and better than setting ticks to 0 because if ticks is just increased by the interrupt in between read and write the single tick will not get lost bool Timers init Function Parameter Return value Initialization of
30. transmission of sensor data communication with other systems using the same radio interface ESBs ESWs Sending and receiving of short messages SMS via connected mobile phone serial port Bluetooth connection available upon request standard for the EWS Just send the ESB an SMS triggering temperature monitoring every Tuesday morning from 7 00 a m until 11 43 a m if and only if there is movement in the room but no light it s possible with a single SMS Sending e g to control home entertainment devices and receiving e g from conventional remote controls of RC5 packets via infrared 12 ScatterWeb inside Periodic polling of sensor data and depending on settings automatic transmission via the radio interface the serial port terminal or mobile phone Simple and easy configuration and control of the ESB terminal commands over the serial interface or radio Software The software of the sensor nodes was first separated into two parts firmware amp application to provide in field programming via radio This has recently changed because that reprogramming strategy created several problems Now the whole thing except the reprogramming code which should not change anymore see progamming c is reprogrammable Anyway the separation between firmware and application is kept because it proved good as hardware abstraction layer and to provide some OS like concepts The Firmware provides abstract functions to inter
31. 14 r13 12 r1 1 r1 0 re r7 r6 restore stack pointer But this produced the same behavior like the first BUT instead of r11 being used it is now r5 which is even more worse r5 is the frame pointer and strangely used by gcc The compiler should never assume r5 is preserved over function calls very strange why it does that here even when r15 is appended to the list of clobbered registers Anyway it works with the second But that may change with O flags or anything else so best will be to put that into an extra function Make sure this function does not get inline into scos call again with fno inline for this file 60 ScatterWeb inside bool Threading init Function Initializes the threading Parameter None Return value code True code always bool Threading add void address Function Adds thread Parameter address address of task Return value code True code if successful lt code gt False lt code gt otherwise bool Threading doEvents Function Does events Parameter None Return value code True code always bool Threading sleep UINT16 ticks Function Sleeps for ticks Parameter ticks ticks to wait Return value code True code always bool Threading wait UINT8 adr UINT8 bitmask Function Waits until address bitmask Parameter adr address bitmask bitmask Return value code True code always bool Threading eventHandler
32. 82 define RADIO_RXBUF_SIZE 270 define RADIO_TXBUF_SIZE 400 define MAX_TIMERS 20 define MAX_TASKS 10 define INFOMEM attribute section infomem define INFOMEMNOBITS attribute section infomemnobits defin SET x y IF defin CLEAR x y amp y define 5 05 0x0001 define MF_RADIO_RX 0x0002 define MF_RADIO_TX 0x0004 define MF_TIMER 0x0008 define MF_SERIAL_RX 0x0010 define MF_SENSORS 0x0020 define MF_RC5 0x0080 define STARTUP_POR 0 define STARTUP_SWRESET eis define STARTUP_REPROGRAM 2 define STARTUP_PANIC define STARTUP_WATCHDOG 4 define STARTUP_KEYV 5 define STARTUP_UNKNOWN 6 46 ScatterWeb inside define WDS_RUNNING 01 define WDS_SWRESET 02 define WDS_REPROGRAM 0 03 define WDS_PANIC 0 04 define INIT FCS Oxffff define C SERIAL al define C_RADIO 2 define 5 50 3 define NUMBER_CALLBACKS 4 define MICIFG 0x01 define MICIE 0x02 define MICVOLTAGE ADC12MEM2 define EXTERNVOLTAGE ADC12MEM3 define BATTERYVOLTAGE ADC12MEM4 define RXPVOLTAGE ADC12MEM5 define BATTERYVOLTAGE ADC12MEM4 enum True 1 False 0 typedef char bool typedef union unsigned int u signed int s typedef unsigned char UINT8 typedef unsigned int UINT16 typedef unsi
33. Additionally a feature has been added to watch stack growth and detect a stack overflow For bad conditions like that a panic function has been added The firmware can disable the application if panic occurred An abstract printf like function has been implemented for string outputting String abstractWrite This is used by the functions String_write to write a string to memory Comm_print to write normal output to the serial port and Comm_log to write debug output to the serial port No other methods should be used for writing to the serial port sendRS232 is not public anymore This is because serial port output is now controlled via Comm logL evel It allows several log levels some debug bits for special debugging and total disabling of all output see ScatterWeb Comm h A cooperative scheduler exists to create simple task functions ScatterWeb Threading h The main super loop goes to sleep when everything is processed all things that need to be handled are interrupt driven see main Every interrupt which needs processing from the super loop wakes the processor up with WAKEUPLPM1 which also sets a flag runModule When all flags in runModule are reset after processing from super loop tasks the loop goes to LPM1 again If a function which needs calls as often as possible is added to the super loop you have to comment out the lines about sleeping Typedefs for UINT8 UINT16 UINT32 have been introduced because it is better sty
34. DIO Broadcasts events in a SENSOR PACKET So to get all sensors reported over serial link and radio do lt code gt ssm FF saf 03 lt code gt ScatterWeb inside 73 bool Event init Function Initializes the event handling Parameter None Return value code True code always 4 2 How to install An adapted GNU compiler for the MSP mspgcc is used for software development for the MSP430 Additional MSP430FreeTools from IAR can flash the code onto the board Furthermore the freely available editor PSPad enables project management compilation and flashing in a few simple steps scatterweb package directory tree Installers Installers for IARTools GNU compiler and PSPad only the installer for the IARTools is needed during the following installation msp430 Already prepared directory for the installation simply copy to C Sources Source code directory 1 Copy the directory MSP430 to C MSP430 2 Run the installer for the IARTools install to 5 430 Systems 3 Add 3 paths C MSP430 IAR Systems C MSP430 IAR Systems 430 bin C MSP430 mspgcc bin or append the following to the PATH variable C MSP430 IAR Systems C MSP430 IAR Systems 430 bin C MSP430 mspgcc bin You can find this at the following location My Computer Properties Advanced Environment Variables 4 Execute C MSP430 mspgcc giveio install_ giveio bat Driver needed running WinXP 2000 to directly acces
35. NG_NOCHILD 0x25 define ROUTING_ROOTPACKET 0x26 define ROUTING_TREEPACKET 0x27 define RSA_KEYREQUEST 0x28 define RSA_KEYREPLY 0x29 define DHCP_PACKET 0x30 define IS_RADIO_RECEIVING cdCounter define IS_RADIO_SENDING amp 0xC0 0x40 typedef struct UINT16 to PIS ScatterWeb inside UINT8 type UINT8 nun UINT8 header UINT16 header_length UN UINT16 data_length extern volatile packet t rxPacket extern packet t sentPacket extern volatile UINT8 txRetries extern volatile UINT8 cdCounter externi volat ise 0 92502 bool Net init bool Net on bool Net off bool Net setTxPower UINT8 value bool Net send packet packet fp char t callback bool Net rxHandler bool Net txHandler char Net esend packet t packet fp char t callback WELE The ScatterWeb Net implements a network service that enables you to develop applications that use network resources without worrying about the specific details of the individual protocol This file contains following functionality for radio Setting of transmit power in 100 steps Interrupt driven rx amp tx radio logic sending of packets with and random backoff CRC 16 checksums acknowledgement with automatic retransmission General Radio software supports ackn
36. art address of bytes to erase size size of bytes to erase code True code if erase successful lt code gt False lt code gt otherwise UINT8 IO read UINT16 e adr UINT8 r adr UINT16 size Function Parameter Return value Reads size bytes from the EEPROM uses sequential read faster than readEEPROMByte e adr start address of bytes to read r adr array to store read bytes size size of bytes to read UINT8 pointer of r adr bool IO write UINT16 e adr UINT8 r adr UINT16 size Function Parameter Return value Writes size bytes to the EEPROM uses sequential write faster than writeEEPROMByte e adr start address of bytes to write r adr array of bytes to write size size of bytes to write code True code if write successful lt code gt False lt code gt otherwise ScatterWeb inside 33 3 5 ScatterWeb Messaging ScatterWeb 2 x System src ScatterWeb Messaging h ifndef ScatterWeb_Messaging define ScatterWeb_Messaging define SERIALONLY 0x02 define COMMAND x flags void term_ x const UINT8 str __attribute__ section commands const command_t com_ x term_ x x flags void term_ x const UINT8 str typedef void fp term const UINT8 extern UINT8 term reply TERM BUFSIZE typedef struct command struct fp term function WAN UINT8 flags command_
37. code gt True lt code gt True if IR sensor available lt code gt False lt code gt otherwise bool Data RC5Enable Function Enables the RC5 Parameter None Return value code True code True if IR sensor available lt code gt False lt code gt otherwise 30 ScatterWeb inside bool Data_RC5Disable Function Disables the RC5 Parameter None Return value lt code gt True lt code gt True if IR sensor available lt code gt False lt code gt otherwise bool Data_RC5SendNEC UINT16 datal UINT16 data2 Function Sends a RC5 NEC command Parameter data1 data1 to send data2 data2 to send Return value lt code gt True lt code gt True if IR sensor available lt code gt False lt code gt otherwise bool Data_sensorHandler Function This member supports the ScatterWeb infrastructure and is not intended to be used directly from your code Parameter Return value void Data_RC5ReceiveHandler Function This member supports the ScatterWeb infrastructure and is not intended to be used directly from your code Parameter Return value void Data_RC5EventHandler Function This member supports the ScatterWeb infrastructure and is not intended to be used directly from your code Parameter Return value ScatterWeb inside 31 3 4 ScatterWeb IO ScatterWeb 2 x System src ScatterWeb IO h ifndef ScatterWeb_IO define ScatterWeb_IO
38. ction Enables the green LED Parameter None Return value code True code if green led available lt code gt False lt code gt otherwise bool Data greenOff Function Disables the green LED Parameter None Return value code True code if green led available lt code gt False lt code gt otherwise 26 ScatterWeb inside bool Data greenToggle Function Toggles the green LED Parameter None Return value code True code if green led available lt code gt False lt code gt otherwise bool Data redOn Function Enables the red LED Parameter None Return value code True code if red led available lt code gt False lt code gt otherwise bool Data redOff Function Disables the red LED Parameter None Return value code True code if red led available lt code gt False lt code gt otherwise bool Data redToggle Function Toggles the red LED Parameter None Return value code True code if red led available lt code gt False lt code gt otherwise bool Data yellowOn Function Enables the yellow LED Parameter None Return value code True code if yellow led available lt code gt False lt code gt otherwise ScatterWeb inside 27 bool Data yellowOff Function Parameter Return value Disables the yellow LED None code True code if yellow led available lt code gt False lt code gt otherwise boo
39. de 13 The terminal software has been moved to the firmware as many commands between devices were the same Command creation has changed and most commands are executable from a remote device with reply Commands can now be placed where they are needed Macros and a special section in flash build a table to automatically search all commands See ScatterWeb Messaging h Light sensor software has been removed due to complex handling Timer slots are also needed for constant dco checking amp adjusting ScatterWeb Timers h and a software RTC ScatterWeb Time h as the RTC is mostly abandoned because of its big current usage it s only used as an well calibrated temperature sensor ScatterWeb System h ScatterWeb Time h represents the new software RTC see currentTime ScatterWeb System h has been completely cleared only the function for reading the temperature and ensuring RTC 32 kHz output at initialization are left fiveMsTimer is replaced through currentTime or use of timers ScatterWeb Timers h its still left for internal timer use ScatterWeb Timers h module has been added no need to poll for an elapsed time anymore ScatterWeb System h includes DCO checking so DCO is recalibrated the whole time not at startup only Other modules have been more separated ScatterWeb Configuration h was in ScatterWeb IO h programming h was in flasher h The watchdog has been rewritten It s now correct and possible to see where a reset came from
40. e c Substitute goods or services loss of use data or profits or ScatterWeb Time h business interruption however caused and on any theory of liability Scatterweb Timers c ScatterWeb Timers h akefile whether in contract strict liability or tort including negligence or otherwise arising in any way out of the use of this software even if advised of the possibility of such damage 18 18 18 110 8 82 10 8 189 89 10 8 180 v2 n9 180 0 vg 80 n 189 19 50 18 lt gt This implementation was developed by the CST group at the FUB Log Suchergebnisse Dateisuchergebnis FTP B make 1 Leaving directory cygdrive c ScatterWeb 2 2 System bin ESB I msp430 gee Wall nmcu smsp430x149 fno defer pop D ESB g O c src ScatterWeb Process c o bin ScatterWeb Process o msp430 gcc Wl Map out out map cref Wl T System ldscript x WU Wall mmcu msp430x149 g O o out out elf System bin ESB Scatt msp430 objcopy ihex out out elf out out hex msp430 size out out elf text data bss dec hex filename 1 34872 4 1391 36267 Sdab out out elf ROM usage is text data RAM usage is data bss lt 1 1 1 103 38171 1 47 2F 005 Eigenen Compiler starten 76 ScatterWeb inside 4 5 How to flash atterWeb 2 2 Appli Datei Projekte Bearbeiten Suchen Ansicht Format Werkzeuge HTML Ei
41. eper on otherwise off ScatterWeb Messaging scf set standard configuration ScatterWeb Configuration Sco read tasks ScatterWeb Threading set firmware flags sff X wer ScatterWeb Configuration 01 FF PROGRAMMABLE 02 or a combination of this values sfr X set receive limit ScatterWeb Messaging sid X set id to x ScatterWeb Configuration ScatterWeb inside 79 sir send x over RC5 ScatterWeb Messaging slb set boot log level Valid values are 01 NO 02 LOW 03 MEDIUM 04 HIGH 05 VERBOSE 20 DEBUG_SYNC 40 DEBUG_DCO 80 DEBUG_RADIO or a combination of this values ScatterWeb Configuration slg if x 1 set green led on otherwise off ScatterWeb Messaging slo set log level Valid values are 01 NO 02 LOW 03 MEDIUM 04 HIGH 05 VERBOSE 20 DEBUG_SYNC 40 DEBUG_DCO 80 DEBUG_RADIO or acombination of this values ScatterWeb Configuration slr if x 1 set red led on otherwise off ScatterWeb Messaging if x 1 set yellow led on otherwise off ScatterWeb Messaging spf set panic flags Valid values are 01 PANIC_ON_STACK_OVERFLOW 02 PANIC_ON_FULL_TIMERS ScatterWeb Configuration 80 ScatterWeb inside 04 PANIC_ON_BAD_RESET 80 PANIC_DISABLES_APP or a combination of this values set sensor mask to x Valid values are 01
42. ery beginning of main just after initPort It checks some registers to see where the reset came from and then sets wd_startup accordingly 50 ScatterWeb inside Technical details of wd_init The MSP internally has two reset signals slau049 pdf Chapter 3 POR power on reset This is a device reset Set by Power Up or a low RST line when configured in reset mode standard power up clear follows every POR But it can occur also without because of watchdog timer expiry or flash control register key violation The SFRs are initialized on resets and some bits get only set or reset when a POR occurred not on a PUC only these in braces see slau049 pdf page 3 4 This feature is used by wdt init with the register TACTL to detect a POR since it will only get reset complete zero if a POR occurred If a PUC only occurred it was a warm start The function looks further whether it was the WDT Flash key violation or an unknown source If it was a Flash key violation it is checked with var wd_state whether it was wanted by software System_reset with wd_state WDS_SWRESET or System_panic with wd_state WDS_PANIC or a real key violation Stack checking wd_stackCheck is a small function which once called by main runs once every second with a timer It checks 8 bytes on top of the data segment behind __noinit_end provided by the linker script for corruption The reset vector in main fills the memory
43. face and use the hardware contains the main execution loop interrupts and provides some OS like concepts The firmware supports all ScatterWeb MSP430 devices ESB and EYE eGate ECR The application userapp program is built on top of the firmware Directory tree Applications Contains application directories with PSPad project files System Contains firmware sources and binaries Major Changes Firmware and userapp are not that strictly separated anymore This made reprogramming easier and all restrictions from the old firmware lt gt userapp separation are gone Reprogramming code is now in programming h flasher h contains the radio transfer of code images For simplicity all 3 firmwares from ESB EYE eGate and ECR have been integrated into one with the use of ifdef at some hardware dependent places When compiling the command line one must always define one of ESB eGate ECR EYE This is done in the makefiles with the variable DEVICE The makefiles are now taking every source file they see in the directories and don t need to be changed for new removed files anymore Look into the makefiles and at new directory structure Radio software has changed Sending is now also done interrupt driven and comes with a ring buffer to store several packets to send Additional new features are 16 checksums and automatic acknowledgements except broadcasts with feedback to the sender of every packet ScatterWeb insi
44. ging pan x set panic flag x ScatterWeb Messaging pel clear panic and reset system ScatterWeb Messaging png x send ping packet to x ScatterWeb Messaging read reason ScatterWeb Configuration raf read announce flags ScatterWeb Event rbu read button state ScatterWeb Messaging rcf read configuration ScatterWeb Configuration rer Xy read eeprom from x to y ScatterWeb IO rff read firmware flags ScatterWeb Configuration rfl xy read flash from x to y ScatterWeb IO rfr read receive limit ScatterWeb Messaging 78 ScatterWeb inside rid read id ScatterWeb Configuration rlb read boot log level ScatterWeb Configuration rig read green led state ScatterWeb Messaging rlo read log level ScatterWeb Configuration rlr read red led state ScatterWeb Messaging rly read yellow led state ScatterWeb Messaging rmm read microphone value ScatterWeb Messaging rpf read panic flags ScatterWeb Configuration rrp read temp rxp ScatterWeb Messaging rsm read sensor mask ScatterWeb Event rsp read stack pointer ScatterWeb Messaging RST reset system ScatterWeb Messaging rtp read transmit power ScatterWeb Messaging rtt read temperature ScatterWeb System rvb read battery value ScatterWeb Messaging rve read extern value ScatterWeb Messaging set announce flags saf x Mora aud NOR ScatterWeb Event 01 AF SERIAL 02 AF RADIO or a combination of this values sbp X if 1 be
45. gned long UINT32 typedef void typedef void typedef void typedef void typedef void 0 Foy CUBO Ww 8 Bom Chanel 00 21 int t UINT16 extern fp_vp callbacks extern volatil extern volatil extern volatil if defined ES e UINT16 runModule e UINT16 rxpTemp e UINT16 rxpValue B extern volatile UINT8 MIC temp_t ScatterWeb inside 47 bool System registerCallback UINT8 type void fp t 0 temp t System getTemperature bool System setDCO bool System startWatchdog bool System stopWatchdog bool System reset const UINT8 System resetReason Sy ite ceg Bg UINT8 System panicReason UINT16 n bool System panicClear bool System wait UINT32 w bool System waitA UINT16 i bool System powerOn bool System powerOff UINT16 System reprogram bool System startConversion include lt msp430x14x h gt include lt io h gt include lt signal h gt include lt stdlib h gt include lt stdarg h gt if defined ECR include lib ecr programming h include lib ecr flasher h lif defined ESB include lib esb programming h include lib esb flasher h
46. h notice this list of conditions and the following disclaimer in the ScatterWeb ID c documentation and or other materials provided with the distribution ScatteiWeb ID h ScatterWeb Messaging c ScatterWeb Messaging h ScatterWeb Net c ScatterWeb Net h Scatterweb String c Neither the name of Freie Universitaet Berlin FUB nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission 12 5 59 5 59 15 59 59 50 59 59 SJ 50 59 SJ 59 15 59 59 8 59 5 9 5 Scatteiweb Stiingh This software is provided by FUB and the contributors on as is ScattelWeb Synchronisation c basis without any representations or warranties of any kind express ScatterWeb Synchronisation h or implied including but not limited to representations or ScatterWeb System c warranties of non infringement merchantability or fitness for a ScatterWeb System h particular purpose In event shall FUB or contributors be liable ScatterWeb Threading c for any direct indirect incidental special exemplary or Scatterweb Threading h consequential damages including but not limited to procurement of ScatterWeb Time c Substitute goods or services loss of use data or profits or Scatterweb Time h business interruption however caused and on any theory of liability Scatterweb Timers c whether in contract strict liability or tort including negligence a ScatterWeb Ti
47. ically access configuration settings The configuration consists of the struct config_t defined ScatterWeb Configuration h The variable Configuration is of that type and represents the current config in RAM and can be accessed directly every time Changes to Configuration will only be made ScatterWeb inside 19 permanent power off amp resets with a call to Configuration_save which copies the content of the Configuration to EEPROM EADR_CONFIG Initial loading from EEPROM EADR_CONFIG is done by Configuration_init and has to be called on initialization in main First time configuration Uncomment the following definition of firstTimeConfig and it will get laid into Infomem 0x1000 0x1100 see hex File Before Configuration_init loads the regular config from EEPROM it checks if the first int which corresponds to the id in Infomem is not OxFFFF If it is not it copies the configuration from Infomem to EEPROM clearing Infomem afterwards and loading the newly written data from EEPROM to Configuration bool Configuration init Function Initializes configuration settings for the configuration section Parameter None Return value code True code always bool Configuration save Function Saves configuration settings for the configuration section Parameter None Return value code True code always bool Configuration print Function Prints configuration settings for the configuration section
48. ime t time Function Reads broken down time as a string The format is the same as in Time_writeTime but the year must be written without 2000 The number of digits is not fixed like in Time_writeTime so it is ok to write 03 09 07 08 31 02 or 3 9 7 8 31 2 Parameter c array to store time time time to read Return value lt code gt True lt code gt always 66 ScatterWeb inside 3 12ScatterWeb Timers ScatterWeb 2 x System src ScatterWeb Timers h ifndef ScatterWeb_Timers define ScatterWeb_Timers include ScatterWeb System h typedef void fp timer UINT16 0 8 bool Timers_add UINT16 ticks fp_timer fp UINT16 data bool Timers_reset UINT16 t fp_timer fp UINT16 data bool Timers_remove fp_timer fp UINT16 data bool Timers eventHandler The ScatterWeb Timers provides the Timer component which allows you to raise an event on a specified interval The Timer component is a hardware based timer which allows you to specify a recurring interval at which the Elapsed event is raised in your application You can then handle this event to provide regular processing Software timers With theses function you can implement delays asynchronously Just give a time and a pointer to a function which should get called when the time has elapsed The timer entries are kept in a fixed size array MAX_TIMERS
49. inks collecting data Nodes may act in all three roles at the same time The ESBs developed by the CST Group forms a sound basis for research in sensor networks the development of university level courses in CS EE based on real hardware and prototyping of sensor net applications The ESBs are part of the ScatterWeb approach comprising a whole family of embedded web servers sensors and actors Typical communication scenarios of sensor networks based on the ESBs are ESBs communicate via the serial port with a standard PC for application development ESBs communicate with mobile phones via the serial port to connect to wide area mobile phone networks This enables remote configuration of ESBs via short messages SMS as well as reception of sensor data on arbitrary mobile phones world wide ESBs communicate via their radio interface with other ESBs or an embedded web server EWS to form a truly embedded highly flexible sensor network solution Main components of the ESB are the sensors a micro controller for processing of all data and a transceiver handling communication with other nodes Software for the following features is already available for the ESB 430 Configuration and analysis of all sensor data vibration noise movement temperature infrared luminosity Control of peripherals timer transceiver serial port EEPROM IR send receive LEDs beeper switches Sending and receiving of data packets via the radio interface
50. ints an UINT16eger in decimal format l Prints an UINT32eger in decimal format 9ob Prints a byte in hex format x Prints an int in hex format Parameter writer function to write fmt function argp list of arguments Return value code True code always bool String write UINT8 dest const char fmt Function Writes Parameter dest dest fmt function list of parameters Return value code True code always UINT16 String parseInt const UINT8 c UINT8 ptr Function Parses int Parameter ptr ptr Return value parsed int UINT32 String parseLongInt const UINT8 UINT8 ptr Function Parses long int Parameter ptr ptr Return value parsed long int ScatterWeb inside 43 3 8 ScatterWeb Synchronisation ScatterWeb 2 x System src ScatterWeb Synchronisation h ifndef ScatterWeb_Synchronisation define ScatterWeb_Synchronisation define ROOT_TIMEOUT 5 define FRAME_LENGTH 3 define INIT_LENGTH 4 strace UINT8 seqNum UINT16 masterRootId UINT8 syncPeriods EXE kboolssynehrenissae eneinmeor bool Synchronisation_isRoot bool Synchronisation_registerSyncDone void t bool Synchronisation doSync dE The ScatterWeb Synchronisation represents the synchronisation bool Synchronisation init Function Initializes the synch
51. ize 7154 1e 42 5006 mov amp 0x0650 r14 0x0650 7158 3b 40 5406 mov 41620 rid 40x0654 718a bO 12 42 71 call 28994 7142 asm _ mov amp savedSP r1 restore stack pointer Tasks currentTask address 0x0000 718e 1e 42 50 06 mov amp 0x0650 r14 0x0650 71a0 Of 5b add 111 r15 71a2 8 43 00 00 mov 0 O r15 r3 As 00 Tasks currentTask state T DESTROYED 71b8 Of 5b add r15 71ba 8 43 04 00 mov 0 4 r15 r3 As 00 ScatterWeb inside 59 That is bad At the beginning the base address of Tasks is moved into r11 for reading out of the table for the scos_prolog call r11 is later after scos_prolog call used to index into Tasks again and the compiler can assume that r11 did not change according to normal calling conventions but that may be wrong in this case When the following instruction is used the compiler omits the add r11 r15 and addresses the table directly asm volatile mov amp savedSP r1 restore stack pointer 718e 1142 4a 06 mov amp 0x064a r1 0x064a Tasks currentTask address 0x0000 71a4 8 43 5406 mov 0 1620 r15 r3 As 00 Tasks currentTask state T DESTROYED 71ba 8 43 5806 mov 0 1624 r15 r3 As 00 don t know why the compiler does that thing not always this way it saves on instruction tried to force it by telling all registers get clobbered through this instruction asm volatile mov amp savedSP 1 r15 r
52. l Data yellowToggle Function Parameter Return value Toggles the yellow LED None code True code if yellow led available lt code gt False lt code gt otherwise bool Data microphoneOn UINT16 delay UINT16 diff Function Parameter Return value Enables the microphone sensor delay delay of measurement diff diff of measurement code True code if microphone sensor available lt code gt False lt code gt otherwise bool Data microphoneOff Function Parameter Return value Disables the microphone sensor None code True code if microphone sensor available lt code gt False lt code gt otherwise bool Data movementOn UINT16 delay Function Parameter Return value Enables the movement sensor delay delay of measurement code True code if movement sensor available lt code gt False lt code gt otherwise 28 ScatterWeb inside bool Data movementOff Function Parameter Return value Disables the movement sensor None code True code if movement sensor available lt code gt False lt code gt otherwise bool Data temperatureOn UINT16 interval UINT16 range UINT16 diff UINT16 spd Function Parameter Return value Enables the temperature sensor interval interval of measurement range range of measurement diff diff of measurement spd spd of measurement code True code if temperatu
53. le and much shorter 14 ScatterWeb inside Important things to know All routines should return fast If a routine occupies the processor for long time for example outputting a long text which works with the blocking sendRS232Char function it should call System_startWatchdog repeatedly normally done main to avoid a watchdog reset If a watchdog reset occurs the firmware will disable the programm if PANIC_DISABLES_USERAPP is set You don t need to change the makefiles anymore Makefiles in firmware and application automatically compile every c file in the src directories and look into every c and h file for changes No initialization of global values is done You can write UINT16 var 49 but var will never be initialized do initialization in code Initialization may work again if the standard startup routine is used Don t use dynamic memory allocation malloc free Dynamic memory allocation bears the following problems on MCUS o Much harder to debug o Unknown behavior at compile time o Memory fragmentation and no way missing MMU to defragment it o No memory protection between stack and heap which grow towards each other o Additionally current msp430 gcc malloc implementation seems to be buggy Sometimes an embedded engineer said Think small on MCUs If you are planning to use dynamic memory allocation you are thinking much too BIG f weird things happen look into linker map
54. ll other headers The firmware provides abstract functions to interface and use the hardware contains the main execution loop interrupts and provides some OS like concepts The firmware supports all ScatterWeb MSP430 devices ESB EYE eGate ECR The first reprogramming concept which produced the firmware application separation was abandoned for two main reasons It relied on a stable almost never changing firmware At the moment this is absolutely wrong and it s questionable if it will ever be relied on the compiler linker to produce always the same assembler output for the firmware when it gets always the same sources object files This was only partially right it depended on too many factors compiler version compiler flags even the machine the compiler is running on and could be wrong under other or future conditions Perhaps one needs to write his own compiler linker or at least modify an existing one to really separate these two software parts on a MCU cleanly 52 ScatterWeb inside bool System registerCallback UINT8 type void fp_t Function Registers callback Parameter type type of callback function to call Return value lt code gt True lt code gt always temp t System getTemperature Function Returns temperature Parameter None Return value current temperature bool System setDCO Function Sets DCO Parameter None Return value code True code always bool Sys
55. ments Each preemptive OS requires and most cooperative OS use one stack per task Exceptions seen 50 far 5 in the EYES Project which preempts only lower priority tasks and lets them reside at the stack while executing a higher priority task and Salvo which seems to implement a very similar approach To have a stack for each task increases memory requirements a lot because the size of the stack for a task is unknown and must be generously set The optimum would be the maximum stack depth of the task call tree A compiler could easily calculate this if recursion and function pointers are not used but i do not know if any compiler supports this feature The second bad is that most times a task won t use its maximum stack depth In contrast to theses approaches this mechanism uses no memory only some static allocated memory for task table and a little bit of stack space like in every other function is needed This puts some limits onto the task functions to make this possible Task functions can t and should never allocate stack space In fact you can allocate stack space and the scheduler will handle it properly that was needed for calls with long argument list which get pushed onto the stack but after a Threading_ call the stack content will always be undefined That means that all state must be held in vars declared globally Additionally they should be declared volatile so the compiler won t do any optimization on them hold them
56. mers h or otherwise arising in any way out of the use of this software even makefile if advised of the possibility of such damage This implementation was developed by the CST group at the FUB For documentation and questions please use the web site http scatterweb mi fu berlin de and the mailinglist scatterweb lists spline inf fu berlin de subscription via the Website Berlin 2005 include ScatterWeb Event h include System src ScatterWeb System h void Process _interceptRadioHandler void Process radioHandler if i IirvDenber RDOANCAGT II ryvDenter Configuration idi 1 1 103 3817 1 8 C DOS Kodierung ANSI Windows ScatterWeb inside 75 20 4 4 How to compile atterWeb 2 2 Appli Datei Projekte Bearbeiten Suchen Ansicht Format Werkzeuge HTML Einstellungen Fenster Hilfe spg 0 0 03108076 52 gt am ScatterWeb Process c amp le x 1 NET IE an Copyright 2005 Freie Universitaet Berlin All rights reserved These sources were developed at the Freie Universit t Berlin Computer APP an Scala ab Event Systems and Telematics group ScatterWeb Eventh ScatterWeb Process c Redistribution and use in source and binary forms with or without Sue modification are permitted provided that the following
57. nstellungen Fenster Hilfe 0 2 uu 0 ScatterWeb Process c 8 a 88 1 4 0 52 25 42 69 0 10 30 40 50 60 70 80 1 1 1 i 1 n 1 1 1 i 1 1 n 1 1 1 amp 3 APP E Scatterweb Event c E Scatterweb Event h ScatterWeb Process c Scatterweb Comm c Scatterweb Comm h ScatterWeb Configuration c Scatterweb Configuration h ScatterWeb Data c ScatterWeb Data h ScatterWeb lO c ScatterWeb lO h ScatterWeb Messaging c Scatterweb Messaging h ScatterWeb Net c ScatterWeb Net h Scatterweb String c Scatterweb String h ScatterWeb Synchronisation c ScatterWeb Synchronisation h ScatterWeb System c Scatterweb System h ScatterWeb Threading c Scatterweb Threading h ScatterWeb Time c ScatterWeb Time h Scatterweb Timers c ScatterWeb Timers h akefile 18 18 18 110 8 82 10 8 189 89 10 8 180 v2 n9 180 0 vg 80 n 189 19 50 18 lt Copyright 2005 Freie Universitaet Berlin All rights reserved These sources were developed at the Freie Universit t Berlin Computer Systems and Telematics group Redistribution and use in source and binary forms with or without modification are permitted provided that the following conditions are met Redistributions of source code must retain the above copyright notice this list of conditions and the following disclaimer Redi
58. out map Sometimes compilation fails or hangs with existing objects files from another machine Do a make clean or simply delete all object o files in firmware and userapp directories in this situation ScatterWeb inside 15 3 1 ScatterWeb Comm ScatterWeb 2 x System src ScatterWeb Comm h ifndef ScatterWeb_Comm define ScatterWeb_Comm define BPS_2400 0x01 define BPS_14400 0x02 define BPS_19200 0x03 define BPS_38400 0x04 define BPS_57600 0x05 define BPS_115200 0x06 UINT8 Comm logLevel bool Comm init UINT8 bps C enam ec haa 5 bool Comm log UINT8 level const char fmt bool Comm on bool 07 bool Comm registerByteLevel fp char t fp ndif The ScatterWeb Comm represents the standard output for applications The init function for the UART Comm init provides setup for all standard baud rates BPS 2400 BPS 14400 BPS 19200 BPS 38400 5 57600 5 115200 UART communication should be done with Comm_print Comm_log as the serial output with this functions is controlled via Com logLevel and struct Configuration boot 1001 in ScatterWeb Configuration All sending functions are blocking Receiving is handled by an interrupt and you can choose byte access or line access byte acces
59. owledgements so it is important to know that all packet types which are no broadcast will get acknowledged by radio software and get repeated several times if needed The radio software uses the num field for acknowledged packets to recognize doubles packet_t is a struct containing 38 ScatterWeb inside a packet header fields and pointers to packet data and is used for sending amp receiving As a packet may be often constructed out of a header portion and a data portion packet_t supports two data pointers to get passed in for sending so these portions don t need to be copied together When receiving however data pointer contains header and data consecutively and header and header length are null How to receive packets To receive packets of a specific type one must define a handler function and add it to Net_txHandler for firmware handlers or to the C_RADIO app callback function When the handler is then called the function can access the received packet in rxPacket How to send packets For sending packets a packet_t must be initialized to must contain the destination id of receiver or broadcast address type must contain the packet type header data must be set to NULL or to the data that should get transported If set header_length data_length should contain the length of the data can be set to transport a byte for not acknowledged packets otherwise it will get overwritten from is always overwritten
60. re sensor available lt code gt False lt code gt otherwise bool Data temperatureOff Function Parameter Return value Disables the temperature sensor None code True code if temperature sensor available lt code gt False lt code gt otherwise bool Data vibrationOn UINT16 delay Function Parameter Return value Enables the vibration sensor delay delay of measurement code True code if vibration sensor available lt code gt False lt code gt otherwise bool Data vibrationOff Function Parameter Return value Disables the vibration sensor None code True code if vibration sensor available lt code gt False lt code gt otherwise ScatterWeb inside 29 bool Data greenLed Function Returns the state of the green LED Parameter None Return value code True code if green Led is switched on lt code gt False lt code gt otherwise bool Data redLed Function Returns the state of the red LED Parameter None Return value code True code if red Led is switched on lt code gt False lt code gt otherwise bool Data yellowLed Function Returns the state of the yellow LED Parameter None Return value code True code if yellow Led is switched on lt code gt False lt code gt otherwise bool Data RC5SendPHI int data Function Sends a RC5 PHI command Parameter data data to send Return value lt
61. ronisation not started by system Parameter None Return value lt code gt True lt code gt always bool Synchronisation isRoot Function Checks if node is currently the root Parameter None Return value code True code if node is root lt code gt False lt code gt otherwise bool Synchronisation registerSyncDone void fp_t Function Registers a function which is called if the sync ends Parameter function to call Return value code True code always 44 ScatterWeb inside bool Synchronisation doSync Function This member supports the ScatterWeb infrastructure and is not intended to be used directly from your code Parameter Return value ScatterWeb inside 45 3 9 ScatterWeb System ScatterWeb 2 x System src ScatterWeb System h ifndef ScatterWeb_System define ScatterWeb_System define WAKEUPLPMI irgname bit do N asm Volo 50 Prene V Mei Us EOS runModule bit while 0 if defined ESB defined eGate defined ECR error No device specified ECR ESB eGate ndif define TERM_BUFSIZE 82 define SERIAL BUFSIZE
62. s To gain access to the byte level register a function that expect to get pas UINT8 as parameter see Comm registerByteLevel fp char t fp line access To gain access to the line level register a function that expect to get pass an void as parameter see C SERIAL and System registerCallback UINT8 type void fp t If the line is handled the receiving function should call Comm clear 16 ScatterWeb inside bool Comm_init 8 bps Function Parameter Return value Initializes the serial bps the bps to be set lt code gt True lt code gt always bool Comm_print const char fmt Function Parameter Return value Sends bytes of data fmt function list of parameters code True code if serial is on lt code gt False lt code gt otherwise bool Comm log UINT8 level const char fmt Function Parameter Return value bool Comm on Function Parameter Return value bool Comm off Function Parameter Return value Sends bytes of log data level log level fmt function list of parameters code True code if serial is on lt code gt False lt code gt otherwise Switches the serial on None code True code always Switches the serial off None code True code always ScatterWeb inside 17 bool Comm registerByteLevel fp char t Function Registers byte level and will be set b
63. s of the clock have been removed due to high current usage while reading the clock Furthermore a software RTC has been implemented with a much finer resolution see ScatterWeb Time c The RTC is now only used as an well calibrated temperature sensor and only these functions remain here for complete clock interfacing code look into attic directory cl_start cl_stop cl_writeOnBus cl_readFromBus are the basic functions for interfacing the RTC 2 like bus Ports ESB EYE clockSDA P50 clockSCL P51 clockAlarm P15 Note The sticks have no RTC and the ECR has the LM71 temperature sensor which is also realized in this file CRC This file offers CRC calculation DCO Initializing amp Controlling the DCO Digitally Controlled Oscillator ScatterWeb inside 49 If FF DCOCHECKER in config t firmwareFlags is set Timers init will add a timer every 100 ms for checkDCO and enable Timer B1 interrupt The interrupt continually measures the ACLK with the DCO like in System setDCO and writes the result into dcoDiff checkDCO takes samples every 100 ms of dcoDiff and adjusts the DCO if needed As the DCO is temperature sensitive and both serial and radio communication depend on the DCO calibrating the DCO continuously is recommended Serial communication stops working at a temperature difference of 10 C A more low power option might be to not use checkDCO and just call System setDCO in long intervals a minute or even longer
64. s the parallel port otherwise the gdb proxy will not run 74 ScatterWeb inside Usage After starting PSPad you can open the project files with a double click The rightmost button in the tool bar starts the compilation The second rightmost button with the selection flash can flash the project For debugging please start start gdb first second rightmost button then execute run insight If you add new files please don t forget to add them to the Makefile too 4 3 How to use Datei Projekte Bearbeiten Suchen Ansicht Format Werkzeuge HTML Einstellungen Fenster Hilfe m t 6 0 A 55A 276 3 cx ScatterWeb Process c 6 eio tgo Copyright 2005 Freie Universitaet Berlin All rights reserved 188 ESB These sources were developed at the Freie Universit t Berlin Computer Systems and Telematics group Scatterweb Event c group Scatterweb Event h E Scatterweb Process c Redistribution and use in source and binary forms with or without LIB modification are permitted provided that the following conditions are EOS met Scatterweb Comm c Scatterweb Comm h Redistributions of source code must retain the above copyright ScatterWeb Configuration c notice this list of conditions and the following disclaimer ScatterWeb Configuration h Scatterweb Data c Redistributions in binary form must reproduce the above copyright ScatterWeb Data
65. stributions in binary form must reproduce the above copyright notice this list of conditions and the following disclaimer in the documentation and or other materials provided with the distribution Neither the name of Freie Universitaet Berlin FUB nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission This software is provided by FUB and the contributors on as is basis without any representations or warranties of any kind express or implied including but not limited to representations or warranties of non infringement merchantability or fitness for a particular purpose In no event shall FUB or contributors be liable for any direct indirect incidental special exemplary or consequential damages including but not limited to procurement of Substitute goods or services loss of use data or profits or business interruption however caused and on any theory of liability whether in contract strict liability or tort including negligence or otherwise arising in any way out of the use of this software even if advised of the possibility of such damage This implementation was developed by the CST group at the FUB m clean 9 fl AIt F9 start gdb Shift F9 run insight scatterflash 120 Log Suchergebnisse Dateisuchergebnis FTP msp430 size out out elf text data bss lt
66. t bool Messaging_on void Messaging serialHandler bool Messaging requestHandler bool Messaging answerHandler bool Messaging requestDataHandler UINT8 data ndif The ScatterWeb Messaging provides functions that allow you to connect to monitor and message on the network and send receive or peek messages Control the MSP via RS232 or radio with simple ASCII commands Remote command execution To issue an command over radio write id answers will get id prep ended 285 rid 85 85 285 tim 85 23080608 984 2001 09 25 03 16 48 34 ScatterWeb inside Command creation Use the COMMAND macro to easily create a new terminal command The first argument to the Macros is always the three digit terminal command code The second argument to the Macros is a 8bit flag field For example the following COMMAND 0 print test r n will evaluate to void term xxx const str attribute section commands const command t com xxx term xxx xxx 0 void term xxx const UINT8 str print test r n Besides creating the function header it first creates a forward declaration which is then needed in the following definition of a const command t com xxx struct in the commands segment com xxx contains a pointer to the function the three digit function code and a flag field Because all those command t entries are put into a special segment commands
67. tem startWatchdog Function Starts watchdog Parameter None Return value code True code always bool System stopWatchdog Function Stops watchdog Parameter None Return value code True code always bool System reset Function Resets System Parameter None Return value code True code always const UINT8 System resetReason Function Checks the reset Parameter None Return value pointer of reset message ScatterWeb inside 53 bool System panic const char fmt Function Sets panic flag Parameter fmt panic to set parameters to set Return value code True code always UINT8 System panicReason UINT16 n Function Checks panic flag Parameter n panicReason n Return value pointer of the panic messages bool System panicClear Function Clears the panic flags Parameter None Return value code True code always bool System wait UINT32 Function Waits A simple looping waiting function Rough estimate at 2 4576 MHz w 1 gt 18us w 10 gt 62us w 100 gt 500us w 400 gt 4ms This method has two big disadvantages it blocks and it s not accurate timers are better Parameter ticks to wait Return value lt code gt True lt code gt always bool System waitA UINT16 i Function Waits which is more precise than wait because it uses TimerA to produce its interval also blocking Parameter ticks to wait
68. the CPU to store the return addresses of subroutine calls and interrupts It uses a pre decrement post increment scheme The advantage of this scheme is that the item on the top of the stack is available The SP can be used by the user software PUSH and POP instructions but the user should remember that the CPU also uses the SP Figure 5 2 shows the system SP bits Call a subroutine CALL dst SP 2 SP PC42 stack dst Return from subroutine RET MOV SP PC fno defer pop Always pop the arguments to each function call as soon as that function returns For machines which must arguments after a function call the compiler normally lets arguments accumulate on the stack for several function calls and pops them all at once Perhaps a cleaner and more portable but also more memory consuming implementation would be possible with setjmp longjmp macros 58 ScatterWeb inside Helper for scos_call Had to be put into an extra function because of following problem The following instruction mov amp savedSP r1 is not really needed because if execution returns here the stack pointer should be what we saved before The important thing is to tell the compiler that the usually caller preserved registers r6 r11 may have changed The problem is the indexing into the Tasks table If following line is omitted the assembler output is scos prolog value Tasks currentTask address Tasks currentTask stackS
69. to be used directly from your code Parameter Return value ScatterWeb inside 63 3 11 ScatterWeb Time ScatterWeb 2 x System src ScatterWeb Time h ifndef ScatterWeb_Time define ScatterWeb_Time include ScatterWeb System h define CURRENT_TIME extern volatile time_t currentTime 0 A A NOE time currentTime ume g time define CURRENT_TIME_SECS EM volerie tins Chace tans UINT32 secs y N secs currentTime secs secs typedef struct UINT8 year UINT8 month UINT8 day UINT8 hour UINT8 min UINT8 sec btime t typedef struct UINT32 secs BIS 585 alle 428 64 ScatterWeb inside time_t Time_getSystemTime time_t time bool Time_setSystemTime time_t time bool Time_convertSystemTime const time_t src btime_t dst bool Time_convertTime const btime_t src time_t dst bool Time_writeTime fp_char_t writer btime_t time Io GINA I e ndif The ScatterWeb Time represents an instant in time typically expressed as a date and time of day This file keeps the global time of this node in the global var currentTime It contains methods for writing reading and con
70. verting currentTime To avoid concurrency problems accessing currentTime must be done with disabled interrupts or in interrupt routines only This defines some macro for accessing Time currentTime safely time Time getSystemTime time time Function Read currentTime or safely with disabled interrupts Easier and also faster to use is CURRENT TIME time t time CURRENT TIME lt gt timet time getCurrentTime amp time Parameter time current time struct to store system time Return value pointer of time bool Time setSystemTime time time Function Write currentTime or safely with disabled interrupts Parameter time current time to set Return value code True code always bool Time convertSystemTime const time src btime dst Function Converts time to broken down time Parameter src input current time dst output btime Return value code True code always ScatterWeb inside 65 bool Time_convertTime const btime_t src time_t dst Function Converts broken down time to time Parameter src input time dst output current time Return value lt code gt True lt code gt always bool Time_writeTime fp_char_t writer btime_t time Function Writes broken down time as a string in the form yyyy mm dd hh mm ss Parameter writer function to write time time to write Return value lt code gt True lt code gt always bool Time_readTime const UINT8 bt
71. with the id of this device Such a packet can then be queued into tx ring buffer with Net_send and a pointer to initialized packet_t Additionally these two functions accept a callback pointer to functions which accept an If set this callback is called when the packet is removed from the tx ring buffer For unacknowledged packets this is after sending the packet For acknowledged packets this is after successfully receiving an ACK for this packet callback argument is set to 1 or when all retries are made without success callback argument is set to 0 The callback function can check the variable txRetries to see how much retries it took always 0 for unacknowledged packets ScatterWeb inside 39 bool Net init Function Initializes the radio Parameter None Return value code True code always bool Net on Function Enables the radio Parameter None Return value code True code always bool Net off Function Disables the radio Parameter None Return value code True code always bool Net setTxPower UINT8 value Function Sets the transceiver power Parameter value tx power to set Return value code True code if value are between 0 and 100 lt code gt False lt code gt otherwise bool Net send packet t packet fp char t callback Function Sends a packet over radio Parameter packet packet to send callback will call after sending without use NULL
72. y Comm init UINT8 bps Parameter Fp pointer of function Return value code True code if ECR or ESB defined lt code gt False lt code gt if eGate defined bool Comm clear Function This member supports the ScatterWeb infrastructure and is not intended to be used directly from your code Parameter Return value 18 ScatterWeb inside 3 2 ScatterWeb Configuration ScatterWeb 2 x System src ScatterWeb Configuration h ifndef ScatterWeb_Configuration define ScatterWeb_Configuration define EADR_CONFIG 0 0 00 define DEBUG_RADIO 0x80 define DEBUG_DCO 0x40 define DEBUG_SYNC 0x20 define NO 0x01 define LOW 0x02 define MEDIUM 0x03 define HIGH 0x04 define VERBOSE 0x05 define PANIC_ON_STACK_OVERFLOW 0x01 define PANIC_ON_FULL_TIMERS 0x02 define PANIC_ON_BAD_RESET 0x04 define PANIC_DISABLES_APP 0x80 define FF_PROGRAMMABLE 0x01 define FF_DCOCHECKER 0x02 typedef struct UINT16 id UINT16 rxReceiveLimit UINT8 transmitPower UINT8 boot_logLevel UINT8 panicFlags UINT8 firmwareFlags ich extern config t Configuration bool Configuration init bool Configuration save Ona primea MEAE The ScatterWeb Configuration provides functions that allow you to programmat

User Guide (for ScatterWeb)

Contents

Download Pdf Manuals

Related Search

Related Contents