Запуск

Лілка постачається з готовою прошивкою Keira, яка вміє багато різних речей. Ця прошивка використовується для демонстрації можливостей Лілки, а також як приклад для розробки власних програм.

В цьому розділі ми розглянемо, як завантажити операційну систему Keira в Лілку.

Клонування репозиторію та побудова прошивки

  1. Перейдіть на вкладку Source Control (Ctrl + Shift + G) та клонуйте репозиторій Lilka:

    ../../_images/08_clone_repo_cropped.png

    Для цього натисніть «Clone Repository» та введіть адресу репозиторію:

    https://github.com/and3rson/lilka

    ../../_images/09_clone_cropped.png

  2. Після клонування репозиторію перейдіть на вкладку PlatformIO та імпортуйте проєкт прошивки Keira для Лілки. Для цього натисніть «Open Project» та виберіть директорію lilka/firmware/keira.

    ../../_images/11_open_pio_project_cropped.png

  3. Тепер нам потрібно дочекатися налаштування середовища розробки.

    PlatformIO автоматично встановить необхідні залежності, такі як компілятори, бібліотеки та інші інструменти, що необхідні для написання програм для Лілки.

    ../../_images/13_wait_pio_project_init_more_cropped.png

  4. Після налаштування середовища розробки перейдіть на вкладку PlatformIO та виберіть v2 в якості цільової платформи. Потім натисніть «Build».

    ../../_images/14_pio_build_v2_cropped.png

    Тепер потрібно дочекатися завершення збірки. Перша збірка може зайняти деякий час.

    ../../_images/15_pio_build_v2_progress_cropped.png

    Щойно збірка завершиться, ви побачите повідомлення про успішне завершення збірки:

    ../../_images/16_pio_build_ok_cropped.png

Завантаження прошивки в Лілку

  1. Підключіть Лілку до комп’ютера за допомогою USB-кабеля та увімкніть її.

    Попередження

    Зверніть увагу: Лілка не підтримує USB 3.0, тому ви не зможете прошивати її через кабель Type C - Type C. Використовуйте кабель Type C - Type A.

    Windows може вимагати встановлення драйверів для Лілки. Якщо вам буде запропоновано встановити драйвери, встановіть їх.

    Після цього вимкніть Лілку.

    Тепер вам потрібно натиснути та утримувати кнопку SELECT і увімкнути Лілку. Після цього можна відпустити кнопку SELECT. Це переведе Лілку в режим завантаження (bootloader mode): в цьому режимі ви можете завантажити в неї нову прошику.

  2. Тепер перейдіть на вкладку PlatformIO та виберіть v2 в якості цільової платформи. Потім натисніть «Upload».

    Спершу PlatformIO виконає підготовчі дії, а потім розпочне завантаження нашої свіжозібраної прошивки в Лілку.

    ../../_images/17_run_upload_v2_cropped.png

    Початок завантаження виглядатиме ось так:

    ../../_images/18_upload_progress_cropped.png

    Тепер потрібно дочекатися завершення завантаження. Щойно завантаження завершиться, ви побачите повідомлення про успішне завершення завантаження:

    ../../_images/19_upload_complete.png

  3. Коли завантаження завершиться, натисніть кнопку RESET на Лілці та насолоджуйтесь новою прошивкою!

    Порада

    Тепер вам не потрібно щоразу вручну переводити Лілку в режим завантаження, щоб завантажити нову прошивку!

    Крім прошивки Keira, ви щойно завантажили в Лілку ще й програму-завантажувач (bootloader). Тепер ви можете завантажувати нові прошивки в Лілку безпосередньо з PlatformIO.

    Просто натисніть кнопку Upload в PlatformIO і вона автоматично переведе Лілку в режим завантаження та завантажить нову прошивку!

Вітаємо!

Вітаємо, ви успішно налаштували середовище розробки та завантажили Keira в Лілку!

Ви можете потицяти Лілку та переконатися, що вона працює і спробувати різні демо. Також ви можете перейти на вкладку Explorer (Ctrl + Shift + E), відкрити файл src/main.cpp та поглянути, як виглядає код прошивки, яку ми щойно зібрали і запустили на Лілці.

Також ви можете запускати готові прошивки прямо з SD-карти, а також писати власні програми на Lua та запускати їх з SD-карти. Детальніше - в наступній частині документації: Можливості.

Лілка - це відкрита платформа, тому ви можете змінювати код прошивки, додавати нові функції та вдосконалювати Лілку, або навіть створювати власні прошивки для неї. Але перш ніж приступати до цього, рекомендуємо ознайомитися з документацією бібліотеки lilka, яка спрощує роботу з Лілкою, за цим посиланням.