Skip to content

Apple's open-source XNU kernel on Android phones: its own loader and drivers, Metal on the Adreno. Runs from RAM; a reboot gives the phone back to Android.

C

English everywhere that is read first; docs/ru/ for the Russian diary; a top-level Makefile; LICENSE, LICENSE.APSL and NOTICE

shimoku740ddc06ec9eae
diff --git a/README.md b/README.md
index 1b18d18..6ef0513 100644
--- a/README.md
+++ b/README.md
@@ -84,7 +84,7 @@ XL_CMDLINE="bootcpu=7 cpus=8 cpufreq=1 ufs=2 touchscreen=1 gpu=1 adsp=1 sound=4
`tools/modem-cycle.sh "ARGS" SECS` does all of that in one command and returns the phone to Android.
-The main kernel arguments (the full list is in `docs/notes.md`):
+The main kernel arguments (the full list is in `docs/ru/notes.md`):
| Argument | What it does |
|---|---|
@@ -116,7 +116,7 @@ repository: `xnuloader/mkidentity.sh` makes it at build time from the device tre
(one 34 KB file; LZFSE is decoded by `lzfse`, macOS's `compression_tool` or the Python `lzfse`
module, or the open lzfse library gets built). User space and the images: `REST=1 userland/build.sh`
(`MODEM=1 SYSTEM=1` put the modem's firmware into the system image). Details: `xnu/README.md`,
-`docs/notes.md`.
+`docs/ru/notes.md`.
## Layout
diff --git a/devices/redwood/uefi/README.md b/devices/redwood/uefi/README.md
index 6e79106..547098a 100644
--- a/devices/redwood/uefi/README.md
+++ b/devices/redwood/uefi/README.md
@@ -1,36 +1,37 @@
-# UEFI для redwood
+# UEFI for redwood
-Порт [Project Silicium / Mu-Silicium](https://github.com/Project-Silicium/Mu-Silicium) на POCO X5 Pro 5G (redwood).
-В апстриме этого устройства нет; порт сделан по образцу `lisa` (тот же SoC-пакет `KodiakPkg`).
+A port of [Project Silicium / Mu-Silicium](https://github.com/Project-Silicium/Mu-Silicium) to the
+POCO X5 Pro 5G, modelled on `lisa` (the same `KodiakPkg` SoC package). You do not need to rebuild
+it to run HakiOS: the built image is in `devices/redwood/prebuilt`, and `mkxnuimg.py` takes it.
-Для запуска пересобирать UEFI не нужно — готовый образ лежит в `devices/redwood/prebuilt`, `mkxnuimg.py` берёт его сам.
+What is here:
-Что здесь:
+- `BASE`: the Mu-Silicium commit the port is made on;
+- `mu-silicium.patch`: changes to existing files: `BootShim/BootShim.S` (copies our "XNUP"
+ container behind the UEFI image to 0xF0000000) and `BootManagerLib` (starts the XNU loader from
+ the container instead of a menu);
+- `files/`: new files: `Platforms/Xiaomi/redwoodPkg` (memory map, driver list),
+ `Silicon/.../BootManagerLib/XnuLoader.[ch]`, `Resources/Configs/redwood.toml`,
+ `Resources/DTBs/redwood.dtb` (the device tree from the phone's vendor_boot), `Binaries/redwood`
+ (the UEFI drivers of the phone's own firmware, extracted from `xbl.img` with
+ [UEFIReader](https://github.com/WOA-Project/UEFIReader), the way Project Silicium ships them for
+ other phones; see `files/Binaries/redwood/README.md`).
-- `BASE` — коммит Mu-Silicium, на котором сделан порт;
-- `mu-silicium.patch` — правки существующих файлов:
- `BootShim/BootShim.S` (копирует за образом UEFI наш контейнер «XNUP» по адресу 0xF0000000),
- `BootManagerLib` (вместо меню запускает загрузчик XNU из контейнера);
-- `files/` — новые файлы: `Platforms/Xiaomi/redwoodPkg` (карта памяти, список драйверов),
- `Silicon/…/BootManagerLib/XnuLoader.[ch]`, `Resources/Configs/redwood.toml`, `Resources/DTBs/redwood.dtb`
- (дерево устройств из vendor_boot телефона), `Binaries/redwood` (драйверы UEFI из прошивки
- `OS1.0.3.0.UMSMIXM`, извлечены [UEFIReader](https://github.com/WOA-Project/UEFIReader) из `xbl.img`,
- с пятью штатными заплатками Silicium — см. `files/Binaries/redwood/README.md`).
+## Build
-## Сборка
-
-Пакеты — как в `setup_env.sh` из Mu-Silicium (на Arch: `git base-devel lld nasm clang llvm aarch64-linux-gnu-gcc
-python python-pip python-virtualenv`).
+Packages as in Mu-Silicium's `setup_env.sh` (Arch: `git base-devel lld nasm clang llvm
+aarch64-linux-gnu-gcc python python-pip python-virtualenv`).
```sh
-devices/redwood/uefi/apply.sh # клонирует Mu-Silicium (с подмодулями, ~3 ГБ) и накладывает порт
+devices/redwood/uefi/apply.sh # clones Mu-Silicium (with submodules, ~3 GB) and applies the port
python3 -m venv venv && venv/bin/pip install -r Mu-Silicium/pip-requirements.txt
cd Mu-Silicium
source ../venv/bin/activate
-python3 build_uefi.py -d redwood -r RELEASE # → Build/redwoodPkg/RELEASE_CLANGPDB/FV/SILICIUM_UEFI.fd
+python3 build_uefi.py -d redwood -r RELEASE # -> Build/redwoodPkg/RELEASE_CLANGPDB/FV/SILICIUM_UEFI.fd
```
-Грабля: зависимость `mu_nasm` ставится через NuGet и требует Mono. Обход без Mono — подложить системный nasm:
+The `mu_nasm` dependency comes through NuGet and wants Mono; without Mono, point it at the
+system nasm:
```sh
D=Mu_Basecore/BaseTools/Bin/mu_nasm_extdep
@@ -39,9 +40,6 @@ echo 'version: 20016.1.1' > $D/extdep_state.yaml
ln -s /usr/bin/nasm /usr/bin/ndisasm $D/Linux-x86-64/
```
-После сборки `mkxnuimg.py` (его вызывает `./xl enter`) берёт UEFI уже из `Mu-Silicium/`, а
-`tools/update-prebuilt.sh` обновляет `devices/redwood/prebuilt`.
-
-`devices/redwood/uefi/export.sh` — обратное действие: сохранить правки из `Mu-Silicium/` сюда.
-
-Сборка «с нуля» по этой инструкции заново не проверялась (дерево собиралось по ходу работы над портом).
+After a build, `mkxnuimg.py` (called by `./xl enter`) takes the UEFI from `Mu-Silicium/`, and
+`tools/update-prebuilt.sh` refreshes `devices/redwood/prebuilt`. `devices/redwood/uefi/export.sh`
+is the reverse: it saves the changes from `Mu-Silicium/` here.
diff --git a/docs/cellular.md b/docs/cellular.md
index 66bda4e..00dbca7 100644
--- a/docs/cellular.md
+++ b/docs/cellular.md
@@ -1,279 +1,51 @@
-# Сотовая связь: состояние и план порта
+# Cellular
-Сейчас сотовая связь в HakiOS **не работает**, но модем уже запускается из XNU (см. «21 октября» ниже). Wi-Fi использует WPSS и свой GLINK/QRTR; модем MPSS — отдельный процессор с другим каналом. `redwood_qmi.c` кодирует сообщения QMI и теперь позволяет привязать клиент к заданному транспорту QRTR, но канал к MPSS ещё не реализован. У iOS также нет драйверов AppleBaseband и AppleIPAppender для этого аппаратного пути. Запуск `CommCenter` без них уже проверялся: он завершается аварийно (см. README, раздел «Телефония»).
+Where the modem stands (October 2026). The detailed, step-by-step diary in Russian is
+`docs/ru/cellular.md`.
-Проверка `python3 devices/redwood/tools/modem_firmware.py --dtb devices/redwood/prebuilt/redwood.dtb --firmware-dir fw-modem --node /soc/qcom,mss@4080000` сопоставила 28 сегментов штатной прошивки с областью `mpss@8b800000` (PAS ID 4). `MODEM=1 SYSTEM=1 ... userland/build.sh` теперь может положить эти локальные файлы в системный APFS после проверки. Это только подготовка образа: наличие прошивки в `/fw` не запускает MPSS. Исходник `redwood_nas.c` содержит клиент QMI NAS для заданного транспорта QRTR: он ищет службу, запрашивает регистрацию и силу сигнала, разбирает ответы и сбрасывает состояние при исчезновении службы. Уровень `bars` остаётся нулевым без подтверждённой регистрации. MPSS-транспорта в XNU пока нет, поэтому этот клиент ещё не получает сообщения с телефона и не подключён к статус-бару iOS. Форматы NAS сверены с [описанием libqmi](https://github.com/linux-mobile-broadband/libqmi/blob/main/data/qmi-service-nas.json).
+## What works
-## Проверка на телефоне, 20 октября 2026
+- The modem (the Hexagon MPSS) boots from XNU: its firmware goes through TrustZone, the shared
+ memory, SMP2P, GLINK and QRTR come up, and it announces about 88 QMI services.
+- Its file systems (modemst1, modemst2, fsc, fsg) are served from the UFS partitions over RMTFS,
+ read-only: writes stay in kernel memory for the session, the phone's flash is never touched.
+- TFTP over QRTR and the service registry (what Android's tqftpserv and pd-mapper do) are ours.
+- The IPA packet engine runs: firmware through TrustZone, its clock through RPMh, both of its SMMU
+ streams through a translation context of ours (the hypervisor takes one match register per
+ stream), the registers Android programs, the modem's filter-table item in shared memory, and the
+ SMP2P entry `ipa` the modem's driver waits for. The INIT_DRIVER handshake goes through.
+- The modem goes online and stays up. The SIM is found (physical slot 2 on the first phone),
+ logical slot 1 is pointed at it, the provisioning session is bound to its USIM, and NAS reads
+ the signal (-70 to -87 dBm on UMTS).
+- SpringBoard's status bar: the signal item is hooked (`userland/src/inject_sb.c`) and shows the
+ kernel's bars (`sysctl kern.redwood.cellular_bars`) once the modem is registered.
-На redwood через `fastboot boot` временно запущены xnuloader и образ iOS 16.5. Системный APFS загружен в ОЗУ; разделы телефона не прошивались. `launchd` запустил `SpringBoard`, и на дисплее открылся интерфейс «Настройки». Это подтверждает загрузку iOS и работу экрана, но не работу модема. В журнале `mg_test` показывает `telephony = true` и `cellular-data = false`; запросы `com.apple.commcenter.xpc` и `com.apple.basebandd.xpc` остаются без службы. Значение `telephony = true` — ответ MobileGestalt о возможностях устройства, а не регистрация в сети. Тест выполнен с готовым ядром из `prebuilt`, поэтому изменения QMI в исходниках XNU в этой загрузке **не проверялись**. Дальнейший аппаратный тест требует сборки ядра с MPSS/QRTR и интеграции с iOS.
+## Not yet
-## Что установлено по redwood
+- Network registration itself: the modem sees the network but has not registered; the last
+ change (binding the provisioning session) is being tested.
+- The data path (IPA endpoints for the AP), calls, SMS.
-`devices/redwood/prebuilt/redwood.dtb` содержит зарезервированную память `mpss@8b800000`, `qcom,smp2p-modem`, `qcom,glink/modem/qcom,modem_qrtr`, `qcom,ipa@1e00000` и `qcom,rmnet-ipa`. Это разные части тракта: запуск прошивки модема, сигнализация, управляющий QMI-канал и передача IP-пакетов. Дерево Android [redwood](https://github.com/Redwood-AOSP/android_device_xiaomi_redwood) включает `full_base_telephony.mk`; его `init.qcom.rc` запускает `vendor.qcrild` и `vendor.qcrild2`. [Ветка araxys с ядром/DTB](https://github.com/Redwood-AOSP/android_device_xiaomi_redwood-kernel/tree/araxys) пригодна как аппаратный справочник. Бинарники Android RIL нельзя просто запустить в iOS: им нужны Android binder, HAL, службы и ABI.
-
-Проверка по USB 20 октября 2026 года: fastboot определил продукт `redwood` и разблокированный загрузчик; Android сообщил `ro.boot.hardware.sku=redwood`, `ro.soc.model=SM7325`. Под Android подсистема `modem` и прошивка `yupik_ipa_fws` были `ONLINE`, `vendor.qcrild`, `vendor.qcrild2`, `vendor.qrtr-ns` — `running`; присутствовали `rmnet_ipa0` и `rmnet_data0`–`rmnet_data5`. Состояние SIM: `ABSENT,LOADED` для двух слотов. Временная загрузка `xnuloader` через `fastboot boot` и его `selftest` прошли (`selftest-ok`); это проверка загрузчика, а не сотовой связи в XNU.
-
-Android `dmesg` уточняет последовательность: сначала поднимается `yupik_ipa_fws`, затем MPSS загружает `modem.mdt` и сегменты в `0x8b800000..0x9ae00000`, получает `Power/Clock ready`, после чего QRTR фиксирует готовность QMI. Штатные `modem.mdt`/`modem.b*` (около 85 МиБ) сохранены локально в игнорируемом Git каталоге `fw-modem/` и не входят в исходники. Их ELF-заголовок содержит 30 программных заголовков и 28 загружаемых сегментов; все файлы совпали по размеру, а сегменты лежат в зарезервированном окне. Загрузчик WPSS ограничен 16 сегментами; путь ADSP рассчитан на 48, но использует собственные ресурсы памяти, SMP2P и GLINK и не может запускать MPSS простым изменением имени прошивки.
-
-## Границы общей реализации
-
-Общими для устройств должны быть контракт транспорта QRTR, разбор QMI, состояние SIM/сети и интерфейс передачи IP-пакетов. Запуск прошивки MPSS, ресурсы памяти, прерывания, SMMU, IPA и прошивки остаются в профиле и драйвере конкретного SoC/устройства. По наличию `qcom,glink` нельзя объявлять поддержку всех Qualcomm или других телефонов.
-
-Порядок доведения до работающей связи:
-
-1. На подключённом Android собрать отчёт `python3 devices/redwood/tools/cellular_probe.py --adb` и сверить DTB, версию прошивки и активные службы. Скрипт читает только открытые свойства и не собирает IMEI, IMSI и номера SIM.
-2. Поднять MPSS в XNU с собственным GLINK/QRTR-каналом, отдельным от WPSS; проверить обнаружение QMI-служб, не отправляя команд регистрации или передачи данных.
-3. Реализовать QMI DMS/UIM/NAS/WDS и состояние SIM/сети; отдельно включить путь IPA/rmnet для мобильных данных.
-4. Подключить эти возможности к CoreTelephony/CommCenter через совместимый сервис и аппаратный драйвер, затем проверить SIM, регистрацию, входящие/исходящие вызовы, SMS и мобильные данные на телефоне. VoLTE/IMS — отдельная работа.
-
-Пока пункт 2 не подтверждён на устройстве, не включать узел `baseband` и не переключать систему на cellular `CommCenter`: это создаёт аварийные циклы без радио.
-
-## Команды до и после подключения
+## How to run it
```sh
-python3 devices/redwood/tools/cellular_probe.py > modem-dtb.json
-# После подключения телефона с разрешённой USB-отладкой:
-python3 devices/redwood/tools/cellular_probe.py --adb > modem-android.json
+XL_SB_DELAY=8 tools/modem-cycle.sh "modem=1 modem_again=1 modem_buffer=0xa8000000" 600
```
-Для другого устройства передать его DTB через `--dtb PATH`; прошивку на телефон инструмент не записывает.
-
-## 21 октября 2026: модем запущен из XNU
-
-Ядро теперь собирается на этом Mac (см. `xnu/README.md`, «Сборка на macOS»), и драйвер
-`bsd/dev/redwood_mpss.c` — копия пути аудио‑DSP (`redwood_adsp.c`) с числами модема — проверен
-на телефоне через `xl run` с `modem_step=11 modem_return=1`:
-
-- шаги 1–10 проходят: прошивка `modem.*` из `/fw` системного образа (85 МБ, 28 сегментов)
- записана в `0x8b800000` и прочитана обратно без расхождений; TrustZone принял подпись
- (образ 4) и область `0xf600000` байт; шины CX и MSS запрошены у RPMh на уровне 384; AOP
- получил `modem: on`; через 63 мс после старта модем сказал `slave-kernel = 0x6` (поднялся и
- взял питание сам); GLINK согласован, канал `IPCRTR` открыт в обе стороны; QRTR: hello в обе
- стороны, модем — узел 0;
-- модем объявил только две службы: 43 (SSCTL, экземпляр 18) и 66 (реестр служб). DMS и NAS
- не появились за 40 с, поэтому шаг 11 (DMS «online», опрос NAS) не выполнен;
-- по просьбе модем остановился за 43 мс (`0x10e`), TrustZone выключил его, AOP получил
- `modem: off`; телефон вернулся в загрузчик штатно.
-
-Причина отсутствия DMS/NAS — у модема нет доступа к своим файловым системам: на Android их
-отдаёт демон `rmtfs` (служба QMI 14 поверх QRTR, [linux-msm/rmtfs](https://github.com/linux-msm/rmtfs)).
-В драйвер добавлена такая служба: четыре раздела (`modemst1`, `modemst2`, `fsc`, `fsg`)
-читаются при старте шагов целиком в память ядра через `redwood_ufs_read_partition()`
-(нужен `ufs=2` в аргументах ядра — блочная служба загрузчика), модем открывает их по путям
-`/boot/modem_fs1` и т. д., получает буфер 2,5 МБ (`qcom,rmtfs_sharedmem@0`), в который
-TrustZone пускает модем вызовом `SCM MP ASSIGN` (HLOS + MSS_MSA, чтение и запись), и читает
-или пишет секторы через него. Записи остаются в памяти ядра: **разделы телефона не
-записываются**. Служба объявляется модему в ответ на hello и на lookup (наша сторона
-сервиса имён QRTR). Это ещё **не проверено на телефоне**: после предыдущего прогона телефон
-исчез с USB (сторожевой таймер загрузчика), нужен ручной перезапуск в fastboot.
-
-Запуск теста:
-
-```sh
-./xl enter && ./xl ramdisk userland/system.apfs # образ с MODEM=1 SYSTEM=1 (один раз после входа в загрузчик)
-XL_CMDLINE="debug=0x8 rd=md0 hv_wdt_pet=1 bootcpu=7 cpus=8 cpufreq=1 sb_delay=600 ufs=2 modem_step=11 modem_return=1 modem_new=12 modem_nas_wait=60" XL_SECS=300 XL_FOLLOW=3 ./xl run
-```
-
-`modem=1` в обычной загрузке делает всё то же на своём потоке и оставляет модем включённым,
-опрашивая NAS каждые две секунды; результат — в `sysctl kern.redwood.cellular_up`,
-`cellular_registered`, `cellular_bars`, `cellular_dbm`, `cellular_radio`. Палочки в
-статус‑баре iOS из этого ещё не получаются: нужна либо часть CommCenter, либо подмена
-элемента статус‑бара в `libredwood-sb.dylib` по этим sysctl (следующий шаг).
-
-## 23 октября 2026: буфер RMTFS и перезапуски телефона
-
-Ночные прогоны (`tools/macos-bin`: adb из platform-tools r34 — сервер adb 37.0.1 на этом Mac
-убивается через две секунды после запуска; `xl` возвращает телефон в Android после каждого
-прогона) показали:
-
-- буфер RMTFS должен лежать **ниже 4 ГБ**: адреса в запросах модема 32‑битные (с буфером
- `0x197508000` модем пишет «xpu lock failed» по усечённому адресу и сдаётся);
-- память CDSP (`0x9c700000`) не годится: после её передачи TrustZone отказывается запускать
- модем (`-3145799`); память видеокодека (`0x8ae00000`) и `ramoops` (`0xb0000000`) —
- модем стартует, но телефон сбрасывается при первой нашей записи сектора; свободная память
- UEFI (`0xa8000000`, `modem_buffer=`) — то же, пока буфер отдан только HLOS и MSS;
-- Android отдаёт буфер трём владельцам: HLOS, MSS_MSA (15) и NAV (0x2b) — в DTB телефона у
- `qcom,rmtfs_sharedmem@0` стоит `qcom,vm-nav-path`. С тремя владельцами запись в буфер после
- «замка» модема проходит без сброса (цикл 2: сектор записан, модему отказано — ядро вернулось
- штатно). Обратная передача (`{HLOS, MSS, NAV} → {HLOS}`) при остановке отказывает
- (`-2`, ответ `0x56`): видимо, пока держится замок модема; на перезагрузку это не влияет;
-- опыты включаются ключами `modem_share_test=1` (пробная запись после передачи),
- `modem_rmtfs_rw_off=1` (отказ в чтении), `modem_rmtfs_rw_fake=1` (запись есть, ответ «нет»),
- `modem_rmtfs_delay=S` (пауза перед первым чтением), `modem_share_off=1`, `modem_no_nav=1`.
-
-Паника `copyio.c:89 Assertion failed: pan != 0` в пользовательских процессах iOS встречалась в
-двух прогонах с модемом; её причина не найдена.
-
-## 23 октября 2026, вечер: модем читает файлы, выходит в ONLINE
-
-С буфером в `0xa8000000`, отданным HLOS, MSS и NAV, модем читает свои файловые системы и за
-~30 с объявляет все службы (88 объявлений: DMS 2, NAS 3, UIM 11, WDS 1, ...). Дальше он стоит в
-режиме **OFFLINE** и на `DMS Set Operating Mode = online` отвечает «устройство не готово» (52),
-на `low power` — «недопустимый переход» (60): он ждёт двух служб процессора приложений, которые
-на Android дают демоны `pd-mapper` и `tqftpserv`:
-
-- **реестр служб** (QMI 64, версия 257): модем спрашивает, где `tms/servreg` и другие; ответ —
- домены (`msm/modem/root_pd`, экземпляр 180) из `*.jsn` раздела прошивки;
-- **TFTP поверх QRTR** (QMI 4096): модем пишет `/readwrite/server_check.txt`, читает
- `/readonly/firmware/image/modem_pr/so/665_0_0.mbn` кусками (опции `rsize`, `seek`, `wsize`,
- `blksize`), просит `/readwrite/ota_firewall/ruleset` (нет — не страшно).
-
-Обе службы теперь в `redwood_mpss.c` (разделы «TFTP over QRTR» и «the service registry's
-locator»): файлы берутся из `/fw/image` системного образа (`fw-modem/image` — копия
-`/vendor/firmware_mnt/image` телефона, снятая `adb pull`; `MODEM=1 SYSTEM=1 userland/build.sh`
-кладёт её в образ), записи модема хранятся в памяти ядра на время прогона. Сервер имён QRTR
-объявляет наши службы модему при hello и отвечает на его lookup.
-
-Результат (прогон 23:00): после обслуживания файлов модем **согласился перейти в ONLINE**, NAS
-ответил «не зарегистрирован, CS/PS отключены», и через несколько секунд модем упал в задаче
-`enl2_dl` (LTE L2, downlink) с нулевым адресом. Предположительно при выходе в сеть он обращается
-к IPA, которого с нашей стороны нет; проверяется ответ «IPA недоступен» через SMP2P
-(`modem_ipa=1`), дальше — либо запуск прошивки IPA и его тактов, либо иной обход.
-
-## 24 октября 2026: IPA — прошивка, такт, SMMU
-
-Падение `enl2_dl` повторяется в каждом прогоне через несколько секунд после ONLINE. Гипотеза —
-модему нужен работающий IPA (пакетный ускоритель, через него идут данные LTE), и в
-`redwood_mpss.c` появился его минимальный драйвер («the IPA» в файле), по образцу
-`drivers/net/ipa` Linux (версия IPA 4.11, sc7280):
-
-- **такт**: без голоса RPMh за BCM `IP0` (`ipa_clock()`) TrustZone отвечает на
- `AUTH_AND_RESET` образа 15 «Unhandled implementation specific error»; с голосом прошивка
- `yupik_ipa_fws` (перемещаемый ELF, кладётся от `0x8b700000`) стартует, микроконтроллер
- отвечает «booted» (`ipa_status()`);
-- **память IPA**: `ipa_memory_init()` обнуляет локальную память (0x3000), пишет канарейки и базу
- контекстов обработки; раскладка — `ipa_data-v4.11.c`;
-- **QMI 0x31**: наш хост (экземпляр 1) посылает модемному драйверу IPA `INIT_DRIVER` с раскладкой
- памяти (таблиц маршрутов 15, иначе модем падает на `num_indices >= rtng_tbl_max`), модем
- подписывается на индикацию; ответ `INIT_COMPLETE` ещё не дождались;
-- **SMMU**: IPA ходит в память через SMMU процессора приложений потоками `0x480` (AP) и `0x482`
- (микроконтроллер). Поток без совпадения даёт отказ, обход (bypass) гипервизор не даёт.
- Контекст с нашими таблицами (тождественное отображение гигабайта DDR от `0x80000000` и imem
- `0x146a8000`) гипервизор принял (`sctlr` стал `0x127`, `s2cr` — наш), но **регистр
- совпадения с потоком `0x480` и маской `0x2` он сбросил в 0**. У Wi-Fi (`0x1c00`, маска 1,
- как в дереве устройств) прошло. В дереве устройств у потоков IPA маска 0 — гипервизор, видимо,
- сверяет пару (поток, маска) со списком хозяев. Прогон 21: по регистру совпадения на каждый
- поток, маска 0.
-
-Телефон после каждого прогона возвращается в Android (`cycle.sh`); разделы не пишутся.
-
-### 24 октября, ночь: что говорит сам Android
-
-Android телефона рутован (KernelSU), и его `dmesg`, debugfs (`/d/ipa`, `/d/gsi`) и IPC-логи
-(`/d/ipc_logging/ipa/log`, `gsi/log`) читаются по adb. По ним:
-
-- SMMU: прогон 21 подтвердил догадку — **гипервизор принял по регистру совпадения на поток**
- (`0x480` и `0x482`, маска 0, оба в контекст 7), отказов IPA не было;
-- модем **не отвечал на INIT_DRIVER** вовсе (13 с до падения `enl2_dl`). У Android ответ
- приходит через 11 мс, и запрос другой: `platform_type 3` (мы слали 1 — «data card»),
- `num_indices 7` (мы 14), область модема `0x27d8` размером `0x800` (мы `0x1f18/0x100c`,
- раскладка upstream v4.11 не совпадает с раскладкой `ipa_4_11_mem_part` из techpack/dataipa),
- контексты обработки `0xad0` размером `0xac0`, статистика квот `0x1d00/0x30`, дропов
- `0x27b0/0x20`; TLV 0x18 (`is_ssr_bootup`) при первой загрузке не посылается;
-- после ответа модем шлёт `INIT_MODEM_DRIVER_CMPLT` (0x35), `CONFIG` (0x27),
- `INSTALL_FILTER_RULE` (0x23), `FILTER_INSTALLED_NOTIF` (0x24) — Android отвечает успехом;
- индикацию `INIT_COMPLETE` (0x22) шлёт сразу после ответа на INIT_DRIVER;
-- микроконтроллер IPA загружает **модем** (его события «booted» приходят после ответа), нам его
- область (0x0..0x288) трогать не надо;
-- прошивка IPA у Android кладётся с `0x8b710000` (reserved `ipa_fw@8b700000` 0x10000,
- `ipa_gsi@8b710000` 0xa000); окно SRAM — `ipa-base + 0x40000 + 0x10000 = 0x1e50000`, 0x3000
- байт (блок в драйвере был отображён на 4 КБ — исправлено на 0x4000).
-
-Источник раскладки и обработчиков: `techpack/dataipa/drivers/platform/msm/ipa/ipa_v3`
-(`ipa_utils.c: ipa_4_11_mem_part`, `ipa_qmi_service.c`), ядро
-Atom-X-Devs/android_kernel_xiaomi_sm7325 (у MiCode ветка `redwood-s-oss`).
-
-### Прогон 23 (01:11): служба IPA модема отвечает — но не на INIT_DRIVER
-
-Пробный запрос (сообщение 0x7fff) на порт службы IPA модема получает ответ через 1 мс
-(result 1, error 0x39 — неизвестное сообщение): транспорт в обе стороны работает. INIT_DRIVER
-(0x21), посланный тем же портом за мгновение до того, ответа не получает ни разу — модем его
-декодирует (иначе был бы ответ об ошибке) и **зависает в обработчике**, то есть на обращении к
-железу IPA (свои GSI-каналы, таблицы через команды, загрузка микроконтроллера). Регистры,
-которые Android пишет до модема (QSB, Qtime, COMP_CFG, группы ресурсов, маршрут), теперь
-выставлены (`ipa_hardware_init()`), это не помогло. Следующие кандидаты: GSI со стороны
-модема (Android регистрирует GSI и поднимает свои каналы до модема — возможно, модему нужны
-прерывания/`GSI_EE` общие регистры), голоса шины `SN8`/`SH0`/`MC0`/`ACV` (имена есть в cmd_db) на
-время рукостискания, и чтение через adb того, что делает модем Android в первые 11 мс после
-INIT_DRIVER (`/d/ipc_logging/gsi/log` вокруг 33.31 с).
-
-### Прогони 24–26 (ранок 24 жовтня)
-
-- 24 (`skip_uc_load=1`): модем падає інакше — `ipa_qsh.c:1241: IPA_QSH failed to send analysis to
- IPA_CTL msgQ`: черга задачі IPA_CTL переповнена, задача стоїть незалежно від мікроконтролера.
-- 25: TrustZone кладе сегменти образу IPA у внутрішню пам'ять GSI (0x1e1f000) і мікроконтролера
- (0x1e81000) байт у байт (перевірено читанням), `GSI_CFG` = 0x205 — як пише `gsi_enable_fw()`.
- Прошивка GSI увімкнена, адреса образу в DDR (0x8b700000 чи 0x8b710000, як у Android) ні на що не
- впливає. Сегмент мікроконтролера — лише 0x3c8 байт: завантажувальний стаб; повну прошивку йому
- дає модем. Пробний запит службі IPA модема відповідається за 1 мс, INIT_DRIVER — ніколи.
-- 26: Android при старті драйвера виділяє в SMEM (розділ apps–modem) елемент
- `SMEM_IPA_FILTER_TABLE` (497) на 0x9000 байт (`qcom,ipa-q6-smem-size`) і відображає його в
- SMMU-контекст IPA: модем кладе туди свої таблиці фільтрів. Тепер елемент робиться на кроці 6
- (раніше, 22 жовтня, його вимкнули: без працюючого IPA модем, знайшовши елемент, падав до появи
- служб). `modem_ipa_item=0` — не робити.
-
-### Прогін 28 (08:49): РУКОСТИСКАННЯ IPA ПРОЙШЛО
-
-Розгадка — у рядках образу модема: `IPA_SMP2P: Could not wait for inbound SMP2P channel
-readiness`. Драйвер IPA модема при ініціалізації чекає, поки в елементі SMP2P процесора
-застосунків з'явиться запис «ipa» (у Android він є з завантаження: `qcom,smp2p-ipa-1-out`), і без
-нього задача IPA_CTL стоїть вічно — звідси мовчання на INIT_DRIVER і падіння `enl2_dl`. З
-`modem_ipa=3` (запис «ipa» = біт 0 «відповідь дійсна» + біт 1 «такт IPA увімкнено») модем за 10 мс
-**прийняв INIT_DRIVER**, надіслав INIT_MODEM_DRIVER_CMPLT, CONFIG і 27 правил фільтрів
-(INSTALL_FILTER_RULE). Впав на звірці ідентифікаторів правил з нашої відповіді
-(`ipa_ipfltr.c:6246`): `rule_id` у структурі правила лежить на зміщенні 168, не 163 — виправлено
-(прогін 29). Елемент SMEM 497 і голоси за шини (SN8, SH0, MC0, ACV) лишаються.
-
-### Прогони 29–30: модем живе, але не шукає мережу — SIM у другому слоті
-
-- 29: з вірними `rule_id` модем пережив установку правил, вийшов в ONLINE і прожив усі 120 с
- опитування NAS, зупинився коректно. NAS: «registration 0 (none), CS 2, PS 2», радіоінтерфейс 0
- (немає сервісу), сигналу нема — модем навіть не шукає.
-- 30: додані запити після ONLINE (`sim_probe()`): UIM Get Card Status (0x2f) — **слот 1: карта
- ERROR (код 3), слот 2: PRESENT, USIM READY**; NAS Get System Selection Preference (0x34): режим
- GSM|UMTS|LTE, вибір автоматичний; NAS Initiate Network Register (0x22) — відмова, помилка 37.
- Android бачить ту саму SIM (Kyivstar, ICCID 8938…4340) активною. Первинна підписка (NAS, що
- опитуємо) прив'язана до логічного слота 1 без картки — звідси «no service». Прогін 31: UIM
- Switch Slot (0x46): логічний слот 1 → фізичний слот 2, потім повторні запити.
-- Прогони з `modem_step=11` тримають SpringBoard 600 с (телефон стоїть на логотипі Apple);
- тепер `tools/modem-cycle.sh` бере `XL_SB_DELAY` з оточення, і прогін 31 — повне завантаження
- iOS з модемом у фоні (`modem=1`).
-
-### Прогін 31 (09:12): повне завантаження iOS, перемикання слота, ПЕРШИЙ СИГНАЛ
-
-`XL_SB_DELAY=8` + `modem=1`: SpringBoard стартує одразу (телефон більше не стоїть на логотипі
-Apple під час тестів), модем піднімається у фоні. Після UIM Switch Slot (логічний 1 → фізичний 2)
-картка з'явилась у слоті 1 у стані «detected», і NAS уперше прочитав сигнал: **-80…-87 dBm,
-UMTS** — радіо працює, модем бачить мережу; реєстрації ще нема (помилка 37 на Initiate Network
-Register = `UIM_UNINITIALIZED`: SIM ще ініціалізується після перемикання). Тепер крок 11 раз на
-10 с питає стан картки та NAS Get System Info (0x4d).
-
-Статус-бар: у SpringBoard iOS 16.5 стільникові пункти заповнює `SBStatusBarStateAggregator`
-через `_updateSignalStrengthItem:withData:SIMInfo:barsGetter:barsSetter:` і `_setItem:enabled:`
-(селектори знайдені в кеші dyld). `inject_sb.c` тепер перехоплює цей метод: коли
-`kern.redwood.cellular_registered`, виставляє палички через barsSetter і вмикає пункт; раз на 3 с
-просить пункт оновитися, коли стан у ядрі змінюється; список методів агрегатора пишеться в лог.
-
-### Прогін 32 (25 жовтня): хук статус-бару живий; підписка ні до чого не прив'язана
-
-- Хук у SpringBoard працює: `_updateSignalStrengthItem:withData:SIMInfo:barsGetter:barsSetter:`
- викликається для пунктів 4 (основна SIM) і 5 (друга), setter-и передаються, і за нашим
- проханням пункт оновлюється; повний список методів агрегатора є в лозі
- (`_postItem:withState:inList:`, `_updateBatteryItems`, …).
-- UIM після перемикання слота: USIM у логічному слоті 1 READY, PIN1 вимкнений, але **первинний
- GW-додаток — 0xffff (немає)**, і NAS System Info показує service 4 (power save) по всіх радіо.
- Тобто підписці не призначено USIM. Прогін 33: UIM Change Provisioning Session (0x38): primary GW,
- activate, слот 1 + AID USIM, потім повторне Initiate Network Register.
-- Прогони з самим модемом не вмикали решту заліза: GPU (`gpu=1`), DSP/батарея (`adsp=1`),
- вібро (`haptic=5`), Wi-Fi (`wifi=1`) — звідси «no GPU to draw with», `SOC=-1%`, без вібрації.
- Прогін 33 — з усім разом. Тач працює, коли екран увімкнений (iOS гасить його через ~25 с
- бездіяльності; кнопка живлення будить).
-
-### Прогони 33–34: усе залізо разом
-
-- 33 (`gpu=1 adsp=1 sound=4 wifi=1 haptic=5 modem=1`): ядро стартувало, і телефон зник з USB у перші
- секунди — як у прогоні 31. 32-й (той самий `modem=1`, але без GPU/DSP/Wi-Fi/вібро) прожив 10 хвилин.
- У коді модема є давня примітка: після старту DSP Wi-Fi старт модема скидав телефон. Прогін 34 — те
- саме без `wifi=1`, щоб звузити винуватця.
-- 33-й також перший із provisioning-сесією UIM (0x38): результат ще не отримано.
+`modem_step=N` runs the bring-up step by step and returns to the loader with the log;
+`modem=1` brings the modem up beside the system. Everything is in
+`xnu/files/bsd/dev/redwood_mpss.c` (the modem), `redwood_nas.c` (NAS), `redwood_qmi.c` (QMI).
+
+## Kernel arguments
+
+| Argument | Meaning |
+|---|---|
+| `modem=1` | the modem beside the system, on a thread of its own |
+| `modem_step=N` | steps 1..N, then back to the loader (`modem_return=1`) |
+| `modem_again=1` | start it although a kernel before this one left it shut down |
+| `modem_buffer=0xa8000000` | the RMTFS buffer (below 4 GB) |
+| `modem_nas_wait=S` | how long step 11 waits for registration |
+| `modem_online=0` | do not put the modem online |
+| `modem_ipa=3` (default) | the SMP2P entry `ipa`: valid, clock on |
+| `modem_sim_switch_off=1` | do not point logical slot 1 at the slot with the ready card |
+| `modem_sim_probe_off=1` | no SIM and network-selection queries |
diff --git a/docs/ru/cellular.md b/docs/ru/cellular.md
new file mode 100644
index 0000000..66bda4e
--- /dev/null
+++ b/docs/ru/cellular.md
@@ -0,0 +1,279 @@
+# Сотовая связь: состояние и план порта
+
+Сейчас сотовая связь в HakiOS **не работает**, но модем уже запускается из XNU (см. «21 октября» ниже). Wi-Fi использует WPSS и свой GLINK/QRTR; модем MPSS — отдельный процессор с другим каналом. `redwood_qmi.c` кодирует сообщения QMI и теперь позволяет привязать клиент к заданному транспорту QRTR, но канал к MPSS ещё не реализован. У iOS также нет драйверов AppleBaseband и AppleIPAppender для этого аппаратного пути. Запуск `CommCenter` без них уже проверялся: он завершается аварийно (см. README, раздел «Телефония»).
+
+Проверка `python3 devices/redwood/tools/modem_firmware.py --dtb devices/redwood/prebuilt/redwood.dtb --firmware-dir fw-modem --node /soc/qcom,mss@4080000` сопоставила 28 сегментов штатной прошивки с областью `mpss@8b800000` (PAS ID 4). `MODEM=1 SYSTEM=1 ... userland/build.sh` теперь может положить эти локальные файлы в системный APFS после проверки. Это только подготовка образа: наличие прошивки в `/fw` не запускает MPSS. Исходник `redwood_nas.c` содержит клиент QMI NAS для заданного транспорта QRTR: он ищет службу, запрашивает регистрацию и силу сигнала, разбирает ответы и сбрасывает состояние при исчезновении службы. Уровень `bars` остаётся нулевым без подтверждённой регистрации. MPSS-транспорта в XNU пока нет, поэтому этот клиент ещё не получает сообщения с телефона и не подключён к статус-бару iOS. Форматы NAS сверены с [описанием libqmi](https://github.com/linux-mobile-broadband/libqmi/blob/main/data/qmi-service-nas.json).
+
+## Проверка на телефоне, 20 октября 2026
+
+На redwood через `fastboot boot` временно запущены xnuloader и образ iOS 16.5. Системный APFS загружен в ОЗУ; разделы телефона не прошивались. `launchd` запустил `SpringBoard`, и на дисплее открылся интерфейс «Настройки». Это подтверждает загрузку iOS и работу экрана, но не работу модема. В журнале `mg_test` показывает `telephony = true` и `cellular-data = false`; запросы `com.apple.commcenter.xpc` и `com.apple.basebandd.xpc` остаются без службы. Значение `telephony = true` — ответ MobileGestalt о возможностях устройства, а не регистрация в сети. Тест выполнен с готовым ядром из `prebuilt`, поэтому изменения QMI в исходниках XNU в этой загрузке **не проверялись**. Дальнейший аппаратный тест требует сборки ядра с MPSS/QRTR и интеграции с iOS.
+
+## Что установлено по redwood
+
+`devices/redwood/prebuilt/redwood.dtb` содержит зарезервированную память `mpss@8b800000`, `qcom,smp2p-modem`, `qcom,glink/modem/qcom,modem_qrtr`, `qcom,ipa@1e00000` и `qcom,rmnet-ipa`. Это разные части тракта: запуск прошивки модема, сигнализация, управляющий QMI-канал и передача IP-пакетов. Дерево Android [redwood](https://github.com/Redwood-AOSP/android_device_xiaomi_redwood) включает `full_base_telephony.mk`; его `init.qcom.rc` запускает `vendor.qcrild` и `vendor.qcrild2`. [Ветка araxys с ядром/DTB](https://github.com/Redwood-AOSP/android_device_xiaomi_redwood-kernel/tree/araxys) пригодна как аппаратный справочник. Бинарники Android RIL нельзя просто запустить в iOS: им нужны Android binder, HAL, службы и ABI.
+
+Проверка по USB 20 октября 2026 года: fastboot определил продукт `redwood` и разблокированный загрузчик; Android сообщил `ro.boot.hardware.sku=redwood`, `ro.soc.model=SM7325`. Под Android подсистема `modem` и прошивка `yupik_ipa_fws` были `ONLINE`, `vendor.qcrild`, `vendor.qcrild2`, `vendor.qrtr-ns` — `running`; присутствовали `rmnet_ipa0` и `rmnet_data0`–`rmnet_data5`. Состояние SIM: `ABSENT,LOADED` для двух слотов. Временная загрузка `xnuloader` через `fastboot boot` и его `selftest` прошли (`selftest-ok`); это проверка загрузчика, а не сотовой связи в XNU.
+
+Android `dmesg` уточняет последовательность: сначала поднимается `yupik_ipa_fws`, затем MPSS загружает `modem.mdt` и сегменты в `0x8b800000..0x9ae00000`, получает `Power/Clock ready`, после чего QRTR фиксирует готовность QMI. Штатные `modem.mdt`/`modem.b*` (около 85 МиБ) сохранены локально в игнорируемом Git каталоге `fw-modem/` и не входят в исходники. Их ELF-заголовок содержит 30 программных заголовков и 28 загружаемых сегментов; все файлы совпали по размеру, а сегменты лежат в зарезервированном окне. Загрузчик WPSS ограничен 16 сегментами; путь ADSP рассчитан на 48, но использует собственные ресурсы памяти, SMP2P и GLINK и не может запускать MPSS простым изменением имени прошивки.
+
+## Границы общей реализации
+
+Общими для устройств должны быть контракт транспорта QRTR, разбор QMI, состояние SIM/сети и интерфейс передачи IP-пакетов. Запуск прошивки MPSS, ресурсы памяти, прерывания, SMMU, IPA и прошивки остаются в профиле и драйвере конкретного SoC/устройства. По наличию `qcom,glink` нельзя объявлять поддержку всех Qualcomm или других телефонов.
+
+Порядок доведения до работающей связи:
+
+1. На подключённом Android собрать отчёт `python3 devices/redwood/tools/cellular_probe.py --adb` и сверить DTB, версию прошивки и активные службы. Скрипт читает только открытые свойства и не собирает IMEI, IMSI и номера SIM.
+2. Поднять MPSS в XNU с собственным GLINK/QRTR-каналом, отдельным от WPSS; проверить обнаружение QMI-служб, не отправляя команд регистрации или передачи данных.
+3. Реализовать QMI DMS/UIM/NAS/WDS и состояние SIM/сети; отдельно включить путь IPA/rmnet для мобильных данных.
+4. Подключить эти возможности к CoreTelephony/CommCenter через совместимый сервис и аппаратный драйвер, затем проверить SIM, регистрацию, входящие/исходящие вызовы, SMS и мобильные данные на телефоне. VoLTE/IMS — отдельная работа.
+
+Пока пункт 2 не подтверждён на устройстве, не включать узел `baseband` и не переключать систему на cellular `CommCenter`: это создаёт аварийные циклы без радио.
+
+## Команды до и после подключения
+
+```sh
+python3 devices/redwood/tools/cellular_probe.py > modem-dtb.json
+# После подключения телефона с разрешённой USB-отладкой:
+python3 devices/redwood/tools/cellular_probe.py --adb > modem-android.json
+```
+
+Для другого устройства передать его DTB через `--dtb PATH`; прошивку на телефон инструмент не записывает.
+
+## 21 октября 2026: модем запущен из XNU
+
+Ядро теперь собирается на этом Mac (см. `xnu/README.md`, «Сборка на macOS»), и драйвер
+`bsd/dev/redwood_mpss.c` — копия пути аудио‑DSP (`redwood_adsp.c`) с числами модема — проверен
+на телефоне через `xl run` с `modem_step=11 modem_return=1`:
+
+- шаги 1–10 проходят: прошивка `modem.*` из `/fw` системного образа (85 МБ, 28 сегментов)
+ записана в `0x8b800000` и прочитана обратно без расхождений; TrustZone принял подпись
+ (образ 4) и область `0xf600000` байт; шины CX и MSS запрошены у RPMh на уровне 384; AOP
+ получил `modem: on`; через 63 мс после старта модем сказал `slave-kernel = 0x6` (поднялся и
+ взял питание сам); GLINK согласован, канал `IPCRTR` открыт в обе стороны; QRTR: hello в обе
+ стороны, модем — узел 0;
+- модем объявил только две службы: 43 (SSCTL, экземпляр 18) и 66 (реестр служб). DMS и NAS
+ не появились за 40 с, поэтому шаг 11 (DMS «online», опрос NAS) не выполнен;
+- по просьбе модем остановился за 43 мс (`0x10e`), TrustZone выключил его, AOP получил
+ `modem: off`; телефон вернулся в загрузчик штатно.
+
+Причина отсутствия DMS/NAS — у модема нет доступа к своим файловым системам: на Android их
+отдаёт демон `rmtfs` (служба QMI 14 поверх QRTR, [linux-msm/rmtfs](https://github.com/linux-msm/rmtfs)).
+В драйвер добавлена такая служба: четыре раздела (`modemst1`, `modemst2`, `fsc`, `fsg`)
+читаются при старте шагов целиком в память ядра через `redwood_ufs_read_partition()`
+(нужен `ufs=2` в аргументах ядра — блочная служба загрузчика), модем открывает их по путям
+`/boot/modem_fs1` и т. д., получает буфер 2,5 МБ (`qcom,rmtfs_sharedmem@0`), в который
+TrustZone пускает модем вызовом `SCM MP ASSIGN` (HLOS + MSS_MSA, чтение и запись), и читает
+или пишет секторы через него. Записи остаются в памяти ядра: **разделы телефона не
+записываются**. Служба объявляется модему в ответ на hello и на lookup (наша сторона
+сервиса имён QRTR). Это ещё **не проверено на телефоне**: после предыдущего прогона телефон
+исчез с USB (сторожевой таймер загрузчика), нужен ручной перезапуск в fastboot.
+
+Запуск теста:
+
+```sh
+./xl enter && ./xl ramdisk userland/system.apfs # образ с MODEM=1 SYSTEM=1 (один раз после входа в загрузчик)
+XL_CMDLINE="debug=0x8 rd=md0 hv_wdt_pet=1 bootcpu=7 cpus=8 cpufreq=1 sb_delay=600 ufs=2 modem_step=11 modem_return=1 modem_new=12 modem_nas_wait=60" XL_SECS=300 XL_FOLLOW=3 ./xl run
+```
+
+`modem=1` в обычной загрузке делает всё то же на своём потоке и оставляет модем включённым,
+опрашивая NAS каждые две секунды; результат — в `sysctl kern.redwood.cellular_up`,
+`cellular_registered`, `cellular_bars`, `cellular_dbm`, `cellular_radio`. Палочки в
+статус‑баре iOS из этого ещё не получаются: нужна либо часть CommCenter, либо подмена
+элемента статус‑бара в `libredwood-sb.dylib` по этим sysctl (следующий шаг).
+
+## 23 октября 2026: буфер RMTFS и перезапуски телефона
+
+Ночные прогоны (`tools/macos-bin`: adb из platform-tools r34 — сервер adb 37.0.1 на этом Mac
+убивается через две секунды после запуска; `xl` возвращает телефон в Android после каждого
+прогона) показали:
+
+- буфер RMTFS должен лежать **ниже 4 ГБ**: адреса в запросах модема 32‑битные (с буфером
+ `0x197508000` модем пишет «xpu lock failed» по усечённому адресу и сдаётся);
+- память CDSP (`0x9c700000`) не годится: после её передачи TrustZone отказывается запускать
+ модем (`-3145799`); память видеокодека (`0x8ae00000`) и `ramoops` (`0xb0000000`) —
+ модем стартует, но телефон сбрасывается при первой нашей записи сектора; свободная память
+ UEFI (`0xa8000000`, `modem_buffer=`) — то же, пока буфер отдан только HLOS и MSS;
+- Android отдаёт буфер трём владельцам: HLOS, MSS_MSA (15) и NAV (0x2b) — в DTB телефона у
+ `qcom,rmtfs_sharedmem@0` стоит `qcom,vm-nav-path`. С тремя владельцами запись в буфер после
+ «замка» модема проходит без сброса (цикл 2: сектор записан, модему отказано — ядро вернулось
+ штатно). Обратная передача (`{HLOS, MSS, NAV} → {HLOS}`) при остановке отказывает
+ (`-2`, ответ `0x56`): видимо, пока держится замок модема; на перезагрузку это не влияет;
+- опыты включаются ключами `modem_share_test=1` (пробная запись после передачи),
+ `modem_rmtfs_rw_off=1` (отказ в чтении), `modem_rmtfs_rw_fake=1` (запись есть, ответ «нет»),
+ `modem_rmtfs_delay=S` (пауза перед первым чтением), `modem_share_off=1`, `modem_no_nav=1`.
+
+Паника `copyio.c:89 Assertion failed: pan != 0` в пользовательских процессах iOS встречалась в
+двух прогонах с модемом; её причина не найдена.
+
+## 23 октября 2026, вечер: модем читает файлы, выходит в ONLINE
+
+С буфером в `0xa8000000`, отданным HLOS, MSS и NAV, модем читает свои файловые системы и за
+~30 с объявляет все службы (88 объявлений: DMS 2, NAS 3, UIM 11, WDS 1, ...). Дальше он стоит в
+режиме **OFFLINE** и на `DMS Set Operating Mode = online` отвечает «устройство не готово» (52),
+на `low power` — «недопустимый переход» (60): он ждёт двух служб процессора приложений, которые
+на Android дают демоны `pd-mapper` и `tqftpserv`:
+
+- **реестр служб** (QMI 64, версия 257): модем спрашивает, где `tms/servreg` и другие; ответ —
+ домены (`msm/modem/root_pd`, экземпляр 180) из `*.jsn` раздела прошивки;
+- **TFTP поверх QRTR** (QMI 4096): модем пишет `/readwrite/server_check.txt`, читает
+ `/readonly/firmware/image/modem_pr/so/665_0_0.mbn` кусками (опции `rsize`, `seek`, `wsize`,
+ `blksize`), просит `/readwrite/ota_firewall/ruleset` (нет — не страшно).
+
+Обе службы теперь в `redwood_mpss.c` (разделы «TFTP over QRTR» и «the service registry's
+locator»): файлы берутся из `/fw/image` системного образа (`fw-modem/image` — копия
+`/vendor/firmware_mnt/image` телефона, снятая `adb pull`; `MODEM=1 SYSTEM=1 userland/build.sh`
+кладёт её в образ), записи модема хранятся в памяти ядра на время прогона. Сервер имён QRTR
+объявляет наши службы модему при hello и отвечает на его lookup.
+
+Результат (прогон 23:00): после обслуживания файлов модем **согласился перейти в ONLINE**, NAS
+ответил «не зарегистрирован, CS/PS отключены», и через несколько секунд модем упал в задаче
+`enl2_dl` (LTE L2, downlink) с нулевым адресом. Предположительно при выходе в сеть он обращается
+к IPA, которого с нашей стороны нет; проверяется ответ «IPA недоступен» через SMP2P
+(`modem_ipa=1`), дальше — либо запуск прошивки IPA и его тактов, либо иной обход.
+
+## 24 октября 2026: IPA — прошивка, такт, SMMU
+
+Падение `enl2_dl` повторяется в каждом прогоне через несколько секунд после ONLINE. Гипотеза —
+модему нужен работающий IPA (пакетный ускоритель, через него идут данные LTE), и в
+`redwood_mpss.c` появился его минимальный драйвер («the IPA» в файле), по образцу
+`drivers/net/ipa` Linux (версия IPA 4.11, sc7280):
+
+- **такт**: без голоса RPMh за BCM `IP0` (`ipa_clock()`) TrustZone отвечает на
+ `AUTH_AND_RESET` образа 15 «Unhandled implementation specific error»; с голосом прошивка
+ `yupik_ipa_fws` (перемещаемый ELF, кладётся от `0x8b700000`) стартует, микроконтроллер
+ отвечает «booted» (`ipa_status()`);
+- **память IPA**: `ipa_memory_init()` обнуляет локальную память (0x3000), пишет канарейки и базу
+ контекстов обработки; раскладка — `ipa_data-v4.11.c`;
+- **QMI 0x31**: наш хост (экземпляр 1) посылает модемному драйверу IPA `INIT_DRIVER` с раскладкой
+ памяти (таблиц маршрутов 15, иначе модем падает на `num_indices >= rtng_tbl_max`), модем
+ подписывается на индикацию; ответ `INIT_COMPLETE` ещё не дождались;
+- **SMMU**: IPA ходит в память через SMMU процессора приложений потоками `0x480` (AP) и `0x482`
+ (микроконтроллер). Поток без совпадения даёт отказ, обход (bypass) гипервизор не даёт.
+ Контекст с нашими таблицами (тождественное отображение гигабайта DDR от `0x80000000` и imem
+ `0x146a8000`) гипервизор принял (`sctlr` стал `0x127`, `s2cr` — наш), но **регистр
+ совпадения с потоком `0x480` и маской `0x2` он сбросил в 0**. У Wi-Fi (`0x1c00`, маска 1,
+ как в дереве устройств) прошло. В дереве устройств у потоков IPA маска 0 — гипервизор, видимо,
+ сверяет пару (поток, маска) со списком хозяев. Прогон 21: по регистру совпадения на каждый
+ поток, маска 0.
+
+Телефон после каждого прогона возвращается в Android (`cycle.sh`); разделы не пишутся.
+
+### 24 октября, ночь: что говорит сам Android
+
+Android телефона рутован (KernelSU), и его `dmesg`, debugfs (`/d/ipa`, `/d/gsi`) и IPC-логи
+(`/d/ipc_logging/ipa/log`, `gsi/log`) читаются по adb. По ним:
+
+- SMMU: прогон 21 подтвердил догадку — **гипервизор принял по регистру совпадения на поток**
+ (`0x480` и `0x482`, маска 0, оба в контекст 7), отказов IPA не было;
+- модем **не отвечал на INIT_DRIVER** вовсе (13 с до падения `enl2_dl`). У Android ответ
+ приходит через 11 мс, и запрос другой: `platform_type 3` (мы слали 1 — «data card»),
+ `num_indices 7` (мы 14), область модема `0x27d8` размером `0x800` (мы `0x1f18/0x100c`,
+ раскладка upstream v4.11 не совпадает с раскладкой `ipa_4_11_mem_part` из techpack/dataipa),
+ контексты обработки `0xad0` размером `0xac0`, статистика квот `0x1d00/0x30`, дропов
+ `0x27b0/0x20`; TLV 0x18 (`is_ssr_bootup`) при первой загрузке не посылается;
+- после ответа модем шлёт `INIT_MODEM_DRIVER_CMPLT` (0x35), `CONFIG` (0x27),
+ `INSTALL_FILTER_RULE` (0x23), `FILTER_INSTALLED_NOTIF` (0x24) — Android отвечает успехом;
+ индикацию `INIT_COMPLETE` (0x22) шлёт сразу после ответа на INIT_DRIVER;
+- микроконтроллер IPA загружает **модем** (его события «booted» приходят после ответа), нам его
+ область (0x0..0x288) трогать не надо;
+- прошивка IPA у Android кладётся с `0x8b710000` (reserved `ipa_fw@8b700000` 0x10000,
+ `ipa_gsi@8b710000` 0xa000); окно SRAM — `ipa-base + 0x40000 + 0x10000 = 0x1e50000`, 0x3000
+ байт (блок в драйвере был отображён на 4 КБ — исправлено на 0x4000).
+
+Источник раскладки и обработчиков: `techpack/dataipa/drivers/platform/msm/ipa/ipa_v3`
+(`ipa_utils.c: ipa_4_11_mem_part`, `ipa_qmi_service.c`), ядро
+Atom-X-Devs/android_kernel_xiaomi_sm7325 (у MiCode ветка `redwood-s-oss`).
+
+### Прогон 23 (01:11): служба IPA модема отвечает — но не на INIT_DRIVER
+
+Пробный запрос (сообщение 0x7fff) на порт службы IPA модема получает ответ через 1 мс
+(result 1, error 0x39 — неизвестное сообщение): транспорт в обе стороны работает. INIT_DRIVER
+(0x21), посланный тем же портом за мгновение до того, ответа не получает ни разу — модем его
+декодирует (иначе был бы ответ об ошибке) и **зависает в обработчике**, то есть на обращении к
+железу IPA (свои GSI-каналы, таблицы через команды, загрузка микроконтроллера). Регистры,
+которые Android пишет до модема (QSB, Qtime, COMP_CFG, группы ресурсов, маршрут), теперь
+выставлены (`ipa_hardware_init()`), это не помогло. Следующие кандидаты: GSI со стороны
+модема (Android регистрирует GSI и поднимает свои каналы до модема — возможно, модему нужны
+прерывания/`GSI_EE` общие регистры), голоса шины `SN8`/`SH0`/`MC0`/`ACV` (имена есть в cmd_db) на
+время рукостискания, и чтение через adb того, что делает модем Android в первые 11 мс после
+INIT_DRIVER (`/d/ipc_logging/gsi/log` вокруг 33.31 с).
+
+### Прогони 24–26 (ранок 24 жовтня)
+
+- 24 (`skip_uc_load=1`): модем падає інакше — `ipa_qsh.c:1241: IPA_QSH failed to send analysis to
+ IPA_CTL msgQ`: черга задачі IPA_CTL переповнена, задача стоїть незалежно від мікроконтролера.
+- 25: TrustZone кладе сегменти образу IPA у внутрішню пам'ять GSI (0x1e1f000) і мікроконтролера
+ (0x1e81000) байт у байт (перевірено читанням), `GSI_CFG` = 0x205 — як пише `gsi_enable_fw()`.
+ Прошивка GSI увімкнена, адреса образу в DDR (0x8b700000 чи 0x8b710000, як у Android) ні на що не
+ впливає. Сегмент мікроконтролера — лише 0x3c8 байт: завантажувальний стаб; повну прошивку йому
+ дає модем. Пробний запит службі IPA модема відповідається за 1 мс, INIT_DRIVER — ніколи.
+- 26: Android при старті драйвера виділяє в SMEM (розділ apps–modem) елемент
+ `SMEM_IPA_FILTER_TABLE` (497) на 0x9000 байт (`qcom,ipa-q6-smem-size`) і відображає його в
+ SMMU-контекст IPA: модем кладе туди свої таблиці фільтрів. Тепер елемент робиться на кроці 6
+ (раніше, 22 жовтня, його вимкнули: без працюючого IPA модем, знайшовши елемент, падав до появи
+ служб). `modem_ipa_item=0` — не робити.
+
+### Прогін 28 (08:49): РУКОСТИСКАННЯ IPA ПРОЙШЛО
+
+Розгадка — у рядках образу модема: `IPA_SMP2P: Could not wait for inbound SMP2P channel
+readiness`. Драйвер IPA модема при ініціалізації чекає, поки в елементі SMP2P процесора
+застосунків з'явиться запис «ipa» (у Android він є з завантаження: `qcom,smp2p-ipa-1-out`), і без
+нього задача IPA_CTL стоїть вічно — звідси мовчання на INIT_DRIVER і падіння `enl2_dl`. З
+`modem_ipa=3` (запис «ipa» = біт 0 «відповідь дійсна» + біт 1 «такт IPA увімкнено») модем за 10 мс
+**прийняв INIT_DRIVER**, надіслав INIT_MODEM_DRIVER_CMPLT, CONFIG і 27 правил фільтрів
+(INSTALL_FILTER_RULE). Впав на звірці ідентифікаторів правил з нашої відповіді
+(`ipa_ipfltr.c:6246`): `rule_id` у структурі правила лежить на зміщенні 168, не 163 — виправлено
+(прогін 29). Елемент SMEM 497 і голоси за шини (SN8, SH0, MC0, ACV) лишаються.
+
+### Прогони 29–30: модем живе, але не шукає мережу — SIM у другому слоті
+
+- 29: з вірними `rule_id` модем пережив установку правил, вийшов в ONLINE і прожив усі 120 с
+ опитування NAS, зупинився коректно. NAS: «registration 0 (none), CS 2, PS 2», радіоінтерфейс 0
+ (немає сервісу), сигналу нема — модем навіть не шукає.
+- 30: додані запити після ONLINE (`sim_probe()`): UIM Get Card Status (0x2f) — **слот 1: карта
+ ERROR (код 3), слот 2: PRESENT, USIM READY**; NAS Get System Selection Preference (0x34): режим
+ GSM|UMTS|LTE, вибір автоматичний; NAS Initiate Network Register (0x22) — відмова, помилка 37.
+ Android бачить ту саму SIM (Kyivstar, ICCID 8938…4340) активною. Первинна підписка (NAS, що
+ опитуємо) прив'язана до логічного слота 1 без картки — звідси «no service». Прогін 31: UIM
+ Switch Slot (0x46): логічний слот 1 → фізичний слот 2, потім повторні запити.
+- Прогони з `modem_step=11` тримають SpringBoard 600 с (телефон стоїть на логотипі Apple);
+ тепер `tools/modem-cycle.sh` бере `XL_SB_DELAY` з оточення, і прогін 31 — повне завантаження
+ iOS з модемом у фоні (`modem=1`).
+
+### Прогін 31 (09:12): повне завантаження iOS, перемикання слота, ПЕРШИЙ СИГНАЛ
+
+`XL_SB_DELAY=8` + `modem=1`: SpringBoard стартує одразу (телефон більше не стоїть на логотипі
+Apple під час тестів), модем піднімається у фоні. Після UIM Switch Slot (логічний 1 → фізичний 2)
+картка з'явилась у слоті 1 у стані «detected», і NAS уперше прочитав сигнал: **-80…-87 dBm,
+UMTS** — радіо працює, модем бачить мережу; реєстрації ще нема (помилка 37 на Initiate Network
+Register = `UIM_UNINITIALIZED`: SIM ще ініціалізується після перемикання). Тепер крок 11 раз на
+10 с питає стан картки та NAS Get System Info (0x4d).
+
+Статус-бар: у SpringBoard iOS 16.5 стільникові пункти заповнює `SBStatusBarStateAggregator`
+через `_updateSignalStrengthItem:withData:SIMInfo:barsGetter:barsSetter:` і `_setItem:enabled:`
+(селектори знайдені в кеші dyld). `inject_sb.c` тепер перехоплює цей метод: коли
+`kern.redwood.cellular_registered`, виставляє палички через barsSetter і вмикає пункт; раз на 3 с
+просить пункт оновитися, коли стан у ядрі змінюється; список методів агрегатора пишеться в лог.
+
+### Прогін 32 (25 жовтня): хук статус-бару живий; підписка ні до чого не прив'язана
+
+- Хук у SpringBoard працює: `_updateSignalStrengthItem:withData:SIMInfo:barsGetter:barsSetter:`
+ викликається для пунктів 4 (основна SIM) і 5 (друга), setter-и передаються, і за нашим
+ проханням пункт оновлюється; повний список методів агрегатора є в лозі
+ (`_postItem:withState:inList:`, `_updateBatteryItems`, …).
+- UIM після перемикання слота: USIM у логічному слоті 1 READY, PIN1 вимкнений, але **первинний
+ GW-додаток — 0xffff (немає)**, і NAS System Info показує service 4 (power save) по всіх радіо.
+ Тобто підписці не призначено USIM. Прогін 33: UIM Change Provisioning Session (0x38): primary GW,
+ activate, слот 1 + AID USIM, потім повторне Initiate Network Register.
+- Прогони з самим модемом не вмикали решту заліза: GPU (`gpu=1`), DSP/батарея (`adsp=1`),
+ вібро (`haptic=5`), Wi-Fi (`wifi=1`) — звідси «no GPU to draw with», `SOC=-1%`, без вібрації.
+ Прогін 33 — з усім разом. Тач працює, коли екран увімкнений (iOS гасить його через ~25 с
+ бездіяльності; кнопка живлення будить).
+
+### Прогони 33–34: усе залізо разом
+
+- 33 (`gpu=1 adsp=1 sound=4 wifi=1 haptic=5 modem=1`): ядро стартувало, і телефон зник з USB у перші
+ секунди — як у прогоні 31. 32-й (той самий `modem=1`, але без GPU/DSP/Wi-Fi/вібро) прожив 10 хвилин.
+ У коді модема є давня примітка: після старту DSP Wi-Fi старт модема скидав телефон. Прогін 34 — те
+ саме без `wifi=1`, щоб звузити винуватця.
+- 33-й також перший із provisioning-сесією UIM (0x38): результат ще не отримано.
diff --git a/docs/metal.md b/docs/ru/metal.md
similarity index 100%
rename from docs/metal.md
rename to docs/ru/metal.md
diff --git a/docs/notes.md b/docs/ru/notes.md
similarity index 98%
rename from docs/notes.md
rename to docs/ru/notes.md
index 1605994..60bd6df 100644
--- a/docs/notes.md
+++ b/docs/ru/notes.md
@@ -1,6 +1,6 @@
# HakiOS: подробные заметки по разработке
-> Это прежний README целиком — история работы, измерения и устройство каждой части. Краткое введение теперь в [README.md](../README.md).
+> Это прежний README целиком — история работы, измерения и устройство каждой части. Краткое введение теперь в [README.md](../../README.md).
**HakiOS** — iOS 16.5 на POCO X5 Pro 5G (redwood). Открытое ядро Apple XNU (xnu-8796.121.2 — ядро iOS 16.5), свой загрузчик и свои замены закрытых драйверов,
@@ -32,7 +32,7 @@
| Сохранение данных: то, что iOS записала в `/private/var`, переживает перезагрузку телефона — архивом в разделе `darwin` (`var_store=1 ufs_write=1`, см. «Том данных между загрузками») | |
| Звук iOS и в QEMU (см. ниже; «Сейчас играет» — с оговоркой), и на самом телефоне: динамики играют то, что играет iOS (`adsp=1 sound=4`, по умолчанию на 30 дБ тише уровня Android), приложения записывают с его главного микрофона (`adsp=1 mic=4`: «Диктофон» пишет и рисует волну); громкость кнопок и Пункта управления — тоже | Из микрофонов поднят только нижний. Звук внутри сеанса съёмки — отдельный путь, и его нет (см. строку про камеру) |
| Камера телефона в самой Camera.app (`cam=5`, см. `cam=N` в «На телефоне»): задняя и фронтальная, живой предпросмотр, цвета по тюнингу самих камер, автофокус и фокус касанием, зум, снимки в HEIC | Видео и Live Photo: звук сеанса съёмки идёт не через микрофон ядра, а через посреднический плагин аудио-HAL, которого на этом телефоне нет — узел звука отвечает `'nope'` (`inject_media.c`) |
-| Sileo и префикс Procursus — dpkg и apt, установка пакетов из сети (`tools/mk-jb.sh`, см. «Sileo») | App Store **рисует свой интерфейс** (20 октября, ветка `services`): карточка «Welcome to the App Store», выбор про персонализированную рекламу и сам магазин с панелью вкладок Today, Games, Apps, Arcade, Search. Это `JetEngine`, рисующий тот документ, приход которого мы видели целиком, — без Apple ID, SIM и активации, по Wi-Fi телефона. **Содержимое вкладки Today не приходит**: магазин пишет в теле «Cannot Connect to App Store» с кнопкой Retry ((снимок экрана удалён из репозитория)). И это **не сеть** — за содержимым запрос не уходит вовсе: таблица задач показывает те же пять запросов (мешок трижды, `jetpack` дважды, все 200), а среди всех ошибок, созданных в приложении за сеанс, **нет ни одной из `NSURLErrorDomain`**. Ничего сетевого не падало, потому что ничего сетевого и не затевалось. Зато 24 раза создаётся `NSCocoaErrorDomain 4099` — это `NSXPCConnectionInterrupted`, а **не** `4097` (`Invalid`): собеседника не «не нашли», он умер посреди разговора, поэтому и строк `failed lookup` нет ни одной. След сошёлся: за тот же прогон умирает ровно одна служба — **`com.apple.fairplayd.H2`, двадцать шесть раз**, каждый раз `exit(0)` и «Service only ran for 0 seconds»; `appstored` при этом жив весь прогон (его собственные отчёты идут 315, 330, 345 … 510 с, часы ни разу не сбрасываются). Цепь целиком: запрос за содержимым требует подписи FairPlay → служба подписи умирает мгновенно → соединение рвётся → запрос не изготавливается → «Cannot Connect to App Store», ни одного обращения в сеть. **Это и есть то, что надо починить, чтобы «Сегодня» загрузилась**, и задача ограниченная: удержать `fairplayd.H2` живым. Разбор самого демона статикой сузил вопрос и снял первого подозреваемого: в `usr/sbin/fairplayd.H2` **не импортируются** ни `__mac_syscall`, ни `sysctl`, ни `exit`, а в его коде нет ни одной инструкции `svc` — значит и те 12 запросов к AMFI, и 33 `sysctl` из трассы принадлежат dyld и libSystem, а не его решению; отказ же MAC от ядра убивал бы процесс, а не давал чистый ноль. Уходит он **возвратом из `main`** (арифметика обфускатора даёт ровно 0), рано — до IOKit и до регистрации своей службы, а 26 смертей за прогон это `KeepAlive` в его `plist`, то есть одна и та же смерть в цикле. Точную ветку статикой не достать: бинарь защищён обфускатором FairPlay со сглаженным потоком управления и зашифрованной таблицей переходов. Зато он зовёт `MGCopyAnswer` и `SecTaskCopyValueForEntitlement` **через границу образов**, то есть подмена dyld их видит — это и есть следующий прибор. Прежняя запись здесь говорила, что магазин остаётся на индикаторе загрузки и за содержимым не ходит ни разу: и то и другое было верно по факту и неверно по смыслу — приложение стояло на первом экране приветствия и ждало нажатия, а под «LOADING» была карточка, которую никто не нажал. После «Continue» и «Turn Off» запросов становится пять вместо четырёх. Мешок настроек из подозреваемых выбыл: из 48 запрошенных ключей 31 отвечен, 17 нет, и ни один из семнадцати не про содержимое (метрики, TestFlight, пороги онбординга, таймауты)|
+| Sileo и префикс Procursus — dpkg и apt, установка пакетов из сети (`tools/mk-jb.sh`, см. «Sileo») | App Store **рисует свой интерфейс** (20 октября, ветка `services`): карточка «Welcome to the App Store», выбор про персонализированную рекламу и сам магазин с панелью вкладок Today, Games, Apps, Arcade, Search. Это `JetEngine`, рисующий тот документ, приход которого мы видели целиком, — без Apple ID, SIM и активации, по Wi-Fi телефона. **Содержимое вкладки Today не приходит**: магазин пишет в теле «Cannot Connect to App Store» с кнопкой Retry (). И это **не сеть** — за содержимым запрос не уходит вовсе: таблица задач показывает те же пять запросов (мешок трижды, `jetpack` дважды, все 200), а среди всех ошибок, созданных в приложении за сеанс, **нет ни одной из `NSURLErrorDomain`**. Ничего сетевого не падало, потому что ничего сетевого и не затевалось. Зато 24 раза создаётся `NSCocoaErrorDomain 4099` — это `NSXPCConnectionInterrupted`, а **не** `4097` (`Invalid`): собеседника не «не нашли», он умер посреди разговора, поэтому и строк `failed lookup` нет ни одной. След сошёлся: за тот же прогон умирает ровно одна служба — **`com.apple.fairplayd.H2`, двадцать шесть раз**, каждый раз `exit(0)` и «Service only ran for 0 seconds»; `appstored` при этом жив весь прогон (его собственные отчёты идут 315, 330, 345 … 510 с, часы ни разу не сбрасываются). Цепь целиком: запрос за содержимым требует подписи FairPlay → служба подписи умирает мгновенно → соединение рвётся → запрос не изготавливается → «Cannot Connect to App Store», ни одного обращения в сеть. **Это и есть то, что надо починить, чтобы «Сегодня» загрузилась**, и задача ограниченная: удержать `fairplayd.H2` живым. Разбор самого демона статикой сузил вопрос и снял первого подозреваемого: в `usr/sbin/fairplayd.H2` **не импортируются** ни `__mac_syscall`, ни `sysctl`, ни `exit`, а в его коде нет ни одной инструкции `svc` — значит и те 12 запросов к AMFI, и 33 `sysctl` из трассы принадлежат dyld и libSystem, а не его решению; отказ же MAC от ядра убивал бы процесс, а не давал чистый ноль. Уходит он **возвратом из `main`** (арифметика обфускатора даёт ровно 0), рано — до IOKit и до регистрации своей службы, а 26 смертей за прогон это `KeepAlive` в его `plist`, то есть одна и та же смерть в цикле. Точную ветку статикой не достать: бинарь защищён обфускатором FairPlay со сглаженным потоком управления и зашифрованной таблицей переходов. Зато он зовёт `MGCopyAnswer` и `SecTaskCopyValueForEntitlement` **через границу образов**, то есть подмена dyld их видит — это и есть следующий прибор. Прежняя запись здесь говорила, что магазин остаётся на индикаторе загрузки и за содержимым не ходит ни разу: и то и другое было верно по факту и неверно по смыслу — приложение стояло на первом экране приветствия и ждало нажатия, а под «LOADING» была карточка, которую никто не нажал. После «Continue» и «Turn Off» запросов становится пять вместо четырёх. Мешок настроек из подозреваемых выбыл: из 48 запрошенных ключей 31 отвечен, 17 нет, и ни один из семнадцати не про содержимое (метрики, TestFlight, пороги онбординга, таймауты)|
| | Вход в учётную запись Apple и iCloud: упирается не в сеть и не в пароль, а в **отсутствие Secure Enclave**. `mobileactivationd` не может создать ключ устройства (`0xe00002c7`, `kIOReturnUnsupported` — наша заглушка `MiniAppleKeyStore` умеет keybag и не умеет UIK), поэтому нет записи активации и устройственного сертификата, поэтому `apsd` не получает push-токен (`copyTokenForDomain push.apple.com (null)`), поэтому `akd` не делает check-in. Каждое звено измерено в журналах. При этом сеть и мешок GrandSlam работают: `akd` ходит на `gsa.apple.com` уже сейчас, без учётной записи. Вторая опора, которой нет: личность устройства **выдумана загрузчиком** — серийный номер `RDW00POCOX5P`, MLB и ECID тоже наши. MobileGestalt у нас настоящая, из образа, и отвечает по дереву устройств, которое строит загрузчик: ключи семейства UDID она соберёт и выдаст — складно и устойчиво, но из выдуманного, — а `HasSEP`, `secureElementID`, `EffectiveProductionStatusSEP` и прочее вернут nil, потому что таких узлов мы не публикуем вовсе |
| SSH на телефон по ключу (`RC_JOBS=rc.jobs.ssh`, OpenSSH из префикса; `init` при каждой сборке префикса строит `/var/jb/etc/pwd.db`, без которой ни одна программа префикса не видит root) | |
@@ -407,7 +407,7 @@ XL_SECS=900 XL_CMDLINE="touchscreen=1 cpufreq=1 bootcpu=7 cpus=8" ./xl run #
## GPU
**iOS на телефоне может рисовать графический процессор** — Adreno 642L, через открытый драйвер Mesa freedreno
-и наш драйвер в ядре ((снимок экрана удалён из репозитория): треугольник, экран блокировки, домашний экран).
+и наш драйвер в ядре (: треугольник, экран блокировки, домашний экран).
Как это устроено:
@@ -2107,14 +2107,14 @@ std::make_exception_ptr<std::future_error>
**App Store рисует свой интерфейс.** Когда последние ожидания AMS были сняты (см. ниже) и перехват
перестал ронять сам демон, магазин прошёл свой первый запуск по шагам и нарисовал их все:
-(снимок экрана удалён из репозитория) — карточка «Welcome to the App Store» с кнопкой «Continue»;
-(снимок экрана удалён из репозитория) — выбор про персонализированную рекламу («Turn Off» — честный ответ для
-телефона без учётной записи); (снимок экрана удалён из репозитория) — собственно магазин: панель вкладок
+ — карточка «Welcome to the App Store» с кнопкой «Continue»;
+ — выбор про персонализированную рекламу («Turn Off» — честный ответ для
+телефона без учётной записи); — собственно магазин: панель вкладок
**Today, Games, Apps, Arcade, Search**, выбрана Today. Это JetEngine, рисующий тот самый документ,
который мы видели приходящим целиком. Содержимое вкладки Today на этом снимке ещё грузится.
**Дальше магазин говорит, чего ему не хватает, сам:** после онбординга он рисует свою панель вкладок и
-показывает в теле **«Cannot Connect to App Store»** с кнопкой Retry ((снимок экрана удалён из репозитория)).
+показывает в теле **«Cannot Connect to App Store»** с кнопкой Retry ().
И это не сеть. В таблице задач по-прежнему те же пять запросов (мешок трижды, `jetpack` дважды), а
среди всех ошибок, которые приложение создаёт за сеанс, **нет ни одной из `NSURLErrorDomain`** — то
есть ничего сетевого не падало, запрос за содержимым просто не делается. Что приложение создаёт:
diff --git a/xnu/README.md b/xnu/README.md
index da37ad0..b2febef 100644
--- a/xnu/README.md
+++ b/xnu/README.md
@@ -1,102 +1,63 @@
-# Ядро
+# The kernel
-Наши правки XNU `xnu-8796.121.2` (ядро iOS 16.5, Darwin 22.5.0):
+Our changes to XNU `xnu-8796.121.2` (the kernel of iOS 16.5, Darwin 22.5.0):
-- `redwood.patch` — изменения в файлах Apple (60 файлов);
-- `files/` — новые файлы по их путям в дереве XNU (37 файлов);
-- `apply.sh` — берёт исходники у Apple и накладывает всё это; `export.sh` — обратное действие.
+- `redwood.patch`: changes to Apple's files;
+- `files/`: new files at their paths in the XNU tree;
+- `apply.sh`: fetches the sources from Apple's GitHub and lays all of this over them;
+ `export.sh`: the reverse, run before committing.
-Собирается на Linux стоковым clang, без macOS и Xcode, — и на macOS с Xcode (ниже, «Сборка на macOS»).
+It builds on Linux with stock clang (no macOS, no Xcode) and on macOS with Xcode.
-## Сборка
+## Build
-Нужно:
-
-- пакеты (Arch): `sudo pacman -S --needed base-devel git curl clang lld python perl xz`;
-- [theos](https://theos.dev/docs/installation-linux) в `~/theos` (или в `$THEOS`): из него берутся cctools
- (`toolchain/linux/iphone/bin`: линкер ld64, nm, otool, strip…) и `sdks/iPhoneOS16.5.sdk`.
+Linux (Arch): `sudo pacman -S --needed base-devel git curl clang lld python perl xz`, and
+[theos](https://theos.dev/docs/installation-linux) in `~/theos` (or `$THEOS`) for its cctools
+(`ld64`, `nm`, `otool`, `strip`) and `sdks/iPhoneOS16.5.sdk`. macOS: Xcode and MacPorts coreutils;
+`xnu-deps/setup.sh` lays out `xnu-deps/theos-mac` itself.
```sh
-xnu/apply.sh # ~6 с: тег xnu-8796.121.2 из apple-oss-distributions/xnu + наши правки
- # → xnu-src/xnu-8796.121.2, ветка redwood, правки не закоммичены
-xnu-deps/setup.sh # ~30 с: исходники зависимостей, mig/unifdef/tcsh, SDK-надстройка, две библиотеки
-./xnu-build.sh -j8 -k # ~45 с на 12 потоках
+xnu/apply.sh # the xnu-8796.121.2 tag from apple-oss-distributions/xnu + our changes -> xnu-src/
+xnu-deps/setup.sh # dependencies, mig/unifdef/tcsh, the SDK overlay, two libraries
+./xnu-build.sh -j8 -k # about a minute on 12 threads
```
-Результат: `xnu-src/xnu-8796.121.2/BUILD/obj/DEVELOPMENT_ARM64_BCM2837/mach.development.bcm2837`.
-`./xl run` и `qemu/run-ios.sh` берут ядро оттуда сами (а `prebuilt/` — только когда его нет).
-
-Проверено: в пустом каталоге, где лежало только содержимое репозитория, эти три команды дали ядро того же
-размера и с тем же набором символов (49 407), что и рабочее. Диск: ~600 МБ, не считая theos.
-
-Что нужно знать:
-
-- **`-k` обязателен.** Единственная ошибка сборки — установка lldbmacros (make завершается с кодом 2) — безвредна.
-- В пути к репозиторию не должно быть пробелов (makefile'ы XNU их не переживают).
-- Обёртка `xnu-deps/host/bin/xnu-clang` зовёт `/usr/bin/clang`. Проверено с clang 22.1.8.
-- После правки заголовков ядра, которые видят две внешние библиотеки (pthread kext, firehose):
- `xnu-deps/setup.sh --rebuild-libs`.
-- DriverKit-генератор Apple (`iig`) закрыт. Вместо него — заглушки `xnu-deps/iig-impl/OSObject.iig.cpp`,
- сгенерированные по списку неопределённых символов линкера. Если набор изменится:
- `xnu-deps/gen-iig-stubs.py xnu-deps/iig-impl/undefined-all.txt xnu-deps/iig-impl qemu/kernel.syms`, затем `rm -rf BUILD`.
-- Для `qemu/sym.py` после пересборки: `nm -n …/mach.development.bcm2837.unstripped > qemu/kernel.syms`.
-
-## Сборка на macOS
-
-Те же три команды. theos не нужен: `xnu-deps/setup.sh` на Darwin сам складывает `xnu-deps/theos-mac`
-(ссылки на cctools из Xcode, iPhoneOS16.5.sdk из github.com/theos/sdks частичным клоном, ~220 МБ)
-и берёт mig, unifdef и csh системные. Нужны Xcode (проверено с 26.5, Apple clang 21) и MacPorts с
-coreutils (`gstat`, `gtimeout` — для `xl`). `host/bin/ld64` там — обёртка, а не ссылка: ld из Xcode
-ищет себя по имени, под которым вызван. Ядро, собранное так, загружается на телефоне и возвращается в
-загрузчик как и собранное на Linux. `xl` на Mac берёт `flock`, `timeout`, `stat` и platform-tools из
-`tools/macos-bin` (см. README там).
+The kernel: `xnu-src/xnu-8796.121.2/BUILD/obj/DEVELOPMENT_ARM64_BCM2837/mach.development.bcm2837`.
+`./xl run` and `qemu/run-ios.sh` take it from there (`prebuilt/` only when it is missing).
-## Работа с деревом
+Things to know:
-Правки делаются прямо в `xnu-src/xnu-8796.121.2` (обычное git-дерево Apple на ветке `redwood`). Перед коммитом
-в этот репозиторий — `xnu/export.sh` (перегенерирует патч и `files/`), а чтобы обновить готовое ядро в
-`prebuilt/` — `tools/update-prebuilt.sh`.
+- `-k` is required: the build always ends with an error in `check_all_exports` (export lists), after
+ the kernel has been linked. Look at the file's date, not at make's exit code.
+- No spaces in the repository's path.
+- After changing kernel headers that the two external libraries see: `xnu-deps/setup.sh --rebuild-libs`.
+- Apple's DriverKit generator (`iig`) is closed; `xnu-deps/iig-impl/` holds stubs generated from
+ the linker's undefined symbols (`xnu-deps/gen-iig-stubs.py`).
+- Edit `xnu-src/xnu-8796.121.2` directly (a git tree on branch `redwood`); `xnu/export.sh`
+ regenerates the patch and `files/` from the whole tree, so bring the tree up to the current patch
+ first if somebody else changed the kernel meanwhile.
-**Две ловушки, каждая стоила по сборке.**
+## What is added
-`export.sh` перегенерирует патч **из вашего дерева целиком**, а не из ваших изменений. Если дерево отстало от
-ветки — кто-то правил ядро после того, как вы развернули своё, — экспорт тихо откатит чужую работу: патч
-получится без их файлов. Перед экспортом приводите дерево к текущему патчу (`git checkout -- .` в `xnu-src`,
-затем `git apply xnu/redwood.patch` и `cp -a xnu/files/. .`), а если правка одна, честнее вклеить в патч её
-диф руками и сказать об этом в коммите. Признак отставшего дерева после сборки — ядро собирается и **падает
-на загрузке** сразу после `Stackshot Succeeded`.
-
-Сборка ядра здесь **штатно заканчивается ошибкой** `check_all_exports` (символы IOKit в `config/`): это
-проверка списков экспорта, а не компиляция. Сам `mach.development.bcm2837` к этому моменту уже слинкован и
-годен — смотрите на дату файла, а не на код возврата `make`. Ошибка была и до всех наших правок.
-
-## Что добавлено в ядро
-
-| Файлы | Что |
+| Files | What |
|---|---|
-| `osfmk/arm64/gic_v3_irq.c`, `generic_arm64_support.c`, `kpc.c`, `ppl/`, `tunables/` | платформа: GICv3, таймер, заглушки вырезанных Apple файлов |
-| `osfmk/arm64/psci_smp.c` | несколько процессоров: запуск ядер через PSCI (boot-arg `cpus=N`), их остановка перед возвратом в загрузчик |
-| `osfmk/arm64/loader_return.c` | возврат в загрузчик с журналом, «сердцебиение», сторожевой таймер гипервизора Qualcomm |
-| `osfmk/arm64/user_exception_trace.c` | отладка userland: `usertrap:`, `userabort:`, стеки потоков (`ustacks`) |
-| `osfmk/minicrypto/` | замена corecrypto: MD5/SHA-1/SHA-2, HMAC, DRBG, AES (исходники Apple corecrypto не использованы) |
-| `iokit/Kernel/GenericARMPE.cpp` | эксперт платформы и CPU |
-| `iokit/Kernel/MiniIOSurface.*`, `MiniIOMobileFramebuffer.cpp`, `MiniAppleKeyStore.cpp` | замены закрытых драйверов: поверхности, экран (с масштабированием в панель и записью экрана), хранилище ключей |
-| `bsd/miscfs/apfs/`, `bsd/miscfs/ramfs/` | свои ФС: APFS только для чтения (корень на флеше и образы в памяти) и записываемая ФС в памяти |
-| `bsd/kern/kern_minimac.c`, `libkern/amfi/` | заглушки AMFI и Sandbox (MAC-политики), права из подписи программы |
-| `bsd/dev/redwood_input.c`, `redwood_goodix.c`, `redwood_virtio_input.c` | ввод: `/dev/redwood-touch`, драйвер Goodix GT9916 (SPI бит-бангом по GPIO), virtio-input для QEMU |
-| `bsd/dev/redwood_cpufreq.c` | частота процессора (Qualcomm EPSS) |
-| `bsd/dev/redwood_net.c`, `bsd/sys/redwood_net.h`, `redwood_virtio_net.c` | сетевой интерфейс `en0` через сетевой KPI ядра (без IONetworkingFamily) и граница между ним и тем, что носит кадры («линк»: три функции в `redwood_net.h`); первый линк — virtio-net для QEMU |
-| `bsd/dev/redwood_adreno.c`, `iokit/Kernel/RedwoodGPU.cpp` | GPU телефона (Adreno 642L): пошаговое включение (`adreno=N`: питание, GMU, zap-шейдер, микрокод), буферы и очередь команд; клиент IOKit с подмножеством msm DRM для Mesa |
-| `bsd/dev/redwood_wifi.c`, `bsd/sys/redwood_qrtr.h` | Wi-Fi телефона (WCN6750), начало пути (`wifi=N`): общая память процессоров Qualcomm (SMEM: чтение и выделение под её замком), сигнальные биты между нами и процессором Wi-Fi (SMP2P, обе стороны), почтовый ящик процессора питания, загрузка прошивки процессора Wi-Fi, его запуск через TrustZone и остановка по просьбе, GLINK (очереди в общей памяти, канал IPCRTR) и QRTR поверх него; `redwood_qrtr.h` — порт датаграмм для остального ядра (открыть, послать, найти службу, закрыть) |
-| `bsd/dev/redwood_qmi.c`, `bsd/sys/redwood_qmi.h` | QMI — протокол сообщений служб на процессорах Qualcomm: кодирование по таблицам, запросы с ответами, оповещения; интерфейс как у Linux (`qmi_*`), чтобы `qmi.c` из ath11k собирался без правок, реализация своя; проверяется на компьютере (`tools/qmi-test/run.sh`) |
-| `bsd/dev/redwood_nas.c`, `bsd/sys/redwood_nas.h` | клиент QMI NAS поверх заданного QRTR: регистрация в сети и уровень сигнала; не показывает сигнал без регистрации. Проверка на компьютере: `tools/qmi-test/run-nas.sh`. Для работы на телефоне требуются отдельный транспорт MPSS и подключение к CoreTelephony |
-| `bsd/dev/redwood_mpss.c` | модем (MPSS): путь аудио-DSP с числами модема (`modem=N`, `modem_step=N`): прошивка из `/fw`, TrustZone (образ 4), шины CX/MSS, SMP2P, GLINK, QRTR с портами для QMI; наша служба RMTFS (QMI 14: файловые системы модема из разделов UFS, в памяти, без записи на флеш) и сервис имён QRTR; DMS «online» и клиент NAS → `sysctl kern.redwood.cellular_*`. Проверено: модем стартует и отвечает; RMTFS ещё не проверен (docs/cellular.md) |
-| `bsd/dev/redwood_wlfw.c` | временная замена `qmi.c` из ath11k: разговор со службой прошивки Wi-Fi вручную, в его порядке и его сообщениями (шаг 15 `wifi=N`); описания сообщений берутся из исходников ath11k при сборке (`tools/mk-wlfw.sh`) и в git не попадают |
-| `bsd/dev/redwood_audio.c`, `redwood_virtio_sound.c`, `redwood_speaker.c` | звук: `/dev/redwood-audio` (куда наше устройство вывода в mediaserverd пишет то, что играет iOS), запись его в память, virtio-sound для QEMU; первый взгляд на усилители динамиков телефона |
-| `bsd/pthread/pthread_kext_static.c` | pthread kext, слинкованный в ядро |
-
-Патч, помимо врезок под всё это, чинит то, что мешает собрать и запустить открытый XNU вне Apple: makefile'ы под
-Linux, конфигурацию `BCM2837` (она взята за основу), ошибки в заброшенном коде (mockfs, не-PPL pmap, percpu на одном
-процессоре) и т. п.
-
-Лицензия: производная работа от XNU, APSL 2.0.
+| `osfmk/arm64/gic_v3_irq.c`, `generic_arm64_support.c`, `psci_smp.c`, `loader_return.c` | the platform: GICv3, the timer, several CPUs through PSCI, the return to the loader with the log, the hypervisor watchdog |
+| `osfmk/minicrypto/` | a replacement for corecrypto (MD5, SHA, HMAC, DRBG, AES) |
+| `iokit/Kernel/GenericARMPE.cpp`, `MiniIOSurface.*`, `MiniIOMobileFramebuffer.cpp`, `MiniAppleKeyStore.cpp` | the platform expert and replacements for closed drivers: surfaces, the display, the key store |
+| `bsd/miscfs/apfs/`, `bsd/miscfs/ramfs/` | read-only APFS and a writable RAM file system |
+| `bsd/kern/kern_minimac.c`, `libkern/amfi/` | AMFI and Sandbox stubs |
+| `bsd/dev/redwood_input.c`, `redwood_goodix.c` | input: `/dev/redwood-touch`, the Goodix GT9916 touch controller |
+| `bsd/dev/redwood_cpufreq.c` | CPU clocks (Qualcomm EPSS) |
+| `bsd/dev/redwood_net.c`, `redwood_virtio_net.c` | the `en0` network interface |
+| `bsd/dev/redwood_adreno.c`, `iokit/Kernel/RedwoodGPU.cpp` | the Adreno 642L GPU |
+| `bsd/dev/redwood_wifi.c`, `redwood_wlfw.c` | Wi-Fi (WCN6750): shared memory, the radio's DSP, the driver |
+| `bsd/dev/redwood_qmi.c`, `redwood_nas.c` | QMI and the NAS client |
+| `bsd/dev/redwood_mpss.c` | the modem: firmware, file systems, IPA, SIM, registration |
+| `bsd/dev/redwood_audio.c`, `redwood_adsp.c`, `redwood_speaker.c`, `redwood_mic.c` | sound through the audio DSP; the battery comes through it too |
+| `bsd/dev/redwood_haptic.c`, `redwood_camera.c`, `redwood_ufs.c` | the vibration motor, the cameras, the UFS storage |
+| `bsd/pthread/pthread_kext_static.c` | the pthread kext linked into the kernel |
+
+The patch also fixes what keeps open XNU from building and running outside Apple: the makefiles
+on Linux, the `BCM2837` configuration it is based on, bugs in abandoned code.
+
+License: a derivative work of XNU, Apple Public Source License 2.0 (`LICENSE.APSL` at the top).