1
0
Fork 0
jebbatime/README.md

119 lines
2.1 KiB
Markdown

# jebbatime
<img src="res/jebbatime.png"/>
jebbatime is an operating system and application suite for the PineTime watch.
# Build
To build.
* Debian Buster (10).
## Dependenices
### Debian Packages
Install dependencies from Debian repos.
```
sudo apt install \
wget git build-essential libsdl2-2.0-0 python3-click python3-gi \
python3-numpy python3-pexpect python3-pil python3-pip python3-pydbus \
python3-serial unzip \
graphviz python3-recommonmark \
python3-sphinx \
python3-cairo \
python3-ecdsa \
pkg-config \
bluez \
ntpdate \
sudo \
gcc-arm-none-eabi ccache \
fonts-lobstertwo
```
### ccache
Add to `~/.bashrc`:
```
PATH=/usr/lib/ccache:$PATH
```
### Source
Source sauce.
```
git clone git@spacecruft.org:jebbatime/jebbatime.git
# Or
git clone https://spacecruft.org/jebbatime/jebbatime.git
cd jebbatime
```
### Python
Install Python dependencies with `pip`.
```
pip3 install --user -r wasp/requirements.txt
pip3 install --user freetype-py
```
### Submodules
Some submodules are mirrored.
```
make submodules
# XXX grabs some source zips
make softdevice
```
### Compile
Build thang.
```
# Blow out, rinse, repeat. Should take less than a minute or so.
make mrproper
make clean BOARD=pinetime
make submodules
make all BOARD=pinetime
```
### Fonts
HOWTO add font.
```
cd tools/micropython-font-to-py
./font_to_py.py \
/usr/share/fonts/opentype/lobstertwo/LobsterTwo-Bold.otf \
--xmap 64 \
--errchar 58 \
--smallest 48 \
--largest 58 \
lobstertwobold64.py
mv lobstertwobold64.py ../../wasp/fonts/
```
# Setup
This assumes two devices, the sealed watch and the open developers watch.
```
mkdir ~/.config/
cp -p config/jebbatime.conf ~/.config/
# Adjust as needed.
vim ~/.config/jebbatime.conf
```
# Use
Basic scripts are in `scripts/`.
# Upstream
## Fork
jebbatime is a lesser fork of Daniel Thompson's Wasp-os.
## Source
Upstream source code:
* https://github.com/daniel-thompson/wasp-os
## Non-free bits
Appears to include non-free "5-Clause Nordic License". `:|`
* https://wasp-os.readthedocs.io/en/latest/five-clause-nordic.html