Свойства can.Channel
объект
Используйте следующие свойства исследовать или сконфигурировать настройки канала CAN. Использование canChannel
создать объект канала CAN.
DeviceVendor
— Имя поставщика устройстваDeviceVendor
свойство указывает на имя поставщика устройства.
Значения автоматически заданы, когда вы конфигурируете канал с canChannel
или j1939Channel
функция.
Типы данных: char
Device
— Тип устройства каналаЭто свойство доступно только для чтения.
Для Национальных устройств Instruments™, Device
свойство отображает номер устройства на оборудовании.
Для всех других поставщиков, Device
свойство отображает информацию о типе устройства, с которым соединяется канал CAN или J1939.
Значения автоматически заданы, когда вы конфигурируете канал с canChannel
или j1939Channel
функция.
Типы данных: char
DeviceChannelIndex
— Индекс канала устройстваЭто свойство доступно только для чтения.
DeviceChannelIndex
свойство указывает на индекс канала, на котором сконфигурирован заданный канал CAN или J1939.
Значения автоматически заданы, когда вы конфигурируете канал с canChannel
или j1939Channel
функция.
Типы данных: double
DeviceSerialNumber
— Порядковый номер устройстваЭто свойство доступно только для чтения.
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Это свойство доступно только для чтения.
MessagesAvailable
свойство отображает общее количество сообщений, доступных, чтобы быть полученным каналом CAN. Значением является 0
когда никакие сообщения не доступны.
Типы данных: double
MessagesReceived
— Количество сообщений получено каналом CANЭто свойство доступно только для чтения.
MessagesReceived
свойство указывает на общее количество сообщений, полученных, поскольку канал был в последний раз запущен. Значением является 0
когда никакие сообщения не были получены, и шаг на основе количества сообщений, канал получает.
Типы данных: double
MessagesTransmitted
— Количество сообщений передается каналом CANЭто свойство доступно только для чтения.
MessagesTransmitted
свойство указывает на общее количество сообщений, переданных, поскольку канал был в последний раз запущен. Значение по умолчанию 0
когда никакие сообщения не были отправлены, и шаг на основе количества сообщений передачи канала.
Типы данных: double
MessageReceivedFcn
— Функция обратного вызова, чтобы запуститься, когда доступные сообщенияСконфигурируйте MessageReceivedFcn
как функция обратного вызова, чтобы запуститься в виде вектора символов, строки или указателя на функцию, когда необходимое количество сообщений доступны.
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
)Это свойство доступно только для чтения.
InitializationAccess
свойство указывает, имеет ли сконфигурированный объект канала CAN или J1939 полный контроль над каналом устройства, согласно следующим значениям:
true
— Имеет полный контроль над аппаратным каналом и может изменить значения свойств.
false
— Не имеет полного контроля и не может изменить значения свойств.
Можно изменить некоторые значения свойств аппаратного канала, только если объект имеет полный контроль над аппаратным каналом.
Примечание
Только первый канал, созданный на устройстве, является предоставленным доступом к инициализации.
Типы данных: логический
InitialTimestamp
— Укажите когда запущенный каналЭто свойство доступно только для чтения.
InitialTimestamp
свойство указывает, когда канал был установлен онлайн с start
функционируйте или когда его триггер запуска был получен. Для устройств National Instruments время получено из драйвера устройства; для устройств от других поставщиков время получено из операционной системы, куда MATLAB запускается.
Типы данных: datetime
FilterHistory
— Укажите на настройки приемных фильтров сообщенияЭто свойство доступно только для чтения.
Укажите на настройки приемных фильтров сообщения, возвращенных как вектор символов. Это свойство указывает на настройки, реализованные функциями filterAllowOnly
, filterAllowAll
, и filterBlockAll
.
Пример: 'Standard ID Filter: Allow All | Extended ID Filter: Allow All'
Типы данных: char
BusStatus
— Состояние шиныЭто свойство доступно только для чтения.
BusStatus
свойство отображает информацию о состоянии шины CAN или шины J1939.
'N/A'
— Свойство, не поддержанное поставщиком.
'ErrorActive'
— Узел передает Активные Флаги ошибки, когда он обнаруживает ошибки. Примечание: Это состояние не обязательно указывает, что ошибка на самом деле существует, но указывает, как обрабатывается ошибка.
'ErrorPassive'
— Узел передает Пассивные Флаги ошибки, когда он обнаруживает ошибки.
'BusOff'
— Узел ничего не передаст на шине.
Типы данных: char
SilentMode
— Задайте, активен ли канал или тихfalse
(значение по умолчанию) | true
Задайте, действует ли канал тихо, согласно следующим значениям:
false
(значение по умолчанию) — Канал находится в режиме normal mode или активном режиме. В этом режиме канал обе передачи и обычно получают сообщения и выполняют другие задачи в сети, такие как подтверждение сообщений и создание ошибочных систем координат.
true
— Канал находится в "тихом" режиме. Можно наблюдать все действие сообщения относительно сети и выполнить анализ, не влияя на сетевое состояние или поведение. В этом режиме можно только получить сообщения и не передать любого.
Типы данных: логический
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
— Количество ошибок во время приема сообщенияЭто свойство доступно только для чтения.
ReceiveErrorCount
свойство указывает на общее количество ошибок во время приема сообщения, поскольку канал был в последний раз запущен. Значение по умолчанию 0
, и шаг на основе количества ошибок.
Типы данных: double
TransmitErrorCount
— Количество ошибок во время передачи сообщенияЭто свойство доступно только для чтения.
TransmitErrorCount
свойство указывает на общее количество ошибок во время передачи сообщения, поскольку канал был в последний раз запущен. Значение по умолчанию 0
, и шаг на основе количества ошибок.
Типы данных: double
BusSpeed
— Битрейт передачи шиныЭто свойство доступно только для чтения.
BusSpeed
свойство указывает на скорость, на которой сообщения передаются в битах в секунду. Значение по умолчанию присвоено драйвером поставщика.
Можно установить BusSpeed
к поддерживаемому битрейту с помощью configBusSpeed
функция, задавая название канала и значение битрейта как входные параметры. Например, чтобы изменить скорость шины объекта canch
канала CAN к 250 000 бит в секунду, и представление результат, тип
configBusSpeed(canch,250000); bs = canch.BusSpeed
Типы данных: double
SJW
— Ширина скачка синхронизации (SJW) сегмента времени передачи битаЭто свойство доступно только для чтения.
SJW
отображает ширину скачка синхронизации сегмента времени передачи бита. Чтобы настроить синхронизатор шины на чипе, контроллер может сократить или продлить длину немного целым числом сегментов времени. Максимальное значение этих корректировок времени передачи бита называют шириной скачка синхронизации или SJW
.
Примечание
Это свойство не доступно для устройств CAN National Instruments. Канал отображает NaN
для значения.
Типы данных: double
TSEG1,TSEG2
— Позволенное количество сегментов битов, чтобы удлинить и сократить шаг расчетаЭто свойство доступно только для чтения.
TSEG1
и TSEG2
свойства указывают на сумму в сегментах времени передачи бита, что канал может удлинить и сократить шаг расчета, соответственно, чтобы ресинхронизировать или компенсировать в течение времен задержки в сети. Значение наследовано, когда вы конфигурируете скорость шины своего канала CAN.
Примечание
Это свойство не доступно для устройств CAN National Instruments. Канал отображает NaN
для значения.
Типы данных: double
NumOfSamples
— Количество выборок, доступных для каналаЭто свойство доступно только для чтения.
NumOfSamples
свойство немного синхронизирует параметр, который указывает на количество битных выборок, выполняемых для одного битного чтения в сети. Значение является положительным целым числом на основе настроек драйвера для канала.
Примечание
Это свойство не доступно для устройств CAN National Instruments. Канал отображает NaN
для значения.
Типы данных: double
BusLoad
— Нагрузка на шину CANЭто свойство доступно только для чтения.
BusLoad
свойство предоставляет информацию о нагрузке на сеть CAN для трафика сообщения на устройствах Kvaser. Текущий трафик сообщения в сети CAN представлен как процент в пределах от 0.00%
к 100.00%
.
Типы данных: double
OnboardTermination
— Сконфигурируйте завершение шины на устройствеtrue
(1
) | false
| (0
)OnboardTermination
свойство задает, использует ли устройство NI-XNET свое встроенное завершение шины CAN. Для получения дополнительной информации о поведении и характеристиках определенного устройства, обратитесь к его документации поставщика.
Типы данных: логический
StartTriggerTerminal
— Задайте запускают триггерный исходный терминал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
— Информация о базе данных CANDatabase
свойство хранит информацию о присоединенной базе данных 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. По иным вопросам, например если надо исправить заблокированное для перевода слово, обратитесь к редакторам через форму технической поддержки.