My personal fork of wasp-os, the MicroPython-based OS for smartwatches
Go to file
Daniel Thompson b9fe31241c Add licensing information for all wasp-os files. 2020-03-22 15:40:18 +00:00
bootloader@7786926950 bootloader: Now works on boards without ST7789 2020-01-31 19:23:46 +00:00
docs Add licensing information for all wasp-os files. 2020-03-22 15:40:18 +00:00
micropython@2e5cb3eb32 wasp: Add full dd-mm-yyyy calender tracking 2020-02-19 19:57:08 +00:00
res wasp: res: Add original source for battery icon 2020-02-09 19:48:40 +00:00
tools Add licensing information for all wasp-os files. 2020-03-22 15:40:18 +00:00
wasp Add licensing information for all wasp-os files. 2020-03-22 15:40:18 +00:00
.gitignore docs: Use sphinx to gather together all the wasp docs 2020-02-22 21:17:30 +00:00
.gitmodules wasp: Add a simple font renderer 2020-02-19 19:57:08 +00:00
COPYING Add licensing information for all wasp-os files. 2020-03-22 15:40:18 +00:00
COPYING.LGPL Add licensing information for all wasp-os files. 2020-03-22 15:40:18 +00:00
Makefile docs: Add .nojeykyll for better github compatiblity 2020-02-24 08:53:44 +00:00
README.md README: Move the screenshots further down the doc 2020-03-06 21:27:33 +00:00
TODO.md docs: Use sphinx to gather together all the wasp docs 2020-02-22 21:17:30 +00:00

README.md

Watch Application System in Python

Introduction

Currently in its infancy wasp-os provides nothing more than a simple digital clock application for PineTime together with access to the MicroPython REPL for interactive testing and tweaking. However it keeps time well and has enough power saving functions implemented that it can survive for well over 24 hours between charges so even at this early stage it is functional as a wearable timepiece.

WASP includes a robust bootloader based on the Adafruit NRF52 Bootloader. It has been extended to make it robust for development on form-factor devices without a reset button, power switch, SWD debugger or UART. This allows us to confidently develop on sealed devices relying only on BLE for updates.

Videos

Developing for Pine64 PineTime using wasp-os and MicroPython
Developing for Pine64 PineTime using wasp-os and MicroPython

WASP bootloader and MicroPython running on Pine64 PineTime
WASP bootloader and MicroPython running on Pine64 PineTime

Building from a git clone

pip3 install --user click serial pyserial
make submodules
make softdevice
make -j `nproc` BOARD=pinetime all

Note: You will need a toolchain for the Arm Cortex-M4. wasp-os is developed and tested using the GNU-RM toolchain (9-2019-q4) from Arm.

Note #2: There are known problems with toolchains older than gcc-7.3 due to problems with link-time-optimization (which is enabled by default)

Installing

Note: If you have a new PineTime then it will have been delivered with flash protection enabled. You must disable the flash protection before trying to program it.

  • Use an SWD programmer to install bootloader.hex to the PineTime. This file is an Intel HEX file containing both the bootloader and the Nordic SoftDevice. Be careful to disconnect cleanly from the debug software since just pulling out the SWD cable will mean the nRF52 will still believe it is being debugged.
  • Copy micropython.zip to your Android device and download nRF Connect for Android if you do not already have it.
  • In nRF Connect, choose settings and reduce the DFU packet count from 10 to 4.
  • Connect to PineDFU using nRFConnect, click the DFU button and send micropython.zip to the device.

At the end of this process your watch will show the time (12:00) and a battery meter. When the watch goes into power saving mode you can use the side button to wake it again.

At this point you will also be able to use the Nordic UART Service to access the MicroPython REPL, although currently you must send ^C to interrupt the program that updates the watch display.

Just for fun try:

^C
import demo
demo.run()
# After watching the demo for a bit...
^C
wasp.app.draw(watch)
wasp.run()

To set the time and restart the main application:

^C
watch.rtc.set_time((hh, mm, ss))
wasp.run()

As mentioned above there are many drivers and features still to be developed, see the TODO list for current status.

Screenshots

wasp-os digital clock app running on PineTime