rarias/nixos-riscv
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

README: init

Browse Source
This commit is contained in:
matthewcroughan 2022-07-10 08:42:14 +01:00
parent d7a0148b4f
commit ee7641c770
1 changed files with 37 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
README.md Normal file
View File

@ -0,0 +1,37 @@
# Flashing the Bootloader
1. Do not apply power to the board
2. Attach the board via serial to your system, ensuring power is still not applied
3. Ensure the serial shows up in `/dev/ttyUSB*`, you can see this by running `dmesg` after plugging in the device
```
❯ dmesg
[200199.253566] usb 1-2: new full-speed USB device number 79 using xhci_hcd
[200199.386983] usb 1-2: New USB device found, idVendor=0403, idProduct=6001, bcdDevice= 6.00
[200199.386988] usb 1-2: New USB device strings: Mfr=1, Product=2, SerialNumber=3
[200199.386990] usb 1-2: Product: FT232R USB UART
[200199.386991] usb 1-2: Manufacturer: FTDI
[200199.386992] usb 1-2: SerialNumber: A50285BI
[200199.390344] ftdi_sio 1-2:1.0: FTDI USB Serial Device converter detected
[200199.390363] usb 1-2: Detected FT232RL
[200199.391207] usb 1-2: FTDI USB Serial Device converter now attached to ttyUSB0
^^^^^^^
^ This becomes /dev/ttyUSB0
```
4. `nix run github:matthewcroughan/visionfive-nix#flashBootloader /dev/ttyUSB0`
5. Wait to be told to apply power to the board this may take a while as U-Boot and OpenSBI are being cross-compiled.
```
Terminal ready
### Apply power to the VisionFive Board ###
```
Once power is applied, picocom will send the OpenSBI/U-Boot payload via XMODEM. You can then flash NixOS or any other distribution that follows the Distro Boot specification[^1] to an SD card and boot it.
###### Why do I need to flash the bootloader?
https://github.com/starfive-tech/u-boot/issues/30
The VisionFive ships with a version of OpenSBI/U-Boot that does not follow the distro-boot specification. NixOS and other distros would like to remain generic, without vendor specific details entering their system. This means booting NixOS requires flashing the bootloader as described above.
[^1]: https://source.denx.de/u-boot/u-boot/-/blob/v2022.04/doc/develop/distro.rst