Перейти к содержимому

Документация

Дополнительные возможности

Автофара, автогромкость, профили колеса, работа в фоне и удержание колеса включённым.

В меню по трём точкам две разные двери, и они не взаимозаменяемы. «Настройки колеса» в разделе «Колесо» открывают то, что записывается в сам аппарат: железо, профили, плагины, таймер выключения. «Настройки» в разделе «Приложение» — всё остальное, что живёт в телефоне, семью разделами: «Скорость и точность», «Алерты», «Карта и GPS», «Автоматика», «Данные», «Связь и датчики», «Диагностика». Набор зависит от колеса: раздел, в котором вашей модели нечего показать, не появляется вовсе. Разделы пишут второй строкой, что в них сейчас выставлено, — не заходя внутрь, видно настройку приложения разом. Раздел, о котором сказать нечего (колесо не ответило, пункт скрыт), молчит: прочерк вместо значения означал бы, что настройка есть и выключена.

Ниже — то, что лежит в этих разделах, и где искать каждую вещь.

Автофара#

Раздел «Автоматика».

Приложение само включает свет, когда вы поехали, и гасит его, когда остановились.

  • Порог включения задаётся по скорости.
  • Выключение привязывается либо к скорости, либо к таймеру полной остановки.
  • Отдельно настраивается автоматический дальний свет со своим порогом.
  • Работу можно ограничить временем суток, чтобы днём фара не включалась.

Это программная функция самого приложения: оно просто вовремя посылает колесу обычную команду включения света. Не путайте её с датчиком освещённости внутри колёс InMotion, который живёт в настройках самого колеса и работает без телефона.

Автофара поддерживается для LeaperKim, NOSFET, Begode, KingSong и InMotion.

Автогромкость#

Раздел «Автоматика».

Музыка в наушниках становится громче с ростом скорости и тише при остановке. Задаются минимальная и максимальная громкость и скорости, на которых они достигаются.

Функция применяется только к выбранным вами устройствам воспроизведения, чтобы она не лезла в громкость, когда телефон играет через колонку дома. Системный индикатор громкости при желании можно скрыть, чтобы он не мигал на пол-экрана всю поездку.

Проценты в настройке — это громкость на слух, а не позиция системного ползунка. Ползунок телефона и своя шкала колонки поверх него сжимают нижнюю треть так, что «20 %» в лоб означали почти тишину; поэтому число проходит через кривую, а концы остаются точными: ноль — тишина, сто — максимум. Кривая одна на Android и iOS, чтобы одна и та же настройка на двух телефонах звучала одинаково.

Экран настроек на iPhone со списком разделов
Настройки на iPhone: с корня открывается любой из разделов.

Профили колеса#

Меню → «Настройки колеса» → настройки железа колеса.

Профиль это сохранённый набор настроек колеса. Профили хранятся отдельно для каждого колеса.

  • Есть встроенный профиль по умолчанию, он заполняется текущими настройками колеса при первом подключении.
  • Свои профили можно создавать, переименовывать, удалять и переключать одним нажатием.
  • Профилем можно обменяться: он отдаётся отдельным файлом, который другой человек загружает у себя.

Применение профиля устроено аккуратно: пропускаются настройки, которых ваше колесо не поддерживает, пропускается транспортировочный режим, и в колесо отправляются только те значения, которые реально отличаются от текущих.

При подключении приложение сверяет настройки колеса с профилями. Если совпал тот, что выбран, он и остаётся. Если совпал другой, выбирается он. Если не совпал никакой, выбирается профиль по умолчанию, и в колесо при этом ничего не пишется.

Работа в фоне и переподключение#

Раздел «Связь и датчики».

Приложение продолжает работать со свёрнутым экраном. Если связь с колесом пропала, оно само ищет колесо и подключается обратно, а поездка при этом не разрывается. Сколько времени искать, вы задаёте сами, по умолчанию пять минут.

Чтобы намеренно завершить соединение на iPhone, выберите «Отключить» в меню с тремя точками. До следующего ручного выбора колеса приложение не будет подключаться к нему снова в этой сессии.

Удержание стоящего колеса включённым#

Меню → «Настройки колеса».

Только для LeaperKim. Колесо выключается само после четырнадцати минут простоя. Если функция включена, приложение поддерживает колесо включённым до заданного вами времени, пока телефон рядом и соединение живо.

Имейте в виду: если после отключения приложения колесо останется стоять, оно выключится через десять или шестьдесят секунд.

Диагностический лог#

Раздел «Диагностика», только на Android.

Если что-то ведёт себя не так, как должно, включите диагностический лог, повторите поездку и пришлите файл. По нему видно, что приложение делало на самом деле: когда подключилось к колесу и когда потеряло связь, какое решение приняла автофара на каждом изменении скорости, почему автогромкость применилась или не применилась, и в какой момент система отправила приложение в фон.

Кнопка «Отправить лог» собирает всё в один текстовый файл и отдаёт его обычным способом — в мессенджер, почтой, куда удобно. Файл можно открыть и прочитать самому, это простой текст.

Лог выключен по умолчанию и на скорость работы не влияет. Сырые данные колеса в него не попадают — это запись поведения приложения, а не протокола.

Виджет на домашнем экране#

Виджет показывает состояние колеса, не открывая приложение. Между поездками это заряд, запас хода, имя колеса и когда была последняя связь; на ходу — скорость, ШИМ и пробег поездки.

Виджет тянется по ширине, и с каждым шагом на нём появляется что-то ещё. Самый узкий — это один прибор: дуга и главное число внутри, заряд между поездками и скорость на ходу. Шире — справа встают три строки: запас хода, пробег и время последней связи. Во всю ширину (до пяти столбцов домашнего экрана) добавляются итоги поездки — средняя скорость, максимальная скорость, максимальный ШИМ и средняя банка — и две кнопки: фара и сигнал.

Кнопка фары шлёт колесу ту же команду, что кнопка «фара» на дашборде, — не какую-то свою. Сигнал пока не работает ни на одном колесе: команда не разобрана, и слать в колесо угаданные байты мы не будем. Кнопка на месте, чтобы не переделывать виджет, когда команда появится.

Без связи с колесом кнопки гаснут, но остаются на месте: пропадающая кнопка перекраивала бы виджет каждый раз, когда колесо отвалилось на светофоре.

Средняя банка есть не у каждого колеса — она берётся у смарт-BMS, и там, где её нет, вместо числа стоит прочерк. Прочерк, а не ноль: ноль означал бы разряженный пакет.

Оформление виджет берёт из приложения, так что выбранный вами акцент и фон действуют и на нём.

Виджет не связывается с колесом сам. Он показывает то, что приложение записало в последний раз, и всегда честно сообщает, насколько давно это было. Обновляется он раз в пятнадцать секунд, пока приложение на связи с колесом: чаще незачем, а батарею телефона это бережёт.

Виджет есть и на Android, и на iPhone.

Меню отладки#

Не в настройках: меню дашборда и список поиска.

Долгое нажатие на устройство в списке поиска открывает служебный экран: сырые пакеты, разобранные кадры, побайтовые изменения, метки, выгрузка записи в файл и отправка своих команд.

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