can.Channel Properties

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

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

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

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

`DeviceVendor` - Имя поставщика устройств
вектор char

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

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

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

`Device` - Тип устройства канала
вектор char

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

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

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

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

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

`DeviceChannelIndex` - Индекс канала устройства
дважды

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

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

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

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

`DeviceSerialNumber` - Серийный номер устройства
double | char

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

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

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

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

`ProtocolMode` - Протокольный режим канала CAN
`'CAN'` (по умолчанию) | `'CAN FD'`

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

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

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

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

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

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

`Running` - Индикация рабочего состояния канала
`false` (`0`) | `true` (`1`)

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

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

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

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

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

`MessagesAvailable` - Количество сообщений, доступных для приема каналом CAN
дважды

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

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

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

`MessagesReceived` - Количество сообщений, полученных каналом CAN
дважды

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

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

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

`MessagesTransmitted` - Количество сообщений, переданных каналом CAN
дважды

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

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

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

`MessageReceivedFcn` - Функция обратного вызова для запуска при наличии сообщений
указатель на функцию | char | строка

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

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

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

canch.MessageReceivedFcn = @Myfunction;

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

`MessageReceivedFcnCount` - Задайте количество сообщений, доступных до запуска коллбэка
числовой

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

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

canch.MessageReceivedFcnCount = 55;

`InitializationAccess` - Указать управление каналом устройства
`true` (`1`) | `false` (`0`)

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

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

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

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

Примечание

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

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

`InitialTimestamp` - Указать, когда канал запущен
datetime

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

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

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

`FilterHistory` - Указать настройки фильтров приема сообщений
char

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

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

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

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

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

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

`BusStatus` - Состояние шины
char

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

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

'N/A' - Свойство, не поддерживаемое поставщиком.
'ErrorActive' - Узел передает активные флаги ошибок, когда обнаруживает ошибки. Примечание.Этот статус не обязательно указывает, что ошибка действительно существует, но указывает, как обрабатывается ошибка.
'ErrorPassive' - Узел передает пассивные флаги ошибок, когда обнаруживает ошибки.
'BusOff' - Узел не будет ничего передавать по шине.

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

`SilentMode` - Укажите, является ли канал активным или бесшумным
`false` (по умолчанию) | `true`

Задайте, работает ли канал бесшумно, согласно следующим значениям:

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

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

`TransceiverName` - Имя приемопередатчика устройства
char

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

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

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

`TransceiverState` - Задайте состояние или режим приемопередатчика
числовой

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

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

high speed
high voltage
sleep
wake up

`ReceiveErrorCount` - Количество ошибок при приеме сообщения
дважды

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

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

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

`TransmitErrorCount` - Количество ошибок при передаче сообщения
дважды

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

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

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

`BusSpeed` - Скорость передачи шины в битах
дважды

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

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

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

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

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

`SJW` - Ширина перехода синхронизации (SJW) сегмента битового времени
дважды

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

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

Примечание

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

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

`TSEG1,TSEG2` - Допустимое количество сегментов бит для удлинения и сокращения шага расчета
дважды

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

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

Примечание

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

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

`NumOfSamples` - Количество выборок, доступных для канала
дважды

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

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

Примечание

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

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

`BusLoad` - Нагрузка на шину CAN
дважды

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

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

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

`OnboardTermination` - Сконфигурируйте завершение шины на устройстве
`true` (`1`) | `false` | (`0`)

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

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

`StartTriggerTerminal` - Задайте начальный вывод источника триггера
char | строка

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

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

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

`DataBase` - Информация базы данных CAN
struct

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

`UserData` - Пользовательские данные
любые данные

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

Совет

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

Документация

can.Channel Properties

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

`DeviceVendor` - Имя поставщика устройств
вектор char

`Device` - Тип устройства канала
вектор char

`DeviceChannelIndex` - Индекс канала устройства
дважды

`DeviceSerialNumber` - Серийный номер устройства
double | char

`ProtocolMode` - Протокольный режим канала CAN
`'CAN'` (по умолчанию) | `'CAN FD'`

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

`Running` - Индикация рабочего состояния канала
`false` (`0`) | `true` (`1`)

`MessagesAvailable` - Количество сообщений, доступных для приема каналом CAN
дважды

`MessagesReceived` - Количество сообщений, полученных каналом CAN
дважды

`MessagesTransmitted` - Количество сообщений, переданных каналом CAN
дважды

`MessageReceivedFcn` - Функция обратного вызова для запуска при наличии сообщений
указатель на функцию | char | строка

`MessageReceivedFcnCount` - Задайте количество сообщений, доступных до запуска коллбэка
числовой

`InitializationAccess` - Указать управление каналом устройства
`true` (`1`) | `false` (`0`)

`InitialTimestamp` - Указать, когда канал запущен
datetime

`FilterHistory` - Указать настройки фильтров приема сообщений
char

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

`BusStatus` - Состояние шины
char

`SilentMode` - Укажите, является ли канал активным или бесшумным
`false` (по умолчанию) | `true`

`TransceiverName` - Имя приемопередатчика устройства
char

`TransceiverState` - Задайте состояние или режим приемопередатчика
числовой

`ReceiveErrorCount` - Количество ошибок при приеме сообщения
дважды

`TransmitErrorCount` - Количество ошибок при передаче сообщения
дважды

`BusSpeed` - Скорость передачи шины в битах
дважды

`SJW` - Ширина перехода синхронизации (SJW) сегмента битового времени
дважды

`TSEG1,TSEG2` - Допустимое количество сегментов бит для удлинения и сокращения шага расчета
дважды

`NumOfSamples` - Количество выборок, доступных для канала
дважды

`BusLoad` - Нагрузка на шину CAN
дважды

`OnboardTermination` - Сконфигурируйте завершение шины на устройстве
`true` (`1`) | `false` | (`0`)

`StartTriggerTerminal` - Задайте начальный вывод источника триггера
char | строка

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

`DataBase` - Информация базы данных CAN
struct

`UserData` - Пользовательские данные
любые данные

См. также

Функции

Темы

Документация по Vehicle Network Toolbox

Поддержка

Документация

can.Channel Properties

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

DeviceVendor - Имя поставщика устройств вектор char

Device - Тип устройства канала вектор char

DeviceChannelIndex - Индекс канала устройства дважды

DeviceSerialNumber - Серийный номер устройства double | char

ProtocolMode - Протокольный режим канала CAN 'CAN' (по умолчанию) | 'CAN FD'

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

Running - Индикация рабочего состояния канала false (0) | true (1)

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

MessagesReceived - Количество сообщений, полученных каналом CAN дважды

MessagesTransmitted - Количество сообщений, переданных каналом CAN дважды

MessageReceivedFcn - Функция обратного вызова для запуска при наличии сообщений указатель на функцию | char | строка

MessageReceivedFcnCount - Задайте количество сообщений, доступных до запуска коллбэка числовой

InitializationAccess - Указать управление каналом устройства true (1) | false (0)

InitialTimestamp - Указать, когда канал запущен datetime

FilterHistory - Указать настройки фильтров приема сообщений char

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

BusStatus - Состояние шины char

SilentMode - Укажите, является ли канал активным или бесшумным false (по умолчанию) | true

TransceiverName - Имя приемопередатчика устройства char

TransceiverState - Задайте состояние или режим приемопередатчика числовой

ReceiveErrorCount - Количество ошибок при приеме сообщения дважды

TransmitErrorCount - Количество ошибок при передаче сообщения дважды

BusSpeed - Скорость передачи шины в битах дважды

SJW - Ширина перехода синхронизации (SJW) сегмента битового времени дважды

TSEG1,TSEG2 - Допустимое количество сегментов бит для удлинения и сокращения шага расчета дважды

NumOfSamples - Количество выборок, доступных для канала дважды

BusLoad - Нагрузка на шину CAN дважды

OnboardTermination - Сконфигурируйте завершение шины на устройстве true (1) | false | (0)

StartTriggerTerminal - Задайте начальный вывод источника триггера char | строка

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

DataBase - Информация базы данных CAN struct

UserData - Пользовательские данные любые данные

См. также

Функции

Темы

Документация по Vehicle Network Toolbox

Поддержка

`DeviceVendor` - Имя поставщика устройств
вектор char

`Device` - Тип устройства канала
вектор char

`DeviceChannelIndex` - Индекс канала устройства
дважды

`DeviceSerialNumber` - Серийный номер устройства
double | char

`ProtocolMode` - Протокольный режим канала CAN
`'CAN'` (по умолчанию) | `'CAN FD'`

`Running` - Индикация рабочего состояния канала
`false` (`0`) | `true` (`1`)

`MessagesAvailable` - Количество сообщений, доступных для приема каналом CAN
дважды

`MessagesReceived` - Количество сообщений, полученных каналом CAN
дважды

`MessagesTransmitted` - Количество сообщений, переданных каналом CAN
дважды

`MessageReceivedFcn` - Функция обратного вызова для запуска при наличии сообщений
указатель на функцию | char | строка

`MessageReceivedFcnCount` - Задайте количество сообщений, доступных до запуска коллбэка
числовой

`InitializationAccess` - Указать управление каналом устройства
`true` (`1`) | `false` (`0`)

`InitialTimestamp` - Указать, когда канал запущен
datetime

`FilterHistory` - Указать настройки фильтров приема сообщений
char

`BusStatus` - Состояние шины
char

`SilentMode` - Укажите, является ли канал активным или бесшумным
`false` (по умолчанию) | `true`

`TransceiverName` - Имя приемопередатчика устройства
char

`TransceiverState` - Задайте состояние или режим приемопередатчика
числовой

`ReceiveErrorCount` - Количество ошибок при приеме сообщения
дважды

`TransmitErrorCount` - Количество ошибок при передаче сообщения
дважды

`BusSpeed` - Скорость передачи шины в битах
дважды

`SJW` - Ширина перехода синхронизации (SJW) сегмента битового времени
дважды

`TSEG1,TSEG2` - Допустимое количество сегментов бит для удлинения и сокращения шага расчета
дважды

`NumOfSamples` - Количество выборок, доступных для канала
дважды

`BusLoad` - Нагрузка на шину CAN
дважды

`OnboardTermination` - Сконфигурируйте завершение шины на устройстве
`true` (`1`) | `false` | (`0`)

`StartTriggerTerminal` - Задайте начальный вывод источника триггера
char | строка

`DataBase` - Информация базы данных CAN
struct

`UserData` - Пользовательские данные
любые данные