Skip to content

Commit dfb61f0

Browse files
committed
Merge tag 'v1.8.7'
Support for Xtensa emitter and assembler, and upgraded F4 and F7 STM HAL This release adds support for the Xtensa architecture as a target for the native emitter, as well as Xtensa inline assembler. The int.from_bytes and int.to_bytes methods now require a second argument (the byte order) per CPython (only "little" is supported at this time). The "readall" method has been removed from all stream classes that used it; "read" with no arguments should be used instead. There is now support for importing packages from compiled .mpy files. Test coverage is increased to 96%. The generic I2C driver has improvements: configurable clock stretching timeout, "stop" argument added to readfrom/writeto methods, "nack" argument added to readinto, and write[to] now returns num of ACKs received. The framebuf module now handles 16-bit depth (generic colour format) and has hline, vline, rect, line methods. A new utimeq module is added for efficient queue ordering defined by modulo time (to be compatible with time.ticks_xxx functions). The pyboard.py script has been modified so that the target board is not reset between scripts or commands that are given on a single command line. For the stmhal port the STM Cube HAL has been upgraded: Cube F4 HAL to v1.13.1 (CMSIS 2.5.1, HAL v1.5.2) and Cube F7 HAL to v1.1.2. There is a more robust pyb.I2C implementation (DMA is now disabled by default, can be enabled via an option), and there is an implementation of machine.I2C with robust error handling and hardware acceleration on F4 MCUs. It is now recommended to use machine.I2C instead of pyb.I2C. The UART class is now more robust with better handling of errors/timeouts. There is also more accurate VBAT and VREFINT measurements for the ADC. New boards that are supported include: NUCLEO_F767ZI, STM32F769DISC and NUCLEO_L476RG. For the esp8266 port select/poll is now supported for sockets using the uselect module. There is support for native and viper emitters, as well as an inline assembler (with limited iRAM for storage of native functions, or the option to store code to flash). There is improved software I2C with a slight API change: scl/sda pins can be specified as positional only when "-1" is passed as the first argument to indicate the use of software I2C. It is recommended to use keyword arguments for scl/sda. There is very early support for over-the-air (OTA) updates using the yaota8266 project. A detailed list of changes follows. py core: - emitnative: fix native import emitter when in viper mode - remove readall() method, which is equivalent to read() w/o args - objexcept: allow clearing traceback with 'exc.__traceback__ = None' - runtime: mp_resume: handle exceptions in Python __next__() - mkrules.mk: rework find command so it works on OSX - *.mk: replace uses of 'sed' with $(SED) - parse: move function to check for const parse node to parse.[ch] - parse: make mp_parse_node_new_leaf an inline function - parse: add code to fold logical constants in or/and/not operations - factor persistent code load/save funcs into persistentcode.[ch] - factor out persistent-code reader into separate files - lexer: rewrite mp_lexer_new_from_str_len in terms of mp_reader_mem - lexer: provide generic mp_lexer_new_from_file based on mp_reader - lexer: rewrite mp_lexer_new_from_fd in terms of mp_reader - lexer: make lexer use an mp_reader as its source - objtype: implement __call__ handling for an instance w/o heap alloc - factor out common code from assemblers into asmbase.[ch] - stream: move ad-hoc ioctl constants to stream.h and rename them - compile: simplify configuration of native emitter - emit.h: remove long-obsolete declarations for cpython emitter - move arch-specific assembler macros from emitnative to asmXXX.h - asmbase: add MP_PLAT_COMMIT_EXEC option for handling exec code - asmxtensa: add low-level Xtensa assembler - integrate Xtensa assembler into native emitter - allow inline-assembler emitter to be generic - add inline Xtensa assembler - emitinline: embed entire asm struct instead of a pointer to it - emitinline: move inline-asm align and data methods to compiler - emitinline: move common code for end of final pass to compiler - asm: remove need for dummy_data when doing initial assembler passes - objint: from_bytes, to_bytes: require byteorder arg, require "little" - binary: do zero extension when storing a value larger than word size - builtinimport: support importing packages from compiled .mpy files - mpz: remove unreachable code in mpn_or_neg functions - runtime: zero out fs_user_mount array in mp_init - mpconfig.h: enable MICROPY_PY_SYS_EXIT by default - add MICROPY_KBD_EXCEPTION config option to provide mp_kbd_exception - compile: add an extra pass for Xtensa inline assembler - modbuiltins: remove unreachable code - objint: rename mp_obj_int_as_float to mp_obj_int_as_float_impl - emitglue: refactor to remove assert(0), to improve coverage - lexer: remove unreachable code in string tokeniser - lexer: remove unnecessary check for EOF in lexer's next_char func - lexer: permanently disable the mp_lexer_show_token function - parsenum: simplify and generalise decoding of digit values - mpz: fix assertion in mpz_set_from_str which checks value of base - mpprint: add assertion for, and comment about, valid base values - objint: simplify mp_int_format_size and remove unreachable code - unicode: comment-out unused function unichar_isprint - consistently update signatures of .make_new and .call methods - mkrules.mk: add MPY_CROSS_FLAGS option to pass flags to mpy-cross - builtinimport: fix bug when importing names from frozen packages extmod: - machine_i2c: make the clock stretching timeout configurable - machine_i2c: raise an error when clock stretching times out - machine_i2c: release SDA on bus error - machine_i2c: add a C-level I2C-protocol, refactoring soft I2C - machine_i2c: add argument to C funcs to control stop generation - machine_i2c: rewrite i2c.scan in terms of C-level protocol - machine_i2c: rewrite mem xfer funcs in terms of C-level protocol - machine_i2c: remove unneeded i2c_write_mem/i2c_read_mem funcs - machine_i2c: make C-level functions return -errno on I2C error - machine_i2c: add 'nack' argument to i2c.readinto - machine_i2c: make i2c.write[to] methods return num of ACKs recvd - machine_i2c: add 'stop' argument to i2c readfrom/writeto meths - machine_i2c: remove trivial function wrappers - machine_i2c: expose soft I2C obj and readfrom/writeto funcs - machine_i2c: add hook to constructor to call port-specific code - modurandom: allow to build with float disabled - modframebuf: make FrameBuffer handle 16bit depth - modframebuf: add back legacy FrameBuffer1 "class" - modframebuf: optimise fill and fill_rect methods - vfs_fat: implement POSIX behaviour of rename, allow to overwrite - moduselect: use stream helper function instead of ad-hoc code - moduselect: use configurable EVENT_POLL_HOOK instead of WFI - modlwip: add ioctl method to socket, with poll implementation - vfs_fat_file: allow file obj to respond to ioctl flush request - modbtree: add method to sync the database - modbtree: rename "sync" method to "flush" for consistency - modframebuf: add hline, vline, rect and line methods - machine_spi: provide reusable software SPI class - modframebuf: make framebuf implement the buffer protocol - modframebuf: store underlying buffer object to prevent GC free - modutimeq: copy of current moduheapq with timeq support for refactoring - modutimeq: refactor into optimized class - modutimeq: make time_less_than be actually "less than", not less/eq lib: - utils/interrupt_char: use core-provided mp_kbd_exception if enabled drivers: - display/ssd1306.py: update to use FrameBuffer not FrameBuffer1 - onewire: enable pull up on data pin - onewire/ds18x20: fix negative temperature calc for DS18B20 tools: - tinytest-codegen: blacklist recently added uheapq_timeq test (qemu-arm) - pyboard.py: refactor so target is not reset between scripts/cmd - mpy-tool.py: add support for OPT_CACHE_MAP_LOOKUP_IN_BYTECODE tests: - micropython: add test for import from within viper function - use read() instead of readall() - basics: add test for logical constant folding - micropython: add test for creating traceback without allocation - micropython: move alloc-less traceback test to separate test file - extmod: improve ujson coverage - basics: improve user class coverage - basics: add test for dict.fromkeys where arg is a generator - basics: add tests for if-expressions - basics: change dict_fromkeys test so it doesn't use generators - basics: enable tests for list slice getting with 3rd arg - extmod/vfs_fat_fileio: add test for constructor of FileIO type - extmod/btree1: exercise btree.flush() - extmod/framebuf1: add basics tests for hline, vline, rect, line - update for required byteorder arg for int.from_bytes()/to_bytes() - extmod: improve moductypes test coverage - extmod: improve modframebuf test coverage - micropython: get heapalloc_traceback test running on baremetal - struct*: make skippable - basics: improve mpz test coverage - float/builtin_float_round: test round() with second arg - basics/builtin_dir: add test for dir() of a type - basics: add test for builtin locals() - basics/set_pop: improve coverage of set functions - run-tests: for REPL tests make sure the REPL is exited at the end - basics: improve test coverage for generators - import: add a test which uses ... in from-import statement - add tests to improve coverage of runtime.c - add tests to improve coverage of objarray.c - extmod: add test for utimeq module - basics/lexer: add a test for newline-escaping within a string - add a coverage test for printing the parse-tree - utimeq_stable: test for partial stability of utimeq queuing - heapalloc_inst_call: test for no alloc for simple object calls - basics: add tests for parsing of ints with base 36 - basics: add tests to improve coverage of binary.c - micropython: add test for micropython.stack_use() function - extmod: improve ubinascii.c test coverage - thread: improve modthread.c test coverage - cmdline: improve repl.c autocomplete test coverage - unix: improve runtime_utils.c test coverage - pyb/uart: update test to match recent change to UART timeout_char - run-tests: allow to skip set tests - improve warning.c test coverage - float: improve formatfloat.c test coverage using Python - unix: improve formatfloat.c test coverage using C - unix/extra_coverage: add basic tests to import frozen str and mpy - types1: split out set type test to set_types - array: allow to skip test if "array" is unavailable - unix/extra_coverage: add tests for importing frozen packages unix port: - rename define for unix moduselect to MICROPY_PY_USELECT_POSIX - Makefile: update freedos target for change of USELECT config name - enable utimeq module - main: allow to print the parse tree in coverage build - Makefile: make "coverage_test" target mirror Travis test actions - moduselect: if file object passed to .register(), return it in .poll() - Makefile: split long line for coverage target, easier to modify - enable and add basic frozen str and frozen mpy in coverage build - Makefile: allow cache-map-lookup optimisation with frozen bytecode windows port: - enable READER_POSIX to get access to lexer_new_from_file stmhal port: - dma: de-init the DMA peripheral properly before initialising - i2c: add option to I2C to enable/disable use of DMA transfers - i2c: reset the I2C peripheral if there was an error on the bus - rename mp_hal_pin_set_af to _config_alt, to simplify alt config - upgrade to STM32CubeF4 v1.13.0 - CMSIS/Device 2.5.1 - upgrade to STM32CubeF4 v1.13.0 - HAL v1.5.1 - apply STM32CubeF4 v1.13.1 patch - upgrade HAL driver to v1.5.2 - hal/i2c: reapply HAL commit ea040a4 for f4 - hal/sd: reapply HAL commit 1d7fb82 for f4 - hal: reapply HAL commit 9db719b for f4 - hal/rcc: reapply HAL commit c568a2b for f4 - hal/sd: reapply HAL commit 09de030 for f4 - boards: configure all F4 boards to work with new HAL - make-stmconst.py: fix regex's to work with current CMSIS - i2c: handle I2C IRQs - dma: precalculate register base and bitshift on handle init - dma: mark DMA sate as READY even if HAL_DMA_Init is skipped - can: clear FIFO flags in IRQ handler - i2c: provide custom IRQ handlers - hal: do not include <stdio.h> in HAL headers - mphalport.h: use single GPIOx->BSRR register - make-stmconst.py: add support for files with invalid utf8 bytes - update HALCOMMITS due to change to hal - make-stmconst.py: restore Python 2 compatibility - update HALCOMMITS due to change to hal - moduselect: move to extmod/ for reuse by other ports - i2c: use the HAL's I2C IRQ handler for F7 and L4 MCUs - updates to get F411 MCUs compiling with latest ST HAL - i2c: remove use of legacy I2C_NOSTRETCH_DISABLED option - add beginnings of port-specific machine.I2C implementation - i2c: add support for I2C4 hardware block on F7 MCUs - i2c: expose the pyb_i2c_obj_t struct and some relevant functions - machine_i2c: provide HW implementation of I2C peripherals for F4 - add support for flash storage on STM32F415 - add back GPIO_BSRRL and GPIO_BSRRH constants to stm module - add OpenOCD configuration for STM32L4 - add address parameters to openocd config files - adc: add "mask" selection parameter to pyb.ADCAll constructor - adc: provide more accurate measure of VBAT and VREFINT - adc: make ADCAll.read_core_temp return accurate float value - adc: add ADCAll.read_vref method, returning "3.3v" value - adc: add support for F767 MCU - adc: make channel "16" always map to the temperature sensor - sdcard: clean/invalidate cache before DMA transfers with SD card - moduos: implement POSIX behaviour of rename, allow to overwrite - adc: use constants from new HAL version - refactor UART configuration to use pin objects - uart: add support for UART7 and UART8 on F7 MCUs - uart: add check that UART id is valid for the given board - cmsis: update STM32F7 CMSIS device include files to V1.1.2 - hal: update ST32CubeF7 HAL files to V1.1.2 - port of f4 hal commit c568a2b to updated f7 hal - port of f4 hal commit 09de030 to updated f7 hal - port of f4 hal commit 1d7fb82 to updated f7 hal - declare and initialise PrescTables for F7 MCUs - boards/STM32F7DISC: define LSE_STARTUP_TIMEOUT - hal: update HALCOMMITS due to change in f7 hal files - refactor to use extmod implementation of software SPI class - cmsis: add CMSIS file stm32f767xx.h, V1.1.2 - add NUCLEO_F767ZI board, with openocd config for stm32f7 - cmsis: add CMSIS file stm32f769xx.h, V1.1.2 - add STM32F769DISC board files - move PY_SYS_PLATFORM config from board to general config file - mpconfigport: add weak-module links for io, collections, random - rename mp_const_vcp_interrupt to mp_kbd_exception - usb: always use the mp_kbd_exception object for VCP interrupt - use core-provided keyboard exception object - led: properly initialise timer handle to zero before using it - mphalport.h: explicitly use HAL's GPIO constants for pull modes - usrsw: use mp_hal_pin_config function instead of HAL_GPIO_Init - led: use mp_hal_pin_config function instead of HAL_GPIO_Init - sdcard: use mp_hal_pin_config function instead of HAL_GPIO_Init - add support for STM32 Nucleo64 L476RG - uart: provide a custom function to transmit over UART - uart: increase inter-character timeout by 1ms - enable utimeq module cc3200 port: - tools/smoke.py: change readall() to read() - pybspi: remove static mode=SPI.MASTER parameter for latest HW API - mods/pybspi: remove SPI.MASTER constant, it's no longer needed - update for moduselect moved to extmod/ - re-add support for UART REPL (MICROPY_STDIO_UART setting) - enable UART REPL by default - README: (re)add information about accessing REPL on serial - make: rename "deploy" target to "deploy-ota" - add targets to erase flash, deploy firmware using cc3200tool - README: reorganize and update to the current state of affairs - modwlan: add network.WLAN.print_ver() diagnostic function esp8266 port: - enable uselect module - move websocket_helper.py from scripts to modules for frozen BC - refactor to use extmod implementation of software SPI class - mpconfigport_512k: disable framebuf module for 512k build - enable native emitter for Xtensa arch - enable inline Xtensa assembler - add "ota" target to produce firmware binary for use with yaota8266 - use core-provided keyboard exception object - add "erase" target to Makefile, to erase entire flash - when doing GC be sure to trace the memory holding native code - modesp: flash_user_start(): support configuration with yaota8266 - force relinking OTA firmware image if built after normal one - scripts/inisetup: dump FS starting sector/size on error - Makefile: produce OTA firmware as firmware-ota.bin - modesp: make check_fw() work with OTA firmware - enable utimeq module - Makefile: put firmware-ota.bin in build/, for consistency - modules/flashbdev: add RESERVED_SECS before the filesystem - modules/flashbdev: remove code to patch bootloader flash size - modules/flashbdev: remove now-unused function set_bl_flash_size - modules/flashbdev: change RESERVED_SECS to 0 zephyr port: - add .gitignore to ignore Zephyr's "outdir" directory - zephyr_getchar: update to Zephyr 1.6 unified kernel API - switch to Zephyr 1.6 unified kernel API - support raw REPL - implement soft reset feature - main: initialize sys.path and sys.argv - use core-provided keyboard exception object - uart_core: access console UART directly instead of printk() hack - enable slice subscription docs: - remove references to readall() and update stream read() docs - library/index: elaborate on u-modules - library/machine.I2C: refine definitions of I2C methods - library/pyb.Accel: add hardware note about pins used by accel - library/pyb.UART: added clarification about timeouts - library/pyb.UART: moved writechar doc to sit with other writes - esp8266/tutorial: update intro to add Getting the firmware section - library/machine.I2C: fix I2C constructor docs to match impl - esp8266/tutorial: close socket after reading page content - esp8266/general: add "Scarcity of runtime resources" section - library/esp: document esp.set_native_code_location() function - library/esp: remove para and add further warning about flash - usocket: clarify that socket timeout raises OSError exception travis: - build STM32 F7 and L4 boards under Travis CI - include persistent bytecode with floats in coverage tests examples: - hwapi: button_led: Add GPIO pin read example - hwapi: add soft_pwm example converted to uasyncio - http_client: use read() instead of readall() - hwapi: add uasyncio example of fading 2 LEDs in parallel - hwapi: add example for machine.time_pulse_us() - hwapi: add hwconfig for console tracing of LED operations - accellog.py: change 1: to /sd/, and update comment about FS - hwapi/hwconfig_console: don't alloc memory in value()
2 parents f874edf + 5653e3c commit dfb61f0

File tree

551 files changed

+220767
-95785
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

551 files changed

+220767
-95785
lines changed

.travis.yml

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -54,6 +54,13 @@ script:
5454
#- (cd tests && MICROPY_CPYTHON3=python3.4 ./run-tests)
5555
#- (cd tests && MICROPY_CPYTHON3=python3.4 ./run-tests --emit native)
5656

57+
# run tests with coverage info
58+
- make -C unix coverage
59+
- (cd tests && MICROPY_CPYTHON3=python3.4 MICROPY_MICROPYTHON=../unix/micropython_coverage ./run-tests)
60+
- (cd tests && MICROPY_CPYTHON3=python3.4 MICROPY_MICROPYTHON=../unix/micropython_coverage ./run-tests -d thread)
61+
- (cd tests && MICROPY_CPYTHON3=python3.4 MICROPY_MICROPYTHON=../unix/micropython_coverage ./run-tests --emit native)
62+
- (cd tests && MICROPY_CPYTHON3=python3.4 MICROPY_MICROPYTHON=../unix/micropython_coverage ./run-tests --via-mpy -d basics float)
63+
5764
after_success:
5865
- (cd unix && coveralls --root .. --build-root . --gcov $(which gcov) --gcov-options '\-o build-coverage/' --include py --include extmod)
5966

cc3200/Makefile

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,9 @@ endif
88
# Make 'release' the default build type
99
BTYPE ?= release
1010

11+
# Port for flashing firmware
12+
PORT ?= /dev/ttyUSB1
13+
1114
# If the build directory is not given, make it reflect the board name.
1215
BUILD ?= build/$(BOARD)/$(BTYPE)
1316

@@ -23,6 +26,9 @@ CFLAGS += -Iboards/$(BOARD)
2326

2427
LDFLAGS = -Wl,-nostdlib -Wl,--gc-sections -Wl,-Map=$@.map
2528

29+
FLASH_SIZE_WIPY = 2M
30+
FLASH_SIZE_LAUNCHXL = 1M
31+
2632
ifeq ($(BTARGET), application)
2733
# qstr definitions (must come before including py.mk)
2834
QSTR_DEFS = qstrdefsport.h $(BUILD)/pins_qstr.h
@@ -39,3 +45,18 @@ endif
3945

4046
# always include MicroPython make rules
4147
include ../py/mkrules.mk
48+
49+
erase:
50+
cc3200tool -p $(PORT) format_flash --size $(FLASH_SIZE_$(BOARD))
51+
52+
deploy:
53+
cc3200tool -p $(PORT) \
54+
write_file bootmgr/build/$(BOARD)/$(BTYPE)/bootloader.bin /sys/mcuimg.bin \
55+
write_file build/$(BOARD)/$(BTYPE)/mcuimg.bin /sys/factimg.bin
56+
57+
# Files *.ucf and *ucf.signed.bin come from CC3200SDK-SERVICEPACK
58+
# package from http://www.ti.com/tool/cc3200sdk
59+
servicepack:
60+
cc3200tool -p $(PORT) \
61+
write_file --file-size=0x20000 --signature ota_1.0.1.6-2.7.0.0.ucf.signed.bin \
62+
ota_1.0.1.6-2.7.0.0.ucf /sys/servicepack.ucf

cc3200/README.md

Lines changed: 94 additions & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -1,36 +1,66 @@
1-
# Build Instructions for the CC3200
1+
MicroPython port to CC3200 WiFi SoC
2+
===================================
23

3-
Currently the CC3200 port of MicroPython builds under Linux and OSX **but not under Windows**.
4+
This is a MicroPython port to Texas Instruments CC3200 WiFi SoC (ARM Cortex-M4
5+
architecture). This port supports 2 boards: WiPy and TI CC3200-LAUNCHXL.
46

5-
The tool chain required for the build can be found at <https://launchpad.net/gcc-arm-embedded>.
7+
## Build Instructions for the CC3200
68

7-
In order to download the image to the CC3200 you will need the CCS_Uniflash tool from TI, which at this
8-
moment is only available for Windows, so, you need Linux/OSX to build and Windows to flash the image.
9+
Currently the CC3200 port of MicroPython builds under Linux and OSX,
10+
but not under Windows.
911

10-
## To build an image suitable for debugging:
12+
The toolchain required for the build can be found at
13+
<https://launchpad.net/gcc-arm-embedded>.
14+
15+
In order to flash the image to the CC3200 you will need the
16+
[cc3200tool](https://github.com/ALLTERCO/cc3200tool). An alternative is
17+
to use CCS_Uniflash tool from TI, which works only under Windows, and all
18+
support is provided by TI itself.
19+
20+
Building the bootloader:
21+
22+
```
23+
make BTARGET=bootloader BTYPE=release BOARD=LAUNCHXL
24+
```
25+
26+
Building the "release" image:
1127

12-
In order to debug the port specific code, optimizations need to be disabled on the
13-
port file (check the Makefile for specific details). You can use CCS from TI.
14-
Use the CC3200.ccxml file supplied with this distribution for the debuuger configuration.
15-
```bash
16-
make BTARGET=application BTYPE=debug BOARD=LAUNCHXL
1728
```
18-
## To build an image suitable to be flashed to the device:
19-
```bash
2029
make BTARGET=application BTYPE=release BOARD=LAUNCHXL
2130
```
22-
## Building the bootloader
23-
```bash
24-
make BTARGET=bootloader BTYPE=release BOARD=LAUNCHXL
31+
32+
To build an image suitable for debugging:
33+
34+
In order to debug the port specific code, optimizations need to be disabled on the
35+
port file (check the Makefile for specific details). You can use CCS from TI.
36+
Use the CC3200.ccxml file supplied with this distribution for the debuuger configuration.
37+
38+
```
39+
make BTARGET=application BTYPE=debug BOARD=LAUNCHXL
2540
```
2641

27-
## Regarding old revisions of the CC3200-LAUNCHXL
28-
First silicon (pre-release) revisions of the CC3200 had issues with the ram blocks, and MicroPython cannot run
29-
there. Make sure to use a **v4.1 (or higer) LAUNCHXL board** when trying this port, otherwise it won't work.
42+
## Flashing the CC3200-LAUNCHXL
43+
44+
Note that WiPy comes factory programmed with a default version of MicroPython,
45+
it cannot be programmed via serial, and can be upgraded only with OTA (see
46+
below).
3047

31-
## Flashing the CC3200
3248
- Make sure that you have built both the *bootloader* and the *application* in **release** mode.
3349
- Make sure the SOP2 jumper is in position.
50+
- Make sure you Linux system recognized the board and created `ttyUSB*`
51+
devices (see below for configuration of `ftdi_sio` driver).
52+
- Run "make erase" and immediately press Reset button on the device.
53+
- Wait few seconds.
54+
- Run "make deploy" and immediately press Reset button on the device.
55+
- You are recommended to install the latest vendor WiFi firmware
56+
servicepack from http://www.ti.com/tool/cc3200sdk. Download
57+
CC3200SDK-SERVICEPACK package, install it, and locate `ota_*.ucf`
58+
and `ota_*.ucf.signed.bin` files. Copy them to the port's directory
59+
and run "make servicepack", with immediate press of Reset button.
60+
- Remove the SOP2 jumper and reset the board.
61+
62+
Flashing process using TI Uniflash:
63+
3464
- Open CCS_Uniflash and connect to the board (by default on port 22).
3565
- Format the serial flash (select 1MB size in case of the CC3200-LAUNCHXL, 2MB in case of the WiPy, leave the rest unchecked).
3666
- Mark the following files for erasing: `/cert/ca.pem`, `/cert/client.pem`, `/cert/private.key` and `/tmp/pac.bin`.
@@ -40,26 +70,30 @@ there. Make sure to use a **v4.1 (or higer) LAUNCHXL board** when trying this po
4070
- Flash the latest service pack (servicepack_1.0.0.10.0.bin) using the "Service Pack Update" button.
4171
- Close CCS_Uniflash, remove the SOP2 jumper and reset the board.
4272

43-
## Updating the board to with new software version
44-
- Make sure the board is running and connected to the same network as the computer.
45-
46-
```bash
47-
make BTARGET=application BTYPE=release BOARD=LAUNCHXL WIPY_IP=192.168.1.1 WIPY_USER=micro WIPY_PWD=python deploy
48-
```
49-
50-
If `WIPY_IP`, `WIPY_USER` or `WIPY_PWD` are omitted the default values (the ones shown above) will be used.
51-
5273
## Playing with MicroPython and the CC3200:
5374

5475
Once the software is running, you have two options to access the MicroPython REPL:
5576

56-
- Through telnet.
77+
- Through telnet.
5778
* Connect to the network created by the board (as boots up in AP mode), **ssid = "wipy-wlan", key = "www.wipy.io"**.
5879
* You can also reinitialize the WLAN in station mode and connect to another AP, or in AP mode but with a
5980
different ssid and/or key.
6081
* Use your favourite telnet client with the following settings: **host = 192.168.1.1, port = 23.**
6182
* Log in with **user = "micro" and password = "python"**
6283

84+
- Through UART (serial).
85+
* This is enabled by default in the standard configuration, for UART0 (speed 115200).
86+
* For CC3200-LAUNCHXL, you will need to configure Linux `ftdi_sio` driver as described
87+
in the [blog post](http://www.achanceofbrainshowers.com/blog/tech/2014/8/19/cc3200-development-under-linux/).
88+
After that, connecting a board will create two `/dev/ttyUSB*` devices, a serial
89+
console is available on the 2nd one (usually `/dev/ttyUSB1`).
90+
* WiPy doesn't have onboard USB-UART converter, so you will need an external one,
91+
connected to GPIO01 (Tx) and GPIO02 (Rx).
92+
* Usage of UART port for REPL is controlled by MICROPY_STDIO_UART setting (and
93+
is done at the high level, using a suitable call to `os.dupterm()` function
94+
in boot.py, so you can override it at runtime regardless of MICROPY_STDIO_UART
95+
setting).
96+
6397
The board has a small file system of 192K (WiPy) or 64K (Launchpad) located in the serial flash connected to the CC3200.
6498
SD cards are also supported, you can connect any SD card and configure the pinout using the SD class API.
6599

@@ -68,26 +102,47 @@ SD cards are also supported, you can connect any SD card and configure the pinou
68102
To upload your MicroPython scripts to the FTP server, open your FTP client of choice and connect to:
69103
**ftp://192.168.1.1, user = "micro", password = "python"**
70104

71-
I have tested the FTP server with **FileZilla, FireFTP, FireFox, IE and Chrome,** other clients should work as well, but I am
72-
not 100% sure of it.
105+
Tested FTP clients are: FileZilla, FireFTP, FireFox, IE and Chrome. Other
106+
clients should work as well, but you may need to configure them to use a
107+
single connection (this should be the default for any compliant FTP client).
73108

74-
## Upgrading the firmware Over The Air:
109+
## Upgrading the firmware Over The Air (OTA)
75110

76-
OTA software updates can be performed through the FTP server. After building a new **mcuimg.bin** in release mode, upload it to:
77-
`/flash/sys/mcuimg.bin` it will take around 6s (The TI simplelink file system is quite slow because every file is mirrored for
78-
safety). You won't see the file being stored inside `/flash/sys/` because it's actually saved bypassing FatFS, but rest assured that
79-
the file was successfully transferred, and it has been signed with a MD5 checksum to verify its integrity.
111+
OTA software updates can be performed through the builtin FTP server. After
112+
building a new `mcuimg.bin` in release mode, upload it to:
113+
`/flash/sys/mcuimg.bin`. It will take around 6s (The TI SimpleLink file
114+
system is quite slow because every file is mirrored for safety). You won't
115+
see the file being stored inside `/flash/sys/` because it's actually saved
116+
bypassing FatFS, but rest assured that the file was successfully transferred,
117+
and it has been signed with a MD5 checksum to verify its integrity.
80118
Now, reset the MCU by pressing the switch on the board, or by typing:
81119

82120
```python
83121
import machine
84122
machine.reset()
85123
```
86124

87-
### Note regarding FileZilla:
125+
There's a script which automates this process from the host side:
126+
127+
- Make sure the board is running and connected to the same network as the computer.
128+
129+
```bash
130+
make BTARGET=application BTYPE=release BOARD=LAUNCHXL WIPY_IP=192.168.1.1 WIPY_USER=micro WIPY_PWD=python deploy-ota
131+
```
132+
133+
If `WIPY_IP`, `WIPY_USER` or `WIPY_PWD` are omitted the default values (the ones shown above) will be used.
134+
135+
136+
## Notes and known issues
137+
138+
## Regarding old revisions of the CC3200-LAUNCHXL
139+
140+
First silicon (pre-release) revisions of the CC3200 had issues with the ram blocks, and MicroPython cannot run
141+
there. Make sure to use a **v4.1 (or higer) LAUNCHXL board** when trying this port, otherwise it won't work.
142+
143+
### Note regarding FileZilla
88144

89145
Do not use the quick connect button, instead, open the site manager and create a new configuration. In the "General" tab make
90146
sure that encryption is set to: "Only use plain FTP (insecure)". In the Transfer Settings tab limit the max number of connections
91147
to one, otherwise FileZilla will try to open a second command connection when retrieving and saving files, and for simplicity and
92148
to reduce code size, only one command and one data connections are possible.
93-

cc3200/application.mk

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -162,8 +162,6 @@ APP_STM_SRC_C = $(addprefix stmhal/,\
162162
import.c \
163163
input.c \
164164
irq.c \
165-
lexerfatfs.c \
166-
moduselect.c \
167165
pybstdio.c \
168166
)
169167

@@ -208,9 +206,9 @@ WIPY_PWD ?= 'python'
208206

209207
all: $(BUILD)/mcuimg.bin
210208

211-
.PHONY: deploy
209+
.PHONY: deploy-ota
212210

213-
deploy: $(BUILD)/mcuimg.bin
211+
deploy-ota: $(BUILD)/mcuimg.bin
214212
$(ECHO) "Writing $< to the board"
215213
$(Q)$(PYTHON) $(UPDATE_WIPY) --verify --ip $(WIPY_IP) --user $(WIPY_USER) --password $(WIPY_PWD) --file $<
216214

cc3200/boards/LAUNCHXL/mpconfigboard.h

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@
3232

3333
#define MICROPY_HW_ANTENNA_DIVERSITY (0)
3434

35-
#define MICROPY_STDIO_UART 0
35+
#define MICROPY_STDIO_UART 1
3636
#define MICROPY_STDIO_UART_BAUD 115200
3737

3838
#define MICROPY_SYS_LED_PRCM PRCM_GPIOA1

cc3200/boards/WIPY/mpconfigboard.h

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -32,6 +32,9 @@
3232

3333
#define MICROPY_HW_ANTENNA_DIVERSITY (1)
3434

35+
#define MICROPY_STDIO_UART 1
36+
#define MICROPY_STDIO_UART_BAUD 115200
37+
3538
#define MICROPY_SYS_LED_PRCM PRCM_GPIOA3
3639
#define MICROPY_SAFE_BOOT_PRCM PRCM_GPIOA3
3740
#define MICROPY_SYS_LED_PORT GPIOA3_BASE

cc3200/misc/mpirq.c

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -176,7 +176,7 @@ STATIC mp_obj_t mp_irq_flags (mp_obj_t self_in) {
176176
}
177177
STATIC MP_DEFINE_CONST_FUN_OBJ_1(mp_irq_flags_obj, mp_irq_flags);
178178

179-
STATIC mp_obj_t mp_irq_call (mp_obj_t self_in, mp_uint_t n_args, mp_uint_t n_kw, const mp_obj_t *args) {
179+
STATIC mp_obj_t mp_irq_call(mp_obj_t self_in, size_t n_args, size_t n_kw, const mp_obj_t *args) {
180180
mp_arg_check_num(n_args, n_kw, 0, 0, false);
181181
mp_irq_handler (self_in);
182182
return mp_const_none;

cc3200/mods/modnetwork.c

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -91,7 +91,7 @@ STATIC const mp_arg_t network_server_args[] = {
9191
{ MP_QSTR_login, MP_ARG_KW_ONLY | MP_ARG_OBJ, {.u_obj = MP_OBJ_NULL} },
9292
{ MP_QSTR_timeout, MP_ARG_KW_ONLY | MP_ARG_OBJ, {.u_obj = MP_OBJ_NULL} },
9393
};
94-
STATIC mp_obj_t network_server_make_new(const mp_obj_type_t *type, mp_uint_t n_args, mp_uint_t n_kw, const mp_obj_t *all_args) {
94+
STATIC mp_obj_t network_server_make_new(const mp_obj_type_t *type, size_t n_args, size_t n_kw, const mp_obj_t *all_args) {
9595
// parse args
9696
mp_map_t kw_args;
9797
mp_map_init_fixed_table(&kw_args, n_kw, all_args + n_args);

cc3200/mods/moduhashlib.c

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -121,7 +121,7 @@ STATIC mp_obj_t hash_read (mp_obj_t self_in) {
121121

122122
/// \classmethod \constructor([data[, block_size]])
123123
/// initial data must be given if block_size wants to be passed
124-
STATIC mp_obj_t hash_make_new(mp_obj_t type_in, mp_uint_t n_args, mp_uint_t n_kw, const mp_obj_t *args) {
124+
STATIC mp_obj_t hash_make_new(mp_obj_t type_in, size_t n_args, size_t n_kw, const mp_obj_t *args) {
125125
mp_arg_check_num(n_args, n_kw, 0, 2, false);
126126
mp_obj_hash_t *self = m_new0(mp_obj_hash_t, 1);
127127
self->base.type = type_in;

cc3200/mods/modusocket.c

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -127,7 +127,7 @@ void modusocket_close_all_user_sockets (void) {
127127
// socket class
128128

129129
// constructor socket(family=AF_INET, type=SOCK_STREAM, proto=IPPROTO_TCP, fileno=None)
130-
STATIC mp_obj_t socket_make_new(const mp_obj_type_t *type, mp_uint_t n_args, mp_uint_t n_kw, const mp_obj_t *args) {
130+
STATIC mp_obj_t socket_make_new(const mp_obj_type_t *type, size_t n_args, size_t n_kw, const mp_obj_t *args) {
131131
mp_arg_check_num(n_args, n_kw, 0, 4, false);
132132

133133
// create socket object
@@ -434,7 +434,6 @@ STATIC const mp_map_elem_t socket_locals_dict_table[] = {
434434

435435
// stream methods
436436
{ MP_OBJ_NEW_QSTR(MP_QSTR_read), (mp_obj_t)&mp_stream_read_obj },
437-
{ MP_OBJ_NEW_QSTR(MP_QSTR_readall), (mp_obj_t)&mp_stream_readall_obj },
438437
{ MP_OBJ_NEW_QSTR(MP_QSTR_readinto), (mp_obj_t)&mp_stream_readinto_obj },
439438
{ MP_OBJ_NEW_QSTR(MP_QSTR_readline), (mp_obj_t)&mp_stream_unbuffered_readline_obj},
440439
{ MP_OBJ_NEW_QSTR(MP_QSTR_write), (mp_obj_t)&mp_stream_write_obj },
@@ -446,7 +445,7 @@ STATIC mp_uint_t socket_read(mp_obj_t self_in, void *buf, mp_uint_t size, int *e
446445
mod_network_socket_obj_t *self = self_in;
447446
mp_int_t ret = wlan_socket_recv(self, buf, size, errcode);
448447
if (ret < 0) {
449-
// we need to ignore the socket closed error here because a readall() or read() without params
448+
// we need to ignore the socket closed error here because a read() without params
450449
// only returns when the socket is closed by the other end
451450
if (*errcode != SL_ESECCLOSED) {
452451
ret = MP_STREAM_ERROR;

0 commit comments

Comments
 (0)