circuitpython/atmel-samd
Scott Shawcroft e3f9ee839a Add frequency changing support to PWMOut.
You can either set it once up front, or set variable_frequency on custruction to
indicate that the frequency must be able to change. This informs whether a timer
can be shared amongst pins.

This also adds persistent clock calibration on atmel-samd. Once the device has
synced its clock frequency over USB it will remember that config value until USB
is used again. This helps ensure the clock frequency is similar on and off USB.

Lastly, this also corrects time.sleep() when on USB by correcting the tick counter.
2017-01-30 15:02:01 -08:00
..
asf Add frequency changing support to PWMOut. 2017-01-30 15:02:01 -08:00
asf_conf atmel-samd: Basic capacitive touch button support. 2016-12-12 15:11:25 -08:00
bindings/samd Improve docs and update to CircuitPython. 2017-01-05 16:20:46 -08:00
boards Add frequency changing support to PWMOut. 2017-01-30 15:02:01 -08:00
common-hal Add frequency changing support to PWMOut. 2017-01-30 15:02:01 -08:00
modules atmel-samd: Move neopixel out of internal flash. 2016-11-18 16:17:56 -08:00
QTouch atmel-samd: Commit QTouch library. Missed because .a files are usually ignored. 2016-12-13 16:11:19 -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 atmel-samd: Support auto-reset based on USB write activity. 2016-10-25 18:36:37 -07:00
access_vfs.h atmel-samd: Rework mass storage interaction with underlying block 2016-10-21 15:36:59 -07:00
autoreset.c Fixup warnings from merge about undefined macro values, switch to 2017-01-12 12:46:18 -08:00
autoreset.h This introduces an alternative hardware API called nativeio structured around different functions that are typically accelerated by native hardware. Its not meant to reflect the structure of the hardware. 2016-11-21 14:11:52 -08: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
internal_flash.c Add frequency changing support to PWMOut. 2017-01-30 15:02:01 -08:00
internal_flash.h atmel-samd: Fix FLASH_ROOT_POINTERS for internal flash builds. 2016-11-30 09:49:39 -08:00
main.c Add frequency changing support to PWMOut. 2017-01-30 15:02:01 -08:00
Makefile Fixup warnings from merge about undefined macro values, switch to 2017-01-12 12:46:18 -08:00
moduos.c This introduces an alternative hardware API called nativeio structured around different functions that are typically accelerated by native hardware. Its not meant to reflect the structure of the hardware. 2016-11-21 14:11:52 -08:00
mpconfigport.h Add persistent VFS shares so that the devices can be used with USB 2017-01-12 12:46:44 -08:00
mphalport.c Add frequency changing support to PWMOut. 2017-01-30 15:02:01 -08:00
mphalport.h atmel-samd: Add APA102 support and flash more advanced status. 2016-12-09 19:35:56 -08: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: Ensure pin state for first script run because we don't 2017-01-13 15:39:50 -08:00
rgb_led_status.c atmel-samd: Add APA102 support and flash more advanced status. 2016-12-09 19:35:56 -08:00
rgb_led_status.h atmel-samd: Add APA102 support and flash more advanced status. 2016-12-09 19:35:56 -08:00
samd21_pins.c Add frequency changing support to PWMOut. 2017-01-30 15:02:01 -08:00
samd21_pins.h atmel-samd: Add preliminary support for UART 2016-12-19 13:03:50 -08:00
spi_flash.c atmel-samd: Add APA102 support and flash more advanced status. 2016-12-09 19:35:56 -08: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 Add frequency changing support to PWMOut. 2017-01-30 15:02:01 -08:00
tick.h This introduces an alternative hardware API called nativeio structured around different functions that are typically accelerated by native hardware. Its not meant to reflect the structure of the hardware. 2016-11-21 14:11:52 -08: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__