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

Исследуйте модель примера

Откройте модель примера, rtwdemo_rtwintro.

open_system('rtwdemo_rtwintro')

В галерее Apps нажмите Simulink Coder.

Откройте Model Data Editor. На вкладке Моделирование (Modeling) щелкните Редактор данных модели (Model Data Editor).

Смотрите вкладку Состояния. Для состояния блока Unit Delay начальное значение устанавливается на 0, по умолчанию, что означает, что начальное значение состояния равняется нулю. Состояние называется X.

Установите Начальное Значение ненулевое число, например 5.

set_param('rtwdemo_rtwintro/X','InitialCondition','5')

Откройте редактор Отображения. На вкладке C Code выберите Code Interface > Individual Element Code Mappings.

На вкладке Signals/States в разделе States установите Класс памяти для X на ExportedGlobal. С этой настройкой состояние блока появляется в сгенерированном коде как отдельная глобальная переменная.

coder.mapping.utils.create('rtwdemo_rtwintro');
cm = coder.mapping.api.get('rtwdemo_rtwintro');
setState(cm,'rtwdemo_rtwintro/X','StorageClass','ExportedGlobal');

В модели откройте Amplifier подсистема, которая является триггируемой подсистемой.

В Model Data Editor смотрите вкладку Параметры. Чтобы задать и просмотреть начальные значения сигналов и состояний, можно использовать вкладку Параметры вместо вкладки Состояния.

Этот Model Data Editor показывает, что для блока Outport, выход Initial (InitialOutput) параметру задано значение 0, значение по умолчанию. Этот выход подсистемы требует начального значения, потому что подсистема выполняется условно. Оставьте начальное значение по умолчанию.

В модели очистите Параметры конфигурации > Повторное использование памяти. Когда вы снимаете эту настройку, сигнальные линии появляются в сгенерированном коде как поля сгенерированной структуры, целью которой является хранение данных сигнала. Это представление сигналов облегчает представление о том, как генератор кода инициализирует данные.

set_param('rtwdemo_rtwintro','OptimizeBlockIOStorage','off')

В модели смотрите поведение параметра параметра конфигурации Параметров конфигурации > Оптимизация > По умолчанию. Параметру конфигурации задано значение Inlined, что означает, параметры блоков, включая начальные значения, появляются в сгенерированном коде как встроенные литералы или как const данные.

Перейдите к корневому уровню модели.

В Model Data Editor нажмите кнопку Показать/обновить дополнительную информацию.

Возле поля Filter contents нажмите кнопку Filter using selection.

В модели щелкните на маркированном блоке Constant INC. Этот Model Data Editor показывает, что Постоянное значение (Value) параметр блока установлен в INC. INC - переменный MATLAB в базовом рабочем пространстве.

Для INC, установите значение в столбце Значение равным Simulink.Parameter(uint8(1)). MATLAB преобразует INC в Simulink.Parameter объект.

В редакторе Отображения на вкладке Parameters примените класс памяти ExportedGlobal на INC. С помощью этой настройки сгенерированный код определяет INC как глобальная переменная. Что касается инициализации, INC является элементом данных о параметрах.

INC = Simulink.Parameter(INC);
INC.StorageClass = 'ExportedGlobal';

Сгенерируйте и смотрите код

Чтобы создать модель и сгенерировать код, нажмите Ctrl + B.

slbuild('rtwdemo_rtwintro');

### Starting build procedure for: rtwdemo_rtwintro
### Successful completion of build procedure for: rtwdemo_rtwintro

Build Summary

Top model targets built:

Model             Action                       Rebuild Reason                                    
=================================================================================================
rtwdemo_rtwintro  Code generated and compiled  Code generation information file does not exist.  

1 of 1 models built (0 models already up to date)
Build duration: 0h 0m 18.384s

В сгенерированном файле rtwdemo_rtwintro.c, вне определения функции, код статически инициализирует данные параметра INC. Значение INC является 1.

file = fullfile('rtwdemo_rtwintro_grt_rtw','rtwdemo_rtwintro.c');
rtwdemodbtype(file,'/* Exported block parameters */','uint8_T INC = 1U;',1,1)

/* Exported block parameters */
uint8_T INC = 1U;                      /* Variable: INC

В том же файле проверьте определение rtwdemo_rtwintro_initialize функция. Во-первых, функция использует memset для инициализации внутренних сигналов в модели к сохраненному значению 0.

rtwdemodbtype(file,'/* block I/O */','sizeof(B_rtwdemo_rtwintro_T));',1,1)

  /* block I/O */
  (void) memset(((void *) &rtwdemo_rtwintro_B), 0,
                sizeof(B_rtwdemo_rtwintro_T));

Затем функция инициализирует состояние Unit Delay, X, к значению земли. В этом случае значение заземления равняется нулю.

rtwdemodbtype(file,'/* exported global states */','X = 0U;',1,1)

  /* exported global states */
  X = 0U;

Функция также инициализирует другие данные, включая входы и выходы корневого уровня (блоки Inport и Outport), к наземным значениям.

rtwdemodbtype(file,'/* external inputs */','Amplifier_Trig_ZCE = POS_ZCSIG;',1,1)

  /* external inputs */
  rtwdemo_rtwintro_U.Input = 0;

  /* external outputs */
  rtwdemo_rtwintro_Y.Output = 0;
  rtwdemo_rtwintro_PrevZCX.Amplifier_Trig_ZCE = POS_ZCSIG;

Затем функция инициализирует X к значению, заданному в условие Initial параметров блоков.

rtwdemodbtype(file,'/* InitializeConditions for UnitDelay: ''<Root>/X'' */',...
    'X = 5U;',1,1)

  /* InitializeConditions for UnitDelay: '<Root>/X' */
  X = 5U;

Наконец, функция инициализирует выход Amplifier подсистема.

rtwdemodbtype(file,'SystemInitialize for Triggered SubSystem',...
    'End of SystemInitialize for SubSystem',1,1)

  /* SystemInitialize for Triggered SubSystem: '<Root>/Amplifier' */
  /* SystemInitialize for Outport: '<Root>/Output' incorporates:
   *  Outport: '<S1>/Out'
   */
  rtwdemo_rtwintro_Y.Output = 0;

Смотрите различие между сохраненным значением и реальной ценностью

Для некоторых данных, даже если реальное начальное значение равно нулю, компьютер сохраняет ненулевое значение в памяти. Чтобы наблюдать это различие, примените тип данных с фиксированной точкой смещения к состоянию блока X. Чтобы запустить этот пример, вы должны иметь Fixed-Point Designer™.

В Model Data Editor смотрите вкладку Signals.

В модели кликните выходной сигнал блока Switch, switch_out.

Используйте столбец Data Type Model Data Editor, чтобы задать тип данных сигнала fixdt(1,16,1,3). Это выражение представляет тип данных с фиксированной точкой с наклоном 1 и смещение 3.

set_param('rtwdemo_rtwintro/Switch','OutDataTypeStr',...
    'fixdt(1,16,1,3)')

В модели выберите блок Sum. В Property Inspector, в разделе Signal Attributes, очистите Требовать, чтобы все входы имели совпадающий тип данных.

set_param('rtwdemo_rtwintro/Sum','InputSameDT','off')

Чтобы предотвратить ошибки компиляции на других платформах, выберите параметр конфигурации модели Только для генерации кода. Эта настройка заставляет модель генерировать только код.

set_param('rtwdemo_rtwintro','GenCodeOnly','on')

Чтобы создать модель и сгенерировать код, нажмите Ctrl + B.

slbuild('rtwdemo_rtwintro')

### Starting build procedure for: rtwdemo_rtwintro
### Successful completion of code generation for: rtwdemo_rtwintro

Build Summary

Top model targets built:

Model             Action          Rebuild Reason                   
===================================================================
rtwdemo_rtwintro  Code generated  Generated code was out of date.  

1 of 1 models built (0 models already up to date)
Build duration: 0h 0m 6.4884s

Функция инициализации модели сначала инициализирует X к реальному основному значению, 0. Из-за типа данных смещения по наклону, который имеет смещение 3, это значение реального мира соответствует сохраненному значению -3.

rtwdemodbtype(file,'/* exported global states */','X = -3;',1,1)

  /* exported global states */
  X = -3;

Затем функция инициализирует X к действительному начальному значению, заданному вами в условие Initial параметров блоков, 5. Это значение реального мира соответствует сохраненному значению 2.

rtwdemodbtype(file,'/* InitializeConditions for UnitDelay: ''<Root>/X'' */',...
    'X = 2;',1,1)

  /* InitializeConditions for UnitDelay: '<Root>/X' */
  X = 2;