MH блог

Прежде чем начать описание установки сообщаю, что Вы можете скачать исходный код драйвера и распаковать его с помощью следующих команд:

Для сборки драйвера Вам понадобятся исходные коды FreeBSD, обычно они лежат в папке /usr/src. Можно также установить их на флешку и монтировать её в указанную папку при необходимости. Как исходные коду скачать и распаковать поищите в Интернете - процесс этот несложный, но лучше следовать описанию.

После того как исходные коды Вашей ОС распакованы в /usr/src, можно пробовать собрать и установить драйвер:

Исходные коды используются только на этапе сборки и больше не требуются.
Драйвер будет установлен в /boot/modules как tm1637.ko. Но загружать его пока рано... Почему? Видите ли, я намеренно немного изменил порядок действий для сборки драйвера - предложил Вам сделать сперва самое сложное, но зато Вы уверены, что драйвер успешно собирается и устанавливается.

Теперь нам необходимо подключить устройство к "малинке" или "апельсинке", но прежде чем мы это сделаем, хочу сказать пару слов: в папке fdt-overlays/ исходников драйвера лежат готовые примеры оверлеев с расширением .dtso.
В них уже указаны пины scl (CLK) и sda (DIO) (это пины, которые я использовал на своих тестовых машинках) и в скобках указаны физические номера пинов. Если Вы подключите свой дисплей именно к ним, то ничего больше делать не надо. Но Вы вольны выбирать любые свободные пины, кроме питания и GND и, в этом случае, Вам поможет Интернет - наберите в поисковике название Вашей платы и слово "pinout". Найдите названия Ваших пинов и следуйте следующим правилам:

• Для малины: название GPIO21 означает, что ячейка для этого пина записывается как &gpio 21 0. Заметьте, что это совершенно не пин № 21. Для покупных дисплеев вторую цифру ставим 0 - не использовать подтягивающий резистор;
• Для апельсина: название PC4 раскладывается в две цифры: порядковый номер буквы после P A=0, B=1 и т.д. У нас C=2 и вторая цифра 4, т.е. &pio 2 4 0. Последняя цифра 0 - это опять подтягивающий резистор.

Аккуратно и внимательно поменяйте в нужном вам оверлее все упоминания пинов - и имена в первом блоке, и ячейки во втором (и физические номера в скобках - Вам же потом понятнее будет), сохраните файл и выйдите из редактора. Теперь запустите команды (можно в папке fdt-overlay/, а можно перейти в родительскую - результат будет один и тот же):

Оверлей с исправленными настройками установлен в /boot/dtb/overlays. Мы могли бы сделать это сразу, перед сборкой модуля, но тогда, если бы что-то пошло не так при сборке, мы бы сомневались, не допустили ли мы ошибку при редактировании.

Теперь добавьте имя оверлея в файл /boot/loader.conf, например:

и перегрузитесь.
..........
Если всё прошло нормально, то команда:

загрузит драйвер в систему. Вот несколько команд для контроля того, что мы только что сделали:

• kldstat покажет список загруженных модулей всместе с нашим новым драйвером;
• dmesg покажет сообщение системы, о найденном устройстве и занятых им пинах;
• devinfo выдаст дерево устройств, в верхних строках которого будет и tm1637;
• ls /dev/tm1637 укажет, что в системе появилось символьное устройство;
• sysctl dev.tm1637 выведет на эран доступные переменные ядра, для управления драйвером;
• sudo echo "12:34" > /dev/tm1637 отобразит на дисплее 12:34.

Не могу удержаться, чтобы не похвалить себя :-), если после первой строки Вы отправите следом строку "12:35", то драйвер отправит на дисплей только одну изменённую цифру, что заметно экономит ресурсы, если обновление информации происходит каждую секунду.

Вот собственно и всё! Осталось напомнить про пару мелочей:

Если Вы хотите запускать драйвер при старте компьютера автоматически, добавьте в файл /boot/loader.conf:


Если Вы желаете написать программу, которой будет нужно выводить на дисплей, то вам помогут примеры, расположенные в папке examples/. Там всё просто, не забудьте каждый раз завершать строку символом '\n' - он необходим в строковом формате драйвера.

Если Вы хотите управлять выводом каждого сегмента дисплея, то для Вас подойдет "сырой" режим драйвера. Для его включения запустите команду:

или заново соберите оверлей, раскоментировав соответствующую строку. В этом режиме драйвер ждет от Вас 4 байта, каждый включенный бит которых соответствует сегменту одного из 4-х символов. В отличие от строкового режима, перед выводом группы байт следует использовать позиционирование в файле с помощью seek() - доступны смещения от 0 до 3-х.

Версия драйвера остаётся alpha, но это не значит, что что-то в нём не работает. Это значит, что я ещё не определился окончательно с его функционалом - я всё ещё добавляю функции (например ioctl() вызовы для тех, кто пишет на C).

Почитайте файл README.md - я стараюсь отображать там все свои добавления.

Удачи!!!