circuitpython/ports/cxd56
Timon a1052d5f73
Initial broadcom port for Raspberry Pi
This targets the 64-bit CPU Raspberry Pis. The BCM2711 on the Pi 4
and the BCM2837 on the Pi 3 and Zero 2W. There are 64-bit fixes
outside of the ports directory for it.

There are a couple other cleanups that were incidental:
* Use const mcu_pin_obj_t instead of omitting the const. The structs
  themselves are const because they are in ROM.
* Use PTR <-> OBJ conversions in more places. They were found when
  mp_obj_t was set to an integer type rather than pointer.
* Optimize submodule checkout because the Pi submodules are heavy
  and unnecessary for the vast majority of builds.

Fixes #4314
2021-11-22 14:54:44 -08:00
..
boards/spresense change board dicts to include a common macro with __name__ 2021-09-03 21:03:55 +02:00
common-hal Initial broadcom port for Raspberry Pi 2021-11-22 14:54:44 -08:00
configs/circuitpython spresense: update SDK to 2.3.0 2021-09-13 11:04:15 +02:00
mkspk run code formatting script 2021-03-15 19:27:36 +05:30
spresense-exported-sdk@6a148be849 spresense: update SDK to 2.3.0 2021-09-13 11:04:15 +02:00
supervisor run code formatting script 2021-03-15 19:27:36 +05:30
tools spresense: update SDK to 2.3.0 2021-09-13 11:04:15 +02:00
.gitignore Add .gitignore 2019-10-11 12:11:48 +02:00
alloca.h Change port name to cxd56 2019-10-11 08:23:51 +02:00
background.c modifications by pre-commit 2021-03-15 18:11:00 -05:00
background.h supervisor: factor supervisor_background_tasks from sundry ports 2020-07-15 11:49:44 -05:00
fatfs_port.c Merge tag 'v1.17' into merge-1.17 2021-10-15 08:20:54 -05:00
Makefile Merge tag 'v1.17' into merge-1.17 2021-10-15 08:20:54 -05:00
mpconfigport.h spresense: Fix USB CDC and MSC 2021-05-18 17:02:16 +02:00
mpconfigport.mk remove gamepad; deprecate gamepadshift 2021-07-26 22:15:09 -04:00
mphalport.c Fix up Spresense build. It doesn't sleep. 2020-03-17 14:21:45 -07:00
mphalport.h Merge tag 'v1.17' into merge-1.17 2021-10-15 08:20:54 -05:00
qstrdefsport.h Merge MicroPython 1.13 into CircuitPython 2021-05-04 18:06:33 -07:00
README.md spresense: update SDK to 2.3.0 2021-09-13 11:04:15 +02:00

CircuitPython port to Spresense

This directory contains the port of CircuitPython to Spresense. It is a compact development board based on Sonys power-efficient multicore microcontroller CXD5602.

Board features:

  • Integrated GPS
    • The embedded GNSS with support for GPS, QZSS and GLONASS enables applications where tracking is required.
  • Hi-res audio output and multi mic inputs
    • Advanced 192kHz/24 bit audio codec and amplifier for audio output, and support for up to 8 mic input channels.
  • Multicore microcontroller
    • Spresense is powered by Sony's CXD5602 microcontroller (ARM® Cortex®-M4F × 6 cores), with a clock speed of 156 MHz.

Currently, Spresense port does not support Audio and Multicore.

Refer to developer.sony.com/develop/spresense/ for further information about this board.

Prerequisites

Linux

Add user to dialout group:

$ sudo usermod -a -G dialout <user-name>

Windows

Download and install USB serial driver

macOS

Download and install USB serial driver

Build instructions

Pull all submodules into your clone:

$ git submodule update --init --recursive

Build the MicroPython cross-compiler:

$ make -C mpy-cross

Change directory to cxd56:

$ cd ports/cxd56

To build circuitpython image run:

$ make BOARD=spresense

USB connection

Connect the Spresense main board to the PC via the USB cable.

Flash the bootloader

The correct bootloader is required for the Spresense board to function.

Bootloader information:

  • The bootloader has to be flashed the very first time the board is used.

  • You have to accept the End User License Agreement to be able to download and use the Spresense bootloader binary.

Download the spresense binaries zip archive from: Spresense firmware v2-3-000

Extract spresense binaries in your PC to ports/spresense/spresense-exported-sdk/firmware/

To flash the bootloader run the command:

$ make BOARD=spresense flash-bootloader

Flash the circuitpython image

To flash the firmware run the command:

$ make BOARD=spresense flash

Accessing the board

Connect the Spresense extension board to the PC via the USB cable.

Once built and deployed, access the CircuitPython REPL (the Python prompt) via USB. You can run:

$ screen /dev/ttyACM0 115200