djsundog
/
circuitpython
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
7,442 Commits 21 Branches 274 Tags 785 MiB
C 90.2%
Python 7.4%
Makefile 1.8%
Shell 0.2%
Go to file
Scott Shawcroft c6d539ace3 atmel-samd: Fix sporadic "syntax errors" 
The GC was deleting memory that was in use because its scan of the
stack missed the very top. Switching to _estack fixes this by relying
on the location from the linker.

Fixes #124
 		2017-05-05 12:04:20 -07:00
atmel-samd atmel-samd: Fix sporadic "syntax errors" 2017-05-05 12:04:20 -07:00
bare-arm py: Be more specific with MP_DECLARE_CONST_FUN_OBJ macros. 2016-10-21 16:26:01 +11:00
cc3200 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
docs Split up nativeio. 2017-04-10 13:32:19 -07:00
drivers Merge tag 'v1.8.7' 2017-01-10 09:56:09 -08:00
esp8266 Switch to a shared piece of code to compute start and length of a 2017-04-20 11:24:05 -07:00
examples examples/hwapi/hwconfig_console: Don't alloc memory in value(). 2016-12-23 17:24:24 +03:00
extmod atmel-samd: Introduce audio sample playback via audioio.AudioOut. 2017-05-01 13:10:03 -07:00
lib Switch to a shared piece of code to compute start and length of a 2017-04-20 11:24:05 -07:00
logo logo/1bit-logo A black & white version of the logo 2016-08-02 14:59:55 +03:00
minimal minimal/Makefile: Split rule for firmware.bin generation. 2016-10-22 22:01:44 +03:00
mpy-cross mpy-cross: Get compiling after recent persistent code refactors. 2016-11-16 20:25:36 +11:00
pic16bit py: Be more specific with MP_DECLARE_CONST_FUN_OBJ macros. 2016-10-21 16:26:01 +11:00
py atmel-samd: Fix sporadic "syntax errors" 2017-05-05 12:04:20 -07:00
qemu-arm Make slice make_new match mp_make_new_fun_t exactly, check the input type and enable it for qemu tests. 2017-02-24 16:48:01 +01:00
shared-bindings atmel-samd: Introduce audio sample playback via audioio.AudioOut. 2017-05-01 13:10:03 -07:00
shared-module atmel-samd: Rework status LED implementation 2017-04-12 15:24:50 -07:00
stmhal Merge tag 'v1.8.7' 2017-01-10 09:56:09 -08:00
teensy all: Consistently update signatures of .make_new and .call methods. 2017-01-04 16:10:42 +03:00
tests Add indices() support to slice. 2017-02-24 15:13:56 +01:00
tools tools: Switch method of detecting travis so that it works OK on CIs without artifacts saved. 2017-05-01 15:12:52 -07:00
unix Correct name of mp_raise_NotImplementedError to make error name. 2017-02-24 16:46:38 +01:00
windows windows: Enable READER_POSIX to get access to lexer_new_from_file. 2016-11-16 20:27:12 +11:00
zephyr zephyr: Enable slice subscription. 2016-12-18 21:52:52 +03:00
.gitattributes Add .gitattributes file to force text line endings to LF. 2015-04-16 22:23:56 +01:00
.gitignore Ignore the bin folder that can be used to collect binaries across ports. 2017-01-05 16:21:16 -08:00
.gitmodules Turn on build saving and uf2 creation. 2017-04-20 14:04:06 -07:00
.travis.yml travis: turn off artifact debug. 2017-04-20 17:02:59 -07:00
ACKNOWLEDGEMENTS ACKNOWLEDGEMENTS: Change backer 905 info, replace city with name. 2016-10-22 14:45:35 +11:00
CODECONVENTIONS.md CODECONVENTIONS.md: Fix typos. 2016-08-24 13:19:25 -07:00
CODE_OF_CONDUCT.md Add code of conduct so that expectations on contributor behavior are 2016-10-13 14:09:39 -07:00
CONTRIBUTING.md Add title to contributing doc. 2016-10-19 10:53:37 -07:00
LICENSE Add license header to (almost) all files. 2014-05-03 23:27:38 +01:00
README.md Update the README with new links. 2017-04-25 11:28:47 -07:00
c2rst.py Switch away from sphinx.parsers which isn't available in sphinx 1.3.5 on Read The Docs. 2016-10-19 10:53:37 -07:00
conf.py Update the Python intersphinx reference to Python 3 https. 2017-03-07 12:59:34 +01:00
index.rst Add a draft of a new design guide. This is meant to capture the goals of CircuitPython and the corresponding design decisions. 2017-02-02 15:15:27 -08:00
license.rst Improve docs and update to CircuitPython. 2017-01-05 16:20:46 -08:00

README.md

Adafruit CircuitPython

Build Status Doc Status Gitter

This is an open source derivative of MicroPython for use on educational development boards designed and sold by Adafruit.

As a MicroPython derivative, this implements Python 3.x on microcontrollers such as the SAMD21 and ESP8266.

Project Status

This project is in beta. Most APIs should be stable going forward.

Supported boards

Designed for CircuitPython

Other

Download

Official binaries are available through the latest GitHub releases. Continuous (one per commit) builds are available here which includes experimental hardware support.

Documentation

Guides and videos are available through the Adafruit Learning System under the CircuitPython category and MicroPython category. An API reference is also available on Read the Docs.

Contributing

See CONTRIBUTING.md for full guidelines but please be aware that by contributing to this project you are agreeing to the Code of Conduct. Contributors who follow the Code of Conduct are welcome to submit pull requests and they will be promptly reviewed by project admins. Please join the Gitter chat too.

Differences from MicroPython

  • Port for Atmel SAMD21 (Commonly known as M0 in product names.)
  • No machine API on Atmel SAMD21 port.
  • Only supports Atmel SAMD21 and ESP8266 ports.
  • Unified hardware APIs: analogio, busio, digitalio, pulseio, touchio, microcontroller, board, bitbangio (Only available on atmel-samd21 and ESP8266 currently.)
  • Tracks MicroPython's releases (not master).
  • No module aliasing. (uos and utime are not available as os and time respectively.)
  • Modules with a CPython counterpart, such as time, are strict subsets of their CPython version. Therefore, code from CircuitPython is runnable on CPython but not necessarily the reverse.
  • tick count is available as time.monotonic()
  • os only available as uos
  • atmel-samd21 features
    • RGB status LED
    • Auto-reset after file write over mass storage. (Disable with samd.disable_autoreset())
    • Wait state after boot and main run, before REPL.
    • Main is one of these: code.txt, code.py, main.py, main.txt
    • Boot is one of these: settings.txt, settings.py, boot.py, boot.txt

Project Structure

Here is an overview of the top-level directories.

Core

The core code of MicroPython is shared amongst ports including CircuitPython:

  • docs High level user documentation in Sphinx reStructuredText format.
  • drivers External device drivers written in Python.
  • examples A few example Python scripts.
  • extmod Shared C code used in multiple ports' modules.
  • lib Shared core C code including externally developed libraries such as FATFS.
  • logo The MicroPython logo.
  • mpy-cross A cross compiler that converts Python files to byte code prior to being run in MicroPython. Useful for reducing library size.
  • py Core Python implementation, including compiler, runtime, and core library.
  • shared-bindings Shared definition of Python modules, their docs and backing C APIs. Ports must implement the C API to support the corresponding module.
  • shared-module Shared implementation of Python modules that may be based on common-hal.
  • tests Test framework and test scripts.
  • tools Various tools, including the pyboard.py module.

Ports

Ports include the code unique to a microcontroller line and also variations based on the board.

  • atmel-samd Support for SAMD21 based boards such as Arduino Zero, Adafruit Feather M0 Basic, and Adafruit Feather M0 Bluefruit LE.
  • bare-arm A bare minimum version of MicroPython for ARM MCUs.
  • cc3200 Support for boards based CC3200 from TI such as the WiPy 1.0.
  • esp8266 Support for boards based on ESP8266 WiFi modules such as the Adafruit Feather HUZZAH.
  • minimal A minimal MicroPython port. Start with this if you want to port MicroPython to another microcontroller.
  • pic16bit Support for 16-bit PIC microcontrollers.
  • qemu-arm Support for ARM emulation through QEMU.
  • stmhal Support for boards based on STM32 microcontrollers including the MicroPython flagship PyBoard.
  • teensy Support for the Teensy line of boards such as the Teensy 3.1.
  • unix Support for UNIX.
  • windows Support for Windows.
  • zephyr Support for Zephyr, a real-time operating system by the Linux Foundation.

CircuitPython only maintains the atmel-samd and esp8266 ports. The rest are here to maintain compatibility with the MicroPython parent project.