Хамелион

Данное программное обеспечение предназначено для управления адресной светодиодной лентой с помощью мокроконтроллерной платформы Arduino

Содержание

1. Инструкция пользователя
   • Сборка и прошивка контроллера
   • Первый вход в приложение (Знакомство с интерфесом)
2. Инструкция для разработчиков
   • Знакомство со структурой проекта
   • Доработка скетча
   • Доработка приложения
   • Доработка функционала общения с контроллером

User instruction

Controller connect

Если вы первый раз работаете с Arduino рекомендую к прочтению статью по Ссылке. Для того чтоб убедиться в отсутствии проблем прошивки, запишите стандартную прошивку предоставляемую Arduino IDE

Далее нам понадобится библиотека FastLed.h (Единственная библиотека используемая в прошивке) версия исопльзуемая на момент написания. Подключаем бибилиотеку с помощью

Скетч -> Бибилотеки -> Добавить библиотеку .zip

Далее скачиваем прошивку (На вкладке релизов репозитория файл main-arduino.zip)

Компилируем проошивку - всё гуд если всё гуд!

Рекомендуется изменить в фале main.ino:

1. Строка 3, цифра - количество светодиодв

2. Строка 4, цифра - имя контакта к которому подключена лента

3. Строка 25, цифра - количество мячиков в последнем режиме (естественно если вы не собираетесь исопльзовать этот режим, можно ничего не трогать этот параметр)

4. Строка 36, символы WS2812 ваш чип ленты входящий в список доступных библиотеки FastLed

Ошибка прошивки: Библиотека не найдена (windows)

При стандартном подключении бибиотеки у меня возникла такая ошибка, иправил тем что перенёс распакованную бибилиотеку в корень стандартых библиотек Arduino IDE

Распакованная библиотека - Documents->Arduino-> libraries->FastLed-master

Стандартные библиотеки - ../Arduino/Lib/

После прошивки подключаем контроллер по следующей схеме:

Другие схемы подключения могутнавредить контроллеру!

P.S. Но я использую без резистера, посмотрим через сколько отвалится ножка контроллера

расчёт мощьности блока питания для стабильной работы вы можете сделать здесь

Стоит отметить что стандартная прошивка для WS2812 от AlexGaver здесь не подойдёт. Она была взята за основу, но полностью переписана и оптимизированна, за счёт чего при стандартной прошивке из репозитория вы можете подключать до 400 свтодиодов (чипов) по сравнению с 200 у Гавера

First Entry

Установка приложения

Если вы пользователь Windows

Запуск

Нажмите на название своей ОС Для открытия подробной инструкции

Windows

рекомендуется ставть программу в папку ProgramFiles. Лучше используйте папку пользователя. Иначе могут возникнуть проблемки.

Запуск происходит стандартно, но если что-то идёт не так, рекомендуется производить запуск от имени администратора

При входе необзодимо указать порт к которому подключен контроллер.

В нашем случае это любой кроме COM1

Linux

Запуск производить только из под sudo. В инном случае по нажатию на любую кнопку приложение будет вылетать из-за отсутствия прав для работы с COM портами

При входе необзодимо указать порт к которому подключен контроллер.

В нашем слуае это любой в пути которого есть "USB"

Знакомство с интерфесом

Итак, интерфес разделён на функциональные части.

Временные - настройки применённые этими кнопками не сохраняются при перезапуске приложения. Из функциональных клавишь

1. Следующий/Предыдущий - переключают режимы
2. Stop/Continue - Заголовки кнопкок переключаются. приостанавливает режим и не даёт ленте изменять цвета
3. ON/OFF - вкл/выкл. Тут всё очевидно
4. В право/В лево - включает режим которые перемещает текущие свтодиоды в соответствующее направление

Центр

1. О программе - на данны момент перекидывает на страницу первой версии проекта. На данны момент не функционирует
2. Название режима
3. Описание режима
4. Применить - передаёт текущий режим на ленту (сделано через кнопку т.к. есть мерцающие режимы режущие глаз)

Функицональная часть!

1. Режимы - список режимов которые можно применить

Параметры

Данные в этом блоке применяются моментально на контроллере

1. Время задержки - каждый режим прогоняется заново в зависимости изменяя параметры. Между каждым шагом етсь задержки. При увеличении задержки режим будет проходить медленнее, и наоборот (в последнем режиме рекомендуется указать задержку 0)
2. Яркость - Задаётся значением от 0 до 255
3. Цвет - режимы где используется 1 цвет позволяют использовать любой цвет. При изменении поле становится активным и не активным в зависимотсти от возможности регулировать данный параметр

Creator instruction

В процесс резработки