.github/ISSUE_TEMPLATE/bug_report.md

   1 ---
   2 name: Bug report
   3 about: Create a bug report for the bootloader EEPROM or rpi-eeprom-update scripts. Please use the Raspberry Pi General Discussion forum for general questions about the bootloader.
   4
   5 ---
   6
   7 This repository tracks bugs for the Raspberry Pi 4 bootloader EEPROM and Linux update scripts.
   8
   9 * If you suspect a hardware problem then please read the [Boot Problems](https://www.raspberrypi.org/forums/viewtopic.php?p=437084) post first before contacting the reseller.
  10 * Support questions or should be posted on the Raspberry Pi [General Discussion](https://www.raspberrypi.org/forums/viewforum.php?f=63)**
  11
  12 **Mandatory information**
  13 * Raspberry Pi model
  14 * Board revision (cat /proc/cpuinfo | grep Revision)
  15 * Operating system version .
  16 * Details of any hardware attached e.g. links to USB
  17 * Photo of the HDMI diagnostics screen, UART trace.
  18
  19 **Describe the bug**
  20 A clear and concise description of what the bug is.
  21
  22 **To Reproduce**
  23 Steps to reproduce the behavior:
  24
  25 **Expected behaviour**
  26 A clear and concise description of what you expected to happen.
  27
  28 **Bootloader version and configuration**
  29 Please include the bootloader version and config.
  30 ```bash
  31 vcgencmd bootloader_version
  32 vcgencmd bootloader_config
  33 ```
  34
  35 **SD card boot (please complete the following information):**
  36  - SD card type
  37  - Partition information (sudo fdisk -l) if you are able to obtain this from another computer.
  38
  39 **USB boot (please complete the following information):**
  40 Verify that the the USB device works correctly when hot-plugged under Linux and attache the output of 'lsusb -vvv'
  41
  42 **Network boot (please complete the following information):**
  43 Network boot bug normally require one or more of the following log types. [PiServer](https://github.com/raspberrypi/piserver) is the officially supported network boot server.
  44
  45  - DHCP server configuration files e.g. dnsmasq.conf
  46  - Wireshark binary packet capture
  47  - UART logs with `uart_2ndstage=1` set in `config.txt`
  48
  49 **NVMe boot (please complete the following information):**
  50
  51 ```bash
  52 sudo apt-get install nvme-cli
  53 sudo nvme list
  54 sudo nvme id-ctrl -H /dev/nvme0
  55 sudo nvme list-ns /dev/nvme0
  56 sudo nvme id-ns -H /dev/nvme0 --namespace-id=1
  57 ```
  58
  59 **Additional context**
  60 Add any other context about the problem here.
  61
  62 The [Bootloader configuration](https://www.raspberrypi.org/documentation/computers/raspberry-pi.html#raspberry-pi-4-bootloader-configuration) page describes how to enable UART or NETCONSOLE logs. For complex USB boot issues NETCONSOLE logs are recommended.
  63