Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions device/cheetah/MODEM-CLIENT.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,7 +61,8 @@ Units (`systemd/`), none enabled by the package:
Config: `/etc/omamobile/modem-sit.conf` (`[network] apn` is required; `ims`,
`ims_apn`, `ims_required` (default no: an IMS failure keeps data, 0.3.2),
`nr`, timeouts including `ims_timeout`; `[control] group`; `[audio] card`
(default `none` since 0.3.3: calls route no audio until M5),
(built-in default `none`; from 0.3.30 a device package's `[audio]` defaults in
`/usr/lib/omamobile/modem-sit.conf.d/*.conf` come first and `/etc` wins over them),
`mic_boost_db`).

Tests: `packages/omamobile-modem-sit/test/all` (about 10 s): 53 unit tests
Expand Down Expand Up @@ -138,7 +139,7 @@ registration indication), unless `ims_required = yes`.

| Gap | Effect |
|---|---|
| Call audio | Off by default (`[audio] card = none`, 0.3.3): calls connect silent. TDM 0 feeds both amplifiers and the top one is the earpiece; until an earpiece mode exists (TELEPHONY-APPS-PLAN T4, MODEM-PLAN M5) a configured card is refused unless speaker protection runs at stage media or c8, the top amplifier is at analog 6 or less (AUDIO-PLAN section 4) and both are within the media stage |
| Call audio | On by default on the Pixel 7 Pro from `omamobile-modem-sit` 0.3.30 with `omamobile-device-cheetah` 0.1.44 (its `/usr/lib/omamobile/modem-sit.conf.d/50-cheetah.conf` sets `card = auto`), each call in the protection service's earpiece mode and refused without it (the call goes on silent); `none` on phones whose device package sets nothing (from 0.3.3 to 0.3.29 the default was `none` everywhere) |
| Speakerphone | Not routed; calls use the stock voice path (EP5 to TDM 0) |
| Call waiting, conference, emergency and short codes, MMS download | Refused or not implemented (emergency numbers are refused by the dialer check: **this phone cannot call emergency services under Linux**) |
| Signal strength | Reported as 0 |
Expand Down
3 changes: 2 additions & 1 deletion device/cheetah/MODEM-PLAN.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,7 +8,8 @@ both ways through Phone and Messages (omatel-agent through
in stock's order (IMS first on CID 2, the internet on CID 3; #384) and no
carrier manifest, the APNs and the bearer order chosen from the SIM
(`omamobile-modem-sit` 0.3.29, #373), the earpiece at every speaker stage
(`omamobile-audio` 0.5.13, #402), and `omamobile-modem-boot.target` on by
(`omamobile-audio` 0.5.13, #402) and on by default on a fresh install
(`omamobile-modem-sit` 0.3.30, `omamobile-device-cheetah` 0.1.44), and `omamobile-modem-boot.target` on by
default from `omamobile-device-cheetah` 0.1.43 (M4.6b, B6-B9b passed,
#398). Kernel `7.3.0-rc6-omamobile-g2219cc6cda77`, the release kernel.
Open: suspend with the modem up (section 6.3; the stack holds a sleep
Expand Down
5 changes: 4 additions & 1 deletion device/cheetah/NOTES.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,10 @@ the same Verizon-network SIM as the entry below. The runbook:
read the SIM once, chose Verizon's values from its overrides (APN
VZWINTERNET, attach none, IMS first on CID 2, the internet on CID 3,
profiles 0/2/3/4) and registered IMS and data, with nothing typed into
`modem-sit.conf`.
`modem-sit.conf`. Call audio ran on one hand edit there, `[audio] card =
auto`: a fresh install had `card = none` (calls connect silent) until
`omamobile-modem-sit` 0.3.30 with `omamobile-device-cheetah` 0.1.44, whose
defaults file sets `auto` on this phone.
- **The earpiece at the loud stage** [V]: stage `c9` with the boost converter
on (657/6 through ASP, the bottom amplifier muted,
`omamobile-earpiece@on.service`) was clean by ear on a VoLTE call, so
Expand Down
2 changes: 1 addition & 1 deletion docs/ROADMAP.md
Original file line number Diff line number Diff line change
Expand Up @@ -87,7 +87,7 @@ M2.5, M3.1, M3.3-B, M3.4 CP ONLINE, M4.1 SIT IPC and clean reboots (passed) ─>
| IMS (VoLTE) registration | Part of M4.2's start-up; its values are proven on one network only (a T-Mobile-network MVNO). Since 0.3.2 a failure keeps data | The SIM test; another network may need its own IMS values |
| Front end | Done offline: `omamobile-mmd` serves ModemManager's API and passed on the phone without a SIM (T1, 2026-10-14) | T2: GNOME Calls, Chatty, omaphone and omamessages against the real modem (runbook S11) |
| Calls and messages UI | omatel (Phone, Messages, their agent) and the shell's call card and lock-screen calls are built and tested offline | After T2; MMS is T3 |
| M5: calls with audio | 14-25 days (TELEPHONY-APPS-PLAN T4): the earpiece mode under speaker protection, a Voice Call UCM verb, speakerphone, Bluetooth | Design only; until then calls connect silent (`[audio] card = none`) |
| M5: calls with audio | 14-25 days (TELEPHONY-APPS-PLAN T4): the earpiece mode under speaker protection, a Voice Call UCM verb, speakerphone, Bluetooth | The earpiece is done on the Pixel 7 Pro and on by default (#402, `omamobile-modem-sit` 0.3.30 with `omamobile-device-cheetah` 0.1.44); speakerphone and Bluetooth are open |
| M6: suspend with the modem online | after S8 and M4 | Design only |

The modem's NV is never written from Linux: the chroot works on checksum-verified RAM copies.
Expand Down
2 changes: 1 addition & 1 deletion docs/release-notes/2026.11.03.md
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ From [docs/DEVICES.md](../DEVICES.md) on the release day:

## Known issues

- **Calls, texts and mobile data work on the tested network.** Tested on the reference phone with one Verizon-network SIM (Tracfone): VoLTE calls both ways, texts over IMS, and mobile data as a fallback route behind Wi-Fi ([DEVICES](../DEVICES.md)). Other networks are untested. The SIM's APNs and bearer order come from its carrier, read once from the SIM at boot ([#373](https://github.com/derekross/omarchy-mobile/pull/373)): a Verizon-network SIM is the one proven end to end; other carriers take the carrier database's APNs, and the Mobile network page under Setup shows and corrects them. Call audio through the earpiece works at every speaker stage (`omamobile-audio` 0.5.13). With the modem up the phone never sleeps (the stack holds a sleep inhibitor, because suspend with the modem up isn't qualified), and each restart with the modem up costs one recovered storage error-handler pass. After a hang or a forced reset with the modem up, the next boot leaves the modem off once (the Mobile data tile says "Off after a hang or reset"; `journalctl -b -1 -u omamobile-modem` has that boot's line) and the boot after starts it again; if that boot ends the same way, the modem stays off (the tile adds "(held)") until the markers are cleared by hand (`sudo rm -f /var/lib/omamobile/modem-up /var/lib/omamobile/modem-up.refused-*`, then restart the phone), and a clean reboot in between resets the count. `sudo touch /etc/omamobile/modem-hold` holds it from the first time. To keep the whole stack off: `sudo systemctl mask omamobile-modem-boot.target` (`disable` doesn't remove the package's link, and `systemctl is-enabled` reads "disabled" either way).
- **Calls, texts and mobile data work on the tested network.** Tested on the reference phone with one Verizon-network SIM (Tracfone): VoLTE calls both ways, texts over IMS, and mobile data as a fallback route behind Wi-Fi ([DEVICES](../DEVICES.md)). Other networks are untested. The SIM's APNs and bearer order come from its carrier, read once from the SIM at boot ([#373](https://github.com/derekross/omarchy-mobile/pull/373)): a Verizon-network SIM is the one proven end to end; other carriers take the carrier database's APNs, and the Mobile network page under Setup shows and corrects them. Call audio through the earpiece works at every speaker stage (`omamobile-audio` 0.5.13), on by default (`omamobile-modem-sit` 0.3.30 with `omamobile-device-cheetah` 0.1.44). A development install whose `/etc/omamobile/modem-sit.conf` was edited (the Mobile network page writes it) keeps its `card = none` line: delete it for call audio. With the modem up the phone never sleeps (the stack holds a sleep inhibitor, because suspend with the modem up isn't qualified), and each restart with the modem up costs one recovered storage error-handler pass. After a hang or a forced reset with the modem up, the next boot leaves the modem off once (the Mobile data tile says "Off after a hang or reset"; `journalctl -b -1 -u omamobile-modem` has that boot's line) and the boot after starts it again; if that boot ends the same way, the modem stays off (the tile adds "(held)") until the markers are cleared by hand (`sudo rm -f /var/lib/omamobile/modem-up /var/lib/omamobile/modem-up.refused-*`, then restart the phone), and a clean reboot in between resets the count. `sudo touch /etc/omamobile/modem-hold` holds it from the first time. To keep the whole stack off: `sudo systemctl mask omamobile-modem-boot.target` (`disable` doesn't remove the package's link, and `systemctl is-enabled` reads "disabled" either way).
- **Suspend: works when asked for, auto-sleep off by default.** `systemctl suspend` sleeps and wakes reliably (on a key or the RTC), Wi-Fi stays connected across it, and standby lasts about 16 hours, well short of stock's. Auto-sleep after the screen goes off ships **off**; it can be turned on with `omarchy-toggle omamobile-sleep on`, but it hasn't finished a day-long test. With the modem up the phone doesn't sleep at all (above). Wi-Fi traffic and a USB plug can't wake the phone.
- **Cameras:** basic image quality (no Google ISP or tuning); the telephoto doesn't focus.
- **Bluetooth:** headset calls (HFP) don't work yet.
Expand Down
1 change: 1 addition & 0 deletions packages/omamobile-device-cheetah/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,7 @@ Omarchy Mobile's system support for the Google Pixel 7 Pro (codename cheetah, Te
| `src/reboot-to.c` | `/usr/bin/reboot-to` | Reboot with a reason the bootloader understands. One source, inside this package, also linked into every initramfs |
| `bin/omamobile-setup-system` | `/usr/bin` | System setup: UTF-8 locale, timezone, NTP (Omarchy lifecycle `setup-system`) |
| `vendor/udev/rules.d/10-omamobile-storage.rules` | `/usr/lib/udev/rules.d` | Continues the initramfs storage guard: Android partitions stay hidden and the whole-disk node unusable |
| `vendor/omamobile/modem-sit.conf.d/50-cheetah.conf` | `/usr/lib/omamobile/modem-sit.conf.d` | omamobile-modem-sit's defaults for this phone: call audio through the AoC card in the protection service's earpiece mode (`card = auto`); a value in `/etc/omamobile/modem-sit.conf` wins |
| `vendor/systemd/network/20-usb-gadget.network` | `/usr/lib/systemd/network` | USB networking to a host (172.16.42.1) |
| `vendor/NetworkManager/conf.d/10-omamobile-usb.conf` | `/usr/lib/NetworkManager/conf.d` | Keeps NetworkManager off the USB link |
| `vendor/systemd/logind.conf.d/10-omamobile-power-key.conf` | `/usr/lib/systemd/logind.conf.d` | A short power press opens the system menu instead of powering off |
Expand Down
7 changes: 7 additions & 0 deletions packages/omamobile-device-cheetah/test/all
Original file line number Diff line number Diff line change
Expand Up @@ -169,6 +169,13 @@ grep -q '^\[Unit\]' "$d" && ! grep -q '^\[Service\]' "$d" || fail "the sit-data
for n in omamobile-modem.service omamobile-modem-inhibit.service omamobile-sitd.service omamobile-sit-data.service omamobile-mmd.service; do
[[ -z $(find "$tmp/root/usr/lib/systemd" -name "$n" -path '*.wants/*' -o -name "$n" -path '*.requires/*') ]] || fail "no wants link for $n is shipped (the target is the switch)"
done
# Call audio (0.1.44): the 7 Pro's defaults for omamobile-modem-sit route
# calls through the AoC card in the earpiece mode; modem-sit's packaged
# /etc file leaves the card unset, so this is what a fresh install gets.
d=$tmp/root/usr/lib/omamobile/modem-sit.conf.d/50-cheetah.conf
[[ -f $d ]] || fail "the modem-sit defaults are staged"
python3 -I -c 'import configparser,sys; p=configparser.ConfigParser(interpolation=None); p.read(sys.argv[1]); sys.exit(p.get("audio","card")!="auto")' "$d" \
|| fail "the 7 Pro's call audio default is card = auto"
if [[ -f ../omamobile-modem/systemd/omamobile-modem-boot.target ]]; then
grep -qx 'WantedBy=multi-user.target' ../omamobile-modem/systemd/omamobile-modem-boot.target || fail "the link matches the target's own [Install]"
grep -qx 'ConditionPathExists=/usr/lib/omamobile-vendor/modem/root' ../omamobile-modem/systemd/omamobile-modem.service \
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
# SPDX-License-Identifier: MIT
# The Pixel 7 Pro's defaults for omamobile-modem-sit, read before
# /etc/omamobile/modem-sit.conf (a value set there wins).
[audio]
# Call audio through the AoC card, each call in the protection service's
# earpiece mode (the top amplifier alone at 657/6, the bottom muted;
# AOC-PLAN.md C9k), clean by ear on VoLTE calls on 2026-11-03
# (device/cheetah/NOTES.md, 2026-11-03).
card = auto
2 changes: 1 addition & 1 deletion packages/omamobile-device-cheetah/version
Original file line number Diff line number Diff line change
@@ -1 +1 @@
0.1.43
0.1.44
8 changes: 6 additions & 2 deletions packages/omamobile-modem-sit/etc/omamobile/modem-sit.conf
Original file line number Diff line number Diff line change
Expand Up @@ -127,14 +127,18 @@ group = wheel

[audio]
# The AoC sound card for call audio: "none" connects calls without routing
# any audio; "auto" finds the AoC card in /proc/asound/cards. With a card
# any audio; "auto" (or an empty value) finds the AoC card in
# /proc/asound/cards. Commented out, the phone's device package decides
# (/usr/lib/omamobile/modem-sit.conf.d): "auto" on the Pixel 7 Pro, whose
# earpiece route is verified; "none" elsewhere until a phone's route is.
# A value here always wins. With a card
# and earpiece = yes, each call runs in the protection service's earpiece
# mode (omamobile-speaker-protection earpiece on: the top amplifier alone
# at 657/6, the bottom muted) and audio is refused unless the service
# reports that mode; with earpiece = no, refused unless the service runs at
# stage media or c8 with the top amplifier at analog 6 or less and both
# within the media stage's ceilings (digital 737, analog 10).
card = none
#card = none
earpiece = yes
# Microphone gain above stock's 130 cB during calls: 6 (default, judged
# louder and clean in calls on this phone) or 0 (stock).
Expand Down
20 changes: 20 additions & 0 deletions packages/omamobile-modem-sit/lib/paths.py
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,14 @@
STATE = Path(os.environ.get('OMAMOBILE_SIT_STATE', '/var/lib/omamobile-sit'))
INBOX = STATE / 'inbox'
CONFIG = Path(os.environ.get('OMAMOBILE_SIT_CONFIG', '/etc/omamobile/modem-sit.conf'))
# A device package's defaults (*.conf, read in name order before CONFIG, so
# a value set in CONFIG wins): the settings that hold only on that phone,
# such as the call audio route its owner has verified ([audio] card = auto
# from omamobile-device-cheetah). Without one, DEFAULTS hold. Only their
# [audio] section is read: omamobile-mmd and the shell read [network] and
# [data] from CONFIG themselves and would never see a device default there.
# A file that can't be read or parsed is skipped (the safe side: no route).
DEVICE_DEFAULTS = Path(os.environ.get('OMAMOBILE_SIT_DEFAULTS', '/usr/lib/omamobile/modem-sit.conf.d'))

# CPIF's character devices. "unix:PATH" is a SOCK_SEQPACKET socket (the
# simulator); "none" for BOOT means "no CP state ioctl: assume ONLINE".
Expand All @@ -43,6 +51,18 @@
def config(path=None):
parser = configparser.ConfigParser(interpolation=None)
parser.read_dict(DEFAULTS)
try:
files = sorted(f for f in DEVICE_DEFAULTS.glob('*.conf') if f.is_file())
except OSError:
files = []
for f in files:
device = configparser.ConfigParser(interpolation=None)
try:
device.read_string(f.read_text(), str(f))
except (OSError, UnicodeDecodeError, configparser.Error):
continue
if device.has_section('audio'):
parser.read_dict({'audio': dict(device['audio'])})
parser.read(path or CONFIG)
return parser

Expand Down
14 changes: 8 additions & 6 deletions packages/omamobile-modem-sit/lib/voice_audio.py
Original file line number Diff line number Diff line change
Expand Up @@ -8,12 +8,14 @@
with omamobile-audio: the downlink plays through TDM 0, so it needs the
amplifiers set up (stock's TDM 0 format, protection service running).

TDM 0 feeds both amplifiers, and the top one is the earpiece. Until the
protection service has an earpiece mode (TELEPHONY-APPS-PLAN T4), routing is
refused unless the protection service reports itself running at stage
media or c8 and the amplifiers are at or below the earpiece ceiling (top
analog <= 6, AUDIO-PLAN.md section 4) and the media stage's (digital <= 737,
analog <= 10, AGENTS.md). The default config routes no call audio at all.
TDM 0 feeds both amplifiers, and the top one is the earpiece. With the
protection service's earpiece mode (AOC-PLAN.md C9k) each call runs in that
mode; without it, routing is refused unless the protection service reports
itself running at stage media or c8 and the amplifiers are at or below the
earpiece ceiling (top analog <= 6, AUDIO-PLAN.md section 4) and the media
stage's (digital <= 737, analog <= 10, AGENTS.md). The built-in default
routes no call audio; a device package whose route is verified sets
[audio] card = auto in its defaults (paths.DEVICE_DEFAULTS).
"""
import ctypes as C
import os
Expand Down
7 changes: 7 additions & 0 deletions packages/omamobile-modem-sit/omamobile-modem-sit.install
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,13 @@ post_upgrade() {
echo " setup: no attach APN, IMS first on CID 2, the internet on CID 3, stock's profiles);"
echo " values you typed keep working. New: [data] roaming (.pacnew)."
fi
if [[ $(vercmp "$2" 0.3.30) -lt 0 ]] \
&& grep -Eq '^[[:space:]]*card[[:space:]]*=[[:space:]]*none[[:space:]]*$' /etc/omamobile/modem-sit.conf 2>/dev/null; then
echo "omamobile-modem-sit 0.3.30: [audio] card now comes from the device package when"
echo " /etc/omamobile/modem-sit.conf leaves it unset. Your edited file keeps its"
echo " \"card = none\" line: on a Pixel 7 Pro, delete that line for call audio through"
echo " the earpiece, then restart the phone. On other phones, leave it."
fi
}
pre_remove() {
systemctl disable --now omamobile-sit-data.service omamobile-sitd.service 2>/dev/null || true
Expand Down
1 change: 1 addition & 0 deletions packages/omamobile-modem-sit/test/env.py
Original file line number Diff line number Diff line change
Expand Up @@ -15,6 +15,7 @@
'OMAMOBILE_SIT_RUN': os.path.join(TMP, 'run'),
'OMAMOBILE_SIT_STATE': os.path.join(TMP, 'state'),
'OMAMOBILE_SIT_CONFIG': os.path.join(TMP, 'modem-sit.conf'),
'OMAMOBILE_SIT_DEFAULTS': os.path.join(TMP, 'modem-sit.conf.d'),
'OMAMOBILE_SIT_DEVICE': 'unix:' + os.path.join(TMP, 'ipc0'),
'OMAMOBILE_SIT_ROUTER': 'unix:' + os.path.join(TMP, 'router'),
'OMAMOBILE_SIT_BOOT': 'none',
Expand Down
Loading