Свойства can.Channel
объект
Используйте следующие свойства, чтобы изучить или сконфигурировать настройки канала CAN. Использовать canChannel
для создания объекта канала CAN.
DeviceVendor
- Имя поставщика устройствThe DeviceVendor
свойство указывает имя поставщика устройства.
Значения определяются автоматически, когда вы конфигурируете канал с canChannel
или j1939Channel
функция.
Типы данных: char
Device
- Тип устройства каналаЭто свойство доступно только для чтения.
Для National Instruments ™® устройства, Device
свойство отображает номер устройства на оборудовании.
Для всех других поставщиков, Device
свойство отображает информацию о типе устройства, к которому подключен канал CAN или J1939.
Значения определяются автоматически, когда вы конфигурируете канал с canChannel
или j1939Channel
функция.
Типы данных: char
DeviceChannelIndex
- Индекс канала устройстваЭто свойство доступно только для чтения.
The DeviceChannelIndex
свойство указывает индекс канала, на котором сконфигурирован указанный канал CAN или J1939.
Значения определяются автоматически, когда вы конфигурируете канал с canChannel
или j1939Channel
функция.
Типы данных: double
DeviceSerialNumber
- Серийный номер устройстваЭто свойство доступно только для чтения.
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
- Функция обратного вызова для запуска при наличии сообщенийСконфигурируйте MessageReceivedFcn
в качестве функции обратного вызова, заданной в виде вектора символов, строки или указателя на функцию, когда доступно необходимое количество сообщений.
The MessageReceivedFcnCount
свойство определяет необходимое количество сообщений, доступных перед сконфигурированной MessageReceivedFcn
выполняется.
Для примера, чтобы задать функцию обратного вызова, которая будет выполняться:
canch.MessageReceivedFcn = @Myfunction;
Типы данных: char
| string
| function_handle
MessageReceivedFcnCount
- Задайте количество сообщений, доступных до запуска коллбэкаСконфигурируйте MessageReceivedFcnCount
к количеству сообщений, которые должны быть доступны до MessageReceivedFcn
срабатывает функция обратного вызова.
Значение по умолчанию 1
. Вы можете задать положительное целое число для вашего MessageReceivedFcnCount
. Для примера, чтобы задать количество сообщений, необходимое для запуска коллбэка:
canch.MessageReceivedFcnCount = 55;
Типы данных: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
InitializationAccess
- Указать управление каналом устройстваtrue
(1
) | false
(0
)Это свойство доступно только для чтения.
The InitializationAccess
свойство указывает, имеет ли сконфигурированный объект CAN или J1939 канал полное управление каналом устройства согласно следующим значениям:
true
- Полностью контролирует аппаратный канал и может изменять значения свойств.
false
- Не имеет полного контроля и не может изменять значения свойств.
Вы можете изменить некоторые значения свойств аппаратного канала, только если объект имеет полный контроль над аппаратным каналом.
Примечание
Только первому каналу, созданному на устройстве, предоставляется доступ к инициализации.
Типы данных: logical
InitialTimestamp
- Указать, когда канал запущенЭто свойство доступно только для чтения.
The InitialTimestamp
свойство указывает, когда канал был установлен в оперативном режиме с start
function или когда был получен его пусковой триггер. Для устройств National Instruments ™ время получается от драйвера устройства; для устройств от других поставщиков время получается из операционной системы, в которой работает MATLAB.
Типы данных: datetime
FilterHistory
- Указать настройки фильтров приема сообщенийЭто свойство доступно только для чтения.
Укажите настройки фильтров приема сообщений, возвращенные как вектор символов. Это свойство указывает настройки, реализованные функциями filterAllowOnly
, filterAllowAll
, и filterBlockAll
.
Пример: 'Standard ID Filter: Allow All | Extended ID Filter: Allow All'
Типы данных: char
BusStatus
- Состояние шиныЭто свойство доступно только для чтения.
The BusStatus
свойство отображает информацию о состоянии шины CAN или J1939 шины.
'N/A'
- Свойство, не поддерживаемое поставщиком.
'ErrorActive'
- Узел передает активные флаги ошибок, когда обнаруживает ошибки. Примечание.Этот статус не обязательно указывает, что ошибка действительно существует, но указывает, как обрабатывается ошибка.
'ErrorPassive'
- Узел передает пассивные флаги ошибок, когда обнаруживает ошибки.
'BusOff'
- Узел не будет ничего передавать по шине.
Типы данных: char
SilentMode
- Укажите, является ли канал активным или бесшумнымfalse
(по умолчанию) | true
Задайте, работает ли канал бесшумно, согласно следующим значениям:
false
(по умолчанию) - канал находится в нормальном или активном режиме. В этом режиме канал как передает, так и принимает сообщения нормально и выполняет другие задачи в сети, такие как подтверждение сообщений и создание систем координат ошибок.
true
- Канал находится в бесшумном режиме. Можно наблюдать всю активность сообщений в сети и выполнять анализ, не влияя на состояние или поведение сети. В этом режиме можно только получать сообщения и не передавать их.
Типы данных: logical
TransceiverName
- Имя приемопередатчика устройстваЭто свойство доступно только для чтения.
TransceiverName
указывает имя приемопередатчика устройства. Приемопередатчик устройства переводит цифровой битовый поток, идущий в шину и поступающий из нее, в действительные электрические сигналы, существующие на шине.
Типы данных: char
TransceiverState
- Задайте состояние или режим приемопередатчикаЕсли ваш CAN или J1939 приемопередатчик позволяет вам управлять его режимом, можно использовать TransceiverState
свойство для установки режима.
Значение числового свойства для каждого режима определяется производителем приемопередатчика. См. документацию приемопередатчика CAN для соответствующих режимов приемопередатчика. Возможные режимы, представляющие заданное числовое значение:
high speed
high voltage
sleep
wake up
Типы данных: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
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
- Задайте начальный вывод источника триггера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
- Информация базы данных CANThe 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
задайте пользовательские данные в простых типах данных и конструкциях.
Типы данных: single
| double
| int8
| int16
| int32
| int64
| uint8
| uint16
| uint32
| uint64
| logical
| char
| string
| struct
| table
| cell
| function_handle
| categorical
| datetime
| duration
| calendarDuration
| fi
Поддержка комплексного числа: Да
1. Если смысл перевода понятен, то лучше оставьте как есть и не придирайтесь к словам, синонимам и тому подобному. О вкусах не спорим.
2. Не дополняйте перевод комментариями “от себя”. В исправлении не должно появляться дополнительных смыслов и комментариев, отсутствующих в оригинале. Такие правки не получится интегрировать в алгоритме автоматического перевода.
3. Сохраняйте структуру оригинального текста - например, не разбивайте одно предложение на два.
4. Не имеет смысла однотипное исправление перевода какого-то термина во всех предложениях. Исправляйте только в одном месте. Когда Вашу правку одобрят, это исправление будет алгоритмически распространено и на другие части документации.
5. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.