can.Channel Properties

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

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

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

расширить все

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Значение определяется, когда вы конфигурируете канал с canChannel функция.

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

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

расширить все

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

The 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

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

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

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

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

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

Примечание

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

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

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

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

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

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

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

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

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

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

расширить все

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

The 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

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

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

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

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

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

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

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

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

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

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

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

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

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

Примечание

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

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

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

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

Примечание

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

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

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

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

Примечание

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

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

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

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

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

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

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

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

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

Примечание

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

Examples

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

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

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

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

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

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

расширить все

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

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

message.Database

Чтобы задать информацию базы данных на канале CAN равной C:\Database.dbc, тип:

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

Совет

Имена файлов базы данных CAN, содержащие неалфавитно-цифровые символы, такие как знаки равенства и амперсанды, несовместимы с Vehicle Network 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
Для просмотра документации необходимо авторизоваться на сайте