mirror of
https://github.com/pine64/blisp.git
synced 2025-01-22 13:40:28 +00:00
improved blisp instructions (#12)
* Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md * Update README.md Co-authored-by: Ben V. Brown <5425387+Ralim@users.noreply.github.com> * Update README.md Co-authored-by: Ben V. Brown <5425387+Ralim@users.noreply.github.com>
This commit is contained in:
River
GitHub
parent
4618e722ab
commit
7601709a4c
65
README.md
65
README.md
@ -15,11 +15,16 @@ Open source tool and library for flashing Bouffalo RISC-V MCUs.
|
||||
# Supported Devices
|
||||
- [X] [Pinecil V2](https://wiki.pine64.org/wiki/Pinecil)
|
||||
|
||||
# Supported OS
|
||||
- [x] Windows
|
||||
- [x] Linux
|
||||
- [ ] Apple (WIP: work-in-progress)
|
||||
|
||||
# Building
|
||||
|
||||
## Clone repository
|
||||
|
||||
If you have not cloned this repository locally; check out the git repository locally by running
|
||||
If you have not cloned this repository locally; clone the git repository locally by running
|
||||
|
||||
```bash
|
||||
git clone --recursive https://github.com/pine64/blisp.git
|
||||
@ -53,7 +58,8 @@ blisp --chip bl60x --reset -p /dev/ttyUSB0 name_of_firmware.bin
|
||||
# Update Pinecil V2
|
||||
1. Windows or Linux: use the easy pre-made blisp executable.
|
||||
2. Instructions on [Pinecil Wiki firmware](https://wiki.pine64.org/wiki/Pinecil#Update_Pinecil_V2)
|
||||
3. For Troubleshooting, [see down below](https://github.com/pine64/blisp#troubleshooting) or [Pinecil Wiki](https://wiki.pine64.org/wiki/Pinecil#Troubleshooting_V2_Flashing)
|
||||
3. For Troubleshooting the pre-made Blisp, [see down below](https://github.com/pine64/blisp#troubleshooting) or [Pinecil Wiki](https://wiki.pine64.org/wiki/Pinecil#Troubleshooting_V2_Flashing)
|
||||
4. If you prefer to build the Blisp Flasher from Code, or have an ARM archietecture (i.e., Pinebook Pro laptop), see below.
|
||||
|
||||
|
||||
# Build BLISP Flasher from code for BL70x
|
||||
@ -74,54 +80,56 @@ mkdir -p tools/blisp/data/bl70x
|
||||
```
|
||||
Note: the blisp command will now be in `build/tools/blisp/` folder and could later be run with flags as ` ./tools/blisp/blisp` unless you cd into that folder.
|
||||
|
||||
2. Get and cp or mv eflash_loader_32m.bin to bl70x folder
|
||||
2. Get the Bouffalo `eflash_loader_32m.bin`
|
||||
|
||||
``` /build/tools/blisp/data/bl70x/eflash_loader_32m.bin ```
|
||||
a. Download [Bouffalo Lab Dev Cube here](https://dev.bouffalolab.com/download).
|
||||
|
||||
a. Download [eflash*32m.bin here](https://github.com/River-b/blisp/tree/master/eflash).
|
||||
b. Extract the DevCube download and get the `eflash_loader_32m.bin` needed for the bl70x chip (the MCU in Pinecil V2).
|
||||
|
||||
b. Move eflash*32m.bin to the build/tools/data/bl70x folder
|
||||
Check this path for the file:
|
||||
``` /BouffaloLabDevCube-v1.8.1/chips/bl702/eflash_loader/eflash_loader_32m.bin ```
|
||||
|
||||
c. Move eflash*32m.bin to the folder build/tools/data/bl70x
|
||||
c. cp or mv the `eflash_loader_32m.bin` to your `build/tools/data/bl70x` folder from step 1. The rest of the Dev Cube could be deleted.
|
||||
|
||||
d. If it is a Zip, then unzip & move it.
|
||||
```
|
||||
unzip eflash_loader_32m.zip -d tools/blisp/data/bl70x/
|
||||
```
|
||||
`/build/tools/blisp/data/bl70x/eflash_loader_32m.bin`
|
||||
|
||||
### Continue with steps if building code to update Pinecil V2.
|
||||
### Continue with the next steps if building code to update Pinecil V2.
|
||||
|
||||
⛔ Do not use the Pinecil DC barrel jack while updating firmware or you may destroy your PC. ⛔
|
||||
⛔ Do not use the Pinecil DC barrel jack while updating firmware or it may destroy your PC and pinecil. ⛔
|
||||
|
||||
3. **Get V2 firmware** from Github Ralim's IronOS
|
||||
|
||||
a. Download the newest stable [firmware release here](https://github.com/Ralim/IronOS).
|
||||
a. Download the newest stable [firmware release here](https://github.com/Ralim/IronOS/releases) (or a beta firmware). Hint: go to Assets section below the comments and get the Pinecilv2.zip file.
|
||||
|
||||
b. Or download the Beta firmware [IronOS here](https://github.com/Ralim/IronOS/actions/runs/3545583488)
|
||||
Scroll to the very bottom of the page and download **Pinecilv2**. This link is to [beta that has BLE and also works for EPR chargers](https://github.com/Ralim/IronOS/actions/runs/3545583488)
|
||||
b. If it's in Zip form, then extract **Pinecilv2.zip** and select a language file (English = `Pinecilv2_EN.bin`).
|
||||
|
||||
d. Extract **Pinecilv2.zip** and select a single language file (English = ```Pinecilv2_EN.bin```).
|
||||
c. Move the `Pinecilv2_EN.bin` (or selected language) into the same folder as the blisp command.
|
||||
|
||||
e. Move the Pinecilv2_EN.bin (or selected language) into the same folder as the blisp command.
|
||||
```
|
||||
build/tools/blisp/Pinecilv2_EN.bin
|
||||
```
|
||||
can delete all the rest of the Pinecilv2**.zip as it is not needed.
|
||||
`build/tools/blisp/Pinecilv2_EN.bin`
|
||||
|
||||
4. Connect Pinecil to PC/laptop: long hold [`-`] , then connect cable. Can release the [-] after about 15-20second. V2 screen should be Empty/black, if not, then repeat connection, or find another cable/port. Pinecil connects as a serial COM port.
|
||||
d. Could delete the rest of Pinecilv2.zip, it is not needed.
|
||||
|
||||
5. If this fails, see [troubleshooting below](https://github.com/River-b/blisp/blob/master/README.md#troubleshooting).
|
||||
4. Connect Pinecil to PC/laptop: long hold `[-]`, then connect cable. Can release the `[-]` after about 15-20second.
|
||||
|
||||
a. V2 screen should be Empty/black, if not, then repeat connection, or find another cable/port.
|
||||
|
||||
b. Pinecil connects as a serial port (Linux = /dev/ttyACM_x_, Windows = COM_x_).
|
||||
|
||||
c. use `dmesg -w` if you would like to watch the connection, Pinecil BL706 will connect as Manufacturer: BLIOT, ttyACM device.
|
||||
|
||||
5. If this fails, see [troubleshooting below](https://github.com/pine64/blisp#troubleshooting).
|
||||
|
||||
6. If you are in the folder `blisp/build/tools/blisp/` then execute
|
||||
```
|
||||
sudo ./blisp write -c bl70x --reset Pinecilv2_EN.bin
|
||||
```
|
||||
Note: if a different language was selected, replace `Pinecilv2_**.bin` above with the chosen file name.
|
||||
|
||||
7. Almost done: unplug from the PC and restart V2. Hold down the minus `(-)` button to see the new version number.
|
||||
Note: if a different language is selected, replace `Pinecilv2_EN.bin` above with the chosen file name.
|
||||
|
||||
7. Almost done: unplug from the PC and restart V2. Hold down the minus `[-]` button to see the new version number.
|
||||
|
||||
8. Before making menu changes, it is recommended to first [Restore Settings to Default](https://github.com/Ralim/IronOS/blob/dev/Documentation/GettingStarted.md#settings-menu).
|
||||
Simply go to Advanced settings > Restore default settings, confirm using the `(+)` button. This sets all menu items to defaults, keeps the same firmware version, and does not affect any Boot-up logo art if applicable. Setting defaults first avoids unexpected behavior due to some changes in upgrades.
|
||||
Simply go to Advanced settings > Restore default settings, confirm using the `[+]` button. This sets all menu items to defaults, keeps the same firmware version, and does not affect any Boot-up logo art if applicable. Setting defaults first avoids unexpected behavior due to some changes in upgrades.
|
||||
|
||||
9. Congradulations, and [Stay Fluxey, my friends!](https://www.reddit.com/r/PINE64official/comments/xk9vxu/most_interesting_man_in_the_world_i_dont_always/?utm_source=share&utm_medium=web2x&context=3)
|
||||
|
||||
@ -136,7 +144,7 @@ Note: if a different language was selected, replace `Pinecilv2_**.bin` above wit
|
||||
|
||||
d. try a different PC/laptop
|
||||
|
||||
2. It is important to hold down the `(-)` minus button _before_ plugging in the Usb-c cable, and do not release the button for another 15-20 seconds. Try to hold it a little longer before releasing if your computer is slow and it is not working. In rare circumstances on fussy USB ports, keep holding the `(-)` for the entire update.
|
||||
2. It is important to hold down the `[-]` minus button _before_ plugging in the Usb-c cable, and do not release the button for another 15-20 seconds. Try to hold it a little longer before releasing if your computer is slow and it is not working. In rare circumstances on fussy USB ports, keep holding the `[-]` for the entire update.
|
||||
|
||||
3. If all of this fails, then join one of the [Live Community Chat channels linked](https://wiki.pine64.org/wiki/Pinecil#Community_links) in the Pinecil Wiki as volunteers there might be able to help.
|
||||
|
||||
@ -152,3 +160,4 @@ Note: if a different language was selected, replace `Pinecilv2_**.bin` above wit
|
||||
- [ ] Another code style
|
||||
- [ ] Finalize API
|
||||
- [ ] SDIO and JTAG support
|
||||
- [ ] Add Apple support
|
||||
|
||||
Loading…
Reference in New Issue
Block a user