exponenta event banner

Кан.Свойства канала

Свойства can.Channel объект

Используйте следующие свойства для проверки или настройки параметров канала CAN. Использовать canChannel для создания объекта CAN-канала.

Информация об устройстве

развернуть все

DeviceVendor указывает имя поставщика устройства.

Значения определяются автоматически при конфигурировании канала с помощью canChannel или j1939Channel функция.

Типы данных: char

Это свойство доступно только для чтения.

Для устройств National Instruments ® Device отображает номер устройства на оборудовании.

Для всех остальных поставщиков: Device отображает информацию о типе устройства, к которому подключен канал CAN или J1939.

Значения определяются автоматически при конфигурировании канала с помощью canChannel или j1939Channel функция.

Типы данных: char

Это свойство доступно только для чтения.

DeviceChannelIndex свойство указывает индекс канала, для которого настроен указанный канал CAN или J1939.

Значения определяются автоматически при конфигурировании канала с помощью canChannel или j1939Channel функция.

Типы данных: double

Это свойство доступно только для чтения.

DeviceSerialNumber отображает серийный номер устройства, подключенного к каналу CAN или J1939.

Значения определяются автоматически при конфигурировании канала с помощью canChannel или j1939Channel функция.

Типы данных: double | char

Это свойство доступно только для чтения.

ProtocolMode свойство указывает протокол связи, для которого настроен канал CAN, либо CAN или CAN FD.

Значение определяется при конфигурировании канала с помощью canChannel функция.

Типы данных: char

Информация о состоянии

развернуть все

Это свойство доступно только для чтения.

Running свойство указывает состояние канала CAN или J1939 в соответствии со следующими значениями:

  • false (по умолчанию) - канал находится в автономном режиме.

  • true - Канал работает в режиме онлайн.

Используйте start для настройки канала в режиме онлайн.

Типы данных: logical

Это свойство доступно только для чтения.

MessagesAvailable отображает общее количество сообщений, доступных для приема каналом CAN. Значение: 0 при отсутствии доступных сообщений.

Типы данных: double

Это свойство доступно только для чтения.

MessagesReceived свойство указывает общее количество сообщений, полученных с момента последнего запуска канала. Значение: 0 когда сообщения не были приняты, и увеличивается в зависимости от количества сообщений, принимаемых каналом.

Типы данных: double

Это свойство доступно только для чтения.

MessagesTransmitted свойство указывает общее количество сообщений, переданных с момента последнего запуска канала. Значение по умолчанию: 0 когда сообщения не были отправлены, и увеличивается в зависимости от количества сообщений, передаваемых каналом.

Типы данных: double

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

MessageReceivedFcnCount свойство определяет необходимое количество сообщений, доступных до настройки MessageReceivedFcn бежит.

Например, чтобы указать выполняемую функцию обратного вызова:

canch.MessageReceivedFcn = @Myfunction;

Типы данных: char | string | function_handle

Настроить MessageReceivedFcnCount до количества сообщений, которые должны быть доступны до MessageReceivedFcn срабатывает функция обратного вызова.

Значение по умолчанию: 1. Можно указать положительное целое число для MessageReceivedFcnCount. Например, чтобы указать количество сообщений, необходимое для запуска обратного вызова:

canch.MessageReceivedFcnCount = 55;

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Это свойство доступно только для чтения.

InitializationAccess свойство указывает, имеет ли сконфигурированный объект CAN или J1939 канала полный контроль над каналом устройства в соответствии со следующими значениями:

  • true - полностью контролирует аппаратный канал и может изменять значения свойств.

  • false - не имеет полного управления и не может изменять значения свойств.

Некоторые значения свойств канала аппаратных средств можно изменить, только если объект имеет полный контроль над каналом аппаратных средств.

Примечание

Доступ к инициализации предоставляется только первому каналу, созданному на устройстве.

Типы данных: logical

Это свойство доступно только для чтения.

InitialTimestamp указывает, когда канал был установлен в оперативном режиме с помощью start или когда был получен пусковой триггер. Для устройств National Instruments время получается от водителя устройства; для устройств других производителей время получается из операционной системы, в которой работает MATLAB.

Типы данных: datetime

Это свойство доступно только для чтения.

Укажите настройки фильтров приема сообщений, возвращаемых в виде символьного вектора. Это свойство указывает параметры, реализованные функциями filterAllowOnly, filterAllowAll, и filterBlockAll.

Пример: 'Standard ID Filter: Allow All | Extended ID Filter: Allow All'

Типы данных: char

Информация о канале

развернуть все

Это свойство доступно только для чтения.

BusStatus отображает информацию о состоянии шины CAN или шины J1939.

  • 'N/A' - Свойство не поддерживается поставщиком.

  • 'ErrorActive' - Узел передает флаги активных ошибок при обнаружении ошибок. Примечание.Этот статус не обязательно указывает на существование ошибки, но указывает на то, как она обрабатывается.

  • 'ErrorPassive' - Узел передает флаги пассивных ошибок при обнаружении ошибок.

  • 'BusOff' - Узел не будет передавать ничего по шине.

Типы данных: char

Укажите, работает ли канал бесшумно, в соответствии со следующими значениями:

  • false (по умолчанию) - канал находится в нормальном или активном режиме. В этом режиме канал как нормально передает, так и принимает сообщения и выполняет другие задачи в сети, такие как подтверждение сообщений и создание кадров ошибок.

  • true - Канал находится в режиме молчания. Можно наблюдать всю активность сообщений в сети и выполнять анализ, не влияя на состояние или поведение сети. В этом режиме можно только принимать сообщения и не передавать их.

Типы данных: logical

Это свойство доступно только для чтения.

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

Типы данных: char

Если приемопередатчик CAN или J1939 позволяет управлять его режимом, можно использовать TransceiverState для установки режима.

Числовое значение свойства для каждого режима определяется производителем приемопередатчика. Соответствующие режимы приемопередатчика см. в документации по приемопередатчику CAN. Возможные режимы, представляющие указанное числовое значение:

  • high speed

  • high voltage

  • sleep

  • wake up

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Это свойство доступно только для чтения.

ReceiveErrorCount свойство указывает общее количество ошибок во время приема сообщения с момента последнего запуска канала. Значение по умолчанию: 0и приращения в зависимости от количества ошибок.

Типы данных: double

Это свойство доступно только для чтения.

TransmitErrorCount свойство указывает общее число ошибок при передаче сообщения с момента последнего запуска канала. Значение по умолчанию: 0и приращения в зависимости от количества ошибок.

Типы данных: double

Это свойство доступно только для чтения.

BusSpeed свойство указывает скорость передачи сообщений в битах в секунду. Значение по умолчанию присваивается драйвером поставщика.

Можно задать BusSpeed к поддерживаемой скорости передачи битов с помощью configBusSpeed , указывая имя канала и значение скорости передачи битов в качестве входных параметров. Например, для изменения скорости шины объекта CAN-канала canch до 250 000 бит в секунду и просмотрите результат, введите

configBusSpeed(canch,250000);
bs = canch.BusSpeed

Типы данных: double

Это свойство доступно только для чтения.

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

Примечание

Это свойство недоступно для устройств National Instruments CAN. Отображается канал NaN для значения.

Типы данных: double

Это свойство доступно только для чтения.

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

Примечание

Это свойство недоступно для устройств National Instruments CAN. Отображается канал NaN для значения.

Типы данных: double

Это свойство доступно только для чтения.

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

Примечание

Это свойство недоступно для устройств National Instruments CAN. Отображается канал NaN для значения.

Типы данных: double

Это свойство доступно только для чтения.

BusLoad свойство предоставляет информацию о нагрузке на сеть CAN для трафика сообщений на устройствах Kvaser. Текущий трафик сообщений в сети CAN представлен в процентах от 0.00% кому 100.00%.

Типы данных: double

OnboardTermination указывает, использует ли устройство NI-XNET бортовое завершение шины CAN. Дополнительные сведения о поведении и характеристиках конкретного устройства см. в документации поставщика.

Типы данных: logical

StartTriggerTerminal свойство указывает соединение триггера синхронизации для запуска канала NI-XNET на подключенном терминале источника.

Для конфигурирования модуля NI-XNET CAN (например, NI 9862) для начала регистрации события запуска внешнего сигнала, обеспечиваемого на внешнем терминале шасси, установите канал CAN. StartTriggerTerminal к соответствующему имени терминала. Сформируйте символьный вектор значения свойства, объединив имя корпуса из утилиты NI MAX и имя триггерного терминала. например, '/cDAQ3/PFI0'.

Примечание

Это свойство можно настроить только один раз. После назначения свойство доступно только для чтения и не может быть изменено. Единственный способ установить другое значение - clear объект канала, повторно создайте канал с помощью canChannelи настройте его свойства.

Примеры

Конфигурирование триггера запуска модуля NI-XNET CAN на терминале /cDAQ3/PFI0.

ch1 = canChannel('NI','CAN1')
ch1.StartTriggerTerminal = '/cDAQ3/PFI0'
start(ch1)  % Acquisition begins on hardware trigger

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

ch1.InitialTimestamp
messages = receive(ch1,Inf);
messages(1).Timestamp

Типы данных: char | string

Прочая информация

развернуть все

Database свойство хранит информацию о присоединенной базе данных CAN. Если сообщение канала не прикреплено к базе данных, значение свойства является пустой структурой. []. Можно редактировать канал CAN Database свойство, но не может редактировать сообщение CAN Database собственность.

Чтобы просмотреть информацию о базе данных, присоединенной к сообщению CAN, введите:

message.Database

Установка для базы данных на канале CAN значения C:\Database.dbc, введите:

channel.Database = canDatabase('C:\Database.dbc')

Совет

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

Типы данных: struct

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

Совет

Чтобы избежать непредвиденных результатов при сохранении и загрузке объекта с помощью UserDataукажите пользовательские данные в простых типах данных и конструкциях.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | char | string | struct | table | cell | function_handle | categorical | datetime | duration | calendarDuration | fi
Поддержка комплексного номера: Да

См. также

Функции

Представлен в R2009a