=  Команда slotcnt  =

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

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

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

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

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

 `{"cmd":"slotcnt"}`

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

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

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

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

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

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

||  '''Ключ'''  ||  '''Тип значения'''  ||  '''Описание'''  ||
||  slot  ||  число  || Номер слота. ||
||  crcMode  ||  число  || Режим контроля целостности сообщений шины управления:[[br]]0 - XOR8;[[br]]1 - CRC16;[[br]]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
    }
  ]
}
}}}

== См. также ==

[wiki:ApiBoard команда board], [ApiSlotcntres команда slotcntres]