Модуль расширения: CAN, WBE2-I-CAN-ISO v.2

From Wiren Board
This is the approved revision of this page, as well as being the most recent.


Купить в интернет-магазине

Эта страница описывает новое устройство WBE2-I-CAN-ISO v.2, описание предыдущей версии WBE2-I-CAN v.1.

Обратная сторона модуля WBE2-I-CAN-ISO v.2
Лицевая сторона модуля WBE2-I-CAN-ISO v.2

Описание модуля

Доступно с релиза wb-2602 WBE2-I-CAN-ISO v.2 — модуль с изолированным CAN интерфейсом. В Linux модуль работает как сетевой интерфейс CAN через мост Holtek HT42B416 (UART-CAN).

Распиновка

Сигналы CAN выведены на клеммы модуля расширения O1-O3.

Распиновка
Клемма Функция
O1 CAN H
O2 CAN L
O3 CAN GND (Isolated GND)

Технические характеристики

Параметр Значение
Скорость CAN 5...1000 кбит/с
Скорость UART 115200 бит/с
Размер буфера RX+TX 28+28 байт
Напряжение изоляции 1 кВ
Диапазон температур -40...+80℃

Совместимость

В конфигурациях плат wb84x модуль доступен для внутренних слотов MOD2 и MOD3, а в wb85x модуль доступен для внутренних слотов MOD1MOD4.

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

Совместимость модулей и разъёмов контроллера
Наименование WB6.3-6.6 WB6.7/WB7 WB8.4 WB8.5
MOD1 MOD2 MOD3 MOD1 MOD2 MOD3 MOD4 MOD1 MOD2 MOD3 MOD4 MOD1 MOD2 MOD3 MOD4
WBE2-I-CAN-ISO v.2 - - - - - - - - + + - + + + +

Установка

При заказе модулей в комплекте с контроллером Wiren Board, мы устанавливаем их на производстве — вам нужно только настроить модули в веб-интерфейсе контроллера.

Если вы купили модули отдельно, установите их самостоятельно:

  1. Разберите корпус контроллера.
  2. Установите модуль, соблюдая полярность: выступ на нем должен попасть в паз на плате контроллера.


Конфигурирование

Настройка в веб-интерфейсе контроллера

Доступно с релиза wb-2602 Подробнее о том, как обновить прошивку контроллера.

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

  1. В веб-интерфейсе откройте НастройкиКонфигурационные файлыМодули расширения и порты.
  2. Выберите внутренний слот, в который установлен модуль.
  3. В списке Тип модуля выберите WBE2-I-CAN.
  4. Нажмите Сохранить.

Для удаления модуля выберите тип Не установлен.

Параметры модуля

Все параметры хранятся в /etc/wb-hardware.conf в секции выбранного слота.

Параметр (ключ в /etc/wb-hardware.conf) Значения По умолчанию Описание
autoUp enabled / disabled enabled Автоматически применяет настройки и поднимает CAN-интерфейс при инициализации модуля. При disabled автоподнятие и применение настроек отключены.
bitrate 5000, 10000, 20000, 50000, 100000, 125000, 250000, 500000, 800000, 1000000 125000 Битрейт CAN, применяется при автоподнятии.
listenOnly enabled / disabled disabled Передаётся как listen-only on/off при автоподнятии интерфейса.
loopback enabled / disabled disabled Передаётся как loopback on/off при автоподнятии интерфейса.
restartMs целое число ≥ 0 1000 Передаётся как restart-ms <значение> при автоподнятии. Значение 0 отключает автовосстановление после bus-off.
terminator enabled / disabled disabled Управляет 120Ω резистором-терминатором CAN.

Имя интерфейса

При инициализации модуль переименовывает CAN-интерфейс в canMODx, где x — номер внутреннего слота (1–4).

Найти его в списке сетевых интерфейсов можно через SSH выполнив команду:

ip a

Поведение в системе

В NetworkManager интерфейс переводится в unmanaged, чтобы NetworkManager не изменял параметры CAN.

Ручная настройка

Пример конфигурации в /etc/wb-hardware.conf:

{
  "mod1": {
    "module": "wbe2-i-can",
    "options": {
      "autoUp": "enabled",
      "bitrate": 125000,
      "listenOnly": "disabled",
      "loopback": "disabled",
      "restartMs": 1000,
      "terminator": "enabled"
    }
  }
}

Особенность работы на скорости выше 100 кбит/с

Несмотря на то, что модуль поддерживает скорость шины CAN до 1 Мбит/с, внутри контроллера он общается по UART со скоростью 115200 бит/с. Эти скорости не связаны напрямую, т.к. CAN-мост работает на основе буферов FIFO.

Для передачи пакета из контроллера в шину CAN, по UART данные поступают сначала в буфер 28 байт на модуле и, как только сформируется пакет CAN, он отправляется из буфера в шину. Пока модуль не отчитается, что пакет отправлен в шину, контроллер не отправит следующий пакет по UART (защита от переполнения буфера, если скорость CAN меньше UART).

Данные, приходящие из CAN-шины, также складываются в буфер 28 байт, затем передаются по UART между модулем и контроллером. Если скорость CAN 100 кбит/с, иногда буфер может переполняться и будут ошибки. Такое возможно, если шина достаточно забита трафиком от других устройств или на контроллер приходят пакеты CAN FD длиннее 20 байт (DLC 11). Тогда новые данные по шине приходят быстрее, чем успевают выгружаться из буфера модуля по UART и часть пакетов затирается. Надежная работа модуля на скоростях шины 125...1000 кбит/с возможна, если интервал времени между пакетами позволит буферу успеть "разгрузиться" по UART на скорости 115200 бит/с.

Известные неисправности

Аппаратные ошибки/особенности WBE2-I-CAN v.2, найденные при эксплуатации устройства.

Ревизии устройства

Номер партии (Batch №) указан на наклейке на боковой поверхности корпуса или на печатной плате.

Ревизия Партии Дата выпуска Отличия от предыдущей ревизии
2.1 v2.1A 04.2026 - ...
  • Первая серийная партия
  • Небольшие изменения топологии
2.0 v1.0A 01.2026 - 03.2026
  • Тестовая партия