Home

Description - STMicroelectronics

1. DEATH OR SEVERE PROPERTY OR ENVIRONMENTAL DAMAGE ST PRODUCTS WHICH ARE NOT SPECIFIED AS AUTOMOTIVE GRADE MAY ONLY BE USED IN AUTOMOTIVE APPLICATIONS AT USER S OWN RISK Resale of ST products with provisions different from the statements and or technical features set forth in this document shall immediately void any warranty granted by ST for the ST product or service described herein and shall not create or extend in any manner whatsoever any liability of ST ST and the ST logo are trademarks or registered trademarks of ST in various countries Information in this document supersedes and replaces all information previously supplied The ST logo is a registered trademark of STMicroelectronics All other names are the property of their respective owners 2011 STMicroelectronics All rights reserved STMicroelectronics group of companies Australia Belgium Brazil Canada China Czech Republic Finland France Germany Hong Kong India Israel Italy Japan Malaysia Malta Morocco Philippines Singapore Spain Sweden Switzerland United Kingdom United States of America www st com 28 28 Doc ID 17750 Rev 3 ky
2. Ti UM0978 Sf i User manual Using the Simple MAC nodetest application 1 Introduction The Simple MAC nodetest application is a low level test program designed for the functional testing of RF modules either your own custom manufactured devices or those provided in the STM32W108 Kits including token viewing range testing received signal strength indicator RSSI measurements and special transmission test modes as required for FCC and CE certification This document describes how to set up and get started running the Simple MAC nodetest application on an STM32W108xx application board platform This document applies to the following STM32W108xx kits STM32W108xx starter kit part number STM32W Sk STM32W108xx extension kit part number STM32W EXT STM32W108xx low cost RF control kit part number STM32W RFCKIT Note 1 The term application board refers to the STM32W108xx boards delivered with all available STM32W1 08xx kits This term is not used for referring to the STM32 Primer2 MB850 platforms 2 For more information visit the STM32W 32 bit RF microcontroller webpages at www st com stm32w These webpages provide full access to all STM32W108xx resources kits software packages and documents March 2011 Doc ID 17750 Rev 3 1 28 www st com Contents UM0978 Contents 1 IRMOGUCTION 5 ice cede eens ie kade heme ee Meade ee 1 2 Getting started sacicciit cided beeen ae ee eee ee 4 2 1 Downloading the binar
3. gt tx2 Txing 2 packets 25500 us apart e nd 2 packets transmitted Last packet status 0x0000 Last packet backoff 0x0000 Frame pending in last ACK No SFD time via TX complete callback Ox6B6F 1 0 16882 100 0 OxFF 45 0xDC 0xB0 0x6000 0Ox00092C5D 0 0x09 0x21 0x08 0x00 0x12 0x23 0x02 0x22 OxF2 0x41 2 0 16882 100 0 OxFF 45 0xDC 0xB0 0x6000 0Ox000995F3 0 0x09 0x21 0x08 0x00 0x12 0x23 0x02 0x22 OxF2 0x41 TX and RX test with RX in Coordinator mode 1 Setup 2 nodes TX transmitter node RX receiver node as described in Section 2 Getting started 2 On both nodes TX and RX set the same radio channel range 11 26 default 11 where x is the channel in hex gt setchannel x 3 On the TX node set the radio power range 43 8 dBm default 3 where x is the power in hex gt settxpower x 4 On the RX node enable the Coordinator mode radio filter and automatic acknowledge and then verify the radio RX configuration gt setaddrfilt 1 gt setautoack 1 gt setcoord 1 Doc ID 17750 Rev 3 ky UM0978 Simple MAC Library nodetest test scenarios gt getrxconfig getrxconfig addressFilter 1 autoAck nel coordinator 1 overflow 0 On the TX node set the current packet length and payload with only the source PANID FCF 0xC021 and then verify the packet content Example Build
4. FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF MFG CBKE DATA FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF F FF FF FF FF FF FF FF FF C943 MFG INSTALLATION CODE FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF B254 MFG OSC24M BIAS TRIM FF FF B634 MFG EUI 64 37 05 00 00 02 E1 80 00 Wy Q WW mj e mj N F F F mj mj j WoW A j mj j mj j mj j j j j j 3 4 Reset test commands The reset tests are used to test different reset scenarios and display the reset reason Table 5 describes the related supported test commands Table 5 Reset test commands Test command Test description resetstring Displays the ResetString assertme Resets the chip using assert reboot Resets the chip using halReboot forceReset u2 Resets with a specific forced reset type wdogreset Triggers a reset using the watchdog 3 4 1 Reset test commands examples To display the reason for the reset string enter gt resetstring The following information is displayed depending on the reset reason RESET EXT PIN when resetting through the application board RST1 button Table 6 describes the possible reasons for reset 2 Doc ID 17750 Rev 3 9 28 Simple MAC nodetest command
5. enter gt getaeskey 4 Doc ID 17750 Rev 3 UM0978 Simple MAC nodetest command classes The following data is displayed 0x00 0x11 0x11 0x11 0x11 0x04 0x22 0x22 0x22 0x22 0x08 0x33 0x33 0x33 0x33 Ox0C 0x44 0x44 0x44 0x44 To set the data to be encrypted enter gt setPlainText 0 55 55 55 55 gt setPlainText 4 66 66 66 66 gt setPlainText 8 77 77 77 77 gt setPlainText c 88 88 88 88 To display the data to be encrypted enter gt getplaintext The following data is displayed 0x00 0x55 0x55 0x55 0x55 0x04 0x66 0x66 0x66 0x66 0x08 0x77 0x77 0x77 0x77 Ox0C 0x88 0x88 0x88 0x88 To encrypt the set data with the set key enter gt aesEncrypt The encrypted data is displayed 0x00 0x55 Ox1E 0x94 0x3F 0x04 0x25 0x28 0x4C OxFF 0x08 Ox0D OxFA 0x3A 0xD5 Ox0C 0x83 0xA2 OxFB 0x0D PHY common test commands The PHY common tests provide a set of commands used to setup the radio and be able to send and receive IEEE 802 15 4 compliant packets In particular the user can initialize the radio seed the random generator with a seed number coming from the radio set the radio operating channel sleep wake up the radio display the channel state busy clear display the current RSSI and energy value set the radio receiver filters for PANID and short long address set the energy threshold used for the Clear Channel Assessment CCA Furthermore the user can enable the Packet Trace Interface inside the STM32W108
6. oflo seq per err lqi rssi ed gain status time fp length payload Table 11 describes the meaning of the RX fields Table 11 RX command fields description Field Description num Number of packets received oflo Number of detected RX overflows seq Packet sequence number per Calculated packet error rate err The number of correlator errors in the packet lqi Calculated Link Quality Indication rssi Received Signal Strength Indication ed ED converted from RSSI gain Receiver gain settings status Hardware status time MAC timer resolution 1s when the packet was received fp TRUE if the library set the Frame Pending bit in the hardware generated MAC ACK to this packet FALSE otherwise Doc ID 17750 Rev 3 ky UM0978 Simple MAC nodetest command classes Note 3 9 Note 3 9 1 Note Table 11 RX command fields description continued Field Description length MAC packet length payload MAC Packet the 2 bytes CRC is not displayed To stop the packet receive mode type e PHY stm32w108xxclass test commands The stm32w108xxclass provide a set of commands used to set a channel and force the related calibration set the power mode normal or boost and if an external power amplifier is used in user RF design check if the temperature conditions require the radio to be re calibrated Each use of the calChannel command cause unnecessary wear
7. 0x4000 OxO00078E9D 0 0x12 0x00 0x01 0x02 0x03 0x04 0x05 0x06 0x07 0x08 0x09 0x0A 0x0B Ox0C Ox0D 0x0E 0x0F 0x10 Ox11 Doc ID 17750 Rev 3 ky UM0978 Simple MAC Library nodetest test scenarios 4 4 2 TX and RX test with RX in Filter mode PANID and short address 1 Setup 2 nodes TX transmitter node RX receiver node as described in Section 2 Getting started On both nodes TX and RX set the same radio channel range 11 26 default 11 where x is the channel in hex gt setchannel x On the TX node set the radio power range 43 8 dBm default 3 where x is the power in hex gt settxpower x On the RX node enable the radio filter and automatic acknowledge and then verify the radio RX configuration gt setaddrfilt 1 gt setautoack 1 gt getrxconfig getrxconfig addressFilter 1 autoAck 1 coordinator 0 overflow 0 On the TX node set the current packet length and payload with the RX PANID and short ID as destination addresses FCF 0x0821 and then verify the packet content Example Build a packet with FCF 0x0821 destination PANID 0x2312 and destination short address 0x2202 gt setTxLength Oxb setTxPayload 0 21 08 00 12 setTxPayload 4 23 02 22 F2 setTxPayload 8 41 00 00 00 gettxpacket len 0x0B 0x00 0x21 0x08 0x00 0x12 0x04 0x23 0x02 0x22 0xF2 0x08 0x41 0x00 0x00 On the RX node set filters for PANID and short address Example S
8. A command for enabling a Packet Error Rate test is also provided Table 8 PHY common test commands Test command Test description initRadio Initialize the radio seedPnrg Seed the random number generator with random data from the radio setPerTest ul m Set Packet Error Rate test mode to m 0 Disable 1 Enable getChannel Display the current channel Doc ID 17750 Rev 3 11 28 Simple MAC nodetest command classes UM0978 3 6 1 12 28 Table 8 PHY common test commands continued Test command setChannel ul Test description c Set the radio channel to c gRadPowState Display the radio power state sRadPowState ul s Set the radio power state to s 0 Asleep 1 Awake getCca Display the Clear Channel Assessment 1 Clear 0 Busy getRssi Display the RSSI in dBm over 8 symbol periods Get 802 15 4 ED 100 dBm to 36 dBm 0x00 to OxFF over 8 symbol getEq periods getPan Id Display the local host PANID setPanId u2 Set local host PANID getShortAddr Display the local host short address setShortAddr u2 Set local host short address getLongAddr Display the local host extended address setAutoCal ul m Set auto calibration mode in RX and TX to m 0 Disable 1 Enable getCcaThresh Display the energy detection clear channel assessment threshold in dBm setCcaThresh s1 e Set energy detection clear chan
9. a receiver node RX The related error rate is calculated and displayed on the RX node To perform the packet error test follow these steps 1 Setup 2 nodes TX transmitter node RX receiver node as described in Section 2 Getting started On both nodes TX and RX type the following command for enabling the packet error test gt setpertest 1 On both nodes TX and RX set the radio channel range 11 26 default 11 where x is the channel in hex gt setchannel x On TX node set the radio power range 43 8 dBm default 3 where x is the power in hex gt settxpower x On the RX node enable Receive mode gt rx On the TX node transmit n packets n 0 infinite gt tx n On the RX node the HyperTerminal displays n packets with associated information as described in Section 3 8 1 PHY common RX test command examples Table 15 shows the execution steps for performing a per test by sending 5 packets on the TX node Table 15 Packet Error Rate test example TX node per test commands RX node per test commands gt setpertest 1 gt setpertest 1 setPerTest PER Test Mode enabled setPerTest PER Test Mode enabled gt Ix rx test start e nd rx num oflo seq per err Iqi rssi ed gain status time fp length gt tx5 1 O 1 O 0 OxFF 47 OxD4 Txing 5 packets 25500 us apart e nd OxB1 0x4000 0x00034095 0 0x
10. of the Flash memory due to writing the token value This command should be only used to recover from hardware related calibration problems which should only occur during hardware development If there are problems with the hardware design it may be possible for erroneous calibration values to be stored in the token In this case the token data must be erased Table 12 PHY stm32w108xxclass test commands Test command Test description calChannel ul Set the channel perform full calibration get TxPowMode Display the TX power level and PA settings setTxPowMode ulul Ip Set Tx power level 0 normal 1 boost and PA p 0 int 1 ext t Monitor checkRadio for calibration needed optionally transmit checkRadio ul throughout t 1 PHY stm32w108xxclass test command examples To check if calibration is needed enter gt checkradio 1 The following information is displayed temperature C and radio calibration values radio is ASLEEP tx during test yes auto calibration enabled checkRadio mode e nd temp vco mod lna 23 0x20 0x41 0x0C To stop the Checkradio mode type e Doc ID 17750 Rev 3 17 28 Simple MAC nodetest command classes UM0978 Table 13 describes meaning of the checkRadio fields Table 13 checkRadio calibration values Field Description temp Temperature in degrees Celsius vco Voltage Controlled Oscillator mod Modulation Digit
11. 1 7 Onthe RX node enable Receive mode gt rX 8 On the TX node transmit n packets n 0 infinite gt tx n 9 On the RX node the HyperTerminal displays n packets with associated information as described in Section 3 8 1 PHY common RX test command examples The following table shows an example of the execution steps required for performing a simple TX RX test with RX in Promiscuous mode the channel power setting commands are not reported Table 16 TX and RX test with RX in Promiscuous mode TX node commands gt gettxpacket len 0x14 0x00 0x00 0x01 0x02 0x03 0x04 0x04 0x05 0x06 0x07 0x08 0x08 0x09 Ox0A 0x0B Ox0C 0x0C Ox0D 0x0E 0x0F 0x10 0x10 0x11 0x12 0x13 RX node commands gt getrxconfig getrxconfig addressFilter 0 autoAck 0 coordinator 0 overflow 0 gt showpayload 1 gt tx2 Txing 2 packets 25500 us apart e nd 2 packets transmitted Last packet status 0x0000 Last packet backoff 0x0000 Frame pending in last ACK No SFD time via TX complete callback Ox62F9 gt Ix rx test start e nd Xx num oflo seq per err Iqi rssi ed gain status time fp length 1 0 4368 100 0 OxFF 47 0xD4 0xB1 0x4000 0x000725D3 0 0x12 0x00 0x01 0x02 0x03 0x04 0x05 0x06 0x07 0x08 0x09 O0x0A 0x0B Ox0C 0x0D 0x0E 0x0F 0x10 Ox11 2 0 4368 100 0 OxFF 47 0xD4 OxB1
12. 12 5 packets transmitted 2 O 2 O 0 OxFF 47 0xD4 ie eres ito 0000 0xB1 0x4000 0x0003A962 0 0x12 Last packet backoff 0x0000 3 O 3 O 0 OxFF 47 0xD4 Frame pending in last ACK No SFD time via TX complete callback 0x49F9 0xB1 0x4000 0x0004122E 0 0x12 4 O f 4 O 0 OxFF 47 OxD4 0xB1 0x4000 0x00047AF9 0 0x12 5 O 5 0 0 OxFF 47 OxD4 0xB1 0x4000 0x0004E3C6 0 0x12 20 28 Doc ID 17750 Rev 3 ky UM0978 Simple MAC Library nodetest test scenarios Note 4 4 4 4 1 1 The fourth column in the display output labeled per shows the packet error rate For this value to be accurate the receiver should not hear any other devices Exiting the test and restarting clears the values and resets the values being displayed Nodetest attempts to display the packet data as fast as it can but it is possible to receive packets faster than nodetest can display the data Therefore there may be gaps in the displayed packets To stop the TX or RX tests type e on the related HyperTerminal TX and RX test scenarios The Simple MAC nodetest commands can be used to target different types of simple transmission reception scenarios 1 Receiver is able to receive all the packets on the selected radio channel Promiscuous mode 2 Receiver enables hardware filters on PANID short or long address for receiving
13. STALLATION CODE 0x080408EE 0x080408EF B254 MFG OSC24M BIAS TRIM Virtual Token B634 MFG EUI 64 8 28 To dump the entire token data set enter gt tokdump The following information is displayed little endian all data represented as a byte array 00 FF C344 F064 MFG CHIP DATA AA 55 F9 38 39 34 37 39 36 43 FF FF FF FF 19 FF FF FF AA 55 F9 38 MFG PART DATA 01 00 02 00 01 FF MFG TESTER DATA F9 38 FF FF FF FF MFG ST EUI 64 37 05 00 00 02 E1 80 00 MFG ANALOG TRIM NORMAL EF 02 14 02 EF 02 EF 12 27 00 34 00 EF 02 00 00 34 OO MFG ANALOG TRIM BOOST EF 02 54 30 EF 02 EF 12 27 00 34 00 EF 02 00 1B 34 00 MFG ANALOG TRIM BOTH 73 06 Fl 02 34 00 F4 01 F1 02 MFG REG TRIM 01 05 MFG 1V8 REG VOLTAGE D7 46 MFG VREF VOLTAGE F4 2E MFG TEMP CAL 84 45 MFG FIB VERSION FE 01 MFG FIB CHECKSUM FF FF MFG FIB OBS FF FF 02 FD 55 AA FF FF MFG CIB OBS A5 5A FF FF FF FF FF FF FF 00 FF 00 FF 00 FF MFG CUSTOM VERSION 01 FE MFG CUSTOM EUI 64 FF FF FF FF FF FF FF FF 4 Doc ID 17750 Rev 3 UM0978 Simple MAC nodetest command classes ED73 MFG STRING FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF C24E MFG BOARD NAME 4D 42 38 35 31 20 41 FF FF FF FF FF FF FF C944 MFG MANUF_ID FF FF D043 MFG PHY CONFIG FF FF C24B MFG BOOTLOAD AES KEY FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF CD53 MFG EZSP STORAGE FF FF FF FF FF FF FF FF C143 MFG ASH CONFIG FF FF FF FF FF FF FF FF FF FF FF FF FF FF
14. a packet with FCF 0xC021 and source PANID 0x2312 setTxLength Oxb setTxPayload 0 21 CO 00 12 setTxPayload 4 23 71 72 73 setTxPayload 8 74 00 00 gettxpacket len 0x0B 0x00 0x21 OxCO 0x00 0x12 0x04 0x23 0x71 0x72 0x73 0x08 0x74 0x00 0x00 On the RX node set filters for PANID Example Set filters on PANID 0x2312 gt setPanId 0x2312 On the RX node enable the payload display gt showpayload 1 On the RX node enable Receive mode vvv NV V V gt rX On the TX node transmit n packets n 0 infinite gt tx n On the RX node the HyperTerminal displays n packets with associated information as described in Section 3 8 1 PHY common RX test command examples Doc ID 17750 Rev 3 25 28 Simple MAC Library nodetest test scenarios UM0978 26 28 Table 18 shows an example of the execution steps required for performing a simple TX and RX test with RX in Coordinator mode channel and power setting commands are not reported Table 18 TX and RX test with RX in Coordinator mode TX node commands gt setTxLength Oxb gt setTxPayload 0 21 CO 00 12 gt setTxPayload 4 23 71 72 73 gt setTxPayload 8 74 000 gt gettxpacket len Ox0B 0x00 0x21 OxCO 0x00 0x12 0x04 0x23 0x71 0x72 0x73 0x08 0x74 0x00 0x00 RX node commands gt setadadrfilt 1 gt setautoack 1 gt setcoord 1 gt getrxconfig getrxconfig addressFilter 1 autoAck 1 coordinator 1 overflow 0 gt
15. al to Analog Converter lna Low Noise Amplifier 3 10 PHY stm32w108xxclass lib timer test commands The phy stm32w108xxclass lib timer provides a set of commands for using the radio MAC Timer The MAC timer is 20 bits long with each LSB tick representing 1 us The MAC timer rolls over to zero approximately once every second The MAC timer is free running from the time that the radio is initialized Table 14 PHY stm32w108xxclass test commands Test command Test description getMacTmr Display the current value of the MAC timer macTmrCmp ul n Count n MAC timer compare interrupts n 0 for infinite enaMacTmrCmp ul e Enable e 1 or disable e 0 MAC timer compare event setMacTmrCmp u2 c Set MAC timer compare event to occur at count c getMacTmrCfg Display the MAC timer compare configuration 3 10 1 Phy stm32w108xxclass test commands examples To display the current MAC timer value enter gt getMacTmr The following information is displayed getMacTmr MAC Timer 0x000BAED3 18 28 Doc ID 17750 Rev 3 ky UM0978 Simple MAC Library nodetest test scenarios 4 4 1 Note 4 2 Note Simple MAC Library nodetest test scenarios Transmit single carrier frequency unmodulated signal on a specific channel To ensure FCC or CE compliance certain tests require transmitting an unmodulated carrier wave tone over a specific channel To send an unmodulated carrier wave
16. ay the complete token data set enter gt tokmap The following information is displayed Start Address End Address creator name 0x0804077E 0x08040795 C344 MFG CHIP DATA 0x08040796 0x0804079B F064 MFG PART DATA 0x0804079C O0x080407A1 F464 MFG TESTER DATA 0x080407A2 0x080407A9 E545 MFG ST _EUI 64 Ox080407AA 0x080407BD F46E MFG ANALOG TRIM NORMAL 0x080407BE 0x080407D1 F442 MFG ANALOG TRIM BOOST 0x080407D2 0x080407DB F462 MFG ANALOG TRIM BOTH 0x080407DC 0x080407DD F274 MFG REG TRIM 0x080407DE Ox080407DF F276 MFG_1V8 REG VOLTAGE 0x080407EO Ox080407E1 F676 MFG VREF_ VOLTAGE ky Doc ID 17750 Rev 3 7 28 Simple MAC nodetest command classes UM0978 0x080407E2 0x080407E3 F463 MFG TEMP CAL 0x080407F4 0x080407F5 FF09 MFG FIB VERSION 0x080407F6 O0x080407F7 E663 MFG FIB CHECKSUM 0x080407F8 0x080407FF E66F MFG FIB OBS 0x08040800 0x0804080F E36F MFG CIB OBS 0x08040810 0x08040811 C356 MFG CUSTOM VERSION 0x08040812 0x08040819 E345 MFG CUSTOM EUI 64 0x0804081A 0x08040829 ED73 MFG STRING 0x0804082A 0x08040839 C24E MFG BOARD NAME 0x0804083A 0x0804083B C944 MFG MANUF ID 0x0804083C 0x0804083D D043 MFG PHY CONFIG 0x0804083E 0x0804084D C24B MFG BOOTLOAD AES KEY 0x0804084E 0x08040855 CD53 MFG EZSP_ STORAGE 0x08040856 0x0804087D C143 MFG ASH CONFIG 0x0804087E 0x080408D9 C342 MFG CBKE DATA 0x080408DA 0x080408ED C943 MFG IN
17. ayload 0 21 08 00 12 gt setTxPayload 4 23 02 22 F2 gt setTxPayload 8 41 00 00 00 To display the current packet enter gt gettxpacket The following information is displayed len 0x0B 0x00 0x21 0x08 0x00 0x12 0x04 0x23 0x02 0x22 OxF2 0x08 0x41 0x00 0x00 Doc ID 17750 Rev 3 UM0978 Simple MAC nodetest command classes To send 5 packets enter gt tx 5 When the packet transmission is completed the following information is displayed Txing 5 packets 50000 us apart e nd 5 packets transmitted Last packet status 0x0000 Last packet backoff 0x0000 Frame pending in last ACK No SFD time via TX complete callback 0x7C56 Note To stop the packet transmission enter e 3 8 PHY common RX test commands The PHY common RX tests provide a set of commands used to set up the radio for the reception of IEEE 802 15 4 compliant packets In particular the user can select if displaying or not the received packet payload enabling or disabling the hardware filters for the packet PANID and short or long addresses enabling or disabling the automatic transmission of acknowledgment on reception of packet which requests ack enable disable the coordinator feature enable disable the check of the CRC value on the received packet enable disable the notification of overflow event on the receiver DMA Furthermore the user can display the current receiver status if filters automatic acknowledge coordinator and overflow features are e
18. b 0 hardware wait for ack setCheckCca ul b Enable b 1 or disable b 0 hardware backoff CCA and check setCcaMax ul n Set the number of times to check CCA to n Doc ID 17750 Rev 3 13 28 Simple MAC nodetest command classes UM0978 3 7 1 14 28 Table 9 PHY common TX test commands continued Test command Test description setBoExpMin ul e Set the minimum backoff exponent to e setBoExpMax ul e Set the maximum backoff exponent to e appendCre ul a Enable a 1 or disable a 0 hardware appended CRC setSfdSent ul a Enable a 1 or disable a 0 SFD sent callback PHY common TX test command examples To display the current output power default is 3 enter gt gettxpower The following information is displayed getTxPower actualPower 3 dBm To display the current radio transmit configuration setting enter gt gettxconfig The following information is displayed 1 enabled 0 disabled gettxconfig waitForAck 1 checkCca 0 ccaAttemptMax 4 backof fExponentMin 3 backof fExponentMax 5 appendCre 1 To display the current output power default is 3 enter gt gettxpower The following information is displayed getTxPower actualPower 3 dBm To set the packet length of 11 including 2 bytes for the CRC enter gt setTxLength 0xb To set the IEEE 802 15 4 packet content 0x21080012230222F241 enter gt setTxP
19. classes UM0978 3 5 3 5 1 10 28 Table 6 List of reset reasons Reason Description PWR HV Power on reset type High voltage power on EXT PIN External reset trigger External pin reset SW RBT Software triggered reset General software reboot FIB GO Reset originated from the FIB bootloader FIB bootloader caused a reset in main Flash memory CRS AST Software crash a self check assert in the code failed WDG LWM Beea A occurred Watchdog low watermark expired and caught FLASH Flash failure cause reset FATAL A non recoverable fatal error occurred FAULT An access fault occurred UNK Unknown cause PHY security test commands The PHY security tests are used to test the STM32W108 AES encryption features Table 7 describes the related supported test commands Table 7 PHY security test commands Test command getAesKey Test description Display the AES key setAesKey ululululul o d0 d1 d2 d3 Set AES key data d0 3 at offset o getPlainText Display the plaintext SOEPLALATORE o dO d1 d2 d3 Set plaintext d0 3 at offset o ululululul aesEncrypt Encrypt the plaintext using the AES key and display the ciphertext PHY security test commands examples To set AES Key data at offset 0 4 8 c enter the following commands gt setaeskey 0 11 1111 11 gt setaeskey 4 22 22 22 22 gt setaeskey 8 33 33 33 33 gt setaeskey c 44 44 44 44 To display the set AES key
20. d conditions of sale Purchasers are solely responsible for the choice selection and use of the ST products and services described herein and ST assumes no liability whatsoever relating to the choice selection or use of the ST products and services described herein No license express or implied by estoppel or otherwise to any intellectual property rights is granted under this document If any part of this document refers to any third party products or services it shall not be deemed a license grant by ST for the use of such third party products or services or any intellectual property contained therein or considered as a warranty covering the use in any manner whatsoever of such third party products or services or any intellectual property contained therein UNLESS OTHERWISE SET FORTH IN ST S TERMS AND CONDITIONS OF SALE ST DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY WITH RESPECT TO THE USE AND OR SALE OF ST PRODUCTS INCLUDING WITHOUT LIMITATION IMPLIED WARRANTIES OF MERCHANTABILITY FITNESS FOR A PARTICULAR PURPOSE AND THEIR EQUIVALENTS UNDER THE LAWS OF ANY JURISDICTION OR INFRINGEMENT OF ANY PATENT COPYRIGHT OR OTHER INTELLECTUAL PROPERTY RIGHT UNLESS EXPRESSLY APPROVED IN WRITING BY AN AUTHORIZED ST REPRESENTATIVE ST PRODUCTS ARE NOT RECOMMENDED AUTHORIZED OR WARRANTED FOR USE IN MILITARY AIR CRAFT SPACE LIFE SAVING OR LIFE SUSTAINING APPLICATIONS NOR IN PRODUCTS OR SYSTEMS WHERE FAILURE OR MALFUNCTION MAY RESULT IN PERSONAL INJURY
21. est commands examples 18 4 Simple MAC Library nodetest test scenarios 19 2 28 4 1 Transmit single carrier frequency unmodulated signal on a specific channel 19 4 2 Transmit continuous stream of random symbols on a specific channel 19 4 3 Packet error rate test 2 0 ee eee ee ees 20 Doc ID 17750 Rev 3 ky UM0978 Contents 4 4 TX and RX test scenarios sinkiverbidureiveaws hen eekaverdee nes 21 4 4 1 TX and RX test with RX in promiscuous mode 21 4 4 2 TX and RX test with RX in Filter mode PANID and short address 23 4 4 3 TX and RX test with RX in Coordinator mode 0 24 5 Revision history xcs ne gk deteeweke wale cues eee eeee eae 27 ky Doc ID 17750 Rev 3 3 28 Getting started UM0978 2 2 1 Note 2 2 Note 4 28 Getting started The Simple MAC software package provides the nodetest application in binary format simplemac test s37 This image is contained in the prebuilt folder delivered with the Simple MAC software package Downloading the binary image To download the binary image of the Simple MAC nodetest application for use on an application board use the stm32w_flasher utility with the available prebuilt image simplemac test s37 For information about how to use the stm32w_flasher utility refer to the selected STM32W108xx Kit user manual If only one application board is connected to your PC you can jus
22. et filters on PANID 0x2312 and short address 0x2202 gt setPanId 0x2312 gt setShortAddr 0x2202 On the RX node enable payload display VvV V V gt showpayload 1 On the RX node enable Receive mode gt rx On the TX node transmit n packets n 0 infinite gt tx n On the RX node the HyperTerminal displays n packets with associated information as described in Section 3 8 1 PHY common RX test command examples Doc ID 17750 Rev 3 23 28 Simple MAC Library nodetest test scenarios UM0978 4 4 3 24 28 Table 17 shows an example of the execution steps required for performing a simple TX and RX test with RX filtering on destination PANID and short address channel and power setting commands are not reported Table 17 TX and RX test with RX filtering on destination PANID and short address TX node commands gt setTxLength Oxb gt setTxPayload 0 21 08 00 12 gt setTxPayload 4 23 02 22 F2 gt setTxPayload 8 41 00 00 gt gettxpacket len 0x0B 0x00 0x21 0x08 0x00 0x12 0x04 0x23 0x02 0x22 OxF2 0x08 0x41 0x00 0x00 RX node commands gt setadarfilt 1 gt setautoack 1 gt getrxconfig getrxconfig addressFilter 1 autoAck 1 coordinator 0 overflow 0 gt setPanld 0x2312 gt setShortAddr 0x2202 gt showpayload 1 gt Ix rx test start e nd X num oflo seq per err Iqi rssi ed gain status time fo length
23. hexadecimal hex format COMMAND PARAMETERS DESCRIPTION Supported parameter types Table 1 list the supported parameter types Commands are NOT case sensitive Table 1 Simple MAC nodetest parameters types Parameters Type Description Buffer arguments are given as a string Buffer arguments can b buffer also be given as a hex digit string using curly braces 1A2B3C The hex digits are converted to bytes in pairs s1 int8s One byte signed s2 int16s Two byte signed ul int8u One byte unsigned u2 int1 6u Two byte unsigned u4 int32u Four byte unsigned Doc ID 17750 Rev 3 5 28 Simple MAC nodetest command classes UM0978 3 1 LED test commands LED test commands verify the correct operation of the STM32W108 application board LEDs Table 2 describes the related supported test commands Table 2 List of LED test commands Test command Test description ledTest Cycle the LEDs ledOn ul Turns on LED ut ledoOff ul Turns off LED u1 ledToggle ul Toggles LED u1 3 1 1 Examples of LED test commands To turn on the application board LED D1 enter gt ledOn 1 To turn on the application board LED D3 enter gt ledOn 2 3 2 Memory test commands The memory tests commands carry out various memory tests Table 3 describes the related supported test commands Table 3 Memory test commands Test command Test description getmemb u4u4 Read
24. nabled Table 10 PHY common RX test commands Test command Test description showPayload ul Enable 1 or disable 0 default PHY payload display in RX output rx Receive mode setAddrFilt ul f Enable f 1 or disable f 0 default hardware address filtering setAutoAck ul a Enable a 1 or disable a 0 default auto ack to ack request packet setCoord ul c Enable c 1 or disable c 0 default this device as coordinator Re A Sr c Enable c 1 default or disable c 0 discarding packets with bad CRC setOverflow ul c Enable c 1 default or disable c 0 notification of overflow events getRxConfig Display RX settings e g filtering auto ack etc ky Doc ID 17750 Rev 3 15 28 Simple MAC nodetest command classes UM0978 3 8 1 Note 16 28 PHY common RX test command examples To display the current receiver status enter gt getrxconfig The following information is displayed getrxconfig addressFilter 0 autoAck 0 coordinator 0 overflow 0 Using the default settings no hardware filters and automatic acknowledge enabled the radio is able to receive all the packets sent in the set channel radio is in Promiscuous mode To display the received packet payload enter gt showpayload 1 To set the radio in Receive mode enter gt rx The following information is displayed rx test start e nd xx num
25. nel assessment threshold to e in dBm getPtiOutput Indicates whether Packet Trace Interface output is enabled or not setPtiOutput ul p Enable p 1 default or disable p 0 Packet Trace output Phy common test commands examples To display the current channel range 11 26 default 11 enter gt getchannel The following information is displayed getChannel Radio channel channel 0x0B To set the radio channel to 15 enter gt setchannel f The following information is displayed setChannel Setting channel and calibrating as needed status 0x00 getChannel Radio channel channel 0x0F To display the current channel status enter gt getcca The following information is displayed 1 channel is clear 0 channel is busy getcca CCA 1 To set the radio PANID to 0x3344 enter gt setpanid 0x3344 4 Doc ID 17750 Rev 3 UM0978 Simple MAC nodetest command classes 3 7 To display the current radio PANID enter gt getpanid The following information is displayed getpanid PAN id 0x3344 To display the channel RSSI value enter gt getrssi The following information is displayed getrssi RSSI 99 dBm PHY common TX test commands The PHY common TX tests provide a set of commands used to set up the radio for the transmission of IEEE 802 15 4 compliant packets In particular the user can specify the
26. packets with the specific destination PANID and short or long address 3 Receiver enables the Coordinator mode and a filter on a specific PANID for receiving packets with no destination addresses but with source PANID matching the receiver PANID TX and RX test with RX in promiscuous mode 1 Setup 2 nodes TX transmitter node RX receiver node as described in Section 2 Getting started 2 On both nodes TX and RX set the same radio channel range 11 26 default 11 where x is the channel in hex gt setchannel x 3 On the TX node set the radio power range 43 8 dBm default 3 where x is the power in hex gt settxpower x 4 On the TX node display the current packet user can change the default length and content using the setTxLength and set TxPayload commands gt gettxpacket 5 On the RX node ensure that the radio filters are disabled the Simple MAC nodetest configures each node in promiscuous node as default Enter the following command to display the radio filters state gt getrxconfig getrxconfig addressFilter autoAck oO oO Oo wee ee coordinator overflow Doc ID 17750 Rev 3 21 28 Simple MAC Library nodetest test scenarios UM0978 22 28 If the addressFilter and autoAck values are 1 disable them using the related commands gt setaddrfilt 0 gt setAutoAck 0 6 On the RX node enable the payload display gt showpayload
27. setPanld 0x2312 gt showpayload 1 gt Ix rx test start e nd rx num oflo seq per err lqi rssi ed gain status time fo length gt tx2 Txing 2 packets 25500 us apart e nd 2 packets transmitted Last packet status 0x0000 Last packet backoff 0x0000 Frame pending in last ACK No SFD time via TX complete callback Ox7F3E 1 0 29811 100 0 OxFF 50 0xC8 OxB1 0x6000 Ox000DE34E 0 0x09 0x21 OxCO 0x00 0x12 0x23 0x71 0x72 0x73 0x74 2 0 29811 100 0 OxFF 50 0xC8 OxB1 0x6000 OxO00E4CE3 0 0x09 0x21 OxCO 0x00 0x12 0x23 0x71 0x72 0x73 0x74 Doc ID 17750 Rev 3 ky Revision history UM0978 5 Revision history Table 19 Document revision history Date Revision Changes 30 Jul 2010 1 Initial release ne Added reference to STM32W108 application boards and removed 06 Feb 2011 2 reference to MB851 board 16 Mar 2011 3 Added support for STM32W108xx kits ky Doc ID 17750 Rev 3 27 28 UM0978 Please Read Carefully Information in this document is provided solely in connection with ST products STMicroelectronics NV and its subsidiaries ST reserve the right to make changes corrections modifications or improvements to this document and the products and services described herein at any time without notice All ST products are sold pursuant to ST s terms an
28. t use the p auto option for automatically detecting the related USB virtual COM Accessing the nodetest application using HyperTerminal Configuring the HyperTerminal for use To run the Simple MAC nodetest application open a HyperTerminal session on the related USB COMx port with these settings Bitrate 115200 Data bits 8 Parity None Stop bits 1 Flow control None Accessing the Simple MAC nodetest commands Press enter on the keyboard to access the Simple MAC nodetest commands Each time the Simple MAC nodetest starts execution the following operations are automatically performed hwver Displays the hardware version Crashinfo Displays any available crash information Resetstring Displays the reset reasons initTokens Initializes tokens initRadio Initializes the radio seedPnrg Seeds the PNRG with random data from the radio setPerTestTx Sets up transmit parameters for the IEEE 802 15 4 PER test Enter he1p to display a list of all supported commands Doc ID 17750 Rev 3 ky UM0978 Simple MAC nodetest command classes 3 Simple MAC nodetest command classes The following classes of test commands are supported led test memory test token cortexm3 test amp token test reset test phy security phy common phy common tx phy common rx phy stm32w108xxclass phy stm32w1 08xxclass lib timer Command format The nodetest test commands have the following format All input values are in
29. tone follow these steps 1 Setup a node TX as described in Section 2 Getting started 2 On the TX node set the radio channel range 11 26 default 11 where x is the channel in hexadecimal format gt setchannel x 3 On the TX node set the radio power range 43 8 dBm default 3 where x is the power in hex gt settxpower x 4 On the TX node start a tone transmission gt txTone To stop the txTone test type e on the related Hyper Terminal Transmit continuous stream of random symbols on a specific channel To ensure FCC or CE compliance certain tests require transmitting a continuous stream of random symbols over a specific channel To send a continuous stream of random symbols follow these steps 1 Setup a node TX as described in Section 2 Getting started 2 On the TX node set the radio channel range 11 26 default 11 where x is the channel in hexadecimal format gt setchannel x 3 On the TX node set the radio power range 43 8 dBm default 3 where x is the power in hex gt settxpower x 4 On the TX node start sending a continuous stream of random symbols gt txStream To stop the txStream test type e on the related Hyper Terminal Doc ID 17750 Rev 3 19 28 Simple MAC Library nodetest test scenarios UM0978 4 3 Packet error rate test The packet error rate PER test consists of sending a set of packets from a transmitter node TX and receiving them on
30. transmission output power the IEEE 802 15 4 packet length and content configure certain parameters affecting the packet transmission wait or not for packet acknowledgment if packet request ack perform or not the CCA before transmission add or not CRC to the transmitted packet set the number of backoffs and exponents involved in the unslotted CSMA CCA algorithm Furthermore the user can choose to enable the SFD send event notification for transmitted packets Certain commands for sending a single carrier frequency tone or continuous stream of random symbols are also provided Table 9 PHY common TX test commands Test command setPerTestTx Test description Setup TX for IEEE 802 15 4 PER test getTxPower Display the current radio TX power in dBm setTxPower sl p Set the radio TX power to p dBm getTxDelay Display the radio TX interpacket delay in us setTxDelay u2 d Set the radio TX interpacket delay to d us tx u2 n Transmit n packets 0 infinite txStream Transmit continuous stream of random symbols txTone Transmit single carrier frequency getTxPacket Display the TX packet length and payload setTxLength ul Set length of transmit payload setTxPay load o dO d1 d2 d3 Set TX packet payload data at offset o ululululul Output waitForAck checkCca ccaAttemptMax getTxConfig backoffExponentMin backoffExponentMax waitForAck ul b Enable b 1 or disable
31. y bytes from x address byte aligned getmemhw u4u4 Read y halfwords from x address halfword aligned getmemw u4u4 Read y words from x address word aligned getmem ulu4u4 Generic get memory bitsize address length setmemb u4ul Store byte y in address x byte aligned setmemhw u4u2 Store halfword y in address x halfword aligned setmemw u4u4 Store word y in address x word aligned setmem ulu4u4 Generic set memory bitsize address value hwver Display the hardware version 6 28 Doc ID 17750 Rev 3 ky UM0978 Simple MAC nodetest command classes 3 2 1 Memory test command examples To read 5 bytes from address 0x20000000 enter gt getmemb 0x20000000 5 The following information is displayed getmemb Addresses 0x20000000 0x20000004 contain addr data 0x20000000 0x03 0x20000001 0x0A 0x20000002 0x3c 0x20000003 oxc3 0x20000004 0x00 3 3 Token test commands The token test commands are used to obtain information about the STM32W108 token system Table 4 describes the related supported test commands Table 4 Token test commands Test command Test description tokMap Print the Token Memory Map initTokens Invoke top level token initialization tokRead u2 Read all data of a token u2 creator code tokDump Dump the entire token data set crashinfo Print crash information 3 3 1 Token test commands examples To displ
32. y image 00 ee 4 2 2 Accessing the nodetest application using HyperTerminal 4 3 Simple MAC nodetest command classes 0000000008 5 3 1 LED test commands 0000 0c eee 6 3 1 1 Examples of LED test commands 000e cece eres 6 3 2 Memory test commands 000 eee eee eee 6 3 2 1 Memory test command examples 000 eee eee 7 3 3 Token testcommands 0 00 cece eee tenets 7 3 3 1 Token test commands examples 00 c eee eee ete eee 7 3 4 Reset test commands 000 0c eee 9 3 4 1 Reset test commands examples 00 c eee eee eee eee 9 3 5 PHY security test commandS cc6 2 ose bnse dulsep dees eee verdes ens 10 3 5 1 PHY security test commands examples 200e ences 10 3 6 PHY common test commands 000 cece eee eee ees 11 3 6 1 Phy common test commands examples 0 0 eee eee 12 3 7 PHY common TX test commands 0000 cece eee eee 13 3 7 1 PHY common TX test command examples 00 2000 14 3 8 PHY common RX test commands 00000 c eee eee ees 15 3 8 1 PHY common RX test command examples 0000 16 3 9 PHY stm32w108xxclass test commands 000000 eee ees 17 3 9 1 PHY stm32w108xxclass test command examples 17 3 10 PHY stm32w108xxclass lib timer test commands 18 3 10 1 Phy stm32w108xxclass t

Description - STMicroelectronics

Contents

Download Pdf Manuals

Related Search

Related Contents