This documentation is out of date.

The new version of the documentation is here: https://cannylogic.com/docs

CANNY CAN(LIN) monitor

From CANNY Wiki
Jump to: navigation, search

CANNY CAN(LIN) monitor (ccm.exe) — утилита, входящая в состав интегрированной среды разработки CannyLab, позволяющая, используя контроллер CANNY 7 в качестве интерфейсного преобразователя, принимать и визуально анализировать данные CAN и LIN на экране ПК, копировать принятые данные в буфер обмена для последующей обработки. При работе с CAN возможна так же передача данных, при работе с LIN только прием.

Подготовка CANNY 7 для работы в качестве CAN(LIN) монитора

Для использования контроллера CANNY 7 в качестве интерфейсного преобразователя CAN(LIN)-to-USB необходимо загрузить в него специальное программное обеспечение, используя утилиту автоматической загрузки ПО контроллера, из состава интегрированной среды разработки CannyLab.

Специальное программное обеспечение расположено каталоге установки cannylab: \ccx\canny7\c7canmon_vXXX.exe, где XXX - актуальная версия специального программного обеспечения контроллера.

Примечание: Функция мониторинга шины LIN поддерживается начиная с версии 1.55 специального программного обеспечения контроллера (c7canmon_v155.exe) и версии 1.16 CANNY CAN(LIN) monitor

Процесс подготовки контроллера CANNY 7.

  • Запустите файл c7canmon_vXXX.exe;
  • В открывшемся окне приложения-загрузчика внимательно ознакомьтесь с сопроводительной информацией на панели "Комментарий", расположенной слева; при необходимости, воспользуйтесь вертикальной прокруткой
File:11 12.png;
  • Откройте корпус контроллера CANNY 7, подключите его к ПК используя кабель-переходник USB-miniUSB и, при необходимости, дождитесь окончания установки драйвера операционной системой;
11 13.png    .     11 14.png
Если подключение выполнено успешно, то в панели состояния отобразится серийный номер подключенного контроллера CANNY 7 и кнопка "Записать" станет активной
File:11 15.png;
  • Нажмите кнопку "Записать" и дождитесь окончания загрузки программного обеспечения в контроллер;
File:11 16.png    .     File:11 17.png
  • Отключите контроллер от ПК.

После успешной подготовка контроллера CANNY 7 к работе в качестве CAN(LIN) монитора необходимо правильно выполнить его подключение к исследуемой шине данных.

ВНИМАНИЕ! Для корректной работы CANNY CAN(LIN) monitor с LIN необходимо, чтобы контакты GND всех устройств LIN, контроллера CANNY 7 и ПК подключенного к контроллеру были надежно соединены между собой.

Порядок подключения к шине CAN

Исходное состояние: контроллер отключен от ПК, питания и шины передачи данных.

  • Выполните подключение проводов 4х-контактного разъема: красный провод - +12В, черный провод - GND, серый провод - CAN-H, синий провод - CAN-L;
11 18.png
  • Подключите 4х-контактный разъем к контроллеру. Двухцветный встроенный светодиод контроллера начнет циклически переключаться;
  • Подключите контроллер к ПК, используя кабель-переходник USB-miniUSB (не в ходит в комплект поставки контроллера);
  • Запустите CANNY Lab и выберите в главном меню пункт CAN/LIN монитор, либо запустите файл ccm.exe из корневого каталога интегрированной среды разработки CannyLab;
  • Используя пункт главного меню CAN Monitor программы ccm.exe, из предлагаемого списка, выберите предполагаемую скорость обмена данными в исследуемой CAN-шине
11 19.png;

Если подключение устройства было выполнено правильно, то в строке состояния CANNY CAN(LIN) monitor будет отображено сообщение об успешном подключении, либо информация о соединении с шиной CAN.

11 25.png

11 21.png

При этом, если шина активна, то в контрольной панели появятся данные CAN, сгруппированные по идентификаторам сообщений, журнал будет наполняться полученными сообщениями в хронологическом порядке.

11 22.png

Если соединение контролера CANNY 7 и CANNY CAN(LIN) monitor не установлено, то в строке состояния будет отображено сообщение об ожидании подключения устройства.

11 20.png

Порядок подключения к шине LIN

Исходное состояние: контроллер отключен от ПК, питания и шины передачи данных (отключен 4х-контактный разъем).

  • Выполните подключение проводов 4х-контактного разъема: красный провод - +12В, черный провод - GND, серый и синий провода оставить неподключенными;
  • Выполните подключение проводов 3х-контактного разъема: белый провод - шина LIN, зеленый и коричневый провода оставить неподключенными;
11 23.png
  • Подключите 4х-контактный разъем к контроллеру - встроенный светодиод устройства начнет переключать свой цвет с зеленого на красный и обратно с промежуточным "перемаригиванием" между этими цветами;
  • Подключите 3х-контактный разъем к контроллеру;
  • Подключите контроллер к ПК, используя кабель-переходник USB-miniUSB;
  • Запустите программу ccm.exe из корневого каталога интегрированной среды разработки CannyLab;
  • Используя пункт главного меню LIN Monitor программы ccm.exe, из предлагаемого списка, выберите стандарт и предполагаемую скорость обмена данными в исследуемой LIN-шине
11 24.png;

Если подключение устройства было выполнено правильно, то в строке состояния CANNY CAN(LIN) monitor будет отображена информация о успешном соединении.

11 25.png

При этом, если шина активна, то в контрольной панели появятся данные LIN, сгруппированные по идентификаторам сообщений, журнал будет заполняться историей полученных сообщений в хронологическом порядке.

11 26.png

ВНИМАНИЕ! При работе с LIN-шиной CANNY CAN(LIN) monitor выступает в качестве SLAVE-узла, при этом в нем реализована автоподстройка скорости обмена данными по шине. Таким образом, при настройке CANNY CAN(LIN) monitor на скорость приема 10кБит/с, он будет также корректно принимать и отображать данные полученные на более высокой скорости (20кБит/с). Однако, при настройке скорости приема на 20кБит/с, прием данных на более низкой скорости невозможен.

Если соединение контролера CANNY 7 и CANNY CAN(LIN) monitor не установлено, то в строке состояния будет отображено сообщение об ожидании подключения устройства.

11 20.png

Клавиши управления CANNY CAN(LIN) monitor

Up/Вверх - Перемещение курсора/прокрутка активной панели окна вверх;
Down/Вниз - Перемещение курсора/прокрутка активной панели окна вниз;
Tab/Табуляция - Смена активной панели окна, переход между активными панелями осуществляется путем нажатия клавиши "Tab" в текущей активной панели, смена происходит в следующем порядке: Контрольная панель => Журнал => Командная строка => Контрольная панель и т.д. последовательно, циклически (по кругу);
Delete - Исключение выделенных идентификаторов CAN-сообщений из протоколирования данных шины (деактивация указанных фильтров в Контрольной панели, выключение записи данных с выбранными идентификаторами цифровой шины в Журнал);
Space/Пробел - Инвертирование (изменение на противоположное) состояния активности фильтров Контрольной панели для выделенных идентификаторов;
Pause/Пауза - Приостановка вывода поступающих данных на Контрольную панель и записи их в Журнал, возобновление вывода поступающих данных выполняется повторным нажатием клавиши Pause/Пауза;
Ctrl+H - Управление режимом сохранения подсветки байт данных CAN-сообщений, в которых происходили какие-либо изменения с момента активации данного режима;
Ctrl+A - Выделение всего содержимого активной панели;
Ctrl+C
Ctrl+Ins
- Копирование выделенного содержимого Журнала в буфер обмена операционной системы;
ESC
F10
- Возврат в главное меню, остановка приема данных, сброс текущего режима работы;
Alt+X - Быстрый выход из утилиты, закрытие окна утилиты;

Главное окно CANNY CAN(LIN) monitor

Внешний вид главного окна в процессе приема данных CAN показан на рисунке. Окно приложения разделено на 5 областей.

11 1.png

Приложение обладает аскетичным, но достаточно функциональным интерфейсом. Управление CANNY CAN(LIN) monitor осуществляется с помощью клавиатуры.

Переключение между областями "Контрольная панель", "Журнал" и "Командная строка" выполняется с помощью клавиши "Tab".

Главное меню CANNY CAN(LIN) monitor

Верхняя строка - область главного меню, состоящая из 4 пунктов. С их помощью осуществляется настройка режимов работы утилиты. Переход в главное меню осуществляется по нажатию клавиши "ESC".

Меню File позволяет пользователю завершить работу с приложением. Кроме того, завершить работу утилиты можно закрыв окно приложения (нажав кнопку Закрыть).

11 2.png

Меню CAN Monitor содержит настройки интерфейса CAN. С его помощью осуществляется выбор скорости обмена данными CAN-сети, с которой будет выполняться сопряжение для проведения мониторинга.

11 3.png

Меню LIN Monitor содержит настройки интерфейса LIN. С его помощью осуществляется выбор скорости обмена данными LIN-сети, с которой будет выполняться сопряжение для проведения мониторинга.

11 4.png

Меню Help открывает пользователю доступ к краткой справке по приложению.

11 5.png

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

11 6.png

Навигация в главном меню осуществляется с помощью клавиш управления курсором. Выбор нужного пункта активного меню выполняется нажатием клавиши "ENTER".

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

Приостановка вывода поступающих данных на экран и записи поступающих CAN-сообщений в Журнал выполняется с помощью клавиши "Pause"/"Пауза". Возобновление вывода поступающих данных на экран и процесса ведения журнала выполняется повторным нажатием клавиши "Pause"/"Пауза".

Начиная с версии 1.59, CANNY CAN(LIN) monitor, потеряв связь с информационной шиной, пытается автоматически восстановить соединение, сохраняя при этом текущие рабочие настройки утилиты (скорость обмена данными, установленные фильтры и т.п.). Остановить режим автоматического восстановления соединения с шиной можно путем перехода в главное меню утилиты, используя клавиши ESC или F10.

Данные принимаемых и отправляемых сообщений в CANNY CAN(LIN) monitor представлены в шестнадцатеричном формате. Статистическая и служебная информация отображается и задается в десятичном формате.

Контрольная панель CANNY CAN(LIN) monitor

В главной области окна приложения, контрольной панели, содержатся актуальные данные CAN, сгруппированные по идентификаторам сообщений.

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

11 7.png

Данные в контрольной панели постоянно обновляются и соответствуют последним полученным по шине CAN значениям.

Последние изменения в данных CAN выделяются желтым цветом.

11 9.png

Формат отображения строк в контрольной панели

11 8.png

Назначение полей строки контрольной панели:

a - маркер состояния фильтра приема сообщения: если маркер установлен, то фильтр приема сообщений с данным идентификатором активирован, сообщения принимаются CANNY CAN(LIN) monitor и записывается в журнал, иначе сообщения с данным идентификатором отбрасываются.
b - поле идентификатора принятого CAN-сообщения; может быть представлено в стандартном (11 бит) или расширенном (29 бит) формате.
c - поля значащих байт данных принятого CAN-сообщения.
d - поля отсутствующих (пустых) байт данных принятого CAN-сообщения.
e - поле отображения данных принятого CAN-сообщения в фрмате ASCII.
f - поле счетчика принятых в текущей сессии CAN-сообщений с данным идентификатором.
g - поле отображения интервала времени, прошедшего между двумя соседними сообщениями с указанным идентификатором.

Управление фильтрами контрольной панели

В начале работы CANNY CAN(LIN) monitor никаких дополнительных настроек фильтров не используется, по умолчанию все фильтры включены, т.е. все сообщения из шины CAN принимаются монитором и сохраняются в его Журнале.

При мониторинге всего потока данных CAN-шин с большими объемами и высокой скоростью передачи информации, в виду ограниченности аппаратных возможностей оборудования, при приеме могут наблюдаться потери отдельных сообщений.

Для ликвидации потерь данных CAN, а также для более детального их изучения рекомендуется выполнять дополнительную настройку фильтров CANNY CAN(LIN) monitor, выделяя из общего потока только интересующие пользователя сообщения.

Пользователю доступны 14 аппаратных фильтра CAN-сообщений. Это означает, что в режиме фильтрации, при мониторинге от 1 до 14 идентификаторов CAN-сообщений, используемые аппаратные фильтры CAN позволяют принимать поток данных практически без потерь сообщений. При большем количестве отслеживаемых идентификаторов к аппаратным фильтрам подключаются программные, не гарантирующие отсутствия потерь. При активации аппаратных фильтров в строке состояния CANNY CAN(LIN) monitor отображается сообщение FLT.

При использовании дополнительных настроек фильтров, т.е. отключении приема сообщений с идентификаторами, не интересующими пользователя, в Журнал записываются только сообщения прошедшие активные фильтры.

Перемещение между записями в Контрольной панели осуществляется с использованием клавиш управления курсором "Вверх" и "Вниз". Клавиши "Page Up" и "Page Down" могут быть использованы для быстрой, постраничной, прокрутки большого количества записей.

В Контрольной панели можно работать как с отдельной строкой/записью, так и сразу со всеми одновременно. Для выделения всех записей необходимо воспользоваться комбинацией клавиш "Ctrl"+"A".

Выбранные (активные) строки контрольной панели выделяется белым цветом фона.

11 11.png

При нажатии клавиши "Delete" выполняется деактивация выделенного фильтра.

11 10.png

Нажатием клавиши "Space"/"Пробел" или "Enter"/"Ввод" выполняется инвертирование текущего состояния выделенного фильтра, т.е. если фильтр был активирован (маркер " * " установлен), то произойдет его деактивация (маркер " * " снят) и наоборот. Инвертирование текущего состояния может быть выполнено и для группы фильтров, при этом каждый фильтр изменит свое состояние на противоположное.

Журнал CANNY CAN(LIN) monitor

Под Контрольной панелью расположена специальная область, Журнал, в которой отображаются принятые CAN(LIN) сообщения в хронологическом порядке, т.е. в порядке их получения из шины обмена данными. В Журнал записываются только сообщения прошедшие активные фильтры, активированные в Контрольной панели. Максимально возможный объем журнала - 10000 записей. Если история сообщений превышает максимальное количество записей журнала, то наиболее ранние записи утрачиваются, освобождая место для свежих данных.

Переход из Контрольной панели в область Журнал выполняется с помощью нажатия клавиши "Tab".

11 27.png

Приостановка вывода поступающих данных на экран и записи поступающих CAN-сообщений в Журнал выполняется с помощью клавиши "Pause"/"Пауза". Возобновление вывода поступающих данных на экран и процесса ведения журнала выполняется повторным нажатием клавиши "Pause"/"Пауза".

Формат отображения записей в журнале

11 28.png

Назначение полей строки журнала:

a - поле идентификатора принятого CAN-сообщения; может быть представлено в стандартном (11 бит) или расширенном (29 бит) формате.
b - поля значащих байт данных принятого CAN-сообщения.
c - поля отсутствующих (пустых) байт данных принятого CAN-сообщения.
d - поле временной отметки (timestamp), отображаемой в миллисекундах с момента запуска CANNY CAN(LIN) monitor.
e - поле отображения данных принятого CAN-сообщения в фрмате ASCII.

Сохранение записей журнала

Информация из журнала может быть скопирована в буфер обмена операционной системы, для последующей вставки программу работы с электронными таблицами или текстовый файл, для дальнейшего более детального изучения и анализа.

Для копирования записей в буфер обмена необходимо, находясь в области журнала, выделить их, используя сочетание клавиш "Ctrl"+"A", и нажать сочетание клавиш "Ctrl"+"C", либо "Ctrl"+"Insert".

Вставка скопированных записей из буфера обмена в открытый файл во время его редактирования, выполняется с помощью сочетания клавиш "Ctrl"+"V" или "Shift"+"Insert".

Примечание: Выделить записи журнала будет довольно трудно, пока в него попадают новые записи - выделение будет постоянно сбрасываться. Поэтому, перед выделением и копированием записей журнала, нажмите на клавиатуре кнопку Pause или физически отключите контроллер от CAN

Командная строка CANNY CAN(LIN) monitor

В нижней части окна CANNY CAN(LIN) monitor, под областью Журнал, над строкой состояния, расположена Командная строка, с помощью которой пользователь может отправлять сообщения в исследуемую CAN-шину.

Переход из области Журнал в область Командная строка выполняется с помощью нажатия клавиши "Tab". Повторное нажатие клавиши "Tab" позволяет перейти из Командной строки в Контрольную панель.

Формат сообщения командной строки

11 29.png

Назначение полей сообщения командной строки:

a - поле идентификатора отправляемого CAN-сообщения; может быть задано в стандартном (11 бит) или расширенном (29 бит) формате.
b - поля байт данных отправляемого CAN-сообщения; могут быть заданы от 1 до 8 байт, длину сообщения определяет количество заданных (в том числе со значениями 00) байт.
c - поле признака расширенного формата идентификатора отправляемого CAN-сообщения (опционально); указывается при необходимости отправки сообщения с идентификатором расширенного формата.
d - поле указания количества необходимых повторов отправляемого CAN-сообщения (опционально); указывается при необходимости отправки данного сообщения несколько (более одного) раз подряд; количество повторов указывается в десятичном формате.

Строка состояния CANNY CAN(LIN) monitor

Нижняя строка главного окна CANNY CAN(LIN) monitor является строкой состояния. Она, как и строка главного меню CANNY CAN(LIN) monitor, выделена цветом фона, отличным от цвета фона рабочей области окна приложения.

В строке состояния отображается информация о текущем статусе соединения с цифровой информационной шиной, справочная и статическая информация, ошибки и служебные сообщения.

Ошибки и сообщения, отображаемые в строке состояния

COVF! - Переполнение CAN. При приеме данных возможны потери сообщений. Используйте режим аппаратной фильтрации для ограничения потока принимаемых контроллером данных;
LOVF! - Переполнение LIN. При приеме данных возможны потери сообщений;
CANERR! - Ошибка приёма. Неверно установлена скорость обмена данными, либо неверное подключение к шине;
LINERR! - Ошибка приёма. Неверно установлена скорость обмена данными, либо неверное подключение к шине;
USBOVF! - Переполнение канала передачи данных USB. Обычно возникает при высокой загрузке процессора ПК;
cui: xx - Скорость работы USB-интерфейса, где xx - количество USB-пакетов, пересылаемых за 1 секунду;
can: xxx - Скорость обмена данными шины CAN, где xxx - значение скорости в килобитах в секунду;
L1.3:xxx - Скорость обмена данными шины LIN, протокол версии 1.3, где xxx - скорость обмена данными в битах в секунду;
L2.0:xxx - Скорость обмена данными шины LIN, протокол версии 2.0, где xxx - скорость обмена данными в битах в секунду;
FLT - Включен режим аппаратной фильтрации CAN-сообщений - в контрольной панели активировано от одного до четырнадцати фильтров;
HLD - Включен режим сохранения подсветки байт данных CAN-сообщений, в которых происходили какие-либо изменения с момента активации данного режима;
PAUSE
(мигающая)
- Вывод поступающих данных на Контрольную панель и запись их в Журнал приостановлены пользователем;

В правой части строки состояния расположена область счетчиков, отображающих количество сообщений, принятых (rx) и отправленных (tx) в текущем сеансе работы CANNY CAN(LIN) monitor: 11 30.png test