can.Channel Properties

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

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

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

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

`DeviceVendor` — Имя поставщика устройства
символьный вектор

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

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

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

`Device` — Тип устройства канала
символьный вектор

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

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

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

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

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

`DeviceChannelIndex` — Индекс канала устройства
'double'

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

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

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

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

`DeviceSerialNumber` — Порядковый номер устройства
удвойтесь | char

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

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

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

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

`ProtocolMode` — Режим Protocol канала CAN
`'CAN'` (значение по умолчанию) | `'CAN FD'`

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

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

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

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

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

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

`Running` — Укажите на рабочее состояние канала
`false`(0 ) | `true`(1 )

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

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

false (значение по умолчанию) — Канал является оффлайновым.
true — Канал в сети.

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

Типы данных: логический

`MessagesAvailable` — Количество сообщений, доступных, чтобы быть полученным каналом CAN
'double'

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

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

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

`MessagesReceived` — Количество сообщений получено каналом CAN
'double'

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

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

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

`MessagesTransmitted` — Количество сообщений передается каналом CAN
'double'

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

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

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

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

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

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

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

canch.MessageReceivedFcn = @Myfunction;

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

`MessageReceivedFcnCount` — Задайте количество сообщений, доступных, прежде чем коллбэк будет инициирован
числовой

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

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

canch.MessageReceivedFcnCount = 55;

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

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

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

true — Имеет полный контроль над аппаратным каналом и может изменить значения свойств.
false — Не имеет полного контроля и не может изменить значения свойств.

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

Примечание

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

Типы данных: логический

`InitialTimestamp` — Укажите когда запущенный канал
datetime

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

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

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

`FilterHistory` — Укажите на настройки приемных фильтров сообщения
'char'

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

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

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

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

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

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

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

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

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

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

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

`SilentMode` — Задайте, активен ли канал или тих
`false` (значение по умолчанию) | `true`

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

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

Типы данных: логический

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

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

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

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

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

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

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

high speed
high voltage
sleep
wake up

`ReceiveErrorCount` — Количество ошибок во время приема сообщения
'double'

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

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

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

`TransmitErrorCount` — Количество ошибок во время передачи сообщения
'double'

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

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

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

`BusSpeed` — Битрейт передачи шины
'double'

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

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

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

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

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

`SJW` — Ширина скачка синхронизации (SJW) сегмента времени передачи бита
'double'

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

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

Примечание

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

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

`TSEG1,TSEG2` — Позволенное количество сегментов битов, чтобы удлинить и сократить шаг расчета
'double'

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

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

Примечание

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

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

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

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

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

Примечание

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

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

`BusLoad` — Нагрузка на шину CAN
'double'

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

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

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

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

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

Типы данных: логический

`StartTriggerTerminal` — Задайте запускают триггерный исходный терминал
char | строка

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

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

Примечание

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

Examples

Сконфигурируйте модуль CAN NI-XNET, запускаются, включают терминал /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
struct ()

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` — Имя поставщика устройства
символьный вектор

`Device` — Тип устройства канала
символьный вектор

`DeviceChannelIndex` — Индекс канала устройства
'double'

`DeviceSerialNumber` — Порядковый номер устройства
удвойтесь | char

`ProtocolMode` — Режим Protocol канала CAN
`'CAN'` (значение по умолчанию) | `'CAN FD'`

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

`Running` — Укажите на рабочее состояние канала
`false`(0 ) | `true`(1 )

`MessagesAvailable` — Количество сообщений, доступных, чтобы быть полученным каналом CAN
'double'

`MessagesReceived` — Количество сообщений получено каналом CAN
'double'

`MessagesTransmitted` — Количество сообщений передается каналом CAN
'double'

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

`MessageReceivedFcnCount` — Задайте количество сообщений, доступных, прежде чем коллбэк будет инициирован
числовой

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

`InitialTimestamp` — Укажите когда запущенный канал
datetime

`FilterHistory` — Укажите на настройки приемных фильтров сообщения
'char'

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

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

`SilentMode` — Задайте, активен ли канал или тих
`false` (значение по умолчанию) | `true`

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

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

`ReceiveErrorCount` — Количество ошибок во время приема сообщения
'double'

`TransmitErrorCount` — Количество ошибок во время передачи сообщения
'double'

`BusSpeed` — Битрейт передачи шины
'double'

`SJW` — Ширина скачка синхронизации (SJW) сегмента времени передачи бита
'double'

`TSEG1,TSEG2` — Позволенное количество сегментов битов, чтобы удлинить и сократить шаг расчета
'double'

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

`BusLoad` — Нагрузка на шину CAN
'double'

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

`StartTriggerTerminal` — Задайте запускают триггерный исходный терминал
char | строка

Другая информация

`DataBase` — Информация о базе данных CAN
struct ()

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

Смотрите также

Функции

Темы

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

Поддержка

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

can.Channel Properties

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

DeviceVendor — Имя поставщика устройства символьный вектор

Device — Тип устройства канала символьный вектор

DeviceChannelIndex — Индекс канала устройства 'double'

DeviceSerialNumber — Порядковый номер устройства удвойтесь | char

ProtocolMode — Режим Protocol канала CAN 'CAN' (значение по умолчанию) | 'CAN FD'

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

Running — Укажите на рабочее состояние канала false(0 ) | true(1 )

MessagesAvailable — Количество сообщений, доступных, чтобы быть полученным каналом CAN 'double'

MessagesReceived — Количество сообщений получено каналом CAN 'double'

MessagesTransmitted — Количество сообщений передается каналом CAN 'double'

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

MessageReceivedFcnCount — Задайте количество сообщений, доступных, прежде чем коллбэк будет инициирован числовой

InitializationAccess — Укажите на управление канала устройства true(1 ) | false(0 )

InitialTimestamp — Укажите когда запущенный канал datetime

FilterHistory — Укажите на настройки приемных фильтров сообщения 'char'

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

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

SilentMode — Задайте, активен ли канал или тих false (значение по умолчанию) | true

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

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

ReceiveErrorCount — Количество ошибок во время приема сообщения 'double'

TransmitErrorCount — Количество ошибок во время передачи сообщения 'double'

BusSpeed — Битрейт передачи шины 'double'

SJW — Ширина скачка синхронизации (SJW) сегмента времени передачи бита 'double'

TSEG1,TSEG2 — Позволенное количество сегментов битов, чтобы удлинить и сократить шаг расчета 'double'

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

BusLoad — Нагрузка на шину CAN 'double'

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

StartTriggerTerminal — Задайте запускают триггерный исходный терминал char | строка

Другая информация

DataBase — Информация о базе данных CAN struct ()

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

Смотрите также

Функции

Темы

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

Поддержка

`DeviceVendor` — Имя поставщика устройства
символьный вектор

`Device` — Тип устройства канала
символьный вектор

`DeviceChannelIndex` — Индекс канала устройства
'double'

`DeviceSerialNumber` — Порядковый номер устройства
удвойтесь | char

`ProtocolMode` — Режим Protocol канала CAN
`'CAN'` (значение по умолчанию) | `'CAN FD'`

`Running` — Укажите на рабочее состояние канала
`false`(0 ) | `true`(1 )

`MessagesAvailable` — Количество сообщений, доступных, чтобы быть полученным каналом CAN
'double'

`MessagesReceived` — Количество сообщений получено каналом CAN
'double'

`MessagesTransmitted` — Количество сообщений передается каналом CAN
'double'

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

`MessageReceivedFcnCount` — Задайте количество сообщений, доступных, прежде чем коллбэк будет инициирован
числовой

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

`InitialTimestamp` — Укажите когда запущенный канал
datetime

`FilterHistory` — Укажите на настройки приемных фильтров сообщения
'char'

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

`SilentMode` — Задайте, активен ли канал или тих
`false` (значение по умолчанию) | `true`

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

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

`ReceiveErrorCount` — Количество ошибок во время приема сообщения
'double'

`TransmitErrorCount` — Количество ошибок во время передачи сообщения
'double'

`BusSpeed` — Битрейт передачи шины
'double'

`SJW` — Ширина скачка синхронизации (SJW) сегмента времени передачи бита
'double'

`TSEG1,TSEG2` — Позволенное количество сегментов битов, чтобы удлинить и сократить шаг расчета
'double'

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

`BusLoad` — Нагрузка на шину CAN
'double'

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

`StartTriggerTerminal` — Задайте запускают триггерный исходный терминал
char | строка

`DataBase` — Информация о базе данных CAN
struct ()

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