/wasp-os

A MicroPython based development environment for smart watches (including Pine64 PineTime)

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

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 :ref:`Roadmap` for current status.

Community

The wasp-os community is centred around the github project and is supplemented with instant messaging via the #wasp-os IRC channel at libera.chat .

If you are unfamiliar with IRC and don't have a preferred client then we recommend connecting to libera.chat using the matrix/IRC bridge. The matrix bridge will allow us to receive messages whilst offline. Follow the link above and, if you do not already have a matrix account, register yourself. That should be enough to get you chatting!

Videos

 

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.

Screenshots

(An older version of) the digital clock application running on a Pine64 PineTime:

wasp-os digital clock app running on PineTime

Screenshots of the available applications running on the wasp-os simulator:

Bootloader splash screen overlaid on the simulator watch art

Watch faces:

Digital clock application running on the wasp-os simulator

Digital clock application with week day running on the wasp-os simulator

Analogue clock application running in the wasp-os simulator

An other clock application running in the wasp-os simulator

Fibonacci clock application running in the wasp-os simulator

Shows a time as words in the wasp-os simulator

Games:

Let's play the 2048 game (in the wasp-os simulator)

Game of Life running in the wasp-os simulator

Snake Game running in the wasp-os simulator

15 Puzzle running in the wasp-os simulator

Time management apps:

Alarm clock application running in the wasp-os simulator

Stop watch application running on the wasp-os simulator

Countdown timer application running in the wasp-os simulator

System apps:

Small application for disabling bluetooth to save power and enhance security

Application launcher running on the wasp-os simulator

Settings application running on the wasp-os simulator

Software selection app running on the wasp-os simulator

Switch watch faces

Other apps: (The "blank" white screenshot is a flashlight app)

Flash the relatively powerful HRS LED repeatedly

Calculator running in the wasp-os simulator

Simple always-on demo for showing off wasp-os at conferences and shows

Torch application running on the wasp-os simulator

Gallery application running on the wasp-os simulator

Heart rate application running on the wasp-os simulator

Haiku application running in the wasp-os simulator

Shows a time as words in the wasp-os simulator

Morse translator/notepad application running on the wasp-os simulator

Customizable pomodoro app with randomized vibration patterns to make sure you notice

Find your phone by causing it to ring

Sports applications, a combined stopwatch and step counter

Step counter application running on the wasp-os simulator

Self test application running a rendering benchmark on the simulator

Music Player running in the wasp-os simulator

Weather application running in the wasp-os simulator