# Сборки прошивок ClearCore
В этом репоизтории хранятся сборки прошивок ClearCore. Здесь можно найти как **old** прошивки, так и **new** прошивки. Разница в следующем:

## Кратко для опытных
|Бинарник|Что содержит|Способ прошивки|Как часто нужно|
|--|--|--|--|
|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**, который обычно обновлять не нужно.