Для разработчиков кастомных и ремонтных прошивок, модификацией auto_update.txt

[Kenotronbot]

Руководство для разработчиков кастомных и ремонтных прошивок.

(Адаптированы для тех, кто занимается модификацией auto_update.txt, сборкой прошивок и работает с платформами MStar, CVT, Realtek и т.д.)

---

Сложности при сборке кастомных прошивок: отличия команд в auto_update.txt

Пособие для разработчиков и инженеров: как избежать ошибок при сборке BIN-образов

---

🛠 Почему пересобранная прошивка может не работать?

В процессе создания кастомных или ремонтных прошивок часто берут за основу готовую прошивку, выделяют конфигурацию (config.xml) и потом автоматически генерируют новую прошивку на её основе.

Но это может привести к ошибке: в одной и той же прошивке разные разделы могут использовать разные команды для записи, стирания или добавления данных!

---

Конкретный пример из практики:

В стандартном auto_update.txt могут использоваться следующие команды:

• mmc erase.p — базовая команда стирания раздела

• mmc erase.part — альтернативная команда стирания (встречается реже)

• mmc unlzo — распаковка и запись архива .img в раздел

• mmc unlzo.cont — запись второго/последующего куска (chunk'а) архива

• filepartload — загрузка куска образа в оперативную память

Важно: одна прошивка может использовать одновременно erase.p для одних разделов, и erase.part для других, как, например, в случае с tee.

---

Почему это критично?

При генерации прошивки по шаблону или стандартному конфигу можно упустить эти отличия. В результате:

• Секция не очищается перед записью;

• Неверно работает разметка раздела;

• Прошивка «зависает» на загрузке;

• OTA-переход не выполняется;

• Нарушается работа CI+, DRM, BOOT и др.

---

Пример оригинального скрипта установки (автоматический auto_update.txt)

# Раздел system
mmc erase.p system
filepartload 0x20200000 $(UpgradeImage) 0x23bc000 0x40ecbf1
mmc unlzo 0x20200000 0x40ECBF1 system 1
filepartload 0x20200000 $(UpgradeImage) 0x64a9000 0x62adad9
mmc unlzo.cont 0x20200000 0x62ADAD9 system 1

# Раздел tee
mmc erase.part tee
filepartload 0x20200000 $(UpgradeImage) 0xcccc000 0x140000
mmc unlzo 0x20200000 0x140000 tee 1

Видим, что:

• system очищается через erase.p

• tee — через erase.part

• запись происходит через unlzo и unlzo.cont

Если применить стандартный шаблон сборки — tee не будет очищен корректно, и обновление прервётся либо система уйдёт в бутлуп.

---

Какой подход использовать при сборке?

Вместо шаблона — использовать парсинг оригинального скрипта

Разделы следует не просто описывать по имени, а сохранять для каждого образа его собственные команды:

• EraseCommand — команда стирания

• WriteCommand — первая команда записи

• WriteChunkCommand — команда записи последующих частей

---

Новый формат конфигурации (пример)

<Image>
  <Name>system</Name>
  <Lzo>True</Lzo>
  <Split>True</Split>
  <Path>system.img</Path>
  <Command>
    <Erase>erase.p</Erase>
    <Write>unlzo</Write>
    <WriteChunk>unlzo.cont</WriteChunk>
  </Command>
</Image>

<Image>
  <Name>tee</Name>
  <Lzo>True</Lzo>
  <Split>False</Split>
  <Path>tee.img</Path>
  <Command>
    <Erase>erase.part</Erase>
    <Write>unlzo</Write>
  </Command>
</Image>

---

Идея по обработке команд загрузки (LoadCmd)

Ещё одно предложение — в конфиг добавить поле LoadRamCmd, куда вписывается шаблон загрузки filepartload:

<LoadRamCmd>filepartload 0x20200000 $(UpgradeImage)</LoadRamCmd>

На этапе сборки к нему просто добавляются offset и size:

filepartload 0x20200000 $(UpgradeImage) 0x23bc000 0x40ecbf1

Это исключает дублирование кода и сохраняет гибкость.

---

Резюме

Проблема	Решение
Команды для erase/flash могут отличаться	Парсить каждую отдельно из оригинального скрипта
Ошибки в OTA из-за erase.part	Учитывать erase.p и erase.part как отдельные сущности
write.cont не везде работает	Использовать writechunk как отдельное поле
Сложный шаблон auto_update	Генерировать скрипт из индивидуальных параметров

---

Вывод

Общий шаблон — не универсален.
Каждая прошивка — индивидуальна.
Только анализ оригинального скрипта установки позволяет собрать корректную рабочую прошивку.

---

🗂 Приложение: список платформ с замеченными отличиями

Платформа	Комментарий
CV338H	Часто используется erase.part для tee
CV358H-A42	Смесь unlzo и unlzo.cont
TP.MS338E.PB803	Частичный sparse, требует доп. очистки
RTD2851 (Realtek)	Уникальный парсер команд, не MStar совместимый

---

Делитесь опытом

Если вы столкнулись с такими случаями — выкладывайте свои конфиги, оригинальные скрипты, платформы.

Это поможет собрать базу для автоматизированной, но надёжной сборки.