117 lines
4.2 KiB
Markdown
117 lines
4.2 KiB
Markdown
Watch Application System in Python
|
|
==================================
|
|
|
|
Introduction
|
|
------------
|
|
|
|
Currently in its infancy wasp-os provides only a little more than a simple
|
|
digital clock application for [PineTime](https://www.pine64.org/pinetime/)
|
|
together with access to the MicroPython REPL for interactive testing and
|
|
tweaking. However 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 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
|
|
------
|
|
|
|
[](https://www.youtube.com/watch?v=YktiGUSRJB4)\
|
|
[An M2 pre-release running on Pine64 PineTime](https://www.youtube.com/watch?v=YktiGUSRJB4)
|
|
|
|
[](https://www.youtube.com/watch?v=tuk9Nmr3Jo8)\
|
|
[How to develop wasp-os python applications on a Pine64 PineTime](https://www.youtube.com/watch?v=tuk9Nmr3Jo8)
|
|
|
|
[](https://www.youtube.com/watch?v=kf1VHj587Mc)\
|
|
[Developing for Pine64 PineTime using wasp-os and MicroPython](https://www.youtube.com/watch?v=kf1VHj587Mc)
|
|
|
|
Building from a git clone
|
|
-------------------------
|
|
|
|
~~~
|
|
pip3 install --user click serial pyserial
|
|
make submodules
|
|
make softdevice
|
|
make -j `nproc` BOARD=pinetime all
|
|
~~~
|
|
|
|
Note: *You will need a toolchain for the Arm Cortex-M4. wasp-os is developed and tested using the [GNU-RM toolchain](https://developer.arm.com/tools-and-software/open-source-software/developer-tools/gnu-toolchain/gnu-rm) (9-2019-q4) from Arm.*
|
|
|
|
Note #2: *There are known problems with toolchains older than gcc-7.3 due to problems with link-time-optimization (which is enabled by default)*
|
|
|
|
Installing
|
|
----------
|
|
|
|
Note: *If you have a new PineTime then it will have been delivered with
|
|
flash protection enabled. You must disable the flash protection before
|
|
trying to program it.*
|
|
|
|
Use an SWD programmer to install `bootloader.hex` to the PineTime. This
|
|
file is an Intel HEX file containing both the bootloader and the Nordic
|
|
SoftDevice. Be careful to disconnect cleanly from the debug software
|
|
since just pulling out the SWD cable will mean the nRF52 will still
|
|
believe it is being debugged (and won't properly enter deep sleep
|
|
modes).
|
|
|
|
To install using Android device:
|
|
|
|
* Copy `micropython.zip` to your Android device and download nRF Connect
|
|
for Android if you do not already have it.
|
|
* In nRF Connect, choose settings and reduce the DFU packet count from
|
|
10 to 4.
|
|
* Connect to PineDFU using nRFConnect, click the DFU button and send
|
|
`micropython.zip` to the device.
|
|
|
|
To install using Linux and ota-dfu:
|
|
|
|
* Look up the MAC address for your watch (try: `sudo hcitool lescan`).
|
|
* Use ota-dfu to upload `micropython.zip` to the device. For example:
|
|
`tools/ota-dfu/dfu.py -z micropython.zip -a A0:B1:C2:D3:E3:F5 --legacy`
|
|
|
|
At the end of this 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 side button to wake it again.
|
|
|
|
At this point you will also be able to use the Nordic UART Service to
|
|
access the MicroPython REPL, although currently you must send ^C to
|
|
interrupt the program that updates the watch display.
|
|
|
|
Just for fun try:
|
|
|
|
~~~
|
|
^C
|
|
import demo
|
|
demo.run()
|
|
# After watching the demo for a bit...
|
|
^C
|
|
wasp.app.draw(watch)
|
|
wasp.system.run()
|
|
~~~
|
|
|
|
To set the time and restart the main application:
|
|
|
|
~~~
|
|
^C
|
|
watch.rtc.set_localtime((yyyy, mm, dd, HH, MM, SS))
|
|
wasp.system.run()
|
|
~~~
|
|
|
|
Or 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 [TODO list](TODO.md) for current status.
|
|
|
|
Screenshots
|
|
-----------
|
|
|
|
|
|
|