Skip to content
Snippets Groups Projects
Commit 36cd5ae3 authored by Stephen D's avatar Stephen D
Browse files

add mac flash instructions

parent 62e6522b
No related branches found
No related tags found
No related merge requests found
Pipeline #4633 passed
......@@ -49,7 +49,7 @@ The black hole can be configured with `set black_hole lat lon radius_meters`. Fo
Note that you probably don't want to center your black hole exactly on your house. It may be possible to work out its position based on when exactly you stop transmitting. Instead, you should configure the black hole to overlap with your house, without being centered.
## Updating firmware (Linux only)
## Updating firmware (Linux)
**NOTE:** Currently, updating the firmware can only be done on Linux. If you don't have a Linux computer, a Raspberry Pi, Virtual Machine, or Live-booted distro can be used.
......@@ -61,6 +61,26 @@ sudo ./flasher-linux
```
3. Follow the instructions on the screen. Afterwards, the board will restart automatically.
## Updating firmware (Mac)
1. Install dependencies
```bash
brew install arm-none-eabi-gcc
brew install dfu-util
```
2. Download the firmware binary from [here](https://gitlab.scd31.com/cats/mobile-transceiver-software/builds/artifacts/master/browse/?job=build)
3. Put the transceiver into firmware flashing mode:
1. Connect the board to your computer via USB
2. Hold down the `flash` button
3. Press the `reset` button
4. Release the `flash` button
5. The red LED will come on, then go off. If it stays on, it means your computer isn’t communicating with the board for some reason. Check your cable!
4. Flash the firmware:
```bash
arm-none-eabi-objcopy -O binary firmware.bin firmware_actual.bin
/opt/homebrew/bin/dfu-util -l # find serial
/opt/homebrew/bin/dfu-util --dfuse-address 0x08000000 -S SERIAL_NUMBER_GOES_HERE -a 0 -D firmware_actual.bin
```
## Compiling firmware from source (Linux only)
### Environment setup
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment