Watch Application System in Python¶

Introduction¶

Wasp-os is a firmware for smart watches that are based on the nRF52 family of microcontrollers, and especially for hacker friendly watches such as the Pine64 PineTime. Wasp-os features full heart rate monitoring and step counting support together with multiple clock faces, a stopwatch, an alarm clock, a countdown timer, a calculator and lots of other games and utilities. All of this, and still with access to the MicroPython REPL for interactive tweaking, development and testing.

Wasp-os comes fully integrated with a robust bootloader based on the Adafruit NRF52 Bootloader. The bootloader 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 on Bluetooth Low Energy for over-the-air updates.

Documentation¶

Wasp-os is has extensive documentation which includes a detailed Application Writer’s Guide to help you get started coding for wasp-os as quickly as possible.

Getting Started¶

Wasp-os can be installed without using any tools or disassembly onto the following devices:

Pine64 PineTime

Colmi P8

Senbono K9

Use the Installation Guide to learn how to build and install wasp-os on these devices.

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

At this point you will also be able to use the Nordic UART Service to access the MicroPython REPL. You can use tools/wasptool --console to access the MicroPython REPL.

To set the time and restart the main application:

^C
watch.rtc.set_localtime((yyyy, mm, dd, HH, MM, SS))
wasp.system.run()

Or, if you have a suitable GNU/Linux workstation, just use:

./tools/wasptool --rtc

which can run these commands automatically.

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

Community¶

The wasp-os community is centred around the github project and is supplemented with instant messaging in the #wasp-os:matrix.org channel. If you do not have a preferred Matrix chat client then we recommend trying out the Element web client Follow the element link and, if you do not already have a matrix account, register yourself. That should be enough to get you chatting!

Alternatively, if you prefer to use IRC then, for all the usual reasons the Matrix channel is also bridged to the #wasp-os IRC channel at libera.chat.

Videos¶

A tour of the new applications for wasp-os¶	Open source heart rate monitoring for Pine64 PineTime¶
An M2 pre-release running on Pine64 PineTime¶	How to develop wasp-os python applications on a Pine64 PineTime¶
Developing for Pine64 PineTime using wasp-os and MicroPython¶

Custom builds¶

Wasp-os is designed to allow users to easily create their own custom builds. Simply modify the wasp.toml file to include your favorite apps and watch faces. See the docs for more information on how to build wasp-os.