1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
|
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 <https://wasp-os.readthedocs.io>`_
which includes a detailed `Application Writer's Guide
<https://wasp-os.readthedocs.io/en/latest/appguide.html>`_ 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 <https://wasp-os.readthedocs.io/en/latest/install.html>`_
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:
.. code-block:: python
^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:
.. code-block:: sh
./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 <https://github.com/daniel-thompson/wasp-os>`_ 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 <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!
Videos
------
.. list-table::
* - .. 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
: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>`_
* - .. figure:: https://img.youtube.com/vi/YktiGUSRJB4/0.jpg
: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>`_
- .. figure:: https://img.youtube.com/vi/tuk9Nmr3Jo8/0.jpg
: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>`_
* - .. figure:: https://img.youtube.com/vi/kf1VHj587Mc/0.jpg
: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>`_
-
Screenshots
-----------
(An older version of) the digital clock application running on a Pine64
PineTime:
.. image:: res/clock_app.jpg
:alt: wasp-os digital clock app running on PineTime
:width: 233
Screenshots of the built in applications running on the wasp-os
simulator:
.. 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
.. image:: res/DemoApp.png
:alt: Simple always-on demo for showing off wasp-os at conferences and shows
:width: 179
.. image:: res/DisaBLEApp.png
:alt: Small application for disabling bluetooth to save power and enhance security
:width: 179
.. image:: res/HeartApp.png
:alt: Heart rate application running on the wasp-os simulator
:width: 179
.. image:: res/MorseApp.png
:alt: Morse translator/notepad application running on the wasp-os simulator
:width: 179
.. image:: res/SportsApp.png
:alt: Sports applications, a combined stopwatch and step counter
:width: 179
.. image:: res/StopclockApp.png
: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
.. image:: res/SoftwareApp.png
:alt: Software selection app running on the wasp-os simulator
:width: 179
wasp-os also contains a library of additional applications for you to choose.
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
.. image:: res/ChronoApp.png
:alt: Analogue clock application running in the wasp-os simulator
:width: 179
.. image:: res/DualApp.png
:alt: An other clock application running in the wasp-os simulator
:width: 179
.. image:: res/FiboApp.png
:alt: Fibonacci clock application running in the wasp-os simulator
:width: 179
.. image:: res/HaikuApp.png
:alt: Haiku application running in the wasp-os simulator
:width: 179
.. image:: res/LifeApp.png
:alt: Game of Life running in the wasp-os simulator
:width: 179
.. image:: res/AlarmApp.png
:alt: Alarm clock application running in the wasp-os simulator
:width: 179
.. image:: res/MusicApp.png
:alt: Music Player running in the wasp-os simulator
:width: 179
.. image:: res/CalcApp.png
:alt: Calculator running in the wasp-os simulator
:width: 179
.. image:: res/2048App.png
:alt: Let's play the 2048 game (in the wasp-os simulator)
:width: 179
.. image:: res/SnakeApp.png
:alt: Snake Game running in the wasp-os simulator
:width: 179
.. image:: res/TimerApp.png
:alt: Countdown timer application running in the wasp-os simulator
:width: 179
.. image:: res/WeatherApp.png
:alt: Weather application running in the wasp-os simulator
:width: 179
.. image:: res/WeekClkApp.png
:alt: Digital clock application, including the week day
:width: 179
.. image:: res/WordClkApp.png
:alt: Shows a time as words in the wasp-os simulator
:width: 179
|