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

В mdlInitializeSizes задайте количество векторов DWork с помощью макроса ssSetNumDWork. Например, чтобы указать, что S-функция содержит два вектора DWork, используйте команду

ssSetNumDWork(S, 2);

Несмотря на то, что метод mdlInitializeSizes говорит механизм ^Simulink®, сколько векторов DWork S-функция будет использовать, механизм не выделяет память для векторов DWork в это время.

S-функция может задержать определение количества векторов DWork, пока вся информация о S-входных-параметрах-функции не доступна путем передачи значения DYNAMICALLY_SIZED макросу ssSetNumDWork. Если S-функция задерживает определение количества векторов DWork в mdlInitializeSizes, это должно предоставить метод mdlSetWorkWidths, чтобы настроить векторы DWork.

Если S-функция не предоставляет метод mdlSetWorkWidths, метод mdlInitializeSizes устанавливает любые применимые атрибуты для каждого вектора DWork. Например, следующие строки инициализируют ширины и типы данных векторов DWork, инициализированных на предыдущем шаге.

ssSetDWorkWidth(S, 0, 2);
ssSetDWorkWidth(S, 1, 1);

ssSetDWorkDataType(S, 0, SS_DOUBLE);
ssSetDWorkDataType(S, 1, SS_BOOLEAN);

В следующей таблице перечислены атрибуты, которые вы можете установить для вектора DWork и показываете пример макроса, который устанавливает ее. Смотрите ssSetDWorkRTWStorageClass для списка поддерживаемых классов памяти.

В mdlStart инициализируйте значения любых векторов DWork, которые должны быть установлены только в начале моделирования. Используйте макрос ssGetDWork, чтобы получить указатель на каждый вектор DWork и инициализировать значения. Например, следующий метод mdlStart инициализирует первый вектор DWork.

static void mdlStart(SimStruct *S)
{
    real_T *x = (real_T*) ssGetDWork(S,0);

    /*  Initialize the first DWork vector */
    x[0] = 0;
    x[1] = 2;
}

Механизм Simulink выделяет память для вектора DWork прежде, чем вызвать метод mdlStart. Поскольку метод mdlStart называется только однажды в начале моделирования, не используйте его для данных или состояний, которые должны быть повторно инициализированы, например, при перевключении отключенной подсистемы, содержащей S-функцию.

В mdlInitializeConditions инициализируйте значения любых векторов DWork, которые должны быть повторно инициализированы в определенные моменты в моделировании. Механизм выполняет mdlInitializeConditions в начале моделирования и любое время, которое повторно включена активированная подсистема, содержащая S-функцию. Смотрите, что пример mdlStart на предыдущем шаге для команд раньше инициализировал векторные значения DWork.

В mdlOutputs mdlUpdate, и т.д., использует макрос ssGetDWork, чтобы получить указатель на вектор DWork и использовать или обновить векторные значения DWork. Например, для вектора DWork, хранящего два дискретных состояния, следующий mdlOutputs и методы mdlUpdate вычисляют вывод и обновляют значения дискретного состояния.

S-функция ранее задала U(element) как (*uPtrs[element]), A, B, C и D как матрицы пространства состояний для дискретной системы пространства состояний.

/* Function: mdlOutputs ==============================================
 * Abstract:
 *      y = Cx + Du 
 */
static void mdlOutputs(SimStruct *S, int_T tid)
{
    if( ssGetDWorkUsageType(S, 0) == SS_DWORK_USED_AS_DSTATE) {
        real_T            *y      = ssGetOutputPortRealSignal(S,0);
        real_T            *x      = (real_T*) ssGetDWork(S, 0);
        InputRealPtrsType uPtrs   = ssGetInputPortRealSignalPtrs(S,0);
        
        UNUSED_ARG(tid); /* not used in single tasking mode */
        
    /* y=Cx+Du */
        y[0]=C[0][0]*x[0]+C[0][1]*x[1]+D[0][0]*U(0)+D[0][1]*U(1);
        y[1]=C[1][0]*x[0]+C[1][1]*x[1]+D[1][0]*U(0)+D[1][1]*U(1);
    }
}



#define MDL_UPDATE
/* Function: mdlUpdate ===============================================
 * Abstract:
 *      xdot = Ax + Bu
 */
static void mdlUpdate(SimStruct *S, int_T tid)
{
    real_T            tempX[2] = {0.0, 0.0};
    real_T            *x       = (real_T*) ssGetDWork(S, 0);
    InputRealPtrsType uPtrs    = ssGetInputPortRealSignalPtrs(S,0);

    UNUSED_ARG(tid); /* not used in single tasking mode */

    /* xdot=Ax+Bu */
    tempX[0]=A[0][0]*x[0]+A[0][1]*x[1]+B[0][0]*U(0)+B[0][1]*U(1);
    tempX[1]=A[1][0]*x[0]+A[1][1]*x[1]+B[1][0]*U(0)+B[1][1]*U(1);
 
    x[0]=tempX[0];
    x[1]=tempX[1];
}