В документации применяется IP-адрес системы 192.168.10.1, этот адрес может отличаться от текущих настроек Вашего прибора. Перед выполнением http запросов, описанных в настоящем документе, пожалуйста, убедитесь, что используемый IP-адрес актуален.

RFID-системы SAUK с поддержкой сетевых интерфейсов Ethernet или Wi-Fi, могут быть интегрированы в сторонние информационно-учетные системы с применением унифицированного открытого протокола «WEB API. Коммутационный протокол для RFID-систем SAUK». Протокол, описываемый в настоящем документе, является разновидностью API клиент-серверной архитектуры REST (Representational State Transfer).

В этой главе описываются способы включения процесса инвентаризации меток (сканирования меток), а также описано, как метка и её идентификационные данные, представлены в оперативной памяти прибора. Способы включения процесса инвентаризации меток:

• Прибор SAUK начинает процесс непрерывной инвентаризации меток в тот момент, когда устанавливается флаг /rfidconfig?infiniteinventory в состояние true. В графическом пользовательском интерфейсе процесс инвентаризации меток запускается путем включения чекбокса «Непрерывное сканирование» во вкладке меню № 1. Процесс инвентаризации будет продолжаться непрерывно до тех пор, пока его не отключить.
• Инвентаризацию меток можно выполнять кратковременно путем выполнения сервисной команды /inventory_once. Соответствующая кнопка в графическом интерфейсе «Сканировать 1 раз» расположена во вкладке меню № 2. При выполнении команды произойдет кратковременное включение радиотракта. При этом процесс включения может производиться несколько раз подряд, количество включений задается параметром /rfidconfig?repeattime, соответствующий параметр графического интерфейса – Считываний за 1 команду¹ во вкладке меню № 1.
• Инвентаризацию меток можно выполнять по внешнему событию – при срабатывании цифрового входа HOLD. При подаче управляющего воздействия на цифровой вход флаг непрерывного сканирования будет взведен автоматически на минимальное время, которое установлено в настройках, вплоть до полного снятия управляющего воздействия с порта Hold.

¹ Если вы работаете в режиме непрерывной инвентаризации, то значение параметра «Считываний за 1 команду» следует установить в 1.
В том или ином случае активируется сканирование RFID-меток. При возникновении RFID-метки в зоне действия системы, она идентифицируется мгновенно, после чего попадает в буфер «Таблица идентификации», при этом, запись о каждой метке дополняется системным временем идентификации метки RTC² , номером антенны ANT³ , силой RSSI сигнала отметка метки, счётчиком успешных сканирований метки CNT (в зависимости от настроек, может считываться дополнительная область памяти метки, например TID или USER). В большинстве случаев этой информации вполне достаточно для последующей постобработки и аналитики данных. После попадания метки в таблицу идентификации, вышеуказанные данные будут обновлены по истечению таймаута «Время сна метки». Ключевым полем для поиска метки в таблице идентификации является EPC-номер метки. ² Если вы работаете в режиме непрерывной инвентаризации, то значение параметра «Считываний за 1 команду» следует установить в 1. ³ Для системы с одной антенной типа моноблок – номер всегда №1. Для многопортовых систем – от 1 до 4 Пример данных из таблицы идентификации:

{  "RTC":"01:20:59",  "CNT":1,  "ANT":1, 
 "PC":"3400",  "EPC":
"7716710A1CD1000000000003","EPCLEN":12,  
"BANK":2,"DATA":
"E280110C2000710A1CD108F6","DATALEN":12,  
"PHASE":176,  "RSSI":-42 }

Каждый раз при успешном сканировании RFID-метки счетчик CNT будет инкрементироваться на 1, время регистрации метки будет обновлено, значения параметров также RSSI, PHASE будут актуализироваться. Если в течение таймаута «Время удержания в таблице» метка прочитана не будет, то она будет удалена из таблицы идентификации.
Обратите внимание. После первого попадания метки в таблицу идентификации и каждый раз при последующем её сканировании, по истечению таймаута «Время сна метки» будут выполняться следующие автоматические сценарии (если они активны, то есть включены в настройках прибора – см. соответствующий раздел):

• коммутация реле в соответствии с правилами коммутации реле (см. раздел /peripheryconfig);
• отправка уведомлений на хост по каналам UART (см. раздел /tagidentity);
• отправка уведомлений на хост по каналам Ethernet и Wi-Fi (см. раздел /tagidentity);
• управление интерфейсными линиями Wiegand;
• иллюминация внешней светодиодной RGB индикации (на лицевой панели прибора SAUK).

² Системное время с момента старта прибора или с момента синхронизации встроенного таймера со временем хоста, либо время из часов реального времени.
³ Для системы с одной антенной типа моноблок – номер всегда №1. Для многопортовых систем – от 1 до 4.

Большая часть автоматических сценариев таких как управления реле, отправка данных по интерфейсам Wiegand, отправка уведомлений на хост, срабатывают после прохождения меткой процедуры проверки идентификационных параметров на соответствие ряду правил. Процесс проверки соответствия этим правилам называется «проверка прав доступа». Права доступа могут проверяться по следующим основным критериям:

• соответствие части EPC-номера фильтру (как правило это значение первых нескольких байт EPC-номера).
• Проверка пароля доступа AccessPassword к памяти EPC-метки.
• Проверка наличия EPC-номера метки в таблице доступа и проверка разрешения доступа для этой метки.

Действия в случае соответствия и несоответствия вышеописанным критериям:

• Если метка соответствует критериям, то производится срабатывание настроенных автоматических сценариев. Также производится подсветка RGB светодиодной индикации на лицевой панели прибора или на специализированной выносной панели индикации (в зависимости от модификации прибора). Светодиодная индикация загорается зеленым цветом. Также метка попадает в таблице идентификации.
• Если метка не соответствует критериям, то выполнение автоматических сценариев блокируется, а метка не попадает в таблицу идентификации. Подсветка RGB загорается голубым цветом (за исключением единственного случая – если проверка пароля AccessPassword не была пройдена).

Пример запроса данных из RFID-системы. Запрос меток, которые обнаружила система (запрос меток из таблицы идентификации).
Запрос: http://192.168.10.1/taglist
Ответ:

{"list": [  {"RTC":"01:20:59","CNT":110,
"ANT":1,"PC":"3400",   
"EPC":"7716710A1CD1000000000003",
"EPCLEN":12,"RSSI":-74},  
{"RTC":"01:20:59","CNT":248,"ANT":1,"PC":
"3400",   "EPC":"77770021D158000000000001
","EPCLEN":12,"RSSI":-29} ]}

Анализируя результат запроса видно, что в буфере прибора хранится две RFID-метки, EPC-номер первой из них 7716710A1CD1000000000003, а второй 77770021D158000000000001. Также видно, что обе метки попали в зону действия антенны №1. При этом, сигнал от метки №2 с уровнем -29 dBm более уверенный, нежели от метки №1 с уровнем -74 dBm. Также видно, что метка №2 была успешно просканирована 248 раз, а метка №1 только 110 раз. По вышеописанным данным уже можно сделать некоторые выводы и предположения о качестве беспроводной связи с метками, то есть, о качестве сканирования метки:

• Например, зная, что обе метки одинаковые, и сканирование обоих меток начато одновременно, можно предположить, что метка №2 находится ближе к антенне, а метка №1 расположена на удалении.
• Например, если обе метки используются одинаково (допустим, они наклеены на одинаковые коробки с товарами), и метки находятся равноудалены относительно антенны. То метка №2 имеет более выгодное расположение, а метку №1 следует расположить немного иначе – тем самым попытаться улучшить качество её сканирования.

При работе с системой SAUK могут быть настроены уведомления об обнаруженных RFID-метках. Уведомления – это сообщения, об обнаруженных RFID-метках, которые отправляются на хост. Уведомления о RFID-метках отправляются на хост с некоторой задержкой, которая составляет величину от 5 мс до 1000 мс после появления RFID-метки в зоне действия антенны. Уведомление отправляется по технологии сокетов (Socket TCP/IP). При работе с уведомлениями важно, чтобы на стороне хоста было серверное приложение, которое должно слушать все входящие соединения по указанному в настройках номеру порта. Формат уведомления может быть байтовым или текстовым, запакованным в строку JSON. Более подробно об уведомлениях и формате пересылки данных написано в соответствующем разделе настоящей документации.
```

Запросы, в соответствии протоколом WEB API, возможно отправлять не только из сторонней информационно-учетной системы, а также через адресную строку браузера. Однако целевое назначение API – работа с оборудованием не из браузера, а именно из сторонней информационно-управляющей системы. Для упрощения разъяснений и благодаря возможности быстрой проверки выполнения команд и получения результата, будем рассматривать отправку запросов через браузер.

Выполнение через адресную строку: http://192.168.10.1/rfidconfig Ответ: cтрока в формате JSON, которая содержит значение регистра rfidconfig. Через WEB-интерфейс: пользователь разворачивает вкладку меню №1

Выполнение через адресную строку: http://192.168.10.1/rfidconfig?infiniteinventory=false Ответ: cтрока в формате JSON, которая содержит значение регистра rfidconfig. Через WEB-интерфейс: отключение чекбокса «Непрерывное сканирование» во вкладке меню №1

Выполнение через адресную строку: http://192.168.10.1/rfidconfig?pwrant1=23&infiniteinventory=true Ответ: cтрока в формате JSON, которая содержит значение регистра rfidconfig. Через WEB-интерфейс: во вкладке меню №1 – пользователь настраивает мощность путем перемещения ползунка регулировки мощности для антенны №1, затем производит включение «Непрерывное сканирование».
Обратите внимание. Изменения того или иного параметра в регистре приводит к возврату JSON-строки, которая содержит все параметры регистра (в данном примере – регистра rfidconfig), но уже с обновленными значениями параметра или нескольких параметров (если они менялись при выполнении запроса). ```

Параметры, которые доступны для чтения или для настройки сгруппированы по ряду критериев. Группа параметров получила название Регистр, который по сути выполняет функцию контроллера, выполнение которого происходит при получении http запроса со стороны клиента – с хоста. Относительно графического WEB-интерфейса, эти регистры также сгруппированы «по интересам» и сформированы в виде так называемых, вкладок меню. В таблице 3.1 представлено краткое описание функциональности регистров, а также представлено их сопоставление с элементами графического пользовательского интерфейса.

Команды, выполняемые прибором, сгруппированы аналогичным образом. В большинстве случаев в графическом пользовательском интерфейсе представлены кнопки, располагаемые во вкладках меню аналогичным образом – в той группе, к которой она наиболее близка по смыслу. Также в приборе реализован ряд команд, которые не имеют специального графического отображения в пользовательском интерфейсе.

В RFID-системе SAUK предусмотрена проверка прав доступа метки по таблице доступа. Проверка прав доступа проверяется различными методами

```

Конфигурационные регистры могут быть просто прочитаны из внутренней памяти прибора либо значения параметров регистров могут быть изменены.

• Http-запрос без параметров. Прибор вернет значение регистра в виде строки, запакованной в формат JSON. Эта строка будет содержать все параметры регистра (в том числе, доступные для последующего изменения).

Например, http://192.168.10.1/rfidconfig - чтение регистра целиком.

• Http-запрос с параметрами будет интерпретирован прибором SAUK как попытка внести изменения в значение того или иного параметра регистра.

Например, http://192.168.10.1/rfidconfig?infiniteinventory=true. Выполнение такого запроса приведет к изменению значения параметра infiniteinventory.

Пример ответа:

{ 
"firmware":"1.9", 
"infiniteinventory":false, 
"rf": 
{   
"rf_session":4,   
"freq_start":866300,   
"freq_space":60,   
"freq_quan":3,   
"repeattime":1 
}, 
"trigger": 
{   
"support":true,   
"enable":[false,false],   
"min_hold_ms":5000 
}, 
"antennas": 
{   
"min_power":18,   
"max_power":30,   
"quantity":4,   
"enable":[true,false,false,false],   
"power":[22,19,19,19],   
"s11":[255,255,255,255],   
"triggered":[1,1,0,0] 
} 
}

Ответ: cтрока в формате JSON, которая содержит значение регистра rfidconfig.

4.1.3. Изменение излучаемых частот RFID-системы
Настройка излучаемых частот производится в соответствии с таблицей «Типовые значения частотных настроек радиоизлучения».

Значение параметра задается в диапазоне от 1 до 30. При работе в режиме непрерывного сканирования данный параметр следует задать равным 1. При установке значения, отличного от 1, при нажатии на кнопку «Сканировать 1 раз» или при выполнении команды /inventory_once прибор просканирует метку заданное количество раз (то есть радиотракт будет кратковременно включаться и отключаться заданное количество раз). Ответ: строка в формате JSON, которая содержит значение регистра rfidconfig. ```

{    
"READER": "Серийный номер считывателя",    
"EPC": "Уникальный номер метки, 
закодированный в память EPC",    
"DATA": "Дополнительные данные из памяти 
RFID-метки, например, TID-номер",    
"DB": "Номер банка памяти из которого 
прочитаны дополнительные данные",    
"RSSI": "Сила сигнала -90 самый слабый, 
30 самый сильный",    
"ANT": "Номер RFID-антенны, которая 
обнаружила метку" 
}