|
4 | 4 |
|
5 | 5 | ## Basic Installation |
6 | 6 |
|
7 | | -### Pre-requisites |
| 7 | +### Requirements |
8 | 8 |
|
9 | | -``` |
10 | | -sudo apt install libegl-dev libopengl-dev libxkbcommon-dev libharfbuzz-dev libmd4c-dev libpulse0 libfuse2 |
11 | | -``` |
| 9 | +Tested and developed against Raspberry Pi OS 13 (trixie). Should work on any 64 bit Raspberry Pi running trixie or later. |
12 | 10 |
|
13 | | -### Install |
| 11 | +### Installation |
14 | 12 |
|
| 13 | +Download the latest release deb file from [Releases](https://github.com/RobCo-Engineering/PIP-OS/releases) and install via apt, for example: |
15 | 14 | ```sh |
16 | | -wget https://gitlab.com/robco-industries/pip-os/-/package_files/166831732/download -O PIP-OS-v7.1.0.45-aarch64.AppImage |
17 | | -chmod +x PIP-OS-v7.1.0.45-aarch64.AppImage |
18 | | -./PIP-OS-v7.1.0.45-aarch64.AppImage |
| 15 | +sudo apt install ./pip-os_7.1.1_arm64.deb |
19 | 16 | ``` |
20 | 17 |
|
21 | | -TODO: Add note about platforms, wayland etc. |
| 18 | +The app can be configured to run at startup or run as a one off: |
| 19 | +```sh |
| 20 | +# Enable at startup (optional) |
| 21 | +systemctl --user enable pip-os.service |
| 22 | + |
| 23 | +# Start PIP-OS |
| 24 | +systemctl --user start pip-os.service |
| 25 | +``` |
22 | 26 |
|
23 | 27 | ## Configuration |
24 | 28 |
|
@@ -190,15 +194,24 @@ If you don't have a valid GPS source, you can also use static data, go to https: |
190 | 194 | positionSource=file:///path/to/location_data.txt |
191 | 195 | ``` |
192 | 196 |
|
193 | | -## Debugging Startup Issues |
194 | | - |
195 | 197 | ## Building from source |
196 | 198 |
|
197 | | -The most straightforward way to simply _build_ this code is using a Docker container that already has all of the Qt install inside it. |
| 199 | +To build from source on Debian 13, first install some of the pre-requisites: |
| 200 | +```sh |
| 201 | +sudo apt-get install git cmake g++ build-essential libgl1-mesa-dev qt6-base-dev qt6-base-dev-tools qt6-quick3d-dev qt6-positioning-dev qt6-location-dev qt6-multimedia-dev qt6-graphs-dev qt6-declarative-private-dev |
| 202 | +``` |
198 | 203 |
|
199 | | -There are some helper scripts inside `hack/`, you _should_ be able to run `./hack/cross_compile.sh` to build an aarch64 AppImage. |
| 204 | +Then pull this repo and build as so: |
| 205 | +```sh |
| 206 | +git clone https://github.com/RobCo-Engineering/PIP-OS.git |
| 207 | +cd PIP-OS |
| 208 | +mkdir build |
| 209 | +cd build |
| 210 | +/usr/lib/qt6/bin/qt-cmake .. -DCMAKE_BUILD_TYPE=Release |
| 211 | +make |
| 212 | +``` |
200 | 213 |
|
201 | | -If you're running from a non ARM linux box, you need to first make sure you're running Docker with QEMU enabled as per https://docs.docker.com/build/building/multi-platform/#qemu |
| 214 | +Built app should be in `build/usr/bin/ |
202 | 215 |
|
203 | 216 | ## Extracting Vault Boy Sprites |
204 | 217 |
|
|
0 commit comments