circuitpython/atmel-samd
Scott Shawcroft a715bf6bac atmel-samd: Introduce board reset mechanic used on CircuitPlayground
Express to ensure the Neopixels are off after reloads.
2017-06-16 15:40:15 -07:00
..
asf atmel-samd: Add a safe mode which detects hard faults and reboots without running user code again. 2017-05-15 15:29:04 -07:00
asf_conf atmel-samd: Use DMA for SPI flash block transfers. 2017-05-02 15:25:06 -07:00
bindings/samd atmel-samd: Fixup autoreset after switching boot to running once. 2017-05-15 20:21:26 -07:00
boards atmel-samd: Introduce board reset mechanic used on CircuitPlayground 2017-06-16 15:40:15 -07:00
common-hal shared-bindings: Move enum-like classes out of DigitalInOut into digitalio. 2017-06-16 13:47:01 -07:00
freetouch@1f21fde3fe atmel-samd: Swap out pulseio for touchio based on FreeTouch. 2017-04-18 09:44:04 -07:00
modules atmel-samd: Move neopixel out of internal flash. 2016-11-18 16:17:56 -08:00
tools
.gitattributes
.gitignore
Makefile atmel-samd: Add user initiated safe mode and rework board.c for 2017-06-16 14:55:53 -07:00
README.rst Improve docs and update to CircuitPython. 2017-01-05 16:20:46 -08:00
access_vfs.c atmel-samd: Rename auto-reset to auto-reload to reduce confusion with physical reset buttons. 2017-05-12 16:45:38 -07:00
access_vfs.h
autoreload.c atmel-samd: Fixup autoreset after switching boot to running once. 2017-05-15 20:21:26 -07:00
autoreload.h atmel-samd: Rename auto-reset to auto-reload to reduce confusion with physical reset buttons. 2017-05-12 16:45:38 -07:00
background.c atmel-samd: Support wav file playback. Tested up to 16bit 22.1khz. Must be mono file! 2017-05-15 19:52:38 -07:00
background.h atmel-samd: Support wav file playback. Tested up to 16bit 22.1khz. Must be mono file! 2017-05-15 19:52:38 -07:00
builtin_open.c atmel/samd: Add filesystem support. 64k is stored in flash. 2016-09-02 17:00:30 -07:00
fatfs_port.c atmel-samd: Correct fake date for FAT. Hopefully it'll be in 2016 now. 2016-12-05 11:15:46 -08:00
flash_api.c atmel-samd: Rework boot, main and REPL order. 2017-05-12 18:26:14 -07:00
flash_api.h atmel-samd: Rework boot, main and REPL order. 2017-05-12 18:26:14 -07:00
internal_flash.c atmel-samd: Rework boot, main and REPL order. 2017-05-12 18:26:14 -07:00
internal_flash.h atmel-samd: Rework SPI flash defines for clarity. 2017-05-12 14:47:39 -07:00
main.c atmel-samd: Introduce board reset mechanic used on CircuitPlayground 2017-06-16 15:40:15 -07:00
moduos.c Switch exception throwing to mp_raise helpers. It saves a little code space each time to share the call. 2017-02-24 15:13:07 +01:00
mpconfigport.h atmel-samd: Add input support. Fixes #143 2017-05-25 11:55:38 -07:00
mphalport.c atmel-samd: Fixup autoreset after switching boot to running once. 2017-05-15 20:21:26 -07:00
mphalport.h atmel-samd: Rework boot, main and REPL order. 2017-05-12 18:26:14 -07:00
qstrdefsport.h Compiled and linked SAMD21x18 version successfully. 2016-08-22 23:53:10 -07:00
rgb_led_colors.h atmel-samd: Add a safe mode which detects hard faults and reboots without running user code again. 2017-05-15 15:29:04 -07:00
rgb_led_status.c atmel-samd: Rework status LED implementation 2017-04-12 15:24:50 -07:00
rgb_led_status.h atmel-samd: Rework status LED implementation 2017-04-12 15:24:50 -07:00
samd21_pins.c atmel-samd: Fix TCC1, its two channels and four wave outputs. 2017-06-12 15:36:09 -07:00
samd21_pins.h atmel-samd: Rework status LED implementation 2017-04-12 15:24:50 -07:00
shared_dma.c atmel-samd: Support wav file playback. Tested up to 16bit 22.1khz. Must be mono file! 2017-05-15 19:52:38 -07:00
shared_dma.h atmel-samd: Use DMA for SPI flash block transfers. 2017-05-02 15:25:06 -07:00
spi_flash.c atmel-samd: Rework boot, main and REPL order. 2017-05-12 18:26:14 -07:00
spi_flash.h atmel-samd: Switch to MICROPY_PORT_ROOT_POINTERS for the flash cache. 2016-11-29 14:29:33 -08:00
tick.c atmel-samd: Rename auto-reset to auto-reload to reduce confusion with physical reset buttons. 2017-05-12 16:45:38 -07:00
tick.h atmel-samd: Rename auto-reset to auto-reload to reduce confusion with physical reset buttons. 2017-05-12 16:45:38 -07:00

README.rst

SAMD21x18
=========

This port brings MicroPython to SAMD21x18 based development boards including the
Arduino Zero, Adafruit Feather M0 Basic and Adafruit M0 Bluefruit LE.

Building
--------

To build for the Arduino Zero:

    make

To build for other boards you must change it by setting ``BOARD``. For example:

    make BOARD=feather_m0_basic

Board names are the directory names in the `boards <https://github.com/adafruit/circuitpython/tree/master/atmel-samd/boards>`_ folder.

Deploying
---------

Arduino Bootloader
^^^^^^^^^^^^^^^^^^

If your board has an existing Arduino bootloader on it then you can use bossac
to flash MicroPython. First, activate the bootloader. On Adafruit Feathers you
can double click the reset button and the #13 will fade in and out. Finally,
run bossac:

    tools/bossac_osx -e -w -v -b -R build-feather_m0_basic/firmware.bin

No Bootloader via GDB
^^^^^^^^^^^^^^^^^^^^^

This method works for loading MicroPython onto the Arduino Zero via the
programming port rather than the native USB port.

Note: These instructions are tested on Mac OSX and will vary for different
platforms.

    openocd -f ~/Library/Arduino15/packages/arduino/hardware/samd/1.6.6/variants/arduino_zero/openocd_scripts/arduino_zero.cfg

In another terminal from `micropython/atmel-samd`:

    arm-none-eabi-gdb build-arduino_zero/firmware.elf
    (gdb) tar ext :3333
    ...
    (gdb) load
    ...
    (gdb) monitor reset init
    ...
    (gdb) continue

Connecting
----------

Serial
^^^^^^

All boards are currently configured to work over USB rather than UART. To
connect to it from OSX do something like this:

    screen /dev/tty.usbmodem142422 115200

You may not see a prompt immediately because it doesn't know you connected. To
get one either hit enter to get `>>>` or do CTRL-B to get the full header.

Mass storage
^^^^^^^^^^^^

All boards will also show up as a mass storage device. Make sure to eject it
before referring to any files.

Port Specific modules
---------------------

.. toctree::
    bindings/samd/__init__