2020-05-15 20:52:49 +02:00
|
|
|
Watch Application System in Python
|
|
|
|
|
==================================
|
|
|
|
|
|
|
|
|
|
Introduction
|
|
|
|
|
------------
|
|
|
|
|
|
2021-02-20 13:32:28 +01:00
|
|
|
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
|
2021-03-08 10:26:59 +01:00
|
|
|
timer, a calculator and lots of other games and utilities. All of this, and
|
2021-02-20 13:32:28 +01:00
|
|
|
still with access to the MicroPython REPL for interactive tweaking, development
|
2020-11-22 10:25:24 +01:00
|
|
|
and testing.
|
2020-05-15 20:52:49 +02:00
|
|
|
|
2021-02-20 13:32:28 +01:00
|
|
|
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.
|
2020-05-15 20:52:49 +02:00
|
|
|
|
|
|
|
|
Documentation
|
|
|
|
|
-------------
|
|
|
|
|
|
|
|
|
|
Wasp-os is has `extensive documentation <https://wasp-os.readthedocs.io>`_
|
2020-07-25 15:59:43 +02:00
|
|
|
which includes a detailed `Application Writer's Guide
|
2020-05-21 09:52:51 +02:00
|
|
|
<https://wasp-os.readthedocs.io/en/latest/appguide.html>`_ to help you
|
2020-05-15 20:52:49 +02:00
|
|
|
get started coding for wasp-os as quickly as possible.
|
|
|
|
|
|
2020-07-29 23:19:52 +02:00
|
|
|
Getting Started
|
|
|
|
|
---------------
|
2020-05-15 20:52:49 +02:00
|
|
|
|
2020-11-22 10:25:24 +01:00
|
|
|
Wasp-os can be installed without using any tools or disassembly onto the
|
|
|
|
|
following devices:
|
2020-05-20 23:17:33 +02:00
|
|
|
|
2020-11-22 10:25:24 +01:00
|
|
|
* Pine64 PineTime
|
2020-07-29 23:19:52 +02:00
|
|
|
* Colmi P8
|
2020-11-08 15:39:06 +01:00
|
|
|
* Senbono K9
|
2020-05-15 20:52:49 +02:00
|
|
|
|
2020-11-22 10:25:24 +01:00
|
|
|
Use the
|
2020-07-29 23:19:52 +02:00
|
|
|
`Installation Guide <https://wasp-os.readthedocs.io/en/latest/install.html>`_
|
2020-11-22 10:25:24 +01:00
|
|
|
to learn how to build and install wasp-os on these devices.
|
2020-05-15 20:52:49 +02:00
|
|
|
|
2020-07-29 23:19:52 +02:00
|
|
|
At the end of the install process your watch will show the time (03:00)
|
2020-11-22 10:25:24 +01:00
|
|
|
together with a date and a battery meter. When the watch goes into power
|
2020-07-29 23:19:52 +02:00
|
|
|
saving mode you can use the button to wake it again.
|
2020-05-15 20:52:49 +02:00
|
|
|
|
|
|
|
|
At this point you will also be able to use the Nordic UART Service to
|
2020-07-29 23:19:52 +02:00
|
|
|
access the MicroPython REPL. You can use ``tools/wasptool --console``
|
|
|
|
|
to access the MicroPython REPL.
|
2020-05-15 20:52:49 +02:00
|
|
|
|
|
|
|
|
To set the time and restart the main application:
|
|
|
|
|
|
|
|
|
|
.. code-block:: python
|
|
|
|
|
|
|
|
|
|
^C
|
|
|
|
|
watch.rtc.set_localtime((yyyy, mm, dd, HH, MM, SS))
|
|
|
|
|
wasp.system.run()
|
|
|
|
|
|
2020-11-22 10:25:24 +01:00
|
|
|
Or, if you have a suitable GNU/Linux workstation, just use:
|
2020-05-15 20:52:49 +02:00
|
|
|
|
|
|
|
|
.. code-block:: sh
|
|
|
|
|
|
|
|
|
|
./tools/wasptool --rtc
|
|
|
|
|
|
|
|
|
|
which can run these commands automatically.
|
|
|
|
|
|
|
|
|
|
As mentioned above there are many drivers and features still to be
|
2020-05-20 23:17:33 +02:00
|
|
|
developed, see the :ref:`Roadmap` for current status.
|
2020-05-15 20:52:49 +02:00
|
|
|
|
2020-11-26 19:56:30 +01:00
|
|
|
Community
|
|
|
|
|
---------
|
|
|
|
|
|
|
|
|
|
The wasp-os community is centred around the
|
|
|
|
|
`github project <https://github.com/daniel-thompson/wasp-os>`_ and is
|
|
|
|
|
supplemented with instant messaging via the #wasp-os IRC channel at
|
2021-06-18 20:15:28 +02:00
|
|
|
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 <https://app.element.io/#/room/#wasp-os:libera.chat>`_.
|
|
|
|
|
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!
|
2020-11-26 19:56:30 +01:00
|
|
|
|
2020-08-16 19:46:44 +02:00
|
|
|
Videos
|
|
|
|
|
------
|
|
|
|
|
|
|
|
|
|
.. list-table::
|
|
|
|
|
|
2021-01-12 21:55:16 +01:00
|
|
|
* - .. figure:: res/thumbnail-nps8Kd2qPzs.jpg
|
|
|
|
|
:target: https://www.youtube.com/watch?v=nps8Kd2qPzs
|
|
|
|
|
:alt: wasp-os: A tour of the new applications for wasp-os
|
|
|
|
|
:width: 95%
|
|
|
|
|
|
|
|
|
|
`A tour of the new applications for wasp-os <https://www.youtube.com/watch?v=nps8Kd2qPzs>`_
|
|
|
|
|
|
|
|
|
|
- .. figure:: https://img.youtube.com/vi/lIo2-djNR48/0.jpg
|
2020-08-16 19:46:44 +02:00
|
|
|
:target: https://www.youtube.com/watch?v=lIo2-djNR48
|
|
|
|
|
:alt: wasp-os: Open source heart rate monitoring for Pine64 PineTime
|
|
|
|
|
:width: 95%
|
|
|
|
|
|
|
|
|
|
`Open source heart rate monitoring for Pine64 PineTime <https://www.youtube.com/watch?v=lIo2-djNR48>`_
|
|
|
|
|
|
2021-01-12 21:55:16 +01:00
|
|
|
* - .. figure:: https://img.youtube.com/vi/YktiGUSRJB4/0.jpg
|
2020-08-16 19:46:44 +02:00
|
|
|
:target: https://www.youtube.com/watch?v=YktiGUSRJB4
|
|
|
|
|
:alt: An M2 pre-release running on Pine64 PineTime
|
|
|
|
|
:width: 95%
|
|
|
|
|
|
|
|
|
|
`An M2 pre-release running on Pine64 PineTime <https://www.youtube.com/watch?v=YktiGUSRJB4>`_
|
|
|
|
|
|
2021-01-12 21:55:16 +01:00
|
|
|
- .. figure:: https://img.youtube.com/vi/tuk9Nmr3Jo8/0.jpg
|
2020-08-16 19:46:44 +02:00
|
|
|
:target: https://www.youtube.com/watch?v=tuk9Nmr3Jo8
|
|
|
|
|
:alt: How to develop wasp-os python applications on a Pine64 PineTime
|
|
|
|
|
:width: 95%
|
|
|
|
|
|
|
|
|
|
`How to develop wasp-os python applications on a Pine64 PineTime <https://www.youtube.com/watch?v=tuk9Nmr3Jo8>`_
|
|
|
|
|
|
2021-01-12 21:55:16 +01:00
|
|
|
* - .. figure:: https://img.youtube.com/vi/kf1VHj587Mc/0.jpg
|
2020-08-16 19:46:44 +02:00
|
|
|
:target: https://www.youtube.com/watch?v=kf1VHj587Mc
|
|
|
|
|
:alt: Developing for Pine64 PineTime using wasp-os and MicroPython
|
|
|
|
|
:width: 95%
|
|
|
|
|
|
|
|
|
|
`Developing for Pine64 PineTime using wasp-os and MicroPython <https://www.youtube.com/watch?v=kf1VHj587Mc>`_
|
|
|
|
|
|
2021-01-12 21:55:16 +01:00
|
|
|
-
|
|
|
|
|
|
2020-05-15 20:52:49 +02:00
|
|
|
Screenshots
|
|
|
|
|
-----------
|
|
|
|
|
|
2020-11-22 10:25:24 +01:00
|
|
|
(An older version of) the digital clock application running on a Pine64
|
|
|
|
|
PineTime:
|
2020-08-16 19:48:15 +02:00
|
|
|
|
2020-05-15 20:52:49 +02:00
|
|
|
.. image:: res/clock_app.jpg
|
|
|
|
|
:alt: wasp-os digital clock app running on PineTime
|
2020-11-22 10:25:24 +01:00
|
|
|
:width: 233
|
2020-08-16 19:48:15 +02:00
|
|
|
|
|
|
|
|
Screenshots of the built in applications running on the wasp-os
|
2021-01-12 23:02:31 +01:00
|
|
|
simulator:
|
2020-08-16 19:48:15 +02:00
|
|
|
|
|
|
|
|
.. image:: res/Bootloader.png
|
|
|
|
|
:alt: Bootloader splash screen overlaid on the simulator watch art
|
|
|
|
|
:width: 179
|
|
|
|
|
|
|
|
|
|
.. image:: res/ClockApp.png
|
|
|
|
|
:alt: Digital clock application running on the wasp-os simulator
|
|
|
|
|
:width: 179
|
|
|
|
|
|
2021-06-20 11:43:25 +02:00
|
|
|
.. image:: res/DemoApp.png
|
|
|
|
|
:alt: Simple always-on demo for showing off wasp-os at conferences and shows
|
|
|
|
|
:width: 179
|
|
|
|
|
|
2021-11-24 20:06:08 +01:00
|
|
|
.. image:: res/DisaBLEApp.png
|
|
|
|
|
:alt: Small application for disabling bluetooth to save power and enhance security
|
|
|
|
|
:width: 179
|
|
|
|
|
|
2021-09-20 16:07:16 +02:00
|
|
|
.. image:: res/GalleryApp.png
|
|
|
|
|
:alt: Gallery application running on the wasp-os simulator
|
|
|
|
|
:width: 179
|
|
|
|
|
|
2020-08-16 19:48:15 +02:00
|
|
|
.. image:: res/HeartApp.png
|
|
|
|
|
:alt: Heart rate application running on the wasp-os simulator
|
|
|
|
|
:width: 179
|
|
|
|
|
|
2021-09-09 14:40:09 +02:00
|
|
|
.. image:: res/MorseApp.png
|
|
|
|
|
:alt: Morse translator/notepad application running on the wasp-os simulator
|
|
|
|
|
:width: 179
|
|
|
|
|
|
2021-06-20 18:24:10 +02:00
|
|
|
.. image:: res/SportsApp.png
|
|
|
|
|
:alt: Sports applications, a combined stopwatch and step counter
|
|
|
|
|
:width: 179
|
|
|
|
|
|
2020-12-31 17:18:13 +01:00
|
|
|
.. image:: res/StopclockApp.png
|
2020-08-16 19:48:15 +02:00
|
|
|
:alt: Stop watch application running on the wasp-os simulator
|
|
|
|
|
:width: 179
|
|
|
|
|
|
|
|
|
|
.. image:: res/StepsApp.png
|
|
|
|
|
:alt: Step counter application running on the wasp-os simulator
|
|
|
|
|
:width: 179
|
|
|
|
|
|
|
|
|
|
.. image:: res/LauncherApp.png
|
|
|
|
|
:alt: Application launcher running on the wasp-os simulator
|
|
|
|
|
:width: 179
|
|
|
|
|
|
|
|
|
|
.. image:: res/SettingsApp.png
|
|
|
|
|
:alt: Settings application running on the wasp-os simulator
|
|
|
|
|
:width: 179
|
|
|
|
|
|
2021-01-12 23:02:31 +01:00
|
|
|
.. image:: res/SoftwareApp.png
|
|
|
|
|
:alt: Software selection app running on the wasp-os simulator
|
2020-08-16 19:48:15 +02:00
|
|
|
:width: 179
|
2020-10-10 13:11:06 +02:00
|
|
|
|
2021-01-12 23:02:31 +01:00
|
|
|
|
2020-10-10 13:11:06 +02:00
|
|
|
wasp-os also contains a library of additional applications for you to choose.
|
2021-01-12 23:02:31 +01:00
|
|
|
These are disabled by default but can be easily enabled using the Software
|
|
|
|
|
application (and the "blank" white screen is a torch application):
|
|
|
|
|
|
|
|
|
|
.. image:: res/SelfTestApp.png
|
|
|
|
|
:alt: Self test application running a rendering benchmark on the simulator
|
|
|
|
|
:width: 179
|
|
|
|
|
|
|
|
|
|
.. image:: res/TorchApp.png
|
|
|
|
|
:alt: Torch application running on the wasp-os simulator
|
|
|
|
|
:width: 179
|
2020-10-10 13:11:06 +02:00
|
|
|
|
2020-12-27 10:13:49 +01:00
|
|
|
.. image:: res/ChronoApp.png
|
|
|
|
|
:alt: Analogue clock application running in the wasp-os simulator
|
|
|
|
|
:width: 179
|
|
|
|
|
|
2021-03-03 21:41:11 +01:00
|
|
|
.. image:: res/DualApp.png
|
|
|
|
|
:alt: An other clock application running in the wasp-os simulator
|
|
|
|
|
:width: 179
|
|
|
|
|
|
2020-10-10 15:21:19 +02:00
|
|
|
.. image:: res/FiboApp.png
|
|
|
|
|
:alt: Fibonacci clock application running in the wasp-os simulator
|
|
|
|
|
:width: 179
|
|
|
|
|
|
2020-10-10 13:12:59 +02:00
|
|
|
.. image:: res/HaikuApp.png
|
|
|
|
|
:alt: Haiku application running in the wasp-os simulator
|
2020-10-10 15:21:19 +02:00
|
|
|
:width: 179
|
2020-10-10 13:12:59 +02:00
|
|
|
|
2020-10-10 13:11:06 +02:00
|
|
|
.. image:: res/LifeApp.png
|
2020-10-22 17:59:17 +02:00
|
|
|
:alt: Game of Life running in the wasp-os simulator
|
|
|
|
|
:width: 179
|
|
|
|
|
|
2021-01-12 23:02:31 +01:00
|
|
|
.. image:: res/AlarmApp.png
|
|
|
|
|
:alt: Alarm clock application running in the wasp-os simulator
|
|
|
|
|
:width: 179
|
|
|
|
|
|
2020-11-22 10:25:24 +01:00
|
|
|
.. image:: res/MusicApp.png
|
2020-10-22 17:59:17 +02:00
|
|
|
:alt: Music Player running in the wasp-os simulator
|
2020-10-10 15:21:19 +02:00
|
|
|
:width: 179
|
2020-11-27 11:39:40 +01:00
|
|
|
|
2020-12-26 20:28:16 +01:00
|
|
|
.. image:: res/CalcApp.png
|
|
|
|
|
:alt: Calculator running in the wasp-os simulator
|
|
|
|
|
:width: 179
|
|
|
|
|
|
2021-01-05 04:12:39 +01:00
|
|
|
.. image:: res/2048App.png
|
|
|
|
|
:alt: Let's play the 2048 game (in the wasp-os simulator)
|
|
|
|
|
:width: 179
|
|
|
|
|
|
2020-12-27 20:35:09 +01:00
|
|
|
.. image:: res/SnakeApp.png
|
2020-11-27 11:39:40 +01:00
|
|
|
:alt: Snake Game running in the wasp-os simulator
|
|
|
|
|
:width: 179
|
2020-12-31 17:18:13 +01:00
|
|
|
|
|
|
|
|
.. image:: res/TimerApp.png
|
|
|
|
|
:alt: Countdown timer application running in the wasp-os simulator
|
|
|
|
|
:width: 179
|
2021-03-05 20:43:06 +01:00
|
|
|
|
2021-03-31 01:10:24 +02:00
|
|
|
.. image:: res/WeatherApp.png
|
|
|
|
|
:alt: Weather application running in the wasp-os simulator
|
|
|
|
|
:width: 179
|
|
|
|
|
|
2021-12-31 19:16:12 +01:00
|
|
|
.. image:: res/WeekClkApp.png
|
|
|
|
|
:alt: Digital clock application, including the week day
|
|
|
|
|
:width: 179
|
|
|
|
|
|
2021-03-05 20:43:06 +01:00
|
|
|
.. image:: res/WordClkApp.png
|
|
|
|
|
:alt: Shows a time as words in the wasp-os simulator
|
|
|
|
|
:width: 179
|
2021-11-20 17:41:34 +01:00
|
|
|
|
2021-11-20 14:27:19 +01:00
|
|
|
.. image:: res/LevelApp.png
|
|
|
|
|
:alt: Shows a time as words in the wasp-os simulator
|
|
|
|
|
:width: 179
|
2022-05-29 18:35:05 +02:00
|
|
|
|
2021-11-20 17:41:34 +01:00
|
|
|
.. image:: res/BeaconApp.png
|
|
|
|
|
:alt: Flash the relatively powerful HRS LED repeatedly
|
2022-05-29 18:35:05 +02:00
|
|
|
:width: 179
|
