circuitpython/atmel-samd
Dan Halbert 2cd62b46cd Fix USB Busy error for kbd hid. Made kbd USB report descriptor be
COMPILER_WORD_ALIGNED as done in #118 for mouse. Added COMPILER_WORD_ALIGNED
to other UDC_DESC_STORAGE declarations that might have the same issue in
the future.
2017-07-12 11:55:49 -07:00
..
asf Fix USB Busy error for kbd hid. Made kbd USB report descriptor be 2017-07-12 11:55:49 -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 atmel-samd: Fix AudioOut buffer playback by supporting bytes_per_sample. 2017-07-12 11:55:49 -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 atmel-samd: Update bossac_osx with one that works. 2016-10-03 12:57:06 -04:00
.gitattributes Include the precompiled math library from ASF. 2016-09-07 14:35:40 -07:00
.gitignore Blinking the LED works. Clocks should be set up correctly. 2016-08-22 23:53:11 -07:00
access_vfs.c Change vfs mount ordering such that the root is always last in the 2017-06-28 14:46:49 -07:00
access_vfs.h atmel-samd: Fix running off of the new VFS filesystem including 2017-06-26 14:04:22 -07:00
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
fatfs_port.c Merge tag 'v1.9.1' 2017-06-20 10:56:05 -07:00
flash_api.c Merge tag 'v1.9.1' 2017-06-20 10:56:05 -07:00
flash_api.h Merge tag 'v1.9.1' 2017-06-20 10:56:05 -07:00
internal_flash.c Merge tag 'v1.9.1' 2017-06-20 10:56:05 -07:00
internal_flash.h atmel-samd: Rework SPI flash defines for clarity. 2017-05-12 14:47:39 -07:00
main.c shared-bindings: Introduce storage.remount() so you can set root as 2017-06-28 16:18:13 -07:00
Makefile shared-bindings: Introduce storage.remount() so you can set root as 2017-06-28 16:18:13 -07:00
mpconfigport.h atmel-samd: update boot output location for new mount point. 2017-06-28 14:51:46 -07:00
mphalport.c atmel-samd: Fixup autoreset after switching boot to running once. 2017-05-15 20:21:26 -07:00
mphalport.h Merge tag 'v1.9.1' 2017-06-20 10:56:05 -07:00
qstrdefsport.h Compiled and linked SAMD21x18 version successfully. 2016-08-22 23:53:10 -07:00
README.rst Improve docs and update to CircuitPython. 2017-01-05 16:20:46 -08: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: Fix running off of the new VFS filesystem including 2017-06-26 14:04:22 -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

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__