commit 7806f9802d2e3d7d4e1952f663386026c93b5449 Author: nikita Date: Fri Jan 9 04:31:30 2026 +0300 Add README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..d916cad --- /dev/null +++ b/README.md @@ -0,0 +1,25 @@ +# Сборки прошивок ClearCore +В этом репоизтории хранятся сборки прошивок ClearCore. Здесь можно найти как **old** прошивки, так и **modern** прошивки. Разница в следующем: + +## Кратко для опытных +|Бинарник|Что содержит|Способ прошивки|Как часто нужно| +|--|--|--|--| +|bootrec|bootloader+recovery|Только USB-B|Единожды для каждого ClearCore| +|fw|firmware|Только по сети|Часто| +|rec|recovery|Только по сети|Очень-очень редко| + +## old прошивки +К **old** прошивкам относятся прошивки, которые были в самом начале проекта. То есть прошивки, которые не поддерживают кастомный загрузчик и обновление по сети. Эти прошивки сначала разрабатывались Богданом, затем стали разрабатываться самим Росквестом. Прошивки, сделанные Росквестом без Богдана, именуются брейнрот персонажами. + +## new прошивки +К **new** прошивкам относятся прошивки, которые поддерживают работу с кастомным загрузчиком и с обновлением по сети. Существуют следующие типы прошивок: +* `bootloader` - кастомный загрузчик. Обязательно должен быть прошит, чтобы работали `firmware` и `recovery`. Загрузчик - это переходный этап в процессе запуска ClearCore, который позволяет запустить Recovery или основную прошивку. Релизы всегда содержат бинарный файл, который включает в себя загрузчик. +* `recovery` - прошивка "Recovery". Загрузчик запускает эту прошивку, если невозможно запуститься правильно, или если было запрошено обновление прошивки. Обновление прошивки по сети всегда производится через Recovery. ClearCore, запущенный в Recovery, не определяется стандартными средствами и не позволяет двигать моторами. +* `firmware` - основная прошивка. Эта прошивка ближе всего по своему функционалу к любой **old** прошивке. Именно она способна двигать тилтами, выдвигаторами и домкратами. + +## Как прошивать релизы +* **old** прошивки всегда прошиваются вручную при помощи USB-B кабеля. К каждому ClearCore, требующему обновления прошивки, нужен физический доступ. +* **new** прошивки прошиваются следующими способами: + - бинарники, начинающиеся с `bootrec`, прошиваются исключительно при помощи USB-B кабеля. Эти бинарники подходят, если ClearCore нужно прошить впервые. В таких бинарниках содержится и `bootloader`, и `recovery`. *Однако важно иметь в виду, что после прошивки этих бинарников требуется обновление по сети, так как ClearCore не содержит основной прошвки.* + - бинарники, начинающиеся с `fw`, используются исключительно для обновления основной прошивки по сети. Эти бинарники содержат **основную прошивку**, которую чаще всего и нужно обновлять. + - бинарники, начинающиеся с `rec`, используются исключительно для обновления Recovery по сети. Эти бинарники содержат **Recovery**, который обычно обновлять не нужно. \ No newline at end of file