Skip to content

Commit 694e5e6

Browse files
authored
Update PlatformIO.md
Update tables, add info about bootloader and upload baud rate, build flags and upload flags
1 parent 0359948 commit 694e5e6

File tree

1 file changed

+32
-8
lines changed

1 file changed

+32
-8
lines changed

PlatformIO.md

Lines changed: 32 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -113,8 +113,13 @@ Below is a table with supported clocks for MiniCore. Defaults to 16 MHz if not s
113113
| 20 MHz | External | `20000000L` |
114114
| 18.432 MHz | External | `18432000L` |
115115
| 16 MHz | External | `16000000L` (default) |
116+
| 14.7456 MHz | External | `14745600L` |
116117
| 12 MHz | External | `12000000L` |
118+
| 11.0592 MHz | External | `11059200L` |
117119
| 8 MHz | External | `8000000L` |
120+
| 7.3728 MHz | External | `7372800L` |
121+
| 3.6864 MHz | External | `3686400L` |
122+
| 1.8432 MHz | External | `1843200L` |
118123
| 8 MHz | Internal | `8000000L` |
119124
| 1 MHz | Internal | `1000000L` |
120125

@@ -161,16 +166,28 @@ Specifies if the EEPROM memory should be retained when uploading using a program
161166

162167
### `board_upload.speed`
163168
Specifies the upload baud rate. Available baud rates is shown in the table below, had has to corrolate with `build_board.f_cpu`.
164-
Recommended baud rate for the particular clock speed is in **bold text**.
169+
170+
**Note that if you're using a programmer that communicates with Avrdude with a serial port (Arduino as ISP, STK500, etc.) the `board_upload.speed` field will interfere with the programmer's baud rate. In this case, use `board_bootloader.speed` to set the bootloader baud rate, and `board_upload.speed` to set the baud rate for the programmer.**
171+
172+
Recommended baud rate for the particular clock speed is in **bold text**.
173+
174+
### `board_upload.speed`
175+
Specifies the upload baud rate. Available baud rates is shown in the table below, had has to corrolate with `build_board.f_cpu`.
176+
Recommended baud rate for the particular clock speed is in *italic text*.
165177

166178
| | 1000000 | 500000 | 460800 | 250000 | 230400 | 115200 | 57600 | 38400 | 19200 | 9600 |
167179
|-------------|---------|--------|--------|--------|--------|--------|--------|--------|-------|--------|
168-
| `20000000L` | | X | | X | | **X** | | | X | |
169-
| `18432000L` | | | X | | X | **X** | X | X | X | X |
170-
| `16000000L` | X | X | | X | | **X** | | X | X | X |
171-
| `12000000L` | | X | | X | | | **X** | | X | X |
172-
| `8000000L` | X | X | | X | | X | X | **X** | X | X |
173-
| `1000000L` | | | | | | | | | | **X** |
180+
| `20000000L` | | X | | X | | *X* | | | X | |
181+
| `18432000L` | | | X | | X | *X* | X | X | X | X |
182+
| `16000000L` | X | X | | X | | *X* | | X | X | X |
183+
| `14745600L` | | | X | | X | *X* | X | X | X | X |
184+
| `12000000L` | | X | | X | | | *X* | | X | X |
185+
| `11059200L` | | | X | | X | X | *X* | X | X | X |
186+
| `8000000L` | X | X | | X | | X | X | *X* | X | X |
187+
| `7372800L` | | | X | | X | *X* | X | X | X | X |
188+
| `3686400L` | | | X | | X | *X* | X | X | X | X |
189+
| `1843200L` | | | | | X | *X* | X | X | X | X |
190+
| `1000000L` | | | | | | | | | | *X* |
174191

175192

176193
### `build_unflags`
@@ -182,6 +199,7 @@ This parameter is used to set compiler flags. This is useful if you want to for
182199

183200
| Flag | Default size | Description |
184201
|-----------------------------|--------------|-----------------------------------------------------------|
202+
| -lprintf_flt | | Lets you print floats with printf (occupies ~1.5 kB) |
185203
| -DSERIAL_RX_BUFFER_SIZE=128 | 64 bytes | Sets the serial RX buffer to 128 bytes |
186204
| -DSERIAL_TX_BUFFER_SIZE=128 | 64 bytes | Sets the serial TX buffer to 128 bytes |
187205
| -DTWI_BUFFER_SIZE=64 | 32 bytes | Sets the TWI (i2c) buffer to 64 bytes |
@@ -202,7 +220,13 @@ Supports all Avrdude compatible programmers such as `usbasp`, `usbtiny` and `stk
202220

203221
### `upload_flags`
204222
Used to pass extra flags to Avrdude when uploading using a programmer.
205-
Typical parameters are `-PUSB`, `-B[clock divider]` and `-b[baudrate]`
223+
Typical parameters are `-PUSB`, `-B[clock divider]` and `-b[baudrate]`.
224+
**Note that every flag has to be on its own line, and they have to be indented with two spaces:**
225+
```ini
226+
upload_flags = -PUSB
227+
-B32
228+
-v
229+
```
206230

207231

208232
### `monitor_port`

0 commit comments

Comments
 (0)