alert-me/display/README.md

48 lines
1.3 KiB
Markdown
Raw Permalink Normal View History

2024-10-02 11:26:05 +00:00
# Alert-Me Display
A simple application for an
[nRF52840](https://www.nordicsemi.com/Products/nRF52840) microcontroller using
[embassy](https://embassy.dev/).
2024-11-16 15:55:15 +00:00
It shows information received with BLE on a
[HD44780 LCD like](https://en.wikipedia.org/wiki/Hitachi_HD44780_LCD_controller)
screen.
2024-10-02 11:26:05 +00:00
This is a learning environment, not a finished product.
# Development
## Nix
If using the nix way as described in the [top-level readme](../README.md), no
further dependencies need to be installed.
## Manual Way
In addition to the [top-level readme](../README.md) dependencies, the following
has to be installed:
- [probe-rs](https://probe.rs/docs/getting-started/installation/)
## Softdevice
2024-05-20 09:18:17 +00:00
The softdevice blob is not distributed with this repository for licensing
2024-10-02 11:26:05 +00:00
reasons (even though my understanding is that it is possible).
2024-05-20 09:18:17 +00:00
Download the
[S140 Softdevice](https://www.nordicsemi.com/Products/Development-software/s140/download)
and flash it to your chip.
_Example command to flash the softdevice_
```
probe-rs download --verify --format hex --chip nRF52840_xxAA ./s140_nrf52_7.3.0_softdevice.hex
```
2024-10-02 11:26:05 +00:00
## Running
2024-10-02 13:25:49 +00:00
Verify that the microcontroller is recognized by running `probe-rs list`.
2024-10-02 11:26:05 +00:00
A simple `cargo run` will then connect to it and upload the code. Logging output
should be visible.