Документация
Модифицированные прошивки и встроенные модули
Встроенные модули колеса, переход со старых плагинов, очистка банка и сброс настроек.
В новых прошивках LoEUC модули встроены в основной образ. Приложение включает и настраивает их, а исполняемый код плагинов больше не заливает. Для прошивки по-прежнему нужен образ именно вашей модели и заводской основы. Наличие сборки в реестре не означает проверку на живом колесе: статус проверки указан отдельно в карточке прошивки.
Распознавание и переход#
Приложение узнаёт хост модулей по свежему паспорту формата 2 и точному совпадению образа с реестром. Управление модулями доступно только для опознанной сборки. Карточка показывает модель, заводскую основу, сборку, возможности и статус проверки. Незнакомый образ требует отдельного подтверждения перед прошивкой.
Старые хосты плагинов доступны только для просмотра: узнать версию установленного плагина нельзя. Каталог остаётся справочником, без установки, снятия отдельных слотов и записи настроек. Очистка всего банка доступна даже без каталога и паспорта. Обновляйте приложение вместе с прошивкой. Хосты плагинов ABI 5 не выпускались и не являются целью перехода.
Хосты модулей Lynx-S, Oryx и Sherman P содержат температуры мотора, автоотключение, стояночную сигнализацию, ПИД с раздельным ассистом, диагностику линии зарядки, телеметрию силовой части и порог писка по ШИМ. У Lynx-S есть также потолок моментного тока. Коррекция скорости, автосвет и настраиваемое ослабление поля доступны у Lynx-S, Oryx b39 и Sherman P b14. NOSFET Aeon содержит температуру мотора, сигнализацию, диагностику зарядки и телеметрию, без ПИД и ассиста. Встроенные настройки Lynx 5, NOSFET Apex и Sherman L сохраняют свой интерфейс; приёмника плагинов у них нет, действия очистки банка тоже нет.
Как включить модули#
- Прошейте подходящий основной образ через «Обновление прошивки». Выполните проверки и подтверждения экрана, включая наклон; никогда не прошивайте на ходу.
- Подключитесь и откройте «Настройки колеса» → «Модули прошивки». Дождитесь распознавания.
- На парковке включите нужный модуль и откройте его редактор настроек. Переключатель показывает маску включённых модулей с колеса, а не предполагаемый результат нажатия.
При первом переходе всё, что меняет поведение колеса, выключено: ПИД/ассист, автоотключение, сигнализация, писк по ШИМ, потолок тока, коррекция скорости и автосвет. Модули данных включены: температуры мотора, телеметрия и диагностика зарядки. Прежние параметры сохраняются, но сохранённый параметр сам по себе не включает модуль, меняющий поведение.
Очистить банк плагинов#
Прошивка основного образа не стирает прежний банк плагинов. Монолит его не исполняет, но после отката на старый хост тот может запустить оставшееся содержимое. Перед возвратом к старой прошивке очистите банк.
«Очистить банк плагинов» стирает все 32 страницы, включая неизвестные, повреждённые и недописанные плагины. Действие не зависит от каталога, заголовков и записей совместимости. Настройки модулей, штатные данные колеса и калибровки сохраняются. Перед началом отдельное подтверждение объясняет, что будет стёрто.
Оставьте колесо на парковке. На хосте модулей приложение проверяет каждую страницу малыми порциями и ждёт свежий паспорт с подтверждением пустоты всех страниц. Неподтверждённые страницы стираются и проверяются повторно ограниченное число раз, затем выводится ошибка. Прогресс и подтверждение приходят от колеса. Старые хосты не умеют доказывать пустоту: результат — «команды отправлены, подтвердить нельзя», либо «очистка не подействовала», если поля плагинов остались активны.
Обрыв связи, отмена и выход с экрана прерывают операцию. На парковке её можно начать заново; повтор безопасен. На балансе кнопки видны, но неактивны. В дампах и демо этих действий нет.
«Сбросить настройки модулей» — отдельное действие с отдельным подтверждением на опознанном хосте модулей. Оно возвращает значения по умолчанию и выключает модули, меняющие поведение, сохраняя данные колеса и банк плагинов. Успех подтверждается свежей маской модулей с колеса.
Старое приложение может предлагать установку плагина на монолит. Монолит не записывает исполняемый код и не принимает прежние идентификаторы команд модулей: старые редакторы не настроят его модули. Используйте обновлённое приложение.
Образы не опубликованы для свободного скачивания. За подходящим production-образом
обратитесь к автору. Файлы DO-NOT-FLASH- предназначены
только для эмулятора. Раздел требует принять условия использования.
Перед прошивкой NOSFET Apex сохраните калибровки кнопкой «Сохранить калибровки (ConfigData.ini)» на экране прошивки. Это только чтение, восстановить файл приложение не умеет. Чтение этой копии на физическом Apex ещё не проверено.
Стояночная сигнализация#
Сигнализация доступна для Lynx-S и NOSFET Aeon. Взвести её можно только в настоящем режиме
паркинга, когда на панели колеса горит P. После взвода она остаётся активной, даже если
колесо вывели из паркинга.
Плагин не реагирует сиреной на единственный короткий толчок. Сначала он подтверждает движение, затем предупреждает короткими сигналами и вспышками фары. Если воздействие продолжается, включается прерывистая сирена на 30 секунд; после неё колесо снова переходит в сторожевой режим. Если во время тревоги снять питание и включить колесо снова, сирена продолжится.
Пока охрана включена:
- колесо не засыпает по таймеру;
- обычное долгое нажатие не выключает его;
- стоящее колесо не переходит в балансировку;
- кнопки панели используются для ввода пина, а не для штатных действий;
- на дисплее Lynx-S показано
ARM P.
Пин состоит из четырёх нажатий трёх кнопок панели. Он задаётся на отдельном экране LoEUC: нажимайте кнопки на самом колесе, проверяйте появляющиеся цифры и только затем сохраняйте. Верная комбинация снимает охрану без телефона, неверная сразу включает сирену. Кнопкой питания охрану не снять и колесо не выключить ни в сторожевом режиме, ни во время сирены. Если пин не задан, без телефона охрану не снять: остаётся дождаться, пока сирена отвоет свои 30 секунд.
Сигнализацию можно включать и выключать из быстрых действий LoEUC и с поддерживаемого внешнего экрана. Состояние кнопки меняется только после ответа колеса, поэтому потерянная команда не выглядит как успешно включённая охрана.
Последняя версия сигнализации с пином проверена на эмуляторе прошивки. Чувствительность к ветру, вибрации покрытия и реальному перемещению колеса ещё требует проверки на живых колёсах.
Характер педалей: ПИД-контроллер Lynx-S#
Модуль «Коэффициенты ПИД» предназначен только для LeaperKim Lynx-S 009.0.04. Он меняет три
коэффициента балансировочного контура, не затрагивая остальные настройки колеса:
- Ka · упор — насколько сильно педаль сопротивляется наклону;
- Kg · успокоение — насколько быстро гасится рывок;
- Kc · подхват — как меняется тяга под нагрузкой; отрицательное значение даёт более сильный подхват.
Вместо прежних профилей и трёх малопонятных ползунков теперь используется радар с отдельной осью для каждого коэффициента. Рядом всегда видны штатное значение, выбранное значение и описание будущего ощущения словами. Штатная жёсткость педалей находится на том же экране: заводская тройка коэффициентов рассчитывается от неё.
Перемещение ручек меняет только черновик. Экран отдельно показывает «Сейчас на колесе» и «Станет», а запись начинается одной кнопкой «Применить» и разрешена только на остановленном колесе. Для разбирающихся пользователей есть режим «Точные значения» с отдельными Ka, Kg и Kc. Возврат к центру/стоку полностью отключает подмену и возвращает штатный расчёт прошивки.
Изменение применяется транзакцией: сначала вся новая тройка готовится отдельно, затем фиксируется целиком. Потеря связи посередине не должна смешать старые и новые коэффициенты. Хост прошивки независимо ограничивает значения проверенной областью на входе и на каждом такте балансировочного контура; приложение заранее показывает, если запрос пришлось ограничить.
Это предохранители от выхода за исследованную область, а не обещание, что любое доступное сочетание понравится конкретному райдеру или безопасно при любой скорости. Стенд подтвердил границы, возврат к стоку и применение коэффициентов по всему тракту. Окончательная оценка ощущения педалей должна делаться на живом колесе осторожно, с малого изменения и на закрытой площадке.
Потолок моментного тока Lynx-S (опасно)#
Модуль «Потолок тока» поднимает предел, до которого Lynx-S 009.0.04 разрешает
запрашивать моментный ток, с заводских 380 А до 420 А, шагом 5 А. Вместе с ним на ту же
величину поднимается аварийная отсечка по фазному току: при 420 А она становится 500 А.
Так устроена сама прошивка, отдельно их не поменять. Тепловое снижение (полный предел только
при температуре силовых ключей 40–70 °C, не ниже 350 А) и предел 150 А при отказе датчиков
Холла работают как прежде.
Любое значение выше 380 А может перегреть и спалить контроллер, в том числе на ходу: колесо выключится, и вы упадёте. Без байпаса здесь лучше вообще ничего не трогать. Перед включением модуля и перед каждым применением нового значения LoEUC показывает это предупреждение и ждёт, пока вы отметите, что делаете это на свой риск.
- Значение меняется только на парковке, по сигналу прошивки о парковке. На балансирующем колесе модуль команду отклоняет, а приложение делает кнопку неактивной.
- Модуль работает на Lynx-S с заводскими пределами. На Sport-сборке (400 / 480 А) он ничего не меняет и показывает «прошивка не подходит».
- На плитке модуля видно, какой предел прошивка применяет на самом деле.
- Перед выключением модуля поставьте 380 А: не считайте, что само выключение сразу вернёт заводской предел.
Проверено на эмуляторе с настоящей прошивкой: прошивка сама пересчитывает оба предела, на балансе и чужими командами значение не меняется. На живом колесе не проверено.
Коррекция скорости Lynx-S, Oryx и Sherman P#
Модуль «Коррекция скорости» есть в Lynx-S 009.0.04 начиная со сборки b74, Oryx 008.0.05 b39 и Sherman P 010.0.02 b14. Он поправляет
скорость и пробег в самой прошивке, до ±20 % с шагом 0,1 %. Поправленные значения видят
экран колеса, телеметрия, любое приложение и ограничитель скорости: +3,0 % значит, что
колесо показывает и считает на 3 % больше заводского. Ограничитель и сигналы скорости
срабатывают по поправленной скорости. Ассист и оценщик InMotion X1 тоже получают
поправленную скорость. Обороты мотора, по которым прошивка решает, что колесо стоит,
не меняются.
- Поправка действует сразу после включения колеса, телефон для этого не нужен.
- Без X1 значение можно менять на стоящем колесе, даже если вы на нём стоите. Если выбран оценщик X1, менять можно только на парковке: X1 считает из скорости ускорение, и скачок поправки на ходу сдвинул бы педали.
- Пока модуль включён, приложение свою поправку скорости не применяет, иначе она легла бы дважды. На экране «Скорость и точность» видно, какую поправку применяет колесо.
- Выключенный модуль — ровно заводской расчёт скорости и пробега.
- Начиная с Lynx-S b77 (а также в Oryx b39 и Sherman P b14) поправка ложится на трип, а одометр остаётся заводским: это история колеса, от которой ведут обслуживание, и переписывать её поправкой под шину незачем. На b74–b76 поправка меняет и одометр.
Проверено на эмуляторе с настоящей прошивкой: при поправке 0 и выключенном модуле прошивка считает скорость и пробег побайтно как заводская, с поправкой — ровно на заданный процент. На живом колесе не проверено.
Автосвет Lynx-S, Oryx и Sherman P#
Модуль «Автосвет» есть в Lynx-S 009.0.04 начиная со сборки b75, Oryx b39 и Sherman P b14. Он делает то же, что
автофара приложения, но сам, в прошивке, — телефон для этого не нужен: поехали — горит
ближний, остановились — погас.
- Включение по скорости; выключение по скорости, по таймеру остановки или по углу педалей (колесо подняли или положили); дальний свет выше своего порога и обратно на ближний через 5 секунд. Окна по времени суток у модуля нет.
- На колесе автосвет включается и выключается удержанием кнопки фары 2 секунды: один короткий тихий писк — включён, два — выключен. Обычное короткое нажатие по-прежнему переключает фару, обычное долгое (около секунды) — второй свет.
- Любое ручное переключение фары — кнопкой на колесе, из LoEUC или из другого приложения — выключает автосвет. Обратно — тем же удержанием кнопки или из приложения.
- Состояние автосвета переживает выключение колеса. Если изменить его на ходу, оно запоминается, когда колесо встанет на парковку.
- Пока модуль включён, автофара приложения не работает, чтобы две автоматики не спорили за одну фару; в разделе «Автоматика» это написано.
Текущие значения всех настроек модуля приложение показывает начиная с Lynx-S b77, Oryx b39 и Sherman P b14. На b75 и b76 колесо возвращало только состояние автосвета, а остальные настройки применяло молча, и экран модуля показывал для них значения по умолчанию.
Проверено на эмуляторе с настоящим кодом прошивки. Как прошивка разбирает кнопку фары, прочитано по её коду и на живом колесе не проверено.
Ослабление поля Lynx-S, Oryx и Sherman P#
Модуль «Ослабление поля» есть в Lynx-S 009.0.04 начиная со сборки b78. На высокой скорости
колесо ослабляет поле мотора, чтобы ему хватало напряжения батареи; в стоке ослабление
начинается около 59 % ШИМ и линейно растёт до 75 А к 97 %. Модуль даёт настроить эту лестницу:
- Начало — ниже этого ШИМ поле не ослабляется (50–85 %). Позднее начало может уменьшить ток на крейсерской скорости, но повышает ШИМ при той же скорости.
- Конец лестницы — ШИМ, на котором ослабление выходит на максимум.
- Максимум FLU — до штатного предела High speed плюс 10 А; в обычном режиме сохраняется потолок производителя. Значения по умолчанию остаются штатными.
| Модель | High speed по умолчанию | Максимум настройки HS | Обычный режим |
|---|---|---|---|
| Lynx-S | 75 А | 85 А | 50 А |
| Oryx | 60 А | 70 А | 45 А |
| Sherman P | 70 А | 80 А | 48 А |
| Lynx | 50 А | 60 А | 30 А |
| Sherman L | 70 А | 80 А | 40 А |
Предел «штатный +10 А» действует с Lynx-S b80, Oryx b40, Sherman P b15, Lynx b4 и Sherman L b4. Более высокое ранее сохранённое значение ограничивается новым потолком; остальные настройки сохраняются.
Oryx b39 и Sherman P b14 поддерживают те же три модуля. Начало, конец лестницы, крутизна относительно штатного закона и кнопка «Как в стоке» учитывают модель. Поправка по напряжению сохраняется. У этих сборок коррекция меняет скорость и трип, а одометр остаётся заводским.
На странице модуля лестница нарисована графиком рядом со стоковой. Если начало и конец стоят слишком близко, лестница выходит слишком крутой, и колесо снижает максимум — график и строка под ним показывают, до какого. Значения меняются на стоящем колесе.
Важно. Слабее или позже ослабление — ШИМ растёт раньше, и колесо раньше пищит и поднимает педали. Сильнее и раньше — наоборот: ШИМ ниже, а запас момента тоньше, чем он выглядит. Выключенный модуль или стоковые значения — заводской закон без изменений. Перед включением модуля и перед каждой записью новых значений LoEUC показывает это предупреждение и ждёт, пока вы отметите, что делаете это на свой риск.
Проверено на эмуляторе с настоящей прошивкой: со стоковыми значениями задание тока совпадает с заводским в каждом такте записи, с настроенными — с законом модуля; разгон до 110 км/ч, рывок на 96 км/ч и пик скорости при начале 85 % такие же, как в стоке. На живом колесе не проверено.
Новые модули Lynx b3#
В «Дополнительных настройках» доступны автофара, коррекция скорости и трипа, ослабление поля и раздельные ассисты разгона/торможения. Все новые функции по умолчанию выключены; прежние ПИД, сигнализация и PIN сохраняются.
Автофара управляет штатным включением/выключением света; отдельного дальнего режима нет. Ручное переключение приостанавливает автосвет. Коррекция меняет скорость и трип, сохраняя штатный одометр; повторная поправка приложения не применяется. Ассисты имеют раздельные силу и предел угла, штатная настройка ThoRa продолжает действовать. При выключении ассистов возвращается штатное поведение.
У Lynx собственная шкала ШИМ: штатное ослабление начинается примерно на 67% и выходит на максимум около 94%. С b4 максимум настройки — 60 А в HS при штатных 50 А; обычный режим сохраняет штатные 30 А. Поправка напряжения и ограничение наклона лестницы сохраняются. Настройки меняются только стоя.
Для кода использован штатный текстовый диагностический вывод StR; его страницы больше не выводятся. Калибровки и LittleFS сохраняются. Это экспериментальная прошивка: стендовая проверка не означает проверку на живом колесе.
Новые модули Sherman L b3#
Sherman L 006.0.10 b3 добавляет автофару, коррекцию скорости и трипа и
настраиваемое ослабление поля в «Дополнительных настройках». После установки
они выключены. ПИД, раздельные ассисты, сигнализация и остальные функции b2 сохранены.
При переходе на b3 однократно сбрасываются настройки наших модулей: ПИД, ассисты, PIN и состояние сигнализации. Четыре страницы журнала заняты новым кодом; старые снимки в двух оставшихся страницах тоже пропускаются. Новые значения сохраняются между включениями. Образ заканчивается перед LittleFS.
- Автофара управляет штатной фарой без телефона по скорости, остановке или углу педалей. Ручное переключение выключает автоматику; вернуть её можно в приложении. Здесь один режим света, без отдельного дальнего и без нового жеста кнопки.
- Коррекция — ±20% с шагом 0,1%. Меняются скорость и трип, одометр остаётся штатным. Пока модуль включён, приложение не добавляет вторую поправку.
- Штатная лестница ослабления — примерно 66–97% ШИМ, 70 А в High speed и 40 А в обычном режиме. С b4 явно выбранный максимум HS — до 80 А с ограничением крутизны относительно родного закона. Выключенный модуль и штатные значения сохраняют родной регулятор; поправка по напряжению остаётся.
Настройки меняются только стоя. Пока модуль автофары включён, автофара телефона не управляет светом одновременно с ним. Проверки на эмуляторе не заменяют проверку на настоящем колесе.
Насколько всё это проверено#
Заливка основного образа с Android проверена на физическом Lynx-S и NOSFET Aeon. Это не подтверждает новые монолитные сборки, управление модулями, очистку и сброс на железе. Статус стенда и реального колеса смотрите в карточке конкретной сборки. Новые пути управления модулями и обслуживания с iOS на физическом колесе не проверены.
Если колесо после прошивки перестало загружаться, не пробуйте случайные образы. В гараже LoEUC есть отдельная команда «Попробовать восстановить прошивку», но восстановление тоже не даёт гарантии и должно использоваться только с образом точно от этой модели.