can.Message Properties

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

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

Идентификация сообщения

расширить все

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

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

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

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

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

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

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

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

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

message = canMessage(300,false,8)

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

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

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

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

  • false - Тип идентификатора стандартный (11 бит).

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

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

message = canMessage(2350,true,8)

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

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

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

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

Сведения о данных

расширить все

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

The 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

The 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

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

расширить все

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

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

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

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

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

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

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

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

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

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

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

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

message.Remote = true

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

Прочая информация

расширить все

The 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