Userspace companion to linux-perpetua. It holds the services and per-device configuration that let Denial drive phone and tablet hardware. The kernel tree stays kernel-only; whatever a device needs in userspace lives here.
Named after Future Gadget #8 from Steins;Gate, a microwave wired to a phone.
| Path | Contents |
|---|---|
devices/<codename>/ |
Everything specific to one device. The codename is the board name in the kernel device tree. |
devices/<codename>/device.toml |
Hardware facts: model, SoC, DTB, display, touch, haptics. |
devices/<codename>/rootfs/ |
Files installed on that device, at the same path. rootfs/usr/lib/udev/rules.d/x.rules installs to /usr/lib/udev/rules.d/x.rules. |
devices/<codename>/boot/ |
Packs a linux-perpetua release into the device's boot images, and the init_boot sources. |
devices/<codename>/packaging/ |
Pacman packages for the device, where it has them. |
tools/ |
Host scripts for any phone: phone-reboot, phone-shot, phone-notifications, phone-backup (Android storage to and from this computer), phone-install (build recipes here and install them, no publish), phone-setup-again (install builds, then back to first-start setup without writing the image). Each takes the phone's SSH host. |
image/ |
The device image builder: one userdata image, per-device boot images. |
REMINDERS.md |
Open work, until it is done. |
services/<capability>/<name>/ |
Daemons and drivers for one hardware capability: haptics, fingerprint, clock. Each is a self-contained project. |
Programs go under services/; the configuration that ties them to one device
goes under devices/. A device folder holds only what is different on that
device: hardware facts, firmware, boot images, the kernel package. A tool that
works on every phone goes in tools/. There are no device build tools:
Denial is just Denial, and the apps and Droidloom build the same way for every
phone. Example: dmail drives any Qualcomm modem, so it
lives in services/modem/dmail/. The 12R's data endpoints belong to that
phone, so they live in its boot image's tail,
devices/aston/boot/tail/dmail/device.toml.
Apps and their libraries are not part of Phonewave; they live in denial-apps.
| Codename | Device | SoC |
|---|---|---|
aston |
OnePlus 12R | SM8550 |
roadstr |
Motorola Edge 70 | Eliza |
iceland |
OnePlus Pad 4 | Kaanapali (SM8850) |
| Capability | Name | Purpose | Devices |
|---|---|---|---|
| haptics | hapticd |
D-Bus service for evdev force-feedback and sysfs vibrators | any |
| clock | rtc-offset |
Keeps the system clock across reboots when the RTC cannot be set | any |
| memory | zram-swap |
Compressed swap in RAM, sized from the installed memory | any |
| radio | radio-addr |
Wi-Fi and Bluetooth addresses from the SoC serial, for bootloaders that pass none | aston, nx809j, pudding |
| wallpaper | wallpaper-depth |
Cuts the wallpaper's subject out so the lock screen clock sits behind it | any with Vulkan |
| fingerprint | jiiov |
JIIOV JV0307 optical fingerprint | roadstr |
| fingerprint | uff |
OPLUS UFF (Goodix G7s) optical fingerprint | aston |
| modem | dmail |
Modem service over QMI: SIM, calls, messages and mobile data, in place of ModemManager | aston |
| modem | qmi-tools |
Small QMI clients for cellular bring-up | aston |
| audio | callaudio |
Puts the sound card on its voice call profile while the modem has a call; call volume and mute | any with a Voice Call UCM verb |
| audio | voicegen |
Builds a voice call profile for the kernel from the stock ACDB, on the workstation | Qualcomm AudioReach |
| screen | screen-record |
Records the screen through Denial, scaled on the GPU, to H.264 video | any running Denial |
| power | battery-stats |
Books where the battery goes: energy and hardware use per screen state, hour and build | any with a battery |
To install Denial Mobile on a phone, follow the manual's Install on a phone.
Device files:
sudo make install-device DEVICE=astonThis installs the services every device runs (zram-swap), then the
device's rootfs/, whose links enable them. DESTDIR installs into a mounted
root filesystem instead. A new device gets the same: its
rootfs/usr/lib/systemd/system/swap.target.wants/zram-swap.service links to
../zram-swap.service.
Each other service builds from its own directory; see each README.
Stock firmware, partition backups, firmware blobs and the boot images a
release is packed on are not public. The scripts read them from
$PHONEWAVE_VAULT/<codename> (default /mnt/development/denial-os/device-vault).
hapticd is a git subtree; pull updates with
--prefix=services/haptics/hapticd.
MIT. See LICENSE. Most of the fingerprint drivers keep their upstream licenses (LGPL-2.1-or-later or GPL-2.0-only); see services/fingerprint.
