can.Channel Properties

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

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

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

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

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

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

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

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

Для Национальных устройств Instruments™, Device свойство отображает номер устройства на оборудовании.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • true — Канал в сети.

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

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

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

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 — Не имеет полного контроля и не может изменить значения свойств.

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

Примечание

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

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

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

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 (значение по умолчанию) — Канал находится в режиме normal mode или активном режиме. В этом режиме канал обе передачи и обычно получают сообщения и выполняют другие задачи в сети, такие как подтверждение сообщений и создание ошибочных систем координат.

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

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

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

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 функция, задавая название канала и значение битрейта как входные параметры. Например, чтобы изменить скорость шины объекта canch канала CAN к 250 000 бит в секунду, и представление результат, тип

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

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

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

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

Примечание

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

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

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

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

Примечание

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

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

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

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

Примечание

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

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

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

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

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

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

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

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. Если ваше сообщение канала не присоединено к базе данных, значение свойства является пустой структурой, []. Можно отредактировать канал 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
Для просмотра документации необходимо авторизоваться на сайте