Stateflow.Message

Сообщение в графике, состоянии или поле

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

    Описание

    Использование Stateflow.Message объекты для локальной передачи данных или между Stateflow® графики в Simulink® модели. Для получения дополнительной информации см. Раздел «Связь с диаграммами Stateflow путем отправки сообщений».

    Создание

    Синтаксис

    message = Stateflow.Message(parent)

    Описание

    пример

    message = Stateflow.Message(parent) создает Stateflow.Message объект в родительском графике, состоянии или поле.

    Входные параметры

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

    Родительский элемент для нового сообщения, заданный как объект Stateflow API одного из следующих типов:

    Свойства

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

    Интерфейс

    Имя сообщения, заданное как вектор символов.

    Возможности сообщения, заданная как 'Local', 'Input', или 'Output'. Для получения дополнительной информации см. Возможности».

    Индекс порта для сообщения, заданный как целочисленный скаляр. Это свойство применяется только к входным и выходным сообщениям. Для получения дополнительной информации см. раздел «Порт».

    Способ инициализации значения данных сообщения, заданный как вектор символов, который зависит от возможностей сообщения:

    • Для локальных и выходных сообщений используйте 'Expression' или 'Parameter'.

    • Для входных сообщений используйте 'Not Needed'.

    Для получения дополнительной информации смотрите Начальное значение.

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

    Пример: message.Props.InitialValue = '1.5';

    Принимают ли данные сообщения комплексные числа, заданные как 'On' или 'Off'. Для получения дополнительной информации смотрите Комплексные данные в Диаграммах Stateflow.

    Пример: message.Props.Complexity = 'On';

    Приоритет для сообщения, заданный как вектор символов. Если одновременно происходит два различных сообщения, это свойство определяет, какое сообщение обрабатывается первым. Меньшее числовое значение указывает на более высокий приоритет. Это свойство применяется только к локальным и выходным сообщениям в дискретных графиках событий. Для получения дополнительной информации смотрите Создание пользовательских систем постановки в очередь с использованием диаграмм Stateflow дискретных событий (SimEvents).

    Очередь

    Поддерживает ли диаграмма Stateflow внутреннюю очередь приема для входа сообщения, заданную в виде числа или логического 1 (true) или 0 (false). Это свойство применяется только к входным сообщениям. Дополнительные сведения см. в разделе Использование внутренней очереди.

    Порядок удаления сообщений из очереди приема, заданный как одно из следующих значений:

    • 'FIFO' - Первый в, первый из.

    • 'LIFO' - Последний раз, первый раз.

    • 'Priority' - Удалите сообщения в соответствии со значением в поле данных. Чтобы задать порядок, используйте MessagePriorityOrder свойство сообщения.

    Это свойство применяется только к локальным сообщениям и входным сообщениям, которые UseInternalQueue установлено на true. Для получения дополнительной информации см. раздел Тип очереди.

    Тип очереди приоритетов для сообщения, заданный как одно из следующих значений:

    • 'Ascending' - Сообщения принимаются в порядке возрастания значения данных сообщения.

    • 'Descending' - Сообщения принимаются в порядке убывания от значения данных сообщения.

    Это свойство применяется только когда QueueType свойство сообщения 'Priority'. Для получения дополнительной информации см. раздел Тип очереди.

    Длина внутренней очереди сообщения в виде целочисленного скаляра. Это свойство применяется только к локальным сообщениям и входным сообщениям, которые UseInternalQueue установлено на true. Для получения дополнительной информации см. раздел Емкость очереди.

    Уровень диагностического действия, когда количество входящих сообщений превышает емкость очереди для сообщения, заданный как 'Error', 'Warning', или 'None'. Это свойство применяется только к локальным сообщениям и входным сообщениям, которые UseInternalQueue установлено на true. Дополнительные сведения см. в разделе Диагностика переполнения очереди.

    Тип данных

    Тип данных сообщения, заданный как вектор символов, который зависит от Props.Type.Method свойство сообщения:

    • Если на Props.Type.Method свойство сообщения 'Inherit', значение этого свойства 'Inherit: Same as Simulink'.

    • Если на Props.Type.Method свойство сообщения 'Built-in', вы можете задать это свойство с одним из следующих опций:

      • 'double'

      • 'single'

      • 'int8'

      • 'int16'

      • 'int32'

      • 'int64'

      • 'uint8'

      • 'uint16'

      • 'uint32'

      • 'uint64'

      • 'boolean'

      • 'ml' (Поддерживается только в графиках, которые используют C в качестве языка действий)

      • 'string' (Поддерживается только в графиках, которые используют C в качестве языка действий)

    • В противном случае Props.Type свойства сообщения определяют значение этого свойства.

    Для получения дополнительной информации смотрите раздел Добавление данных в разделе Создание графиков при помощи Stateflow API.

    Метод настройки типа данных сообщения, заданный как 'Inherited', 'Built-in', 'Bus Object', 'Enumerated', 'Expression', или 'Fixed point'.

    Это свойство эквивалентно Mode полю помощника по типам данных в диалоговом окне Свойства сообщения. Для получения дополнительной информации см. Раздел «Задание типа данных Stateflow».

    Пример: message.Props.Method = 'Built-in';

    Имя Simulink.Bus объект, который определяет данные сообщения, заданные как вектор символов. Это свойство применяется только когда Props.Type.Method свойство сообщения 'Bus Object'. Для получения дополнительной информации смотрите Сигналы шины доступа через структуры Stateflow.

    Пример: message.Props.Type.BusObject = 'COUNTERBUS';

    Имя перечисляемого типа, который задает данные сообщения в виде вектора символов. Это свойство применяется только когда Props.Type.Method свойство сообщения 'Enumerated'. Для получения дополнительной информации смотрите Ссылку значений по Имени при помощи перечисленных данных.

    Пример: message.Props.Type.EnumType = 'BasicColors';

    Выражение, которое вычисляет тип данных сообщения, заданный как вектор символов. Это свойство применяется только когда Props.Type.Method свойство сообщения 'Expression'. Для получения дополнительной информации смотрите Задать свойства данных при помощи выражений MATLAB.

    Пример: message.Props.Type.Expression = 'type(y)';

    Сигнальность данных сообщения с фиксированной точкой, заданная в виде числа или логического 1 (true) или 0 (false). Это свойство применяется только когда Props.Type.Method свойство сообщения 'Fixed point'. Для получения дополнительной информации смотрите Данные с Фиксированной Точкой в Диаграммах Stateflow.

    Пример: message.Props.Type.Signed = false;

    Размер слова, в битах, данных сообщения с фиксированной точкой, заданная как вектор символов. Это свойство применяется только когда Props.Type.Method свойство сообщения 'Fixed point'. Для получения дополнительной информации смотрите Данные с Фиксированной Точкой в Диаграммах Stateflow.

    Пример: message.Props.Type.WordLength = '32';

    Метод масштабирования данных сообщения с фиксированной точкой, заданный как 'Binary point', 'Slope and bias', или 'None'. Это свойство применяется только когда Props.Type.Method свойство сообщения 'Fixed point'. Для получения дополнительной информации смотрите Данные с Фиксированной Точкой в Диаграммах Stateflow.

    Пример: message.Props.Type.Fixpt.ScalingMode = 'Binary point';

    Длина дроби, в битах, данных сообщения с фиксированной точкой, заданная как вектор символов. Это свойство применяется только к данным сообщений с фиксированной точкой, когда Props.Type.Fixpt.ScalingMode свойство 'Binary point'. Для получения дополнительной информации смотрите Данные с Фиксированной Точкой в Диаграммах Stateflow.

    Пример: message.Props.Type.Fixpt.FractionLength = '2';

    Наклон данных сообщения с фиксированной точкой, заданный как вектор символов. Это свойство применяется только к данным сообщений с фиксированной точкой, когда Props.Type.Fixpt.ScalingMode свойство 'Slope and bias'. Для получения дополнительной информации смотрите Данные с Фиксированной Точкой в Диаграммах Stateflow.

    Пример: message.Props.Type.Fixpt.Slope = '2^-2';

    Смещение данных сообщения с фиксированной точкой, заданное как вектор символов. Это свойство применяется только к данным сообщений с фиксированной точкой, когда Props.Type.Fixpt.ScalingMode свойство 'Slope and bias'. Для получения дополнительной информации смотрите Данные с Фиксированной Точкой в Диаграммах Stateflow.

    Пример: message.Props.Type.Fixpt.Bias = '0';

    Следует ли препятствовать замене типа с фиксированной точкой данных сообщения на автоматический тип, выбранный Fixed-Point Tool (Fixed-Point Designer), заданный в виде числа или логического 1 (true) или 0 (false). Для получения дополнительной информации см. раздел «Автомасштабирование с использованием Fixed-Point Tool» (Fixed-Point Designer).

    Пример: message.Props.Type.Fixpt.Lock = true;

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

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

    Размер данных

    Размер данных сообщения, заданный как вектор символов. Для получения дополнительной информации см. Раздел «Задание размера данных Stateflow».

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

    Размер данных сообщения, определяемый компилятором, задается как вектор символов.

    Иерархия

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

    Машина, содержащая сообщение, заданное как Stateflow.Machine объект.

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

    Расположение родительского элемента сообщения в иерархии модели, заданное как вектор символов.

    Идентификация

    Описание сообщения, заданное как вектор символов.

    Ссылка на документ для сообщения, заданная как вектор символов.

    Определяемый пользователем тег для сообщения, заданный как данные любого типа.

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

    Независимый от сеанса идентификатор, заданный как целочисленный скаляр. Используйте это свойство, чтобы отличить сообщение от других объектов в модели.

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

    Уникальный идентификатор, заданный как целочисленный скаляр. В отличие от SSIdNumberзначение этого свойства переназначается каждый раз, когда вы запускаете новый MATLAB® Сеанс и может быть повторно использован после удаления объекта.

    Функции объекта

    classhandleПредоставьте указатель на класс для объекта
    dialogОткройте диалоговое окно свойств
    getВерните структуру MATLAB, содержащую настройки свойств объекта или массива объектов
    setУстановите свойства с заданными значениями
    upВозврат родительского элемента объекта
    viewОтобразите объект в среде редактирования

    Примеры

    свернуть все

    Добавьте сообщение к графику ch. Укажите его имя, возможности и тип данных.

    message = Stateflow.Message(ch);
message.Name = 'M';
message.Scope = 'Input';
message.Props.Type.Method = 'Built-in';
message.DataType = 'int32';

    См. также

    | |

    Темы

    Введенный в R2015b

    Документация Stateflow

    Поддержка

    Для просмотра документации необходимо авторизоваться на сайте