1
0
Fork 0
jebbatime/README.md

119 lines
2.1 KiB
Markdown
Raw Normal View History

2021-06-12 11:53:48 -06:00
# jebbatime
2021-06-12 17:48:41 -06:00
<img src="res/jebbatime.png"/>
2021-06-12 11:53:48 -06:00
jebbatime is an operating system and application suite for the PineTime watch.
2021-06-12 12:51:15 -06:00
# 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 \
2021-06-12 13:11:44 -06:00
python3-cairo \
2021-06-12 13:32:54 -06:00
python3-ecdsa \
2021-06-12 13:11:44 -06:00
pkg-config \
2021-06-12 14:51:08 -06:00
bluez \
2021-06-12 15:03:33 -06:00
ntpdate \
2021-06-12 15:14:59 -06:00
sudo \
2021-06-12 14:51:55 -06:00
gcc-arm-none-eabi ccache \
2021-06-12 12:51:15 -06:00
fonts-lobstertwo
```
### ccache
Add to `~/.bashrc`:
```
PATH=/usr/lib/ccache:$PATH
```
2021-06-12 13:11:44 -06:00
### Source
2021-06-12 12:51:15 -06:00
Source sauce.
```
git clone git@spacecruft.org:jebbatime/jebbatime.git
# Or
git clone https://spacecruft.org/jebbatime/jebbatime.git
2021-06-12 13:11:44 -06:00
cd jebbatime
```
### Python
Install Python dependencies with `pip`.
```
pip3 install --user -r wasp/requirements.txt
pip3 install --user freetype-py
2021-06-12 12:51:15 -06:00
```
2021-06-12 13:21:25 -06:00
### 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
2021-06-12 13:36:33 -06:00
```
### 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/
2021-06-12 13:21:25 -06:00
```
2021-06-12 14:08:19 -06:00
# Setup
This assumes two devices, the sealed watch and the open developers watch.
```
mkdir ~/.config/
2021-06-12 14:09:49 -06:00
cp -p config/jebbatime.conf ~/.config/
2021-06-12 14:08:19 -06:00
# Adjust as needed.
vim ~/.config/jebbatime.conf
```
2021-06-12 15:19:17 -06:00
# Use
Basic scripts are in `scripts/`.
2021-06-12 11:53:48 -06:00
# Upstream
## Fork
jebbatime is a lesser fork of Daniel Thompson's Wasp-os.
## Source
Upstream source code:
* https://github.com/daniel-thompson/wasp-os
2021-06-12 17:13:05 -06:00
## Non-free bits
Appears to include non-free "5-Clause Nordic License". `:|`
* https://wasp-os.readthedocs.io/en/latest/five-clause-nordic.html