µracoli Manual  Version foo
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