Доступ к таймерам программно

О API таймера

Эта тема описывает API, которые позволяют вашим S-функциям использовать в своих интересах КПД, предлагаемые абсолютными и прошедшими таймерами. Макросы SimStruct обеспечиваются для использования в симуляции, и функции TLC предоставляются встроенной генерации кода. Обратите внимание на то, что

  • Чтобы сгенерировать и использовать новые таймеры, аналогичные описанному выше, ваши S-функции должны указать потребность использовать абсолютный или прошедший таймер путем вызова ssSetNeedAbsoluteTime или ssSetNeedElapseTime в mdlInitializeSampleTime.

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

C API для S-функций

Макросы SimStruct, описанные в этой теме, обеспечивают доступ к абсолютным и прошедшим таймерам для S-функций в процессе моделирования.

В функциях ниже, SimStruct *S аргумент является указателем на simstruct из S-функции вызова.

  • void ssSetNeedAbsoluteTime(SimStruct *S, boolean b): если b TRUE, регистры, что S-функция вызова требует абсолютных данных времени и выделяет абсолютный счетчик времени для уровня, в который выполняется S-функция (если такой счетчик не были уже выделены).

  • int ssGetNeedAbsoluteTime(SimStruct *S): возвращается 1, если S-функция указала это, требуется абсолютное время.

  • double ssGetTaskTime(SimStruct *S, tid): считайте абсолютное время для данной задачи с идентификатором задачи tid. ssGetTaskTime действует прозрачно, независимо от того, используете ли вы новые функции таймера. ssGetTaskTime документируется в главу Функций SimStruct документации Simulink®.

  • void ssSetNeedElapseTime(SimStruct *S, boolean b): если b TRUE, регистры, что S-функция вызова требует данных прошедшего времени и выделяет счетчик прошедшего времени для инициированной подсистемы, в который выполняется S-функция (если такой счетчик не были уже выделены). См. также Счетчики Прошедшего времени в Инициированных Подсистемах.

  • int ssGetNeedElapseTime(SimStruct *S): возвращается 1, если S-функция указала это, требуется прошедшее время.

  • void ssGetElapseTime(SimStruct *S, (double *)elapseTime): возвращается, к местоположению, на которое указывает elapseTime, значение (как double) из счетчика прошедшего времени, сопоставленного с S-функцией.

  • void ssGetElapseTimeCounterDtype(SimStruct *S, (int *)dtype): возвращает тип данных счетчика прошедшего времени, сопоставленного с S-функцией к местоположению, на которое указывает dtype. Эта функция предназначается для использования с ssGetElapseTimeCounter функция (см. ниже).

  • void ssGetElapseResolution(SimStruct *S, (double *)resolution): возвращает разрешение (то есть, шаг расчета) счетчика прошедшего времени, сопоставленного с S-функцией к местоположению, на которое указывает resolution. Эта функция предназначается для использования с ssGetElapseTimeCounter функция (см. ниже).

  • void ssGetElapseTimeCounter(SimStruct *S, (void *)elapseTime): Эта функция обеспечивается для использования блоков, которые требуют значений прошедшего времени для расчетов фиксированной точки. ssGetElapseTimeCounter возвращается, к местоположению, на которое указывает elapseTime, целочисленное значение счетчика прошедшего времени сопоставлено с S-функцией. Если встречный размер составляет 64 бита, значение возвращено как массив двух 32-битных слов со словом младшего разряда, сохраненным в более низком адресе.

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

    int    *y_dtype;
    ssGetElapseTimeCounterDtype(S, y_dtype);
    
     switch(*y_dtype) {
      case SS_DOUBLE_UINT32: 
          {
              uint32_T dataPtr[2];
              ssGetElapseTimeCounter(S, dataPtr);
     } 
          break;
      case SS_UINT32:
          {
             uint32_T dataPtr[1]; 
             ssGetElapseTimeCounter(S, dataPtr);
     }
          break;
      case SS_UINT16:
         {
              uint16_T dataPtr[1]; 
              ssGetElapseTimeCounter(S, dataPtr);
         }
          break;
      case SS_UINT8:
         {
             uint8_T dataPtr[1];
             ssGetElapseTimeCounter(S, dataPtr);
      }
         break;
      case SS_DOUBLE:
          {
             real_T dataPtr[1]; 
             ssGetElapseTimeCounter(S, dataPtr);
         }
          break;
      default:
        ssSetErrorStatus(S, "Invalid data type for elaspe time
            counter");
        break;
    }

    Если вы хотите использовать фактическое прошедшее время, издайте приказ к ssGetElapseTime функционируйте, чтобы получить доступ к прошедшему времени непосредственно. Вы не должны получить встречное значение и затем вычислить прошедшее время.

    double *y_elapseTime; 
    .
    .
    .
    ssGetElapseTime(S, elapseTime)

API TLC для генерации кода

Следующие функции TLC поддерживают счетчики прошедшего времени в сгенерированном коде, когда вы встраиваете S-функции путем записи скриптов TLC для них.

  • LibGetTaskTimeFromTID(block): Генерирует код, чтобы считать абсолютное время для задачи в который block выполняется.

    LibGetTaskTimeFromTID документируется с другими функциями шага расчета на страницах TLC Function Library Reference документации Компилятора Выходного языка.

    Примечание

    Не используйте LibGetT с этой целью. LibGetT всегда читает базовую ставку (tid 0) таймер. Если LibGetT называется для блока, выполняющегося на подуровне, неправильный таймер читается, вызывая серьезные ошибки.

  • LibGetElapseTime(system): Генерирует код, чтобы считать счетчик прошедшего времени для systemсистема родительская система блока вызова.) Видят, Генерируют Код для Счетчика Прошедшего времени для примера кода, сгенерированного этой функцией.

  • LibGetElapseTimeCounter(system): Генерирует код, чтобы считать целочисленное значение счетчика прошедшего времени для systemсистема родительская система блока вызова.) Эта функция должна использоваться в сочетании с LibGetElapseTimeCounterDtypeId и LibGetElapseTimeResolution. (См. обсуждение ssGetElapseTimeCounter выше.)

  • LibGetElapseTimeCounterDtypeId(system): Генерирует код, который возвращает тип данных счетчика прошедшего времени для systemсистема родительская система блока вызова.)

  • LibGetElapseTimeResolution(system): Генерирует код, который возвращает разрешение счетчика прошедшего времени для systemсистема родительская система блока вызова.)

Похожие темы

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