Skip to content

Commit 73eccd6

Browse files
authored
Update bcm2711_bootloader_config.md (raspberrypi#1682)
* Update bcm2711_bootloader_config.md Document max length limitations and default values for the NETCONSOLE property * Update bcm2711_bootloader_config.md
1 parent d41d69f commit 73eccd6

File tree

1 file changed

+13
-6
lines changed

1 file changed

+13
-6
lines changed

hardware/raspberrypi/bcm2711_bootloader_config.md

Lines changed: 13 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -146,6 +146,7 @@ Version: 2020-04-16
146146
Specify the custom directory prefix string used when `TFTP_PREFIX` is set to 1. For example:- `TFTP_PREFIX_STR=tftp_test/`
147147

148148
Default: ""
149+
Max length: 32 characters
149150
Version: 2020-04-16
150151

151152
### PXE_OPTION43
@@ -228,22 +229,28 @@ N.B. NETCONSOLE blocks until the ethernet link is established or a timeout occur
228229
#### Format
229230
See https://wiki.archlinux.org/index.php/Netconsole
230231
```
231-
src_port@src_ip/dev_name,dst_port@tgt_ip/tgt_mac
232-
E.g. 6665@169.254.1.1/eth0,6666@/
232+
src_port@src_ip/dev_name,dst_port@dst_ip/dst_mac
233+
E.g. 6665@169.254.1.1/,6666@/
233234
```
234-
In order to simplify parsing, the bootloader requires every field separator to be present. In the example the target IP address (255.255.255.255) and target mac address (00:00:00:00:00) are assigned default values.
235+
In order to simplify parsing, the bootloader requires every field separator to be present. The source ip address must be specified but the following fields may be left blank and assigned default values.
236+
237+
* src_port - 6665
238+
* dev_name - "" (the device name is always ignored)
239+
* dst_port - 6666
240+
* dst_ip - 255.255.255.255
241+
* dst_mac - 00:00:00:00:00
235242

236243
One way to view the data is to connect the test Pi 4 to another Pi running WireShark and select “udp.srcport == 6665” as a filter and select `Analyze -> Follow -> UDP stream` to view as an ASCII log.
237244

238245
`NETCONSOLE` should not be enabled by default because it may cause network problems. It can be enabled on demand via a GPIO filter e.g.
239246
```
240247
# Enable debug if GPIO 7 is pulled low
241248
[gpio7=0]
242-
BOOT_UART=1
243-
NETCONSOLE=6665@169.254.1.1/eth0,6666@/
249+
NETCONSOLE=6665@169.254.1.1/,6666@/
244250
```
245251

246-
Default: ""
252+
Default: "" (not enabled)
253+
Max length: 32 characters
247254
Version: 2020-09-03
248255

249256
### USB_MSD_EXCLUDE_VID_PID

0 commit comments

Comments
 (0)