Merge pull request #8 from macmpi/dev

add systemd service (beta)

Author: macmpi

README.md

@@ -12,13 +12,14 @@ It is **a shell script** to run on device in order to enable features, rather th
 - mass-storage
 
 ## Benefits:
+- simple: one single command/service to run (no kernel parameters-list & drivers fiddling)
 - Interoperates with most host OS computers (Linux/macOS/Windows) without additional host-side drivers or configuration required.
 - Supports any linux device with OTG-peripheral capability (including Raspberry Pis).
 - Performs initial OTG ports sanity-checks and returns diagnostics if not properly set.
 
 ## Setup procedure:
 Make sure `dwc2` (or `dwc3`) driver is previously loaded on capable device, and configuration is set to **OTG peripheral** mode: this may be driven by hardware (including cable) and/or software.\
-(on supporting Pi devices, just add `dtoverlay=dwc2,dr_mode=peripheral` in `config.txt` to force both by software)
+(on supporting Pi devices[^2], just add `dtoverlay=dwc2,dr_mode=peripheral` in `config.txt` to force both by software)
 
 Then connect device to host via USB cable, and run `xg_multi` on device as follows:
 ```
@@ -37,7 +38,9 @@ Options: -D|--Device <MAC address>  Specify MAC address for device
 ```
 Main execution steps are logged: `cat /var/log/messages | grep xg_multi`.
 
-OpenRC files are available to run `xg_multi` as a boot service; a complete Alpine Linux [package](https://pkgs.alpinelinux.org/packages?name=xg_multi&branch=edge&repo=&arch=&origin=&flagged=&maintainer=) is also available (check [wiki](https://github.com/macmpi/xg_multi/wiki/Install) for details).
+Services files are provided to run `xg_multi` as a boot service; a complete Alpine Linux [package](https://pkgs.alpinelinux.org/packages?name=xg_multi&branch=edge&repo=&arch=&origin=&flagged=&maintainer=) is also available (check [wiki](https://github.com/macmpi/xg_multi/wiki/Install) for details).
+
+[![Packaging status](https://repology.org/badge/vertical-allrepos/xg-multi.svg)](https://repology.org/project/xg-multi/versions)
 
 *Note:*
 - application-specific ports setup (i.e. serial options, console bring-up, networking configuration, ...) are not in the scope of this project: user shall take care of this after gadget ports are created.\
@@ -47,9 +50,11 @@ OpenRC files are available to run `xg_multi` as a boot service; a complete Alpin
   cat /etc/udev/rules.d/99-ttyacms-gadget.rules
   ATTRS{idVendor}=="0x1d6b" ATTRS{idProduct}=="0x0104", ENV{ID_MM_DEVICE_IGNORE}="1"
 ```
-- `xg_multi` is intended to run on `ash` shell within `busybox`. It may work within other environments (`bash`,...), but has not been tested (yet).
+- `xg_multi` is initially intended to run on `ash` shell within `busybox`, and works within other environments.
 
 ## Credits
 Kudos for info & snippets from @geekman, @Leo-PL and many others to understand/work-around various MS-Windows particularites...
 
 [^1]: Windows does NOT support dual configurations (ECM/RNDIS) with composite gadget.
+
+[^2]: OTG capable Pi devices include Zero serie/A/A+/3A+/4B/400/5/500/Compute-Modules

xg_multi.confd renamed to services/openrc/xg_multi.confd

@@ -0,0 +1,4 @@
+# check available options at https://github.com/macmpi/xg_multi
+
+XG_MULTI_OPTS=""
+

xg_multi.initd renamed to services/openrc/xg_multi.initd

@@ -0,0 +1,21 @@
+# SPDX-FileCopyrightText: Copyright 2025, macmpi
+# SPDX-License-Identifier: MIT
+
+# This systemd service manages xg_multi usb-gadget setup
+
+[Unit]
+Description=Extended Multifunction Composite USB-gadget
+Requires=sys-kernel-config.mount
+After=sysinit.target sys-kernel-config.mount local-fs.target syslog.service
+Before=NetworkManager.service [email protected]
+
+[Service]
+EnvironmentFile=/etc/default/xg_multi
+Type=oneshot
+RemainAfterExit=yes
+ExecStart=/usr/bin/xg_multi $XG_MULTI_OPTS
+ExecStop=/usr/bin/xg_multi -r
+
+[Install]
+WantedBy=multi-user.target
+