My personal fork of wasp-os, the MicroPython-based OS for smartwatches
Go to file
Daniel Thompson 66e8d3e58a docs: install: Move Building from source into the install guide
Direct links to the install guide mean some people are reading the docs
but never see the main docs index and, as a result, don't find the
instructions on how to build from source. Let's fix that!

Fixes: #49
Signed-off-by: Daniel Thompson <daniel@redfelineninja.org.uk>
2020-07-31 16:47:08 +01:00
bootloader@89ba9a874f boards: p8: Full support for Colmi P8 2020-07-27 22:15:42 +01:00
docs docs: install: Move Building from source into the install guide 2020-07-31 16:47:08 +01:00
micropython@c7cf47a368 boards: p8: Full support for Colmi P8 2020-07-27 22:15:42 +01:00
reloader@b4512e5d92 boards: p8: Full support for Colmi P8 2020-07-27 22:15:42 +01:00
res res: Add underlying png images for recently added icons. 2020-07-27 22:17:00 +01:00
tools wasptool: Add support for selecting devices by name and MAC address 2020-07-26 21:04:30 +01:00
wasp boards: p8: Full support for Colmi P8 2020-07-27 22:15:42 +01:00
.gitignore dsd6, nitrogen: Make them build again 2020-06-17 21:35:19 +01:00
.gitmodules wasp: apps: Step counter application 2020-06-09 21:31:55 +01: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 Makefile: Allow installation via DaFlasher 2020-07-26 21:03:30 +01:00
README.rst docs: install: Move Building from source into the install guide 2020-07-31 16:47:08 +01:00
TODO.rst docs: install: Move Building from source into the install guide 2020-07-31 16:47:08 +01:00

README.rst

Watch Application System in Python
==================================

Introduction
------------

Although still in its infancy wasp-os provides many example applications
including a simple digital clock, a stopwatch, a step counter and a heart rate
monitor. All of these, together with access to the MicroPython REPL for
interactive tweaking and testing, are running on `PineTime
<https://www.pine64.org/pinetime/>`_.  It keeps time well and has enough power
saving functions implemented that it can survive for well over 72 hours between
charges so even at this early stage it is functional as a wearable timepiece.

Wasp-os 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
------

.. image:: 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: 320
   :height: 240

`Open source heart rate monitoring for Pine64 PineTime <https://www.youtube.com/watch?v=lIo2-djNR48>`_

.. image:: 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: 320
   :height: 240

`An M2 pre-release running on Pine64 PineTime <https://www.youtube.com/watch?v=YktiGUSRJB4>`_

.. image:: 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: 320
   :height: 240

`How to develop wasp-os python applications on a Pine64 PineTime <https://www.youtube.com/watch?v=tuk9Nmr3Jo8>`_

.. image:: 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: 320
   :height: 240

`Developing for Pine64 PineTime using wasp-os and MicroPython <https://www.youtube.com/watch?v=kf1VHj587Mc>`_

Documentation
-------------

Wasp-os is has `extensive documentation <https://wasp-os.readthedocs.io>`_
which includes a detailed `Applicaiton 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 onto the following
devices:

 * Pine64 PineTime (developer edition)
 * Colmi P8

The
`Installation Guide <https://wasp-os.readthedocs.io/en/latest/install.html>`_
contains detailed instructions on how to build and install wasp-os.

At the end of the install process your watch will show the time (03:00)
together with a date and 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 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.

Screenshots
-----------

.. image:: res/clock_app.jpg
   :alt: wasp-os digital clock app running on PineTime