forked from rsta2/circle
-
Notifications
You must be signed in to change notification settings - Fork 0
/
bootloader.txt
155 lines (102 loc) · 6.07 KB
/
bootloader.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
BOOTLOADER
The Circle project has an integrated serial bootloader, which can be used to
speed-up the development process and to make it more comfortable. The bootloader
has been adapted from the well-known bootloader by David Welch.
To use the bootloader, you have to do the following:
1. You need a serial USB adapter (3.3V level) connected to GPIO14/15 (Broadcom
numbering) of your Raspberry Pi computer on one side and to your development
machine on the other. On the Raspberry Pi 5 the dedicated UART connector is used
to connect the serial adapter. See this document for the pinout:
https://datasheets.raspberrypi.com/debug/debug-connector-specification.pdf
2. On your development machine there must be a python3 interpreter (including the
python3-pyserial module) installed. You may also need the terminal program
"putty".
3. Add the following lines to the file Config.mk in the Circle root directory:
SERIALPORT = /dev/ttyUSB0 (device of your serial USB adapter)
FLASHBAUD = 115200 (baud rate for loading the application)
USERBAUD = 115200 (baud rate used by the application)
By increasing FLASHBAUD you can speed-up to loading process very much. It
depends on your serial adapter, which baud rates are possible. Common values are
460800, 921600 or higher.
USERBAUD is the baud rate, used by the application itself, if it communicates
using the serial interface.
4. The Circle project libraries used in your application have to be build
manually using "./makeall" as described in the main README.md file.
5. You have to prepare a SD card with a FAT partition, which starts your
Raspberry Pi in bootloader mode. Go to the boot/ subdirectory and enter:
make all
5b. If building for AArch64, then additionally enter:
make bootloader64
After completion copy the files from boot/ to the SD card's FAT partition and in
the destination, rename config32.txt or config64.txt (for AArch64) to config.txt.
Please note, that you have to repeat this step, if you change the parameter
FLASHBAUD in Config.mk. The built bootloader is specific for this baud rate. Put
the SD card into your Raspberry Pi, which is connected to your development
machine and power it on.
6. The bootloader starts when you go to the subdirectory of your application (or
sample program) in a shell and enter:
make flash
7. If your application uses the serial interface itself, you can start the
terminal program "putty" directly from the shell. You have to enter "make
monitor" like you have done for "flash" before and putty should open with the
right communication parameters.
8. To start another development cycle, power off and on the Raspberry Pi, and
after rebuilding do again "make flash".
Using the Flash Tool "Flashy"
-----------------------------
The above procedure describes flashing the device using the traditional python3 based flash
tool and bootloader. There is also a new flash tool and bootloader that provide improved
features:
* The new flash tool waits for ack messages from the bootloader to ensure it's ready. If
the device isn't ready it will wait until you reset it.
* Improved reliability as the new bootloader now performs checksums and reports any errors
with the transfer.
* A new "fast transfer mode" effectively doubles the transfer rate by sending binary instead
of hex encoded data. RPi 2 can handle 2M Baud in fast mode (equivalent to 4M Baud with
the old flasher) and RPi 3 can handler 3M baud (equivalent to 6M).
* The new flasher tool can send magic reboot strings and wait for the device to become ready
before starting the transfer - which can be faster than pessimistic delays and hoping the
device is ready.
* After flashing the new flasher tool can automatically switch into monitor mode (switching
baud rates if necessary) to view the output of the flashed program.
* Ability to reset the bootloader to recover from a previously cancelled or failed transfer.
* Ability to introduce a "go delay" - a delay that the bootloader will stall for between
receiving the go command and launching the user program. This can be used if you need
to see the very start of the debug log and your monitor program takes too long to start.
The new flasher tool is written in JavaScript and requires NodeJS to be installed. To use it:
1. Make sure you have NodeJS installed
2. Go to the `tools/flashy` sub-folder and run `npm install` to install the required
serial port module.
3. If you're currently using an old version of the bootloader, rebuild the latest version and
copy it to the SD card. (This is optional as the new flash script works with the old
bootloader but most new features won't work)
4. In your Config.mk set the variable `USEFLASHY`, along with the other serial port settings:
USEFLASHY = 1
REBOOTMAGIC = <magicstring>
FLASHYFLAGS = <other command line args for the flashy script>
SERIALPORT = /dev/ttyUSB0
FLASHBAUD = 115200
USERBAUD = 115200
5. Flash the device as per before:
make flash
6. If the device is ready the transfer will start immediately, otherwise a "waiting for device"
message will be displayed until you power cycle or reset the device.
You can also manually launch the flasher tool like so...
node tools/flashy/flashy.js /dev/ttyUSB0 kernel7.hex --flashBaud:2000000
Or, pass additional args via the make script:
make flash FLASHYFLAGS=--godelay:500
For a full set of command line args, run the script with --help
node tools/flashy/flashy.js --help
For details on using this under WSL, see the [Windows build instructions](windows-build.txt)
If you want to use Flashy with the Bluetooth modules HC-05 or HC-06, please see
[these instructions](https://github.com/rsta2/circle/pull/312).
Using "Flashy" v2
-----------------
There is a new improved version of Flashy, which is maintained in a separate
project:
https://github.com/toptensoftware/flashy
Details about the features of this version and its installation can be found in
the project README. The configuration in Circle to use this version is very
similar as described above, with one difference. In your Config.mk you have to
specify:
USEFLASHY = 2