inky

Инки

Библиотека Python для Inky Phat, инки, что и инки впечатления, электронная бумага отображается для Raspberry Pi.

Inky Phat

Inky Phat представляет собой дисплей с электронной бумагой 250x122 пикселей, доступный в красном/черном/белом, желтом/черном/белом и черном/белом. Он отлично подходит для именных веществ и отображения очень низкой частоты, такой как ежедневный календарь или обзор погоды.

Инки что

Inky Что представляет собой дисплей с электронной бумагой 400x300, доступный в красном/черном/белом, желтом/черном/белом и черном/белом. У него есть тонны разрешения для подробных ежедневных списков дел, многодневных прогнозов погоды, расписания автобусов и многое другое.

Чернильное впечатление

Чернильное впечатление - это наша линия славных 7 цветных дисплеев Eink, доступных в 4 дюймах (640 x 400 пикселей) 5,7 "(600 x 448 пикселей) и 7,3" (800 x 480 пикселей). Они упакованы с сильными цветами и идеально подходят для отображения полной графики или множества данных.

Установка

Мы рекомендуем использовать эту библиотеку с книжным червем Raspberry Pi OS или позже. Это требует Python ≥3,7.

Полная установка (рекомендуется):

Мы создали простой сценарий установки, который установит все предварительные условия и приведет к тому, что вы работаете с минимальными усилиями. Чтобы запустить его, запустите терминал, который вы найдете в меню -> Аксессуары -> терминал на рабочем столе Raspberry Pi, как показано ниже:

В новом окне терминала введите команды точно так же, как это показано ниже (проверьте опечатки), и следуйте инструкциям на экране:

git clone https://github.com/pimoroni/inky
cd inky
./install.sh

Примечание библиотеки будут установлены в виртуальной среде "Пиморони, вам нужно будет активировать ее для запуска примеров:

 source ~/.virtualenvs/pimoroni/bin/activate

Разработка:

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

git clone https://github.com/pimoroni/inky
cd inky
./install.sh --unstable

Установите стабильную библиотеку из PYPI и настройте вручную

• Установите виртуальную среду: python3 -m venv --system-site-packages $HOME/.virtualenvs/pimoroni
• Переключиться на виртуальную среду: source ~/.virtualenvs/pimoroni/bin/activate
• Установите библиотеку: pip install inky

Это не внесет никаких изменений конфигурации, поэтому вам также может потребоваться включить:

• i2c: sudo raspi-config nonint do_i2c 0
• SPI: sudo raspi-config nonint do_spi 0

Необязательно запустить sudo raspi-config или графический пользовательский интерфейс конфигурации Pi Raspberry для включения интерфейсов.

Кроме того, вам может потребоваться отключить выбор чипа SPI, чтобы избежать ошибки:

 Woah there, some pins we need are in use!
  ️   Chip Select: (line 8, GPIO8) currently claimed by spi0 CS0

Это требует добавления dtoverlay=spi0-0cs к /boot/firmware/config.txt .

Использование

Библиотека должна запускать с Python 3.

Автоматическая установка

Inky может попытаться автоматически идентифицировать вашу доску (из информации, хранящейся в его eEPROM) и соответствующим образом настроить. Это самый простой способ работать с недавними чернильными дисплеями.

 from inky . auto import auto
display = auto ()

Затем вы можете получить цвет и разрешение от доски:

 display . colour
display . resolution 

Ручная установка

Если у вас есть старый черничный без EEPROM, вы можете указать тип вручную. Внутренняя библиотека содержит модули как для PHAT, так и для чего, загрузите чернильный Phat One следующим образом:

 from inky import InkyPHAT

Затем вам нужно будет выбрать свой цвет, один из «красный», «желтый» или «черный» и создать класс:

 display = InkyPHAT ( 'red' )

Если вы используете то, что вам нужно, чтобы загрузить чернильный класс из чернильной библиотеки так:

 from inky import InkyWHAT
display = InkyWHAT ( 'red' )

После того, как вы инициализируете инки, есть только три метода, с которыми вы должны быть обеспокоены:

Установить изображение

Установите изображение PIL, массив Numpy или список во внутренний буфер инки. Размеры изображения должны соответствовать размерам PHAT или того, что вы используете.

 display . set_image ( image )

Вы должны использовать PIL , чтобы создать изображение. PIL предоставляет модуль ImageDraw , который позволяет рисовать текст, линии и формы над вашим изображением. См.: Https://pillow.readthedocs.io/en/stable/reference/imagedraw.html

Установить границу

Установите цвет границы, Phat или что.

 display . set_border ( colour )

colour inky.BLACK inky.WHITE одним из inky.RED inky.YELLOW

Обновите дисплей

После того, как вы подготовили и установили свое изображение, и выбрали цвет границы, вы можете обновить свой дисплей E-INK с помощью:

 display . show ()

Мигрируя

Если вы мигрируете код из старой inkyphat библиотеки, вы обнаружите, что большая часть функций манипуляции с рисунком и изображениями была удалена из инки. Эти функции всегда были предоставлены PIL, и рекомендуемый подход состоит в том, чтобы использовать PIL для создания и подготовки вашего изображения, прежде чем установить его в Inky с set_image() .