circuitpython/ports/teensy
Damien George ad7213d3c3 py: Add mp_raise_msg_varg helper and use it where appropriate.
This commit adds mp_raise_msg_varg(type, fmt, ...) as a helper for
nlr_raise(mp_obj_new_exception_msg_varg(type, fmt, ...)).  It makes the
C-level API for raising exceptions more consistent, and reduces code size
on most ports:

   bare-arm:   +28 +0.042%
minimal x86:  +100 +0.067%
   unix x64:   -56 -0.011%
unix nanbox:  -300 -0.068%
      stm32:  -204 -0.054% PYBV10
     cc3200:    +0 +0.000%
    esp8266:   -64 -0.010% GENERIC
      esp32:  -104 -0.007% GENERIC
        nrf:  -136 -0.094% pca10040
       samd:    +0 +0.000% ADAFRUIT_ITSYBITSY_M4_EXPRESS
2020-02-13 11:52:40 +11:00
..
core ports: Make new ports/ sub-directory and move all ports there. 2017-09-06 13:40:51 +10:00
memzip_files ports: Make new ports/ sub-directory and move all ports there. 2017-09-06 13:40:51 +10:00
add-memzip.sh ports: Make new ports/ sub-directory and move all ports there. 2017-09-06 13:40:51 +10:00
hal_ftm.c ports: Make new ports/ sub-directory and move all ports there. 2017-09-06 13:40:51 +10:00
hal_ftm.h ports: Make new ports/ sub-directory and move all ports there. 2017-09-06 13:40:51 +10:00
hal_gpio.c teensy: Update GPIO speed consts to align with changes in stm32 port. 2018-02-14 10:52:45 +11:00
help.c py/builtinhelp: Change signature of help text var from pointer to array. 2017-09-12 16:03:52 +10:00
lcd.c all: Update Makefiles and others to build with new ports/ dir layout. 2017-09-06 14:09:13 +10:00
led.c py: Add mp_raise_msg_varg helper and use it where appropriate. 2020-02-13 11:52:40 +11:00
led.h ports: Make new ports/ sub-directory and move all ports there. 2017-09-06 13:40:51 +10:00
lexerfrozen.c ports: Make new ports/ sub-directory and move all ports there. 2017-09-06 13:40:51 +10:00
lexermemzip.h ports: Make new ports/ sub-directory and move all ports there. 2017-09-06 13:40:51 +10:00
main.c py: Add mp_raise_msg_varg helper and use it where appropriate. 2020-02-13 11:52:40 +11:00
make-pins.py ports: Make new ports/ sub-directory and move all ports there. 2017-09-06 13:40:51 +10:00
Makefile ports: Allow overriding CROSS_COMPILE in a custom makefile. 2019-12-27 23:53:16 +11:00
mk20dx256_af.csv ports: Make new ports/ sub-directory and move all ports there. 2017-09-06 13:40:51 +10:00
mk20dx256_prefix.c stm32/pin: In pin AF object, remove union of periph ptr types. 2018-04-11 16:14:58 +10:00
mk20dx256.ld ports: Make new ports/ sub-directory and move all ports there. 2017-09-06 13:40:51 +10:00
modpyb.c lib/utils/pyexec: Introduce MICROPY_REPL_INFO, wrap debug prints in it. 2019-12-28 00:05:39 +11:00
mpconfigport.h lib/utils/pyexec: Introduce MICROPY_REPL_INFO, wrap debug prints in it. 2019-12-28 00:05:39 +11:00
pin_defs_teensy.c ports: Make new ports/ sub-directory and move all ports there. 2017-09-06 13:40:51 +10:00
pin_defs_teensy.h stm32/pin: In pin AF object, remove union of periph ptr types. 2018-04-11 16:14:58 +10:00
qstrdefsport.h ports: Make new ports/ sub-directory and move all ports there. 2017-09-06 13:40:51 +10:00
README.md ports: Make new ports/ sub-directory and move all ports there. 2017-09-06 13:40:51 +10:00
reg.c ports: Convert legacy uppercase macro names to lowercase. 2019-02-12 14:54:51 +11:00
reg.h ports: Make new ports/ sub-directory and move all ports there. 2017-09-06 13:40:51 +10:00
servo.c py: Add mp_raise_msg_varg helper and use it where appropriate. 2020-02-13 11:52:40 +11:00
servo.h ports: Make new ports/ sub-directory and move all ports there. 2017-09-06 13:40:51 +10:00
std.h ports: Make new ports/ sub-directory and move all ports there. 2017-09-06 13:40:51 +10:00
teensy_hal.c ports: Provide mp_hal_stdio_poll for sys.stdio polling where needed. 2019-07-01 17:10:12 +10:00
teensy_hal.h ports: Modify mp_hal_pin_write macro so it can be used as a function. 2020-01-14 23:48:42 +11:00
teensy_pins.csv ports: Make new ports/ sub-directory and move all ports there. 2017-09-06 13:40:51 +10:00
timer.c py: Add mp_raise_msg_varg helper and use it where appropriate. 2020-02-13 11:52:40 +11:00
timer.h ports: Make new ports/ sub-directory and move all ports there. 2017-09-06 13:40:51 +10:00
uart.c py: Add mp_raise_msg_varg helper and use it where appropriate. 2020-02-13 11:52:40 +11:00
uart.h teensy: Add own uart.h to not rely on stm32's version of the file. 2018-12-10 23:55:11 +11:00
usb.c ports: Make new ports/ sub-directory and move all ports there. 2017-09-06 13:40:51 +10:00
usb.h ports: Make new ports/ sub-directory and move all ports there. 2017-09-06 13:40:51 +10:00

Build Instructions for Teensy 3.1

Currently the Teensy 3.1 port of MicroPython builds under Linux and not under Windows.

The tool chain required for the build can be found at https://launchpad.net/gcc-arm-embedded.

Download the current Linux *.tar.bz2 file. Instructions regarding unpacking the file and moving it to the correct location as well as adding the extracted folders to the enviroment variable can be found at http://eliaselectronics.com/stm32f4-tutorials/setting-up-the-stm32f4-arm-development-toolchain/

In order to download the firmware image to the teensy, you'll need to use the downloader included with TeensyDuino. The following assumes that you have TeensyDuino installed and set the ARDUINO environment variable pointing to the where Arduino with TeensyDuino is installed.

cd teensy
ARDUINO=~/arduino-1.0.5 make

To upload MicroPython to the Teensy 3.1.

Press the Program button on the Teensy 3.1

sudo ARDUINO=~/arduino-1.0.5/ make deploy

Currently, the Python prompt is through the USB serial interface, i.e.

minicom -D /dev/ttyACM0

TIPS

Install 49-teensy.rules into /etc/udev/rules.d

If you install the 49-teensy.rules file from http://www.pjrc.com/teensy/49-teensy.rules into your /etc/udev/rules.d folder then you won't need to use sudo:

sudo cp ~/Downloads/49-teensy.rules /etc/udev/rules.d
sudo udevadm control --reload-rules

Unplug and replug the teensy board, and then you can use: ARDUINO=~/arduino-1.0.5/ make deploy

Create a GNUmakefile to hold your ARDUINO setting.

Create a file call GNUmakefile (note the lowercase m) in the teensy folder with the following contents:

$(info Executing GNUmakefile)

ARDUINO=${HOME}/arduino-1.0.5
$(info ARDUINO=${ARDUINO})

include Makefile

GNUmakefile is not checked into the source code control system, so it will retain your settings when updating your source tree. You can also add additional Makefile customizations this way.

Tips for OSX

Set the ARDUINO environment variable to the location where Arduino with TeensyDuino is installed.

export ARDUINO=~/Downloads/Arduino.app/Contents/Java/

Search /dev/ for USB port name, which will be cu.usbmodem followed by a few numbers. The name of the port maybe different depending on the version of OSX. To access the Python prompt type:

screen <devicename> 115200