Skip to content
denialwmPublic

About

Device services interfacing mobile devices kernel and applications

Resources

Stars

4 stars

Watchers

0 watching

Forks

Latest commit

 

History

307 Commits

Folders and files

Repository files navigation

Phonewave

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.

Synthia, chin in her hands, watching a banana turn into a green gel banana
Phonewave with Synthia.

Layout

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.

Devices

Codename Device SoC
aston OnePlus 12R SM8550
roadstr Motorola Edge 70 Eliza
iceland OnePlus Pad 4 Kaanapali (SM8850)

Services

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

Install

To install Denial Mobile on a phone, follow the manual's Install on a phone.

Device files:

sudo make install-device DEVICE=aston

This 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.

License

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.

About

Device services interfacing mobile devices kernel and applications

Resources

Stars

4 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages