↓ Перейти к основному содержимому
Нативная поддержка plug-and-play в macOS: разработка Web NFC API и смарт-карт APDU с ACS ACR1252U-M1
  1. Блог/

Нативная поддержка plug-and-play в macOS: разработка Web NFC API и смарт-карт APDU с ACS ACR1252U-M1

Оглавление

Продукт статьи: ACS ACR1252U-M1 (USB NFC Reader III, считыватель карт с сертификацией NFC Forum) Для кого: разработчики приложений macOS (Apple Silicon), front-end инженеры Web NFC, тестировщики смарт-карт и систем контроля доступа, makers и исследователи лабораторий Цель статьи: разобраться в стандартах CCID / PC/SC, стоящих за «нативной поддержкой macOS», и понять, как работать с метками NTAG213/NTAG215 двумя путями разработки — Web NFC в браузере и APDU в локальных программах, включая управление байтами зуммером и двухцветным светодиодом считывателя.


⚠️ Самое важное ограничение поддержки — сначала (прочитайте перед покупкой)

  1. Web NFC API сейчас работает только в браузерах на базе Chromium и только на устройствах Android и ChromeOS. Настольный Chrome на macOS/Windows/Linux, настольный Edge, Firefox и Safari не имеют интерфейса NDEFReader.
  2. Safari на macOS и iOS (любой браузер) вообще не поддерживают Web NFC; на iOS доступ к NFC возможен только через нативный фреймворк Core NFC (требуется написать приложение).
  3. Web NFC в браузере использует «встроенный в устройство контроллер NFC» (например, телефон Android или ноутбук ChromeOS), а не внешний USB-считыватель. Внешний ACR1252U-M1 работает по стандарту PC/SC и управляется командами APDU из локальных программ — это два отдельных пути, поэтому перед покупкой уточните свою целевую платформу.

Вступление: одна NFC-карта, два пути разработки
#

Представьте, что у вас есть метка NTAG215 для контроля доступа или защиты продукции, и вы хотите превратить её в данные, которые можно читать и записывать в «браузере». Одновременно вы хотите написать на macOS утилиту, которая заставит считыватель «пикнуть один раз и загореться зелёным» с помощью байтов.

Эти две задачи соответствуют двум совершенно разным технологиям:

  1. Web NFC API: в поддерживаемых браузерах (Chromium на Android/ChromeOS) несколько строк JavaScript читают и записывают метки NDEF напрямую — без какого-либо аппаратного считывателя.
  2. APDU (Application Protocol Data Unit): через стандарт PC/SC локальные программы (Swift, Python…) отправляют считывателю байтовые команды, расширяя управление за пределы карты на само устройство — например, на зуммер и двухцветный светодиод считывателя.

ACS ACR1252U-M1 подходит в качестве первого считывателя для разработки, потому что он соответствует стандарту CCID и имеет сертификацию PC/SC и NFC Forum: на macOS он работает сразу после подключения, без установки сторонних драйверов. Ниже три раздела: «почему нативная поддержка важна», «как применять Web NFC на практике» и «как управлять светом и звуком через APDU», а в конце — контрольный лист перед покупкой.


1. CCID и PC/SC на Mac с Apple Silicon: почему «нативная поддержка» важна для разработчиков
#

1.1 Три термина по порядку: CCID, PC/SC и нативная поддержка
#

ТерминПолное названиеОбъяснение в одной фразе
CCIDChip Card Interface DeviceСтандартный класс USB (USB Class), определяющий, как считыватели смарт-карт общаются по USB. У устройств, совместимых с CCID, протоколом управляет операционная система.
PC/SCPersonal Computer/Smart CardСтандарт API, позволяющий приложениям обращаться к считывателям смарт-карт через единый интерфейс, независимо от чипа внутри.
Нативная поддержкаDriverless / Built-in DriverОперационная система встроила драйвер этого класса; пользователь подключает устройство — и оно работает, без «установки диска с драйвером производителя».

Простыми словами: CCID оформляет «как считыватель разговаривает с компьютером» в единую USB-спецификацию, а PC/SC оформляет «как приложения вызывают считыватель» в единый API. Когда есть и то и другое, операционная система поддерживает устройство на уровне ядра — это и есть «нативная поддержка».

ACR1252U-M1 имеет сертификации CCID, PC/SC, NFC Forum и FeliCa Performance (как указано в спецификации). Это значит, что он работает по принципу plug-and-play на любой операционной системе, реализующей эти два стандарта.

1.2 Почему это особенно важно на Apple Silicon
#

В эпоху Apple Silicon (M1/M2/M3/M4) macOS значительно ужесточила ограничения на сторонние драйверы:

  • Расширения ядра (Kernel Extension / kext) считаются переходной технологией: обновления системы и безопасность загрузочного диска (Secure Boot) жёстко блокируют неподписанные и не прошедшие нотаризацию драйверы. Поддерживать драйвер macOS, который пользователи действительно могут «установить», стоит очень дорого, и многие продукты просто отказываются от этого.
  • В macOS встроен фреймворк Smart Card Services, который уже включает поддержку считывателей CCID. Поэтому считывателю, совместимому с CCID, не нужен драйвер производителя на macOS — операционная система распознаёт его сама.

В этом и есть настоящая ценность «нативной поддержки»: вам не нужно ждать от производителя новый драйвер для серии M и не нужно беспокоиться о Team ID или нотаризации. Крупные обновления macOS также не влияют на работу считывателя.

Проверка того, что система распознала считыватель (на macOS):

# Просмотр считывателей смарт-карт (появление ACR1252U / ACS означает, что система его перечислила)
system_profiler SPCardReaderDataType

# После установки pcsc-tools (пакет brew) можно следить в реальном времени через pcsc_scan
brew install pcsc-tools
pcsc_scan

1.3 Практическое значение для разработчиков
#

Сценарий разработкиСчитыватель без CCIDACR1252U-M1 (CCID/PC/SC)
Установка драйвера на macOSУстановщик производителя + подпись и нотаризацияБез установки, подключил и работай
После крупного обновления macOSЧасто выходит из строя (истёкшая подпись или отклонённый kext)Не затрагивается
Смена компьютера для разработкиПереустановка драйвера на каждой машинеПросто подключить
Кроссплатформенность (macOS/Linux/Windows)Драйверы разных производителей несовместимыОдни и те же команды PC/SC
Защита безопасности macOSНекоторые требуют снижения уровня безопасности для загрузкиОтключать защиту не нужно вообще

Красная линия безопасности: этот продукт и все сценарии статьи работают при настройках безопасности macOS по умолчанию (полная безопасность, защита целостности системы SIP включена). Если на другой платформе драйвер не загружается, не обходите это отключением Secure Boot или снижением уровня безопасности — правильный путь: устройство, совместимое со стандартом CCID, или поддерживаемая ОС процедура подписи.


2. Web NFC API на практике: чтение и запись NTAG213 / NTAG215 в браузере
#

2.1 Сначала проверьте охват поддержки (ключевой момент Support Reduction)
#

Web NFC API (интерфейсы NDEFReader/NDEFWriter) есть не во всех браузерах. В таблице ниже — фактическое положение дел на 2026 год:

СредаБраузерWeb NFC (NDEFReader)Примечания
AndroidChrome/Edge/Samsung Internet (на базе Chromium)✅ ПоддерживаетсяТребуется HTTPS или localhost, а также жест пользователя
ChromeOSВстроенный Chrome в ChromeOS✅ ПоддерживаетсяУстройство должно иметь контроллер NFC
macOS, настольныйChrome/настольный Edge❌ Не поддерживаетсяВ настольном Chrome нет Web NFC
macOS, настольныйSafari❌ Не поддерживаетсяНет ни в одной версии Safari
Windows/Linux, настольныйНастольные Chrome/Edge/Firefox❌ Не поддерживаетсяWeb NFC не открыт для настольных версий
iOS (iPhone/iPad)Любой браузер (включая Chrome и Edge iOS)❌ Не поддерживаетсяВсе браузеры iOS используют WebKit; для NFC — только Core NFC в нативном приложении

Вывод: чтобы «по-настоящему» работать с NFC-метками в браузере, вам нужен телефон Android или устройство ChromeOS. На настольном macOS ценность ACR1252U-M1 — в разработке локальных программ через PC/SC, о которой говорится во второй и третьей главах: чтение и запись тех же меток или отправка команд APDU для управления считывателем.

Ещё одно ключевое заблуждение: Web NFC в браузере использует встроенный в устройство чип NFC (контроллер NFC телефона или ноутбука ChromeOS); внешний USB-считыватель браузерный Web NFC не использует никогда. Так что «подключил ACR1252U-M1 к Chromebook — и веб-страница читает карты» — это не так. Аппаратный источник у двух путей разный.

2.2 Нужные метки: NTAG213 и NTAG215
#

Формат NDEF, который использует Web NFC, чаще всего сочетается с метками NFC Forum Type 2, то есть семейством NTAG213 / NTAG215 / NTAG216 от NXP (часто применяется в контроле доступа, визитках, защите от подделок, заменителях Amiibo и т. д.):

ПараметрNTAG213NTAG215
Память пользователя144 bytes504 bytes
Доступная ёмкость NDEFоколо 137 bytesоколо 496 bytes
Типичное применениеКороткие ссылки, одна визитка, небольшие данныеДанные среднего объёма (более длинный JSON/несколько записей)
Скорость чтения/записи106 kbps (фактически определяет считыватель)106 kbps
БезопасностьЗащита одним паролемЗащита одним паролем

О ёмкости: в 137 bytes помещается примерно 130 английских символов; для среднего контента до 1 КБ или для эксперимента «несколько записей на одной карте» выбирайте NTAG215. На начальном этапе разработки рекомендуется запастись пачкой пустых меток (пустые, незаблокированные, без пароля) — удобно перезаписывать многократно.

Про «блокировку» нужно различать два случая: после установки пароля вы всё ещё можете пройти проверку командой PWD_AUTH и продолжить запись; по-настоящему необратимо — запись битов блокировки (Lock Bits): как только они заблокированы, право записи не вернётся никогда.

2.3 Пример чтения (NDEFReader.scan)
#

Сначала откройте страницу HTTPS (или localhost) в Android Chrome/ChromeOS Chrome и поднесите метку к зоне NFC-антенны устройства. Пример:

<!DOCTYPE html>
<html lang="ru">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>Демо чтения/записи Web NFC</title>
</head>
<body>
  <h1>Демо чтения/записи Web NFC</h1>
  <button id="btnScan">Начать сканирование</button>
  <button id="btnWrite">Записать метку</button>
  <pre id="output"></pre>

  <script>
    const out = (msg) => {
      document.getElementById('output').textContent += msg + '\n';
    };

    if (!('NDEFReader' in window)) {
      out('Этот браузер не поддерживает Web NFC (NDEFReader).\nИспользуйте Android Chrome или ChromeOS Chrome.');
    }

    // Чтение: scan() должен запускаться жестом пользователя
    document.getElementById('btnScan').addEventListener('click', async () => {
      try {
        const reader = new NDEFReader();
        await reader.scan();
        out('Сканирование начато, поднесите метку к зоне NFC-антенны телефона…');

        reader.onreading = (event) => {
          out('--- Метка прочитана ---');
          out('Серийный номер (Serial Number): ' + event.serialNumber);
          for (const record of event.message.records) {
            out('recordType: ' + record.recordType);
            if (record.recordType === 'text' || record.recordType === 'url') {
              out('Содержимое: ' + record.data);
            } else {
              out('Содержимое (двоичный ByteArray): ' + new Uint8Array(record.data));
            }
          }
        };

        reader.onreadingerror = () => out('Ошибка чтения: проверьте, поддерживает ли метка NDEF.');
      } catch (err) {
        out('scan() не удался: ' + err.name + ' / ' + err.message);
      }
    });
  </script>
</body>
</html>

Для меток NTAG213/NTAG215 (Type 2) event.message разбивает NDEF-сообщение метки на records: у типов text и url поле record.data уже является строкой; остальные типы приходят как ArrayBuffer и требуют преобразования.

2.4 Пример записи (NDEFReader.write)
#

Замените обработчик кнопки выше на:

// Запись: write() тоже требует жеста пользователя, а метка должна быть в зоне считывания
document.getElementById('btnWrite').addEventListener('click', async () => {
  try {
    const writer = new NDEFReader();

    // Способ 1: записать обычный текст (автоматически упаковывается в запись text)
    // await writer.write('Тест Yopitek Web NFC');

    // Способ 2: записать URL-запись (подходит для визиток и привлечения трафика)
    await writer.write({
      records: [
        { type: 'url', data: 'https://www.yupitek.com' },
        { type: 'text', data: 'Технический блог о продуктах ALFA / ACS' },
      ],
    });

    out('Запись выполнена!');
  } catch (err) {
    out('Ошибка записи: ' + err.name + ' / ' + err.message);
  }
});

После записи поднесите ту же метку к ACR1252U-M1 (или к любому инструменту чтения с поддержкой NDEF), чтобы убедиться, что содержимое записано правильно.

2.5 Частые ошибки (подсказки по Debugging)
#

СимптомПричинаСпособ решения
Страница сообщает «NDEFReader is not defined»Настольные Chrome/Safari/Firefox не поддерживают Web NFCИспользуйте Android Chrome или ChromeOS; на macOS — путь PC/SC
scan() выбрасывает NotAllowedErrorНет жеста пользователя или страница не HTTPSВызывайте после нажатия кнопки; для локальной разработки используйте http://localhost
Метка определяется, но onreadingerror срабатывает постоянноНедостаточная ёмкость, повреждённый формат или карта не поддерживает NDEFПопробуйте пустую незаблокированную NTAG213/215
Запись обрывается на серединеМетка заблокирована (Lock Bits) или превышена ёмкостьПроверьте ёмкость (137/496 bytes) и биты блокировки; заблокированные метки не восстанавливаются
Нет событий после ухода с вкладки/выключения экранаWeb NFC работает только когда вкладка на переднем плане и в фокусеДержите вкладку открытой; фоновое сканирование — не предназначение Web NFC

Предупреждение о безопасности (чего делать не нужно): Web NFC может читать и записывать только то, «что метка позволяет». Если карта реализует проверку пароля, защищённый канал ISO 14443-4 или шифрование (например, серверную проверку в системе контроля доступа), браузер не может — и не должен — обходить её механизм безопасности. Все уроки этой статьи ограничены пустыми метками и тестовыми картами, которые принадлежат вам или на использование которых у вас есть разрешение.


3. Разработка команд APDU: управление зуммером и двухцветным светодиодом с помощью байтов
#

APDU — это «низкоуровневый язык» мира смарт-карт и считывателей. Web NFC упаковывает формат данных за вас; но управление самим считывателем ACR1252U-M1 на macOS — светом и зуммером — требует прямой отправки APDU.

3.1 Базовая структура APDU
#

Команда, отправляемая считывателю/карте, — это последовательность байтов следующего формата:

CLA  INS  P1  P2  Lc   Data(0~N bytes)   Le
└─класс команды┘└─команда┘└─параметры┘  └─длина данных┘  └─ожидаемая длина ответа┘
  • CLA: класс команды (0x00 = стандарт ISO 7816; 0xFF = собственное пространство команд производителя).
  • INS: код команды (0xA4 = SELECT, 0x20 = VERIFY, 0xCA = GET DATA…).
  • P1 P2: два байта параметров.
  • Lc: длина следующих за ним Data (можно опустить).
  • Le: ожидаемая длина ответа (Response) (можно опустить).

Ответ — это данные плюс два завершающих байта SW1 SW2; распространённые значения: 90 00 (успех), 6A 82 (файл не найден), 63 00 (проверка не пройдена).

3.2 Подготовка среды разработки на macOS
#

В macOS уже встроена поддержка PC/SC, поэтому достаточно установить pyscard для Python, чтобы сразу отправлять APDU:

# Установка pcsc-tools (включает pcsc_scan, удобно для проверки считывателя)
brew install pcsc-tools

# Установка pyscard (через системный фреймворк PC/SC в macOS)
pip install pyscard

# Проверка, что pyscard видит считыватели
python3 -c "from smartcard.System import readers; print(readers())"
# Ожидаемый вывод, примерно: ['ACS ACR1252U ... 00 00']

3.3 Первая APDU: Echo и версия прошивки
#

ACR1252U-M1 поддерживает стандартную «команду Echo» от ACS — её можно использовать как тест соединения; затем прочитайте версию прошивки, чтобы убедиться, что связь с компьютером в порядке:

from smartcard.System import readers
from smartcard.util import toHexString

reader = readers()[0]
conn = reader.createConnection()
conn.connect()

# 1) Echo: возвращает ASCII "12345678"
sw, data = conn.transmit([0xFF, 0x00, 0x00, 0x00, 0x00])
print('Echo SW :', toHexString(sw))
print('Echo данные:', ''.join(chr(b) for b in data))

# 2) Версия прошивки
sw, data = conn.transmit([0xFF, 0x00, 0x48, 0x00, 0x00])
print('Firmware:', toHexString(data))

Появление 12345678 означает, что канал PC/SC исправен и прошивка считывателя отвечает нормально.

3.4 Отправка APDU на карту: пример MIFARE DESFire
#

Представьте бесконтактную карту как «байтовую почтовую систему»: вы отправляете команду — она возвращает данные. На примере тестовой карты MIFARE DESFire, поддерживающей настоящий APDU (ISO 14443-4), отправьте команду «Get Version» (90 60 00 00 00):

# DESFire GetVersion: первый байт ответа 0x04 означает семейство DESFire (EV1/EV2/EV3)
sw, data = conn.transmit([0x90, 0x60, 0x00, 0x00, 0x00])
print('SW  :', toHexString(sw))
print('Data:', toHexString(data))
# Например: 04 01 01 00 04 12 08 01
#           └DESFire┘└строка версии┘     └прошивка/аппаратура/партия производства…┘

Если DESFire под рукой нет, можно использовать команду PPSE для пассивного зондирования любой бесконтактной платёжной карты EMV: 00 A4 04 00 0E 32 50 41 59 2E 53 59 53 2E 44 44 46 30 31 00 (SELECT “2PAY.SYS.DDF01”). Только на своих тестовых картах.

3.5 Управление зуммером и двухцветным (красным/зелёным) светодиодом
#

В корпусе ACR1252U-M1 установлены двухцветный светодиод (красный/зелёный) и однотональный зуммер — оба «управляются пользователем». Это самый распространённый способ обратной связи о состоянии в приложениях: проверка карты пройдена → один писк + зелёный свет; проверка не пройдена → красное мигание. Результат виден, не глядя на экран.

Для управления такими функциями «корпуса считывателя» используется собственное пространство команд производителя (команды APDU с префиксом FF; CLA=0xFF — зарезервированная область команд производителя). Типовая структура такая (соответствие байтов зависит от версии прошивки; перед разработкой сверяйтесь с официальным документом ACS «ACR1252U-M1 Application Programming Interface»):

FF  00  40  00  04  00  00  <LED>  <BUZZER>
└─префикс команды производителя─┘   └Len┘ └─параметры─┘  └свет┘ └длина писка┘
ПараметрПример значенияСмысл (по примеру прошивки)
LED0x00Выключен
LED0x01Красный свет
LED0x02Зелёный свет
LED0x03Красный + зелёный одновременно
BUZZER0x00Без писка
BUZZER0x04Писк около 1 секунды (единица времени — по официальному документу)
# Зелёный свет + короткий писк (пример байтов; сверьтесь с официальным API-документом вашей прошивки)
sw, data = conn.transmit([0xFF, 0x00, 0x40, 0x00, 0x04, 0x00, 0x00, 0x02, 0x04])
print('Ответ LED/Buzzer:', toHexString(sw))   # ожидается 90 00 (успех)

# Выключить
sw, data = conn.transmit([0xFF, 0x00, 0x40, 0x00, 0x04, 0x00, 0x00, 0x00, 0x00])

Замечание для разработки: определения байтов и единицы времени могут различаться между версиями прошивки. Правильный порядок: сначала прочитайте версию прошивки командой из 3.3, затем сверьтесь с официальным API-документом этой версии, чтобы подтвердить определения байтов LED/BUZZER, и проверьте реальным ответом SW1 SW2 = 90 00. Цель примеров в этой статье — показать метод разработки «управление корпусом устройства байтами», а не обход механизма проверки какой-либо карты.

Красная линия безопасности: управление зуммером и светодиодом — это видимое поведение самого считывателя и не связано с тем, «можно ли скопировать или подделать содержимое карты». Эта статья не предоставляет и не затрагивает никаких методов копирования бесконтактных карт доступа, обхода паролей или проверок безопасности карт; все тесты APDU проводите только на картах и устройствах, которые принадлежат вам или на использование которых у вас есть явное разрешение.


4. Контрольный лист совместимости перед покупкой (Pre-purchase Worksheet)
#

Прежде чем заказывать ACR1252U-M1, ответьте на вопросы таблицы ниже — результат напрямую определяет «покупать или нет и какую модель»:

4.1 Какая у вас основная среда?
#

Моя основная средаПодходящая технологияСтоит ли покупать ACR1252U?
Телефон Android/ноутбук ChromeOSWeb NFC API (браузер)✅ Можно купить, но Web NFC не будет использовать считыватель; браузер работает через встроенный чип NFC
macOS (Apple Silicon) + нативное приложениеPC/SC + APDU (pyscard/Swift)✅ Самая рекомендуемая комбинация, нативная поддержка
Браузер macOS (Safari/настольный Chrome)—⚠️ Web NFC не поддерживается вообще; если нужно только браузерное решение — используйте Android/ChromeOS
iOS (iPhone/iPad)Core NFC (фреймворк нативных приложений)⚠️ Считыватель не подходит (iOS требует встроенный NFC или периферию с сертификацией MFi); оценивайте отдельно
Linux (настольный/сервер)pcscd + PC/SC✅ Поддерживается (пакет ccid)
WindowsPC/SC✅ Поддерживается (встроенный драйвер CCID)

Полную таблицу поддержки браузеров (с деталями по каждому браузеру) см. в 2.1; здесь отвечаем только на вопрос «стоит ли покупать для вашей основной среды».

4.2 Что «я действительно хочу сделать»?
#

  • Хочу управлять считывателем напрямую через APDU в локальной программе macOS (зуммер, светодиод, чтение/запись бесконтактных карт) → Покупать
  • Хочу читать и записывать метки NDEF через Web NFC в браузере Chromium на Android/ChromeOS → Считыватель покупать не нужно; используйте встроенный NFC устройства; ACR1252U — только для проверки на стороне PC/SC
  • Хочу поддержку MIFARE/FeliCa/ISO 14443 B и других промышленных/карт доступа → Покупать (эта модель поддерживает ISO 14443 A/B, MIFARE и FeliCa)
  • Нужен слот SAM (модуль безопасного доступа) для экспериментов с диверсификацией ключей и взаимной аутентификацией → Покупать (встроенный слот SAM на 1× SIM-карту)
  • Хочу тестировать FIDO / WebAuthn или устройства типа YubiKey/PocketKey → Сначала уточните статус поддержки FIDO в официальной документации ACS (эта статья не подтверждает непроверенные спецификации)
  • На компьютере только порты USB-C, и не хочется переходников → Сначала проверьте, есть ли в официальной линейке ACS модель той же серии с интерфейсом USB-C (по официальному сайту ACS); у M1 фиксированный кабель USB-A

4.3 Краткая справка по характеристикам (сверьтесь перед заказом)
#

ПараметрACR1252U-M1
ИнтерфейсUSB Full Speed (12 Mbps), фиксированный кабель USB-A 1 m
Дальность считыванияДо примерно 50 mm (зависит от метки)
Скорость чтения/записи106/212/424 Kbps
Сертифицированные типы картВсе четыре типа NFC, ISO 14443 A/B, MIFARE Classic, FeliCa
Управление корпусомДвухцветный светодиод (красный/зелёный), однотональный зуммер (оба программируемые)
Дополнительный слот1× SAM (размер SIM, ISO 7816 Class A)
Размеры/вес98 × 65 × 12,8 mm/81 g
Питание5V, макс. 200 mA

Принцип решения: если ваши ответы сосредоточены вокруг «нативное приложение macOS + APDU + бесконтактные карты», ACR1252U-M1 — вариант с максимальным соответствием; если ваше приложение точно будет только в браузере, ориентируйтесь на Android/ChromeOS, а бюджет покупки потратьте на пустые метки и тестовые карты.


5. Заключение
#

Для разработчиков на Apple Silicon «нативная поддержка» — не прилагательное, а проверяемый инженерный факт. Благодаря стандартам CCID / PC/SC ACR1252U-M1 позволяет начать разработку на macOS без установки каких-либо драйверов. В сочетании с Web NFC (Chromium/Android/ChromeOS) и PC/SC APDU (локально на macOS) одна и та же партия меток NTAG213/NTAG215 позволяет полностью отработать «чтение, запись, управление» на обоих технических путях.

Запомните две вещи: сначала проверьте охват поддержки вашего браузера (Web NFC ограничен Chromium на Android/ChromeOS), затем решите, нужно ли вам управлять корпусом считывателя (это работа APDU). Остальное — дело байтов.


Приложение: приём обращений по устранению неполадок (для поддержки и пользователей)
#

СимптомЧто проверитьЧастая причина и решение
system_profiler SPCardReaderDataType не показывает считыватель на macOSСменить порт USB-A/проверить кабельПроблема кабеля или питания; ACR1252U-M1 не требует дополнительных драйверов, не скачивайте сторонние kext
pip install pyscard не работает или readers() пустПроверить Xcode Command Line ToolsСначала xcode-select --install; pyscard работает через системный фреймворк PC/SC
Ответ APDU 6F 00 или неожиданный код SWПроверить длину команды и префиксПространство команд производителя — по официальному API-документу; байты нельзя собирать произвольно
Зуммер/светодиод не реагируютПроверить версию прошивки, затем таблицу командБайты управления светом зависят от версии прошивки; ориентируйтесь на официальный документ этой версии
Браузер сообщает NDEFReader is not definedВернуться к таблице поддержки в 2.1Настольные Chrome/Safari и iOS не поддерживают; используйте Android Chrome/ChromeOS
Запись метки не удаётсяПроверить ёмкость и состояние блокировкиЛимиты 137/496 bytes; заблокированные (Lock Bits) метки не восстанавливаются; метки с паролем требуют сначала PWD_AUTH
Одна и та же карта читается то так, то сякПроверить положение и расстояниеНужно менее 50 mm и подальше от металлических поверхностей; подносите перпендикулярно к центру зоны считывания

Отказ от ответственности: эта статья — техническое описание для академических и инженерных целей разработки. Охват поддержки Web NFC определяется официальными объявлениями каждого браузера; определения байтов APDU и поведение считывателя — версией прошивки ACR1252U-M1 и официальной документацией ACS. Все тесты с бесконтактными картами проводите на устройствах, которые принадлежат вам или на использование которых у вас есть явное разрешение. Эта статья не является официальным обязательством совместимости с какими-либо коммерческими системами или брендами и не предоставляет методов обхода механизмов безопасности карт.

Здесь пока нет статей.