Target Language Compiler

model.rtw Changes Between Real-Time Workshop 3.0 and 4.0

Several changes have been made to the model.rtw file. These changes:

• Provide more functionality
• Reduce generated code size
• Increase generated code efficiency
• Faster code generation

model.rtw Differences

• The StatesMap was updated to reduce the size of the model.rtw file, making code generation faster. The StatesMap now contains rows for states that go to a port (direct port connections). For example, SignalSrc X4 means the fifth row in the StatesMap only, not the fifth index.4. Note, the StatesMap now only contains the a mapping for the double, non-complex continuous and discrete states.
• S-function changes:
• Added UsingUPtrs ParamSetting for Level 2 C-MEX S-functions. This is needed to support the ssSetInputPortRequiredContiguous flag for non-inlined Level 2 C-MEX S-functions.
• If the number of input ports for a Level 1 S-function is zero, then the ParamSetting.Contiguous field now writes out as "" instead of "yes".
• Removed Slopes parameter from 1D Look-Up table. Slopes for the 1D look-up are computed at runtime.
• Removed DiscStatesDataTypeIdx and DiscStatesComplexSignal. These are now handled by the data type work vector fields.
• Added support for frames. A frame signal is a multi-element signal consisting of multiple samples for a given time point. Frame signals are typically used in signal processing algorithms. Specifically:
• A FrameData field was added to each block input port record.
• A DataOutputPortFrameData field was added to the block record. This was not added to block output port record because this record is specific to a buffer and not to a block. In the case of frame data, the same buffer could have different frame interpretations based on the block they feed into.
• Added to the BlockOutputDefaults record:

    NumReusedBlockOutputs 0
    NumMergedBlockOutputs 0

• Combined discrete states with the data type work vector handling. Updated DataLoggingOpts to reflect discrete states are now a part of DWork. Specifically:
• Removed

    CompiledModel.NumDiscStates
    CompiledModel.Modes
    CompiledModel.NumRWork
    CompiledModel.NumIWork
    CompiledModel.NumPWork
    CompiledModel.NumDWork
    CompiledModel.NumDWorkRecords

• Renamed the DWork record as follows.

           old                                  new

      DWorkRecords {                          DWorks {
         DWorkRecordDefaults {                   DWorkDefaults {
            DataTypeIdx                             Data TypeIdx
            ComplexSignal                           ComplexSignal
            UsedAsDState                            UsedAs
         }                                       }
         NumDWorkRecords                         NumDWorks
         DWorkRecord {                           DWork {
            BlockIdentifier                         Identifier
            Name
            Width                                   Width
            DaTaTypeIdx                             DataTypeIdx
            ComplexSignal                           ComplexSignal
            UsedAsDState                            UsedAs
            DWorkSrc                                SigSrc
         }                                       }
         :                                       :
         :                                       :
      }                                       }

• Changed the following fields from the block record.

                           used to be       changed to

        Block.DiscStates   [width, vectIdx] [width, dWorkIdx]
        Block.RWork        [width, vectIdx] [width, dWorkIdx]
        Block.IWork        [width, vectIdx] [width, dWorkIdx]
        Block.PWork        [width, vectIdx] [width, dWorkIdx]
        Block.ModeVector   [width, vectIdx] [width, dWorkIdx]

where vectIdx was the vector index into the corresponding vector, while recIdx is now the index of the corresponding DWork in the model-wide DWorks record.

• Changed "Block.DWork[xx].RecordIdx" to "Block.Dwork[xx].RecordIndex".
• To support the addition of run-time parameters, the block Parameter records are now the last items in the Block records (i.e., parameter settings and so on come before block Parameter records and the parameter count vector.)
• To support parameter pooling, moved the writing of the ModelParameters record above the System records. Several new fields were added to the ModelParameters record.
• Added support for block parameter aliases. For example, lock records now look like

       NumParameters 2
       Parameter {
       }
       Parameter {
       }
       P1Name  Parameter[0]
       P2Name  Parameter[1]

• Added support for block parameter value aliases when there is a one-to-one mapping with the model parameters record. Parameter records now have

Parameter {
   Value CompiledModel.ModelParameters.Parameter[#].Value
}

when a mapping can be located between the values in Parameter records and the ModelParameters record. This was done to speed up code generation and reduce the size of the model.rtw file when we can locate a mapping between the values in Parameter records and the ModelParameters record.

• Added support for matrix signals. All parameters are assumed to be in column-major ordering and several blocks were updated to reflect this.

Matrix support involved adding a Dimensions field to many records. Specifically, we now:

• Write actual block and model parameter dimensions, i.e., updated the Parameter records in the Block and ModelParameters Parameter records.
• Write matrix dimensions for data store memory blocks, i.e., updated the DataStores record.
• Write block output port dimensions only if the output signal is a matrix, i.e., updated RootSignals or Subsystem record.
• Write external input dimensions for matrix signals, i.e., updated ExternalInputs record.
• Write external output dimensions for matrix signals, i.e., updated ExternalOutputs record.
• Write block output dimensions for matrix signals, i.e., updated BlockOutput record.
• Write data input port dimensions for matrix signals, i.e., updated DataInputPorts record.
• Write data output port dimensions for matrix signal, i.e., updated DataOutputPort record.

Matrix support also required eliminating the notion of number of data logging rows. This required the renaming of the following blocks.

• Scope:

Renamed "MaxRows" to "MaxDataPoints"

Renamed "LimitMaxRows" to "LimitDataPoints"

Renamed "Matrix" option in SaveFormat parameter to "Array" format

• ToWorkspace:

Renamed "Buffer" to "MaxDataPoints"

Renamed "Matrix" option in SaveFormat parameter to "Array" format

• FromWorkspace:

Renamed "Matrix" option in Data format parameter to "Array" format

• Added DataOutputPort records to the Block records.
• Added ObjectProperities for signals specified in the Unified Data Repository to the BlockOutputs record.
• Many of the block records changed to support matrices.
• Some blocks records were updated to add data type support to them.

General model.rtw Concepts

General Information and Solver Specification