#Адаптация под устройство

hakios устроен так, что новый телефон — это новый репозиторий устройства, а не форк. Вы описываете телефон, загружаете ядро без единого его драйвера, а затем включаете железо по одному драйверу за раз. Здесь весь путь целиком; точные форматы — в справочнике: Port a device, How the repositories fit, Writing a driver.

#Подойдёт ли мой телефон?

Ещё понадобятся: UEFI для телефона (порт Mu-Silicium или HakiOS U-Boot), дерево устройств телефона и компьютер, на котором собирается ядро (см. Запуск в QEMU).

#План

1  описать телефон          tools/hakios-device.py new        → devices/<name>/ проходит `check`
2  загрузиться без него     make phone SECS=120               → сессия доходит до launchd и завершается сама
3  включить железо          по одному драйверу, по порядку    → каждый увиден работающим
4  записать, что работает   строки status в device.conf       → таблица устройств на сайте
5  опубликовать             ваш репозиторий + PR в манифест   → любой может сделать `sync` вашего телефона

#1. Описать телефон

Снимите дерево устройств, пока телефон работает в Android, и пусть инструмент создаст репозиторий:

adb pull /sys/firmware/fdt device-tree.dtb
tools/hakios-device.py new mydevice --soc sc7280 --title "My Phone" --vendor Someone --maintainer "you" --fdt device-tree.dtb
make mydevice_defconfig
make config

Что появится в devices/mydevice/:

device.conf                  что это за телефон и что на нём работает
configs/mydevice_defconfig   три строки: common_defconfig + <soc>.config + mydevice.config
configs/mydevice.config      CONFIG_DEVICE="mydevice", все драйверы телефона для начала выключены
soc/                         слой чипа: soc.conf и configs/<soc>.config
soc.args                     адреса чипа (soc_*), прочитанные из дерева устройств
README.md                    чек-лист того, что у телефона своё

Готово, когда проходит tools/hakios-device.py check mydevice.

#device.conf

device mydevice
	title       My Phone
	vendor      Someone
	soc         sc7280
	defconfig   mydevice_defconfig
	firmware    pull-firmware.sh
	maintainer  you
	status      display     partial   UEFI's framebuffer, through the loader (to be checked)

• Одна строка status <область> works|partial|missing <пояснение> на область. Области: display touch buttons cpu gpu storage audio battery haptic camera torch wifi bluetooth cellular network thermal usb sensors.
• works — только то, что вы видели работающим на телефоне. Написанное, но не проверенное — partial с пояснением, чего не хватает.
• Страницы устройств на сайте генерируются из этого файла (python3 tools/docs-gen.py) — не правьте их руками.

#Файлы, которые вы будете править

#2. Загрузиться без драйверов телефона

make kernel
make loader
make phone SECS=120          # аргументы берутся из вашего .config

Ищите в logs/last.log по порядку: баннер загрузчика, kernel.ver=, hakios-kernel: N drivers built in (...), затем launchd. Готово, когда сессия доходит до launchd, завершается сама и телефон возвращается.

#3. Включать железо по одному драйверу

Каждый драйвер ничего не делает без своего аргумента, а неудачный шаг пишет одну строку в лог и останавливается — поэтому неверный адрес стоит вам строки в логе, а не телефона. Идите в этом порядке: каждому шагу нужны предыдущие.

Для каждого драйвера:

1. Прочитайте комментарий в начале его файла в drivers/: там сказано, откуда на эталонном телефоне взят каждый адрес и каждое число.
2. Найдите тот же узел в своём дереве устройств.
3. Разложите отличия по местам: факт о чипе — во фрагмент слоя чипа, факт о телефоне — в configs/mydevice.config как аргумент.
4. Включите, запустите, прочитайте лог, повторите.

Для железа, которого нет в общем дереве (другой контроллер тача, eMMC вместо UFS, другой чип Wi-Fi), пишется свой драйвер: файл hakios.<name>.c и блок в drivers/<subsystem>/conf. Рецепт — Writing a driver; проверяет python3 tools/drivers-check.py.

#4. Записать, что работает

Обновите строки status, затем:

python3 tools/docs-gen.py               # страница устройства из device.conf
tools/hakios-device.py check mydevice

#5. Опубликовать

tools/hakios-device.py split mydevice ../hakios-device-mydevice

Опубликуйте как hakios-device-mydevice (или hakios-soc-<soc> для общего слоя чипа) и откройте pull request в основной репозиторий, который добавляет ваш блок в devices/manifest.conf. tools/hakios-device.py lock mydevice впишет туда ревизию. После этого любой сможет сделать tools/hakios-device.py sync mydevice.

#Правила для любого порта

• Никаких прошивок производителя, файлов Apple и настоящих серийных номеров ни в одном репозитории. Прошивки снимаются с собственного телефона пользователя в fw-*/, который git игнорирует.
• Порт, который копирует слой чипа, держит его идентичным всем остальным копиям; инструменты отказываются работать с двумя разными копиями и называют обе.
• Напишите в Telegram-канал, прежде чем начать: возможно, вашим телефоном уже кто-то занимается.