Skip to content

Commit 7c0b1ee

Browse files
Interface: Fix blhost instructions
1 parent c2e7b9b commit 7c0b1ee

File tree

1 file changed

+12
-5
lines changed

1 file changed

+12
-5
lines changed

software/interface.md

Lines changed: 12 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -124,11 +124,13 @@ You can also flash a full DAPLink image to the <span class="v2">V2</span> device
124124

125125
[Download latest full DAPLink image](/docs/software/assets/DAPLink-factory-release/kl27z_bl_0255_if_0255_microbit_full_image.bin){: .btn.sm-btn download}
126126

127-
You will need to register for and download the [**Bootloader Host Application (blhost)**](https://www.nxp.com/design/software/development-software/mcuxpresso-software-and-tools-/mcuboot-mcu-bootloader-for-nxp-microcontrollers:MCUBOOT?&tab=Design_Tools_Tab) from NXP. IN the /bin folder you will find executables for your operating system.
127+
You will need to register for and download the [**Bootloader Host Application (blhost)**](https://www.nxp.com/design/software/development-software/mcuxpresso-software-and-tools-/mcuboot-mcu-bootloader-for-nxp-microcontrollers:MCUBOOT?&tab=Design_Tools_Tab) from NXP. In the `/bin` folder you will find executables for your operating system.
128+
129+
<div class="alert alert-warning">Please ensure you are using the latest version of blhost, old versions incompatibility with new OS versions can have unexpected results.</div>
128130

129131
### Enter bootloader mode
130132

131-
To enter this mode we need to ground TP1 during board power up, this is the BOOTMODE pin in the KL27. To do that, connect with a wire (or something like a paper-clip) TP1 red circle) with any ground point (black square) as you insert the USB cable into the device.
133+
To enter this mode we need to ground TP1 during board power up, this is the BOOTMODE pin in the KL27. To do that, connect with a wire (or something like a paper-clip) from TP1 (the red circle) with any ground point (any black square) as you insert the USB cable into the device.
132134

133135
![TP1](/docs/software/assets/TP1.png){: width: 300px}
134136

@@ -142,14 +144,19 @@ Usage info:
142144
blhost --help
143145
```
144146

145-
Flash KL27 bin file:
147+
The DAPLink software enables flash protection for bootloader area, so we need to use this specific erase command:
148+
149+
```
150+
blhost -u 0x15a2,0x0073 flash-erase-all-unsecure
151+
```
152+
153+
Then unplug the micro:bit from the computer and plug it again, the KL27 should automatically enter the kinetis bootloader. To flash the bin file:
146154

147155
```
148-
blhost -u 0x15a2,0x0073 flash-erase-all 0
149156
blhost -u 0x15a2,0x0073 write-memory 0x0 kl27_file.bin
150157
```
151158

152-
Read KL27 flash contents into `kl27_flash_dump.bin` file:
159+
To read KL27 flash contents into `kl27_flash_dump.bin` file:
153160

154161
```
155162
blhost -u 0x15a2,0x0073 read-memory 0x0 0x40000 kl27_flash_dump.bin

0 commit comments

Comments
 (0)