[docs] Add dumping instructions

This commit is contained in:
Kuba Szczodrzyński
2022-09-10 18:24:10 +02:00
parent 9495e3418c
commit db5bf4fc46
3 changed files with 37 additions and 0 deletions

View File

@@ -13,9 +13,11 @@
* Beken BK72xx
* [General info](docs/platform/beken-72xx/README.md)
* [Flashing](docs/platform/beken-72xx/flashing.md)
* [Dumping](docs/platform/beken-72xx/dumping.md)
* Realtek AmebaZ Series
* [General info](docs/platform/realtek/README.md)
* [Flashing (AmebaZ)](docs/platform/realtek-ambz/flashing.md)
* [Dumping (AmebaZ)](docs/platform/realtek-ambz/dumping.md)
* [Debugging](docs/platform/realtek/debugging.md)
* [Exception decoder](docs/platform/realtek/exception-decoder.md)
* C library

View File

@@ -0,0 +1,20 @@
# Dumping - Beken 72xx
- [bk7231tools](https://github.com/notkmhn/bk7231tools)
## Dumping firmware
Dumping is also done using UART (TX1/RX1).
- Connect power to the board: GND and 3V3 (from your UART adapter or a higher-powered source).
- Connect an USB<->UART adapter to the chip: RX->TX1, TX->RX1.
- Install Python and Git.
- Clone bk7231tools: `git clone https://github.com/notkmhn/bk7231tools`
- `cd bk7231tools`
- Run dumping: `python bk7231tools.py read_flash -d COM96 -b 230400 -s 0 -c 512 dump.bin`. Change the port (`-p`) and baudrate (`-b`) if you want.
!!! note
The `--no-verify-checksum` is not required on BK7231N in latest versions of `bk7231tools`, despite the readme saying otherwise.
It's advised to run without that option, to make sure the dump is valid.
- You have 10 seconds to reset the chip (pull CEN to GND, or power-cycle the board) after running the command. The program will then begin dumping.
!!! note
If you need, you can increase the linking timeout using `--timeout` parameter.

View File

@@ -0,0 +1,15 @@
# Dumping - Beken 72xx
- [rtltool.py](https://github.com/libretuya/ltchiptool/blob/master/ltchiptool/soc/ambz/util/rtltool.py)
## Dumping firmware
Dumping is also done using UART (TX2/RX2; Log_UART).
- Connect power to the board: GND and 3V3 (from your UART adapter or a higher-powered source).
- Connect an USB<->UART adapter to the chip: RX->TX1, TX->RX1.
- Put the chip into download mode: reset the chip, while pulling UART2_TX to GND. If successful, the chip should print few garbage characters every second.
- Disconnect TX from GND after powering up the board.
- Install Python.
- Grab `rtltool.py` from the link above.
- Run dumping: `python rtltool.py -p COM60 rf 0 0x200000 dump.bin`. Change the port (`-p`) to your adapter's port.