|9 years ago|
|Makefile||9 years ago|
|README.md||10 years ago|
|main.c||10 years ago|
This application is a showcase for RIOT's hardware support. Using it for your board, you should be able to interactively use any hardware that is supported.
To do this, the application uses the
modules and all the driver modules each board supports.
shell is a very simple interactive command interpreter that can be
used to call functions. Many of RIOT's modules define some generic
shell commands. These are included via the
ps module which provides the
ps shell command is
Finally, in order for the shell to receive input, the
Build, flash and start the application:
export BOARD=your_board make make flash make term
term make target starts a terminal emulator for your board. It
connects to a default port so you can interact with the shell, usually
/dev/ttyUSB0. If your port is named differently, the
PORT=/dev/yourport variable can be used to override this.
The shell commands come with online help. Call
help to see which commands
exist and what they do.
help command on an msba2:
2014-05-06 13:14:38,508 - INFO # > help 2014-05-06 13:14:38,511 - INFO # Command Description 2014-05-06 13:14:38,515 - INFO # --------------------------------------- 2014-05-06 13:14:38,518 - INFO # reboot Reboot the node 2014-05-06 13:14:38,522 - INFO # id Gets or sets the node's id. 2014-05-06 13:14:38,529 - INFO # heap Shows the heap state for the LPC2387 on the command shell. 2014-05-06 13:14:38,535 - INFO # ps Prints information about running threads. 2014-05-06 13:14:38,540 - INFO # date Gets or sets current date and time. 2014-05-06 13:14:38,544 - INFO # temp Prints measured temperature. 2014-05-06 13:14:38,548 - INFO # hum Prints measured humidity. 2014-05-06 13:14:38,553 - INFO # weather Prints measured humidity and temperature. 2014-05-06 13:14:38,557 - INFO # offset Set temperature offset. 2014-05-06 13:14:38,563 - INFO # cur Prints current and average power consumption. 2014-05-06 13:14:38,567 - INFO # rstcur Resets coulomb counter. 2014-05-06 13:14:38,573 - INFO # addr Gets or sets the address for the transceiver 2014-05-06 13:14:38,579 - INFO # chan Gets or sets the channel for the transceiver 2014-05-06 13:14:38,585 - INFO # txtsnd Sends a text message to a given node via the transceiver 2014-05-06 13:14:38,592 - INFO # monitor Enables or disables address checking for the transceiver 2014-05-06 13:14:38,598 - INFO # dread_sec Reads the specified sector of inserted memory card 2014-05-06 13:14:38,605 - INFO # dread Reads the specified bytes from inserted memory card 2014-05-06 13:14:38,610 - INFO # dget_ssize Get the sector size of inserted memory card 2014-05-06 13:14:38,616 - INFO # dget_scount Get the sector count of inserted memory card 2014-05-06 13:14:38,622 - INFO # dget_bsize Get the block size of inserted memory card 2014-05-06 13:14:38,625 - INFO # mersenne_init initializes the PRNG 2014-05-06 13:14:38,630 - INFO # mersenne_get returns 32 bit of pseudo randomness
ps command on an msba2:
2014-05-09 17:38:33,388 - INFO # > ps 2014-05-09 17:38:33,394 - INFO # pid | name | state Q | pri | stack ( used) location 2014-05-09 17:38:33,401 - INFO # 0 | idle | pending Q | 31 | 160 ( 148) 0x40000014 2014-05-09 17:38:33,407 - INFO # 1 | main | running Q | 15 | 2560 ( 848) 0x400000b4 2014-05-09 17:38:33,414 - INFO # 2 | uart0 | bl rx _ | 14 | 512 ( 296) 0x40000ce0 2014-05-09 17:38:33,420 - INFO # 3 | radio | bl rx _ | 13 | 512 ( 188) 0x40001a74 2014-05-09 17:38:33,427 - INFO # 4 | Transceiver | bl rx _ | 12 | 512 ( 300) 0x40001f98 2014-05-09 17:38:33,431 - INFO # | SUM | | | 4256
id command sets or gets the node's id. It can be used to
identify a node. Boards that support the
config module will write
the id to a persistent memory location so the node keeps it across
ps command is used to analyze the thread's state and memory
The default application does not include any upper network layers, but you can use the transceiver directly to communicate with the nodes neighbourhood.
The application comes with a thread that prints out any packets the
node receives automatically. The
monitor command can be used to
change this to only printing packets addressed for this node. Use
monitor 0 to disable monitoring and
monitor 1 to reenable it.
txtsnd can be used to send network packets using the boards default
txtsnd 0 hello world to broadcast the string
hello world. Type
txtsnd 42 hello forty-two to send a message to
the node with network address 42.
The nodes address can be configured using
a parameter to see the current address, or
addr 42 to set it to 42.
pan (where available) commands can be used likewise
to set channel and personal area network identifier respectively.