A custom deployment of MicroPython designed specifically for Frame. Check out the user docs here.

For those of you who want to modify the standard firmware, keep on reading.

1. Ensure you have the ARM GCC Toolchain installed.

2. Ensure you have the nRF Command Line Tools installed.

3. Clone this repository along with submodules and build the mpy-cross toolchain:

   git clone https://github.com/brilliantlabsAR/frame-micropython.git
   cd frame-micropython
   
   git submodule update --init
   git -C network_core/micropython submodule update --init lib/micropython-lib
   
   make -C network_core/micropython/mpy-cross

4. You should now be able to build the project by calling make from the frame-micropython folder.

   make

5. Before flashing an nRF5340, you may need to unlock the chip first.

   nrfjprog --recover

6. You should then be able to flash the device.

   make flash

1. Open the project in VSCode.

   There are some build tasks already configured within .vscode/tasks.json. Access them by pressing Ctrl-Shift-P (Cmd-Shift-P on MacOS) → Tasks: Run Task.

   1. Build
   2. Build & Flash Chip
   3. Erase & Unlock Chip
   4. Clean
   5. Release

2. You many need to unlock the device by using the Erase Chip task before programming or debugging.

3. To enable IntelliSense, be sure to select the correct compiler from within VSCode. Ctrl-Shift-P (Cmd-Shift-P on MacOS) → C/C++: Select IntelliSense Configuration → Use arm-none-eabi-gcc.

4. Install the Cortex-Debug extension for VSCode in order to enable debugging.

5. A debugging launch is already configured within .vscode/launch.json. Run the J-Link launch configuration from the Run and Debug panel, or press F5. The project will automatically build and flash before launching.

6. To monitor the logs, run the task RTT Console and ensure the J-Link launch configuration is running.

For information on developing and flashing the FPGA binary. Check the Frame FPGA repository.