firmware

Добавлены эндпоинты для обновления прошивки СКО.

⚠️Важно! Этот процесс достаточно чувствительный к питанию СКО

⚠️При отключении питания СКО может стать неисправно

⚠️Процесс может занять до нескольких минут времени. Ответ на запрос будет выдан только по завершении обновления.

⚠️После завершения обновления СКО “переподключается”, соответственно без передачи заголовка tokens.refresh со значением true будет не найдено.

Проверить совместимость tsrv c версией СКО можно следующим образом:

1. Запросить информацию об СКО: Получение СКО
2. В ответе извлечь поле is_compatible. В случае, если версия ПО несовместима с версией прошивки СКО, значение будет равно false

Перед обновлением стоит убедиться, что прошивка доступна: 1.

{
   "address": "ik.service.token.firmware",
   "headers": {
      "action": "check",
   },
   "data": null,
   "type": "send"
}

Ответ следующего формата:

{
   "type": "send",
   "data": {
      "version": "1.17" <--- или `null`, если прошивка отсутствует
   }
}

В случае, если is_compatible == false и в ответе на наличие обновления прошивки пришел null в поле version, следует обратиться в соответствующий интеграционный чат с предоставлением информации о рег. номере и серийном номере СКО.

Процесс обновления прошивки через эндпоинты выглядит следующим образом:

1. Требуется авторизация по PUK коду:

{
   "address": "ik.service.token.authority",
   "headers": {
      "action": "authorize",
      "tokens.refresh": true
   },
   "type": "send",
   "data": {
      "puk": "12345678"
   }
}

⚠️Если авторизация по пин-коду была пройдена, требуется сделать logout

2. Выполнить запрос на обновление прошивки:

{
   "address": "ik.service.token.firmware",
   "headers": {
      "action": "upgrade",
      "tokens.refresh": "true"
   },
   "data": null,
   "type": "send"
}

В ответ будет отдан ответ в формате:

{
   "type": "send",
   "data": {
      "version": "1.17" <--- Либо null, если обновление не найдено
   }
}

⚠️ Этот этап может занять существенно времени в зависимости от ряда условий: интернет соединение, скорость и стабильность USB порта. Важно, что на этом этапе отключение tsrv, перезапуск ПК или отключение СКО в том числе из-за сбоя питания недопустимо и может привести к полной неисправности СКО

3. После получения ответа СКО будет переподключено и можно выполнить авторизацию по пин-коду. При авторизации рекомендуется передать tokens.refresh со значением true для поиска СКО среди USB устройств