Q-LTK

Q-LTK - это сервис выполняющий взаимодействие между оборудованием RFID, которое поддерживает протокол LLRP. Сервис выполняет подключение к считывателям RFID и получает данные меток в зоне видимости антенн считывателя.

Сервис может быть развернут для систем Windows, Linux (включая Docker). Конфигурирование параметров считывателя осуществляется при помощи файла спецификации addRoSpec.xml.

Дистрибутив программного обеспечения Q-LTK предоставляется по запросу через сайт https://querion.ru

Установка¶

Установка Q-LTK в качестве сервиса зависит от особенностей целевой платформы и выполняется по разному.

Сервис Windows¶

Требования

Для установки сервиса в качестве службы Windows необходимо, чтобы в системе был установлен фреймворк .NET версии 5.x.x (скачать).

Далее необходимо выполнить установку службы:

Откройте командную строку от пользователя с правами администратора.

Выполните команду

sc.exe create "Q_LTK_Service" binpath="{Absolute-Path-To}\dotnet.exe {Absolute-Path-To-Q_LTK}\App.WindowsService.dll"

где:

Absolute-Path-To - путь к папке куда был установлен .NET
Absolute-Path-To-Q_LTK - путь к папке с файлами Q-LTK

Если команда выше выполнилась без ошибок в списке служб Windows должна появится служба с названием Q_LTK_Service

Необходимо убедиться, что она запускается и имеет статус Работает

Настройка параметров сервиса¶

Для выполнения настройки сервиса необходимо использовать файлы конфигурации в каталоге config основного дистрибутива. В данном каталоге для настройки предусмотрены три файла:

appsettings.json - предназначен для настройки параметров подключения к считывателям и внешним сервисам
addRoSpec.xml - используется для настройки внутренних параметров и режимов считывателя
nlog.config - настройка параметров логгера (документация по настройке), не требует дополнительной настройки.

Параметры appsettings.json¶

Файл представляет собой типовой объект JSON:

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft": "Warning",
      "Microsoft.Hosting.Lifetime": "Information"
    },
    "EventLog": {
      "LogLevel": {
        "Default": "Information",
        "Microsoft.Hosting.Lifetime": "Information"
      }
    }
  },
  "Readers": [
    {
      "Reader": "192.168.88.47",
      "Options": [ "-t" ],
      "Session": 1,
      "SearchMode": 1,
      "ModeIndex": 1000,
      "RoSpecXML": "config\\addRoSpec.xml",
      "HttpService": {
        "UID": "2532c6de-a817-4a20-86c1-7eb46adca1be",
        "URL": "http://127.0.0.1:8088/test",
        "Login": "admin",
        "Password": "password"
      }
    },
    {
        ...
        ...
        ...
    }
  ]

В данном файле рекомендуется изменять параметры только для объекта Readers, которые представляется собой список (массив) объектов считывателей

Reader - адрес или имя хоста считывателя к которому необходимо подключиться Options - режимы чтения блока памяти меток

Список параметров

Usage: docSample5.exe [options] READERHOSTNAME
     -p <password> -- specify an optional password for operations
     -n <password> -- specifies a new password for the set password command
     -t  -- specify to automatically backscatter the TID
     -s  -- if setting QT config, -s will short range the tag
     -q <n> -- run QT scenario n where n is defined as 
      0 -- Read standard TID memory
      1 -- set tag password (uses -p, -n )
      2 -- Read private memory data without QT commands
      3 -- read QT status of tag (uses -p)
      4 -- set QT status of tag to private (uses -p, -s)
      5 -- set QT status of tag to public (uses -p, -s)
      6 -- Peek at private memory data with temporary QT command (uses -p)
      7 -- Write 32 words of user data to random values
      8 -- Write 6 words of public EPC data to random values
      9 -- Read Reserved memory

Session, SearchMode - режимы работы с сессиями RFID меток (подробнее)

ModeIndex - параметры режимов подключения и работы к считывателя Impinj. Поддерживаемый режим считывателя зависит от региона и модели считывателя/шлюза Impinj.

Таблица режимов совместимости

Mode Index	Mode Name	Regions	R120 1port	R220 2port	R420 4port	R640 xPortal	R660 xSpan	R680 xArray
0	Max Throughput	All			Y	Y	Y	Y
1	Hybrid Mode(M=2)	All			Y	Y	Y	Y
2	Dense Reader (M=4)	All	Y	Y	Y	Y	Y	Y
3	Dense Reader (M=8)	All	Y	Y	Y	Y	Y	Y
4	Max Miller (M=4)	Not supported by regions supporting mode 5.			Y	Y	Y	Y
5	Dense Reader (M=4) 2	ETSI, China, India, Japan, Korea, and So. Africa	Y	Y	Y	Y	Y	Y
1000	AutoSet Dense Reader	All	Y	Y	Y	Y	Y	Y
1002	AutoSet Dense Reader Deep Scan	All	Y*	Y*	Y	Y	Y	Y
1003	AutoSet Static Fast	All			Y	Y	Y	Y
1004	AutoSet Static Dense Reader	All			Y	Y	Y	Y

RoSpecXML - путь к основному файлу конфигурации параметров считывателя

HttpService - параметры сервера на который будут отправляться сообщения с прочитанными RFID данными

   UID - уникальный идентификатор считывателя во внешней системе
   URL - ip-адрес или имя хоста сервиса внешней системы
   Login - имя пользователя для авторизации во внешней системе 
   Password - пароль авторизации во внешней системе

На данный момент поддерживается авторизация через механизм Basic Authenticate либо через параметра token в URL запроса.

Параметры addRoSpec.xml¶

Основной файл конфигурации определяющий параметры считывания данных RFID. Параметры в ROSpec сообщают считывателю Speedway, какие данные и каким образом считыватель будет их читать.

Внимание!

Не меняйте содержимое файла если вы точно не уверены, что понимаете структура параметров и их спецификацию. Рекомендуется менять только существующие значения параметров.

Регулировка мощности антенн¶

Для настройки мощности антенн необходимо задать значение необходимое для каждой антенны. Параметры отвечающие за это содержаться в файле addRoSpec.xml указанного в параметрах соответствующего считывателя. Основными параметрами, которые отвечают за регулировку мощности считывания являются:

N - номер антенны

ReceiverSensitivity - (чувствительность приема) величина, которая определят значение RSSI для обратного радиосигнала после опроса (облучения) метки. Метки RFID, значения RSSI которых будет ниже указанного в параметрах RoSpec, игнорируются. Новые параметры задаются индексом в соответствии с таблицей значений:

Таблица значений чувствительности

Индекс 1 - имеет максимальную чувствительность

Index	ReceiveSensitivityValue	Receive Sensitivity (dBm)
1	0	-80
2	10	-70
3	11	-69
4	12	-68
5	13	-67
6	14	-66
7	15	-65
8	16	-64
9	17	-63
10	18	-62
11	19	-61
12	20	-60
13	21	-59
14	22	-58
15	23	-57
16	24	-56
17	25	-55
18	26	-54
19	27	-53
20	28	-52
21	29	-51
22	30	-50
23	31	-49
24	32	-48
25	33	-47
26	34	-46
27	35	-45
28	36	-44
29	37	-43
30	38	-42
31	39	-41
32	40	-40
33	41	-39
34	42	-38
35	43	-37
36	44	-36
37	45	-35
38	46	-34
39	47	-33
40	48	-32
41	49	-31
42	50	-30

TransmitPower - данный параметр определяет мощность с которой считыватель будет выполнять опрос (облучение) RFID метки. Новые параметры задаются индексом, в соответствии с таблицей значений:

Таблица значений мощности

Индекс 1 - имеет минимальное чувствительность

Index	TransmitPowerValue	Transmit Power (dBm)
1	1000	10.00
2	1025	10.25
3	1050	10.50
4	1075	10.75
5	1100	11.00
6	1125	11.25
7	1150	11.50
8	1175	11.75
9	1200	12.00
10	1225	12.25
11	1250	12.50
12	1275	12.75
13	1300	13.00
14	1325	13.25
15	1350	13.50
16	1375	13.75
17	1400	14.00
18	1425	14.25
19	1450	14.50
20	1475	14.75
21	1500	15.00
22	1525	15.25
23	1550	15.50
24	1575	15.75
25	1600	16.00
26	1625	16.25
27	1650	16.50
28	1675	16.75
29	1700	17.00
30	1725	17.25
31	1750	17.50
32	1775	17.75
33	1800	18.00
34	1825	18.25
35	1850	18.50
36	1875	18.75
37	1900	19.00
38	1925	19.25
39	1950	19.50
40	1975	19.75
41	2000	20.00
42	2025	20.25
43	2050	20.50
44	2075	20.75
45	2100	21.00
46	2125	21.25
47	2150	21.50
48	2175	21.75
49	2200	22.00
50	2225	22.25
51	2250	22.50
52	2275	22.75
53	2300	23.00
54	2325	23.25
55	2350	23.50
56	2375	23.75
57	2400	24.00
58	2425	24.25
59	2450	24.50
60	2475	24.75
61	2500	25.00
62	2525	25.25
63	2550	25.50
64	2575	25.75
65	2600	26.00
66	2625	26.25
67	2650	26.50
68	2675	26.75
69	2700	27.00
70	2725	27.25
71	2750	27.50
72	2775	27.75
73	2800	28.00
74	2825	28.25
75	2850	28.50
76	2875	28.75
77	2900	29.00
78	2925	29.25
79	2950	29.50
80	2975	29.75
81	3000	30.00
82	3025	30.25
83	3050	30.50
84	3075	30.75
85	3100	31.00
86	3125	31.25
87	3150	31.50
88	3175	31.75
89	3200	32.00
90	3225	32.25
91	3250	32.50
92	3275	32.75
93	3300	33.00

<AntennaConfiguration>
 <AntennaID>N</AntennaID>
  ...
   <RFReceiver>
     <ReceiverSensitivity>42</ReceiverSensitivity>
   </RFReceiver>
   ...
   <RFTransmitter>
      ...
      <TransmitPower>1</TransmitPower>
      ...
   </RFTransmitter>
  ...
 </AntennaConfiguration>
<AntennaConfiguration>