circuitpython/atmel-samd
Scott Shawcroft 30ee7019ca Merge tag 'v1.9.1'
Fixes for stmhal USB mass storage, lwIP bindings and VFS regressions

This release provides an important fix for the USB mass storage device in
the stmhal port by implementing the SCSI SYNCHRONIZE_CACHE command, which
is now require by some Operating Systems.  There are also fixes for the
lwIP bindings to improve non-blocking sockets and error codes.  The VFS has
some regressions fixed including the ability to statvfs the root.

All changes are listed below.

py core:
- modbuiltins: add core-provided version of input() function
- objstr: catch case of negative "maxsplit" arg to str.rsplit()
- persistentcode: allow to compile with complex numbers disabled
- objstr: allow to compile with obj-repr D, and unicode disabled
- modsys: allow to compile with obj-repr D and PY_ATTRTUPLE disabled
- provide mp_decode_uint_skip() to help reduce stack usage
- makeqstrdefs.py: make script run correctly with Python 2.6
- objstringio: if created from immutable object, follow copy on write policy

extmod:
- modlwip: connect: for non-blocking mode, return EINPROGRESS
- modlwip: fix error codes for duplicate calls to connect()
- modlwip: accept: fix error code for non-blocking mode
- vfs: allow to statvfs the root directory
- vfs: allow "buffering" and "encoding" args to VFS's open()
- modframebuf: fix signed/unsigned comparison pendantic warning

lib:
- libm: use isfinite instead of finitef, for C99 compatibility
- utils/interrupt_char: remove support for KBD_EXCEPTION disabled

tests:
- basics/string_rsplit: add tests for negative "maxsplit" argument
- float: convert "sys.exit()" to "raise SystemExit"
- float/builtin_float_minmax: PEP8 fixes
- basics: convert "sys.exit()" to "raise SystemExit"
- convert remaining "sys.exit()" to "raise SystemExit"

unix port:
- convert to use core-provided version of built-in import()
- Makefile: replace references to make with $(MAKE)

windows port:
- convert to use core-provided version of built-in import()

qemu-arm port:
- Makefile: adjust object-file lists to get correct dependencies
- enable micropython.mem_*() functions to allow more tests

stmhal port:
- boards: enable DAC for NUCLEO_F767ZI board
- add support for NUCLEO_F446RE board
- pass USB handler as parameter to allow more than one USB handler
- usb: use local USB handler variable in Start-of-Frame handler
- usb: make state for USB device private to top-level USB driver
- usbdev: for MSC implement SCSI SYNCHRONIZE_CACHE command
- convert from using stmhal's input() to core provided version

cc3200 port:
- convert from using stmhal's input() to core provided version

teensy port:
- convert from using stmhal's input() to core provided version

esp8266 port:
- Makefile: replace references to make with $(MAKE)
- Makefile: add clean-modules target
- convert from using stmhal's input() to core provided version

zephyr port:
- modusocket: getaddrinfo: Fix mp_obj_len() usage
- define MICROPY_PY_SYS_PLATFORM (to "zephyr")
- machine_pin: use native Zephyr types for Zephyr API calls

docs:
- machine.Pin: remove out_value() method
- machine.Pin: add on() and off() methods
- esp8266: consistently replace Pin.high/low methods with .on/off
- esp8266/quickref: polish Pin.on()/off() examples
- network: move confusingly-named cc3200 Server class to its reference
- uos: deconditionalize, remove minor port-specific details
- uos: move cc3200 port legacy VFS mounting functions to its ref doc
- machine: sort machine classes in logical order, not alphabetically
- network: first step to describe standard network class interface

examples:
- embedding: use core-provided KeyboardInterrupt object
2017-06-20 10:56:05 -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 Merge tag 'v1.9.1' 2017-06-20 10:56:05 -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
Makefile Merge tag 'v1.9.1' 2017-06-20 10:56:05 -07:00
README.rst Improve docs and update to CircuitPython. 2017-01-05 16:20:46 -08:00
access_vfs.c Merge tag 'v1.9.1' 2017-06-20 10:56:05 -07:00
access_vfs.h atmel-samd: Rework mass storage interaction with underlying block 2016-10-21 15:36:59 -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 Merge tag 'v1.9.1' 2017-06-20 10:56:05 -07:00
moduos.c Merge tag 'v1.9.1' 2017-06-20 10:56:05 -07:00
mpconfigport.h Merge tag 'v1.9.1' 2017-06-20 10:56:05 -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
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 Merge tag 'v1.9.1' 2017-06-20 10:56:05 -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__