Hypnos

This is a Zephyr-based firmware for the PineTime and P8 smartwatches.

Hypnos, son of Night and Darkness
He is said to be a calm and gentle god, as he helps humans in need and, due to their sleep, owns half of their lives.¹

Features and roadmap

• 100 % Free Software
• Battery life: about one week
• Battery status: get state of charge and whether it's charging
• Clock: accurately increment current time
• Time and date synchronization with Bluetooth-connected device
• Touch sensor: tap to light up the display, swipe to display version information
• LVGL graphics: show time, date, battery and Bluetooth status
• Support for the PineTime bootloader
• Over-the-air firmware updates (SMP over BLE)
• Optional debug output via JLink RTT
• Show notifications from Bluetooth-connected device
• Set alarm
• Wrist vibration
• Quick glance via lift-to-wake

Developer getting started guide

This document assumes that you run a GNU/Linux or Mac operating system.

Set up the development environment

Follow Zephyr's Getting Started Guide up to step 3.2 "Get the Zephyr source code". Here you should run the commands below instead of the ones in the guide:

$ git clone https://github.com/endian-albin/pinetime-hypnos
$ cd pinetime-hypnos
$ west init -l app/
$ west update

Then complete the remaining steps under section 3 and 4. Finally, run make tools.

Build and flash Hypnos

Run make to build everything with the defaults or make help to view all the options and targets.

Then connect your in-circuit programmer and run make flash. To install without a programmer, see Firmware updates below.

Build and flash the bootloader

To install or upgrade the bootloader, follow Lup Yuen's build instructions or fetch the prebuilt binary.

Then flash it to the beginning of the internal memory:

pyocd flash -e sector -t nrf52 bootloader-image.bin

Firmware updates

SMP over Bluetooth LE

Hypnos supports firmware image management over the Simple Management Protocol.

To make use of this feature, get the mcumgr command-line tool. Then run the commands below to list, upload, test and confirm firmware images over BLE:

# mcumgr --conntype="ble" --connstring ctlr_name=hci0,peer_name='Hypnos' image list
# mcumgr --conntype="ble" --connstring ctlr_name=hci0,peer_name='Hypnos' image upload hypnos-mcuboot-app-img.bin
# mcumgr --conntype="ble" --connstring ctlr_name=hci0,peer_name='Hypnos' image test <hash of slot-1 image>
# mcumgr --conntype="ble" --connstring ctlr_name=hci0,peer_name='Hypnos' reset
# mcumgr --conntype="ble" --connstring ctlr_name=hci0,peer_name='Hypnos' image confirm

If you are unhappy with the new image, simply run the reset command again instead of image confirm to revert to the old one. If the image has already been confirmed but you still want to revert, simply run the commands above but skip the upload step or perform a manual rollback (see below). See this document for more information.

DFU over Bluetooth LE

To install Hypnos over the air from InfiniTime, run make dfu to create a (Nordic) DFU package and upload it using ota-dfu.py or nRF Connect.

Manual rollback

Version 5 of Lup Yuen's bootloader allows you to revert to the old firmware image by holding the button during boot.

Copying

This software may be used under the terms of the Apache License 2.0, unless explicitly stated otherwise.

The documentation contained in this README and on the wiki are under the CC BY-SA 4.0 license.