← Статьи

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; продукт не связан с их владельцами и ими не сертифицирован.