# Install
[libjsonrpccpp](../libjsonrpccpp/README.md)
[libmraa](../libmraa/README.md)
[libupm](../libupm/README.md)
```sh
make xbuild
make xpackage
make xdeploy
```
```sh
make reinstall
```
# Structure of album directories
`music_directory/additional_directory/artist - year - album/00.m3u`
`music_directory` :
from /etc/mpd.conf
`additional_directory` :
to use weights in random selection of albums,
weights will be in music_directory/mps.weights
# [Client state diagram](README-0.md)
```mermaid
stateDiagram
direction LR
[*] --> Normal
Normal --> Normal: setup / ok / up / down / right
Normal --> Album: left
Album --> Normal: ok
Album --> Album: up / down
Album --> Artist: left
Artist --> Album: setup
Artist --> Artist: letter
```
# [Screensaver state diagram](README-0.md)
```mermaid
stateDiagram
direction LR
[*] --> Normal
Normal --> Menu: ok
Menu --> Normal: ok = cancel
Menu --> Normal: right = /usr/bin/rtc
Menu --> [*]: up = reboot / down = halt
Menu --> Date: left
Date --> Date: dir
Date --> Hour: ok
Hour --> Hour: dir
Hour --> Normal: ok
```
# [Main sequence diagram](README-0.md)
```mermaid
sequenceDiagram
Participant U as User
Participant C as Client
Participant S as Server
loop
U->>C: event "setup"
activate C
C->>+S: call "rand"
S-->>-C: album
deactivate C
end
Note over U,S: Less than 20 seconds
U->>C: event "ok"
activate C
C->>+S: call "ok"
S-->>-C: album
C->>+S: call "checksum"
S-->>-C: album
deactivate C
```
# Create chroot
```console
localhost> cd ../hosts/debian12
localhost> make up
localhost> vagrant ssh
vagrant1> mkdir ~/sbuild
vagrant1> DIST=stable
vagrant1> ARCH=armhf # nanopi-neo:armhf orange-pi-zero:arm64 rockpi-s:arm64
vagrant1> mmdebstrap --variant=buildd --architectures=$ARCH $DIST ~/sbuild/$DIST-$ARCH.tar.xz --include=cmake,debhelper,fakeroot,help2man,pkg-config,lintian,dose-distcheck,apt-utils,libargtable2-dev,libcurl4-openssl-dev,libjsoncpp-dev,libmicrohttpd-dev,libmpdclient-dev,liblirc-dev,swig,python3-dev
```
# Release
```console
vagrant1> sudo apt install libmpdclient-dev liblirc-dev
localhost> make BUILDER=sbuild rbuild
localhost> make BUILDER=sbuild rpackage
localhost> make BUILDER=sbuild rxpackage OPTS='-e ARCH=armhf'
```
<details>
<summary><s>Release with pbuilder</s></summary>
```console
localhost> cd ../hosts/debian12
localhost> vagrant ssh
vagrant1> cd ~/pbuilder/*_result
vagrant1> python3 -m http.server
vagrant2> sudo apt install libmpdclient-dev liblirc-dev
vagrant2> cd ~/pbuilder/*_result
vagrant2> pbuilder-dist bookworm armhf update --extrapackages 'libmpdclient-dev liblircclient-dev' --allow-untrusted --othermirror 'deb [allow-insecure=yes] http://localhost:8000/ ./'
localhost> sudo apt install libmpdclient-dev liblirc-dev
localhost> make BUILDER=pbuilder build
localhost> make BUILDER=pbuilder package
localhost> make BUILDER=pbuilder rbuild
localhost> make BUILDER=pbuilder rpackage
localhost> make BUILDER=pbuilder rxpackage OPTS='-e ARCH=armhf'
vagrant2> cp -av libmraa2_2.2.0-1_armhf.deb libupm-lcd2_2.0.0-1_armhf.deb libjsonrpccpp-client0_1.4.1-1.0_armhf.deb libjsonrpccpp-common0_1.4.1-1.0_armhf.deb libjsonrpccpp-server0_1.4.1-1.0_armhf.deb mps_1.0.0_armhf.deb /vagrant/.vagrant
localhost> user=$USER
localhost> host=pi
localhost> scp .vagrant/*.deb $user@$host:/tmp/
localhost> ssh $user@$host
remotepi> cd /tmp
remotepi> sudo apt reinstall ./*.deb
```
</details>
## Update sysroot for cross compilation
```console
vagrant2> cp -av *-dev_* /vagrant/.vagrant
localhost> user=$USER
localhost> host=pi
localhost> ssh $user@$host
remotepi> cd /run/user/1000
localhost> scp .vagrant/*-dev_* $user@$host:/run/user/1000/
remotepi> sudo apt reinstall ./*-dev_*
```
[update](../libjsonrpccpp/README.md#sysroot-installation)
# Divers
<details>
<summary>Test without arm</summary>
```console
terminal1> make build
terminal1> make server
terminal2> make client # KEY_SETUP, KEY_OK, ...
terminal3> make dir path=
terminal3> ./client.py
terminal3> ./client.py [method] # rand, ok, ...
terminal3> ./client.py quit
```
</details>
<details>
<summary>php usage</summary>
```console
terminal1> make tunnel
terminal2> make php
```
</details>
<details>
<summary>music_directory update</summary>
```sh
mpc update
rm mps.list
sudo systemctl restart mpserver
```
</details>
<details>
<summary>No apt list update</summary>
```sh
sudo mv /etc/apt/apt.conf.d/02-armbian-postupdate ~/
```
</details>
<details>
<summary>mpc usage for debug</summary>
```sh
mpc --host=/run/mpd.sock clear
mpc --host=/run/mpd.sock load 'music_directory/.../00.m3u'
mpc --host=/run/mpd.sock play
```
</details>
[gitlab](../hosts/gitlab/README.md)
# License CeCILL 2.1
Copyright Sébastien Beaugrand
This software is governed by the CeCILL license under French law and
abiding by the rules of distribution of free software. You can use,
modify and/or redistribute the software under the terms of the CeCILL
license as circulated by CEA, CNRS and INRIA at the following URL
"http://www.cecill.info".
As a counterpart to the access to the source code and rights to copy,
modify and redistribute granted by the license, users are provided only
with a limited warranty and the software's author, the holder of the
economic rights, and the successive licensors have only limited
liability.
In this respect, the user's attention is drawn to the risks associated
with loading, using, modifying and/or developing or reproducing the
software by the user in light of its specific status of free software,
that may mean that it is complicated to manipulate, and that also
therefore means that it is reserved for developers and experienced
professionals having in-depth computer knowledge. Users are therefore
encouraged to load and test the software's suitability as regards their
requirements in conditions enabling the security of their systems and/or
data to be ensured and, more generally, to use and operate it in the
same conditions as regards security.
The fact that you are presently reading this means that you have had
knowledge of the CeCILL license and that you accept its terms.