Installation

Installation#

Build#

Building myGPIOd is straight forward.

Dependencies#

  • C build environment

  • cmake >= 3.13

  • libgpiod >= 2.0.0

  • libmicrohttpd

  • Optional: - libcurl - libmpdclient2 - lua >= 5.3.0

Build myGPIOd#

This builds and installs the mygpiod daemon, mygpioc command line tool, the shared library libmygpio, the associated header files for development and the documentation.

  1. Get myGPIOd tarball from GitHub

  2. Extract myGPIOd tarball and change path to this directory

  3. Run cmake: cmake -B build -DCMAKE_INSTALL_PREFIX:PATH=/usr -DCMAKE_BUILD_TYPE=Release .

  4. Build: cmake --build build

  5. Install (as root): cmake --install build

Run#

myGPIOd needs read-write access to the gpio chip device (e. g. /dev/gpiochip0).

/usr/bin/mygpiod [/etc/mygpiod.conf]

The cmake install script creates a startup script for systemd, openrc or sysVinit.

Systemd#

You must enable and start the service manually. Use systemctl enable mygpiod to enable myGPIOd at startup and systemctl start mygpiod to start myGPIOd now.

myGPIOd logs to STDERR, you can see the live logs with journalctl -fu mygpiod.

The default myGPIOd service unit uses the DynamicUser= directive, therefore no static mygpiod user is created. If you want to change the group membership of this dynamic user, you must add an override.

Example: add the mygpiod user to the gpio group

mkdir /etc/systemd/system/mygpiod.service.d
echo -e '[Service]\nSupplementaryGroups=gpio' > /etc/systemd/system/mygpiod.service.d/gpio-group.conf

Docker#

Example docker compose file to start myGPIOd.

services:
  mygpiod:
    image: ghcr.io/jcorporation/mygpiod/mygpiod
    container_name: mygpiod
    restart: unless-stopped
    environment:
      TZ: Europe/Berlin
      MPD_HOST: 192.168.1.1
    user: 1000:1000
    group_add:
      - gpio
      - video
    devices:
      - /dev/gpiochip0:/dev/gpiochip0
      - /dev/vcio:/dev/vcio
    volumes:
      - /etc/mygpiod.conf:/etc/mygpiod.conf
      - /etc/mygpiod.d/:/etc/mygpiod.d/

To run mygpioc in the already running myGPIOd container:

docker exec -it mygpiod mygpioc gpiolist
Contents