wiki:ApiSlotcnt

Version 2 (modified by alx, 7 years ago) ( diff )

Добавлена ссылка на slotcntres

Команда slotcnt

Назначение команды

Клманда slotcnt позволяет получить информацию о состоянии служебных коммуникационных каналов между активной платой SW-01 и другими платами блока. Активная плата выполняет периодический опрос наличия и состояния плат в каждом слоте блока. Для каждого слота в кассете имеется набор счетчиков, сохраняющих статистику обмена сообщениями с платами.

Ключи запроса

Ключ Тип значения обязательный Описание
cmd строка да "slotcnt" - имя команды

Пример запроса

{"cmd":"slotcnt"}

Права доступа

Для выполнения команды slotcnt не требуется наличия каких-либо прав.

Возвращаемые данные

В случае успешного выполнения команда slotcnt возвращает JSON-объект со следующими ключами:

Ключ Тип значения Описание
cmd строка "slotcnt" - имя команды
slots массив массив JSON-объектов, каждый из которых содержит режим обмена и набор счетчиком, связанные с одним из слотов блока. Описание ключей хэша дано ниже.

Элементы массива slots содержат следующие ключи:

Ключ Тип значения Описание
slot число Номер слота.
crcMode число Режим контроля целостности сообщений шины управления:
0 - XOR8;
1 - CRC16;
2 - CRC32.
rx_ok число Число успешно полученных сообщений (сообщений с корректной длиной и верной контрольной суммой).
rx_bytes число Число байт успешно принятых сообщений (сообщений с корректной длиной и верной контрольной суммой).
rx_bad число Число сообщений, принятых с неверной контрольной суммой.
rx_big число Число сообщений, размер которых превышает размер приемного буфера.
rx_short число Число сообщений, размер которых меньше минимально допустимого (2 байта плюс контрольная сумма).
rx_discarded число Число сообщений, отброшенных в результате обнаружения логических ошибок в процессе приема (например два ESC-символа подряд, флаг после ESC-символа и т.п.).
un_requests число Число успешно принятых, но не обработанных запросов. Наличие таких запросов может свидетельствовать о том, что ПО мастер-платы SW-01 устарело, либо о логических ошибках в процессе обмена сообщениями между платами.
tx_ok число Число переданных сообщений.
tx_bytes число Число байт переданных сообщений.
tx_dropped число Число сообщений, полученных от функций верхнего уровня для передачи плате, но отброшенных транспортом из-за превышения максимально допустимого размера.

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

{
  "cmd":"slotcnt",
  "slots":[
    {
      "crcMode":0,
      "rx_bad":0,
      "rx_big":0,
      "rx_bytes":2860967,
      "rx_discarded":0,
      "rx_ok":111783,
      "rx_short":0,
      "slot":1,
      "tx_bytes":1021078,
      "tx_dropped":0,
      "tx_ok":111783,
      "un_requests":0
    },
    {
      "crcMode":0,
      "rx_bad":0,
      "rx_big":0,
      "rx_bytes":3006498,
      "rx_discarded":0,
      "rx_ok":111744,
      "rx_short":0,
      "slot":2,
      "tx_bytes":1044286,
      "tx_dropped":0,
      "tx_ok":111746,
      "un_requests":0
    },
    .....
    {
      "crcMode":0,
      "rx_bad":0,
      "rx_big":0,
      "rx_bytes":0,
      "rx_discarded":0,
      "rx_ok":0,
      "rx_short":0,
      "slot":22,
      "tx_bytes":399385,
      "tx_dropped":0,
      "tx_ok":48609,
      "un_requests":0
    }
  ]
}

См. также

команда board, команда slotcntres

Note: See TracWiki for help on using the wiki.