DataMatrix, QR и штрихкоды на Raspberry Pi: установка и скорость
Raspberry Pi часто ставят прямо у линии или на складе: камера, плата, и коды читаются без отдельного компьютера. Ниже — что нужно, чтобы читать DataMatrix, QR и штрихкоды на Raspberry Pi и других платах ARM, как поставить библиотеку одной командой и сколько занимает чтение на Raspberry Pi 4.
Что поддерживается
| Плата и система | Подходит |
|---|---|
| Raspberry Pi 3, 4, 5 и другие платы ARM64 (aarch64) с Raspberry Pi OS Bookworm (Debian 12) и новее | да |
| 32-битная Raspberry Pi OS (ARMv7, armhf) Bookworm и новее — Raspberry Pi 2, 3, 4, Zero 2 W | да |
| Ubuntu 24.04 и новее на ARM | да |
| Raspberry Pi OS Bullseye (Debian 11), Ubuntu 22.04 и старше | нет: нужна glibc 2.36 и новее |
| Raspberry Pi 1 и Zero первой версии (ARMv6) | нет |
Версию glibc показывает команда ldd --version, версию системы — cat /etc/os-release. Если glibc старее 2.36, pip сообщит, что подходящего пакета нет: обновите систему или напишите нам — соберём под вашу.
Установка
Пакеты на PyPI собраны под ARM64 и ARMv7, в них ядра NEON — ничего собирать на плате не нужно. Python 3.9 и новее:
python3 -m venv ~/scanner
~/scanner/bin/pip install libscanner-unir # DataMatrix, QR, штрихкоды
# или libscanner-dmr — только DataMatrix
~/scanner/bin/unir --versionЧтение кода из Python:
import unir
result = unir.scan_file("etiketka.jpg")
if result.ok:
print(result.codes[0].symbology_name, result.text) # текст — bytes, GS сохранёнИли без своего кода — утилитой командной строки: unir etiketka.jpg. Для C++ в разделе «Загрузки» личного кабинета есть архивы для Linux ARM64 и ARMv7 с библиотекой, заголовками и утилитой.
Первый месяц библиотека работает на плате без лицензии и без интернета. Потом нужен ключ; для плат, которые стоят без сети, лицензию можно активировать через другой компьютер — это описано в документации.
Сколько занимает чтение на Raspberry Pi 4
Raspberry Pi 4 Model B, unir 1.2.15 из PyPI, кадры промышленной камеры, медиана по кадрам:
| Задача | 1 поток | 4 потока |
|---|---|---|
| Один код DataMatrix на кадре 5 Мп (2416×2024) | 0,25 с | — |
| Все 20 кодов DataMatrix листа A4 на кадре 5 Мп | 6,2 с | 1,9 с |
| Все коды листа со штрихкодами EAN-13, SSCC и QR, кадр 8,5 Мп (3456×2458) | 3,3 с | — |
Вывод простой: один код с кадра камеры Raspberry Pi 4 читает за доли секунды, а на десятки кодов на большом кадре уходят секунды. Если нужно быстрее:
- Снимайте только нужное. Кадр, обрезанный до зоны, где бывает код, читается заметно быстрее: работы меньше примерно пропорционально площади.
- Не берите разрешение с запасом. Достаточно 2–3 пикселей на модуль кода; как это посчитать — в статье о разрешении камеры.
- Задайте символики. Если на линии только DataMatrix, не ищите штрихкоды:
--sym dmилиSettings.symbologies. - Ограничьте время на кадр. Настройка
budget_ms(ключ--budget-ms) обрывает поиск по сроку и отдаёт то, что успели прочитать, — темп линии не сбивается на тяжёлом кадре. - Возьмите плату мощнее. Raspberry Pi 5 заметно быстрее Pi 4 (на ней мы пока не мерили); для десятков кодов на кадре — мини-ПК на x86 (на 8 ядрах x86 снимок 12 Мп с 16 кодами читается за 0,45 с, подробнее — в статье о нескольких кодах на снимке).
Попробовать
Документация — unir и dmr, пакеты — libscanner-unir и libscanner-dmr на PyPI. Проверить свой снимок без установки — в онлайн-сканере. Нужна сборка под свою плату или систему — напишите нам.
«Честный знак» — товарный знак ООО «Оператор-ЦРПТ», «GS1» — GS1 AISBL; продукт не связан с их владельцами и ими не сертифицирован.