can.Message Properties

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

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

Передайте идентификацию

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

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

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

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

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

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

ID свойство представляет числовой идентификатор для сообщения CAN. Область значений значений:

  • 0 до 2 047 для стандартного идентификатора

  • 0 до 536,870,911 для расширенного идентификатора

Можно сконфигурировать идентификатор сообщения при построении его. Например, чтобы установить стандартный идентификатор значения 300 и длина данных восьми байтов, введите:

message = canMessage(300,false,8)

Для шестнадцатеричных значений преобразуйте использование hex2dec функция.

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

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

Extended свойство является типом идентификатора для сообщения CAN. Это может или быть стандартный идентификатор или расширенный идентификатор, согласно следующим значениям:

  • false — Тип идентификатора является стандартным (11 битов).

  • true — Тип идентификатора расширен (29 битов).

Можно сконфигурировать расширенное свойство сообщения при построении его. Например, чтобы установить тип идентификатора сообщения на расширенный, с набором ID к 2 350 и длиной данных к восьми байтам, введите:

message = canMessage(2350,true,8)

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

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

Name свойство отображает имя сообщения как значение вектора символов. Это значение получено с имени сообщения, которое вы задали в базе данных. Вы не можете отредактировать это свойство, если вы задаете необработанные сообщения.

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

Детали данных

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

Timestamp свойство отображает время, в которое сообщение было получено на канале CAN. Это время основано на времени начала канала получения.

Вы можете хотеть установить значение при построении сообщения. Например, чтобы установить метку времени сообщения к 12, введите:

message.Timestamp = 12

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | fi

Используйте Data свойство задать необработанные данные в сообщении CAN. Данные являются массивом uint8 значений, на основе длины данных, которую вы задаете в сообщении.

Например, чтобы создать сообщение CAN и задать его данные:

message = canMessage(2500,true,8)
message.Data = [23 43 23 43 54 34 123 1]

Если вы используете базу данных CAN для своих определений сообщения, можно непосредственно задать значения в Signals структура свойства.

Можно также использовать pack функционируйте, чтобы загрузить данные в ваше сообщение.

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

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

Создайте сообщение CAN.

message = canMessage(canDb,'messageName');

Отобразите сигналы сообщения.

message.Signals
    VehicleSpeed: 0
       EngineRPM: 250

Измените значение сигнала.

message.Signals.EngineRPM = 300

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

Длина сообщения CAN в байтах в виде uint8 значения. Это указывает на число элементов в Data вектор. Для сообщений CAN это ограничивается 8 байтами; поскольку CAN FD обменивается сообщениями, длина может быть 0-8, 12, 16, 20, 24, 32, 48, или 64 байта.

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

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

Код длины CAN FD передает данные, возвращенные как uint8 значение. Это относится к Length свойство: для размеров до 8 байтов они - то же самое, но DLC значения в пределах от 9 (двоичный файл 1001) к 15 (двоичный файл 1110) используются, чтобы задать длины данных 12, 16, 20, 24, 32, 48, и 64 байта. Для получения дополнительной информации см. CAN FD - Некоторые Детали Протокола.

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

Флаги протокола

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

BRS свойство указывает, что переключатель битрейта сообщения CAN FD установлен. Это определяет, быстрее ли битрейт для фазы данных сообщения (true) или то же самое (false) как битрейт арбитражной фазы. Для получения дополнительной информации см. CAN FD - Некоторые Детали Протокола.

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

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

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

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

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

Error свойство указывает, если верный, что сообщение CAN является ошибочной системой координат.

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

Используйте Remote свойство задать сообщение CAN как удаленную систему координат.

  • false (значение по умолчанию) — Сообщение не является удаленной системой координат.

  • true — Сообщение является удаленной системой координат.

Изменить значение по умолчанию Remote и сделайте сообщение удаленной системой координат, введите:

message.Remote = true

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

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

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

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