µracoli Manual Version foo

- µracoli
- User Guide
- Reference Guide

uracoli-wuart.md
1 # wuart - The Wireless UART (needs merge) {#md_wuart}
2
3 ## Introduction
4
5 The wireless UART can be used to communicate between two PCs via a RF
6 link, or to communicate between a PC and an autnomous sensor/actor
7 node. The WUART application starts on a fixed channel and is automatically
8 in the transparent data mode.
9
10 +------------------+ +------------------+
11 | Terminal PC#1 | | Terminal PC#2 |
12 |------------------| |------------------|
13 | Wuart 0.2 ... | | Wuart 0.2 ... |
14 |#2: howdy #1 | |#1: hiho #2 |
15 |#3: t=24 | |#3: t=24 |
16 |#2: yyyyy | |#1: xxxxx |
17 |#3: t=25 | |#3: t=25 |
18 | | | |
19 +-------*----------+ +--------*---------+
20 | |
21 |serial IF |serial IF
22 | |
23 | ^ ^ |
24 +---*----+ | | +---*----+
25 | WUART | | | | WUART |
26 | Node#1 +--+ +--+ Node#2 |
27 | | | |
28 +--------+ ^ +--------+
29 | +--------+
30 +-+ Sensor |
31 | Node#3 |
32 +--------+
33
34 ## Compiling
35
36 The wireless UART for the radiofaro board is build with the following
37 commands:
38
39 cd uracoli-src-<version>
40 make -C wuart radiofaro
41
42 The firmware file `bin/wuart_radiofaro.hex` is now available.
43 It can be flashed into the microcontroller e.g. with an AVR-Dragon-programmer
44 using the command:
45
46 avrdude -Pusb -cdragon_jtag -pm128rfa1 -U bin/wuart_radiofaro.hex
47
48 Now open a serial terminal programm (e.g. @ref sterm), adjust the baudrate,
49 set the hardware handshake to _none_ and after a reset of WUART node you will
50 see a boot message, similiar to this:
51
52 Wuart 0.2 chan=17 radio 02.01
53
54 Do the same steps for a second board and try to chat between the terminal
55 windows.
56
57 A list of all supported boards is displayed with the command:
58
59 make -C wuart list
60 make: Entering directory `/home/axel/Work/uracoli-src-<version>/wuart'
61 any2400 : A.N. Solutions ANY Brick
62 any2400st : A.N. Solutions ANY Stick
63 ...
64 zgbt1281a2uart1 : Meshnetics Zigbit A2, using UART1
65 zigduino : Zigduino made by Logos Electromechanical LLC
66
67 Alternatively you can compile the example programm `xmpl_linbuf_tx.hex`
68 and watch the text that appears in the terminal window of the PC.
69
70 make -C xmpl -f xmpl_linbuf_tx.mk <sensorboard>
71
72 This example can be used as starting point for an own application.
73
74 ## Protocoll
75