You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/FIRST_STEPS.md
+8-81Lines changed: 8 additions & 81 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -6,84 +6,11 @@ Just check the pictures if anything looks like your board and click on it.
6
6
After flashing your file feel free to re-configure BLEnky using the section at the bottom of the page.
7
7
8
8
If you don't find your board here, try looking through the [latest release](https://github.com/dakhnod/BLEnky/releases/latest) for a package that sounds like your board.
9
-
If your board shows up as a drive and says something about UF2, follow [these instructions](#uf2-based-boards).
10
-
If it just shows up as a Serial port, it likely has the nordic bootloader installed, go with [this](#nordic-dfu-based-boards).
11
-
If it doesn't show up at all, follow [this](#generic-board--without-bootloader).
On these boards, you need to update the bootloader first.
21
-
Thus install `adafruit-nrfutil` using pip.
22
-
Then, get [this file](https://github.com/user-attachments/files/19794746/xiao_nrf52840_ble_bootloader-0.9.2-10-g4329614-dirty_s140_6.1.1.zip) and run `adafruit-nrfutil dfu serial -p BOARD_PORT -pkg xiao_nrf52840_ble_bootloader-0.9.2-10-g4329614-dirty_s140_6.1.1.zip`.
23
-
After, make sure that the .txt on the board shows Softdevice version 6.1.1.
24
-
After, you just need to copy the right file onto the board, which appears as a flash drive.
25
-
The firmware file to search for contains `xiao_ble.uf2`.
26
-
Firmware files can be found [in the releases](https://github.com/dakhnod/BLEnky/releases/latest).
27
-
28
-
Once the firmware is copied/flashed, the flash drive will disappear and you should be able to head to https://ble.nullco.de and connect to your board. You just saved yourself years of development!
29
-
30
-
To get back into the bootloader, a quick doble reset should suffice.
31
-
32
-
## Pro micro / Nice nano
33
-
34
-
These boards come pre-flashed with a uf2 bootloader, so you just need to copy the right file onto the board, which appears as a flash drive.
35
-
The firmware file to search for contains `others_promicro_nrf52840.uf2`.
36
-
Firmware files can be found [in the releases](https://github.com/dakhnod/BLEnky/releases/latest).
37
-
38
-
Once the firmware is copied/flashed, the flash drive will disappear and you should be able to head to https://ble.nullco.de and connect to your board. You just saved yourself years of development!
39
-
40
-
To get back into the bootloader, a quick doble reset should suffice.
41
-
42
-
## nRF52840 Dongle
43
-
44
-
These boards come pre-flashed with the nordic bootloader.
45
-
To flash these, you need to plugin the dongle and install nrfutil.
46
-
47
-
Then get this file and run
48
-
```
49
-
nrfutil dfu serial -p DONGLE_PORT -pkg FIRMWARE_FILE.zip
50
-
```
51
-
The file to look for contains `nordic_nrf52840dongle.zip`.
52
-
Firmware files can be found [in the releases](https://github.com/dakhnod/BLEnky/releases/latest).
53
-
54
-
Once the firmware is copied/flashed, the flash drive will disappear and you should be able to head to https://ble.nullco.de and connect to your board. You just saved yourself years of development!
55
-
56
-
To get back into the bootloader, a quick doble reset should suffice.
57
-
58
-
## UF2 based boards
59
-
60
-
For these boards, find the right `.uf2` firmware in [in the latest release](https://github.com/dakhnod/BLEnky/releases/latest) and copy it onto the drive that should appear once you connect the board.
61
-
If you can't find anything suiting, get the generic build and configure it through the website.
62
-
63
-
Just make sure, using the text file on the drive, that the Softdevice version is 6.1.1.
64
-
65
-
Once the firmware is copied/flashed, the flash drive will disappear and you should be able to head to https://ble.nullco.de and connect to your board. You just saved yourself years of development!
66
-
67
-
To get back into the bootloader, a quick doble reset should suffice.
68
-
69
-
## Nordic DFU based boards
70
-
71
-
For these boards, find the right firmware in [in the latest release](https://github.com/dakhnod/BLEnky/releases/latest).
72
-
To flash these, you need to plugin the dongle and install nrfutil.
73
-
If you can't find anything suiting, get the generic build and configure it through the website.
74
-
75
-
Then get this file and run
76
-
```
77
-
nrfutil dfu serial -p DONGLE_PORT -pkg FIRMWARE_FILE.zip
78
-
```
79
-
80
-
Once the firmware is copied/flashed, the flash drive will disappear and you should be able to head to https://ble.nullco.de and connect to your board. You just saved yourself years of development!
81
-
82
-
To get back into the bootloader, a quick doble reset should suffice.
83
-
84
-
## Generic board / without bootloader
85
-
86
-
If your board does not appear to have a bootloader at all, get the hex file for your board, or the generic hex file.
87
-
Then follow [these instruction](FLASHING.md).
88
-
89
-
Once the firmware is copied/flashed, the flash drive will disappear and you should be able to head to https://ble.nullco.de and connect to your board. You just saved yourself years of development!
9
+
If your board shows up as a drive and says something about UF2, follow [these instructions](boards/GENERIC_UF2.md).
10
+
If it just shows up as a Serial port, it likely has the nordic bootloader installed, go with [this](boards/NORDIC_DFU.md).
11
+
If it doesn't show up at all, follow [this](boards/GENERIC.md).
If your board does not appear to have a bootloader at all, get the hex file for your board, or the generic hex file.
4
+
Then follow [these instruction](FLASHING.md).
5
+
6
+
Once the firmware is copied/flashed, the flash drive will disappear and you should be able to head to https://ble.nullco.de and connect to your board. You just saved yourself years of development!
For these boards, find the right `.uf2` firmware in [in the latest release](https://github.com/dakhnod/BLEnky/releases/latest) and copy it onto the drive that should appear once you connect the board.
4
+
If you can't find anything suiting, get the generic build and configure it through the website.
5
+
6
+
Just make sure, using the text file on the drive, that the Softdevice version is 6.1.1.
7
+
8
+
Once the firmware is copied/flashed, the flash drive will disappear and you should be able to head to https://ble.nullco.de and connect to your board. You just saved yourself years of development!
9
+
10
+
To get back into the bootloader, a quick doble reset should suffice.
For these boards, find the right firmware in [in the latest release](https://github.com/dakhnod/BLEnky/releases/latest).
4
+
To flash these, you need to plugin the dongle and install nrfutil.
5
+
If you can't find anything suiting, get the generic build and configure it through the website.
6
+
7
+
Then get this file and run
8
+
```
9
+
nrfutil dfu serial -p DONGLE_PORT -pkg FIRMWARE_FILE.zip
10
+
```
11
+
12
+
Once the firmware is copied/flashed, the flash drive will disappear and you should be able to head to https://ble.nullco.de and connect to your board. You just saved yourself years of development!
13
+
14
+
To get back into the bootloader, a quick doble reset should suffice.
These boards come pre-flashed with the nordic bootloader.
4
+
To flash these, you need to plugin the dongle and install nrfutil.
5
+
6
+
Then get this file and run
7
+
```
8
+
nrfutil dfu serial -p DONGLE_PORT -pkg FIRMWARE_FILE.zip
9
+
```
10
+
The file to look for contains `nordic_nrf52840dongle.zip`.
11
+
Firmware files can be found [in the releases](https://github.com/dakhnod/BLEnky/releases/latest).
12
+
13
+
Once the firmware is copied/flashed, the flash drive will disappear and you should be able to head to https://ble.nullco.de and connect to your board. You just saved yourself years of development!
14
+
15
+
To get back into the bootloader, a quick doble reset should suffice.
These boards come pre-flashed with a uf2 bootloader, so you just need to copy the right file onto the board, which appears as a flash drive.
6
+
The firmware file to search for contains `others_promicro_nrf52840.uf2`.
7
+
Firmware files can be found [in the releases](https://github.com/dakhnod/BLEnky/releases/latest).
8
+
9
+
Once the firmware is copied/flashed, the flash drive will disappear and you should be able to head to https://ble.nullco.de and connect to your board. You just saved yourself years of development!
10
+
11
+
To get back into the bootloader, a quick doble reset should suffice.
12
+
13
+
## Low power
14
+
15
+
In order to get the lowest power ingest (microamperes), supply around 3V to the pin marked in this picture:
On these boards, you need to update the bootloader first.
4
+
Thus install `adafruit-nrfutil` using pip.
5
+
Then, get [this file](https://github.com/user-attachments/files/19794746/xiao_nrf52840_ble_bootloader-0.9.2-10-g4329614-dirty_s140_6.1.1.zip) and run `adafruit-nrfutil dfu serial -p BOARD_PORT -pkg xiao_nrf52840_ble_bootloader-0.9.2-10-g4329614-dirty_s140_6.1.1.zip`.
6
+
After, make sure that the .txt on the board shows Softdevice version 6.1.1.
7
+
After, you just need to copy the right file onto the board, which appears as a flash drive.
8
+
The firmware file to search for contains `xiao_ble.uf2`.
9
+
Firmware files can be found [in the releases](https://github.com/dakhnod/BLEnky/releases/latest).
10
+
11
+
Once the firmware is copied/flashed, the flash drive will disappear and you should be able to head to https://ble.nullco.de and connect to your board. You just saved yourself years of development!
12
+
13
+
To get back into the bootloader, a quick doble reset should suffice.
0 commit comments