| 4 | 4 |
1. Copy all files from this repository to the CircuitPython drive
|
| 5 | 5 |
2. Install the dependencies:
|
| 6 | 6 |
- using [circup][circup]: `$ circup [--path /path/to/drive] install -r requirements.txt`
|
| 7 | |
- manually download the needed libraries from the [Adafruit CircuitPython Library Bundle][cpy-lib-bundle] and place them in the `lib` folder
|
|
7 |
- manually download the needed libraries from the [Adafruit CircuitPython Library Bundle][cpy-lib-bundle]
|
|
8 |
and place them in the `lib` folder
|
|
9 |
3. Set hardware settings in `config.py`:
|
|
10 |
Import the module from `hex33board.boards` corresponding to the hardware revision you have.
|
|
11 |
|
|
12 |
## Boot modes
|
|
13 |
After a reset, `boot.py` is executed. Depending on the `dev_mode` value in `config.py` and
|
|
14 |
whether the menu button (very top left of the board) is pressed, the board boots in different modes:
|
|
15 |
|
|
16 |
With `dev_mode = False` and the button not pressed, the board starts in "normal mode".
|
|
17 |
The board will show up as a read-only flash drive on the computer,
|
|
18 |
and settings changed in the boards menu will be saved automatically.
|
|
19 |
|
|
20 |
When the button is pressed, the board starts in "dev mode".
|
|
21 |
In this case the board shows up read-write on the computer and will autoreload as the firmware is changed.
|
|
22 |
While "dev mode" is active, settings changed on the board aren't saved.
|
|
23 |
|
|
24 |
If `dev_mode = True` in `config.py`, things work the other way around:
|
|
25 |
the board goes into "dev mode" by default, but will start in "normal mode" when the menu key is held during reset.
|
| 8 | 26 |
|
| 9 | 27 |
[circup]: https://github.com/adafruit/circup
|
| 10 | 28 |
[cpy-lib-bundle]: https://circuitpython.org/libraries
|