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

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

Следующая таблица обобщает входные параметры к LibBlockInputSignal.

%<tRealPart>Integer
%<tImagPart>Integer

"%<tRealPart>5"
"%<tImagPart>5"

Общее использование

Использование LibBlockInputSignal попадает в категории, описанные ниже.

Прямая индексация.  Если ucv == "" и lcv == "", LibBlockInputSignal возвращает выражение индексации для элемента, указанного sigIdx.

Цикл прокручиваться/разворачивать.  В этом случае lcv и sigIdx сгенерированы директивой %roll, и ucv должен быть "". Непустое значение для lcv позволено только, когда сгенерировано директивой %roll и при использовании Ролика файл TLC (или пользователь предоставил Ролик файл TLC, который соответствует той же переменной/сигнала обработке смещения). Кроме того, вызовы LibBlockInputSignal с lcv должны произойти только, когда "U" или определенный входной порт (например, "u0") передаются директиве %roll через аргумент переменных списка.

Следующий пример показывает один вход / одну S-функцию выходного порта.

%assign rollVars  = ["U", "Y", "P"]
%roll sigIdx=RollRegions, lcv=RollThreshold, block, ...
    "Roller", rollVars
  %assign u = LibBlockInputSignal( 0, "", lcv, sigIdx)
  %assign y = LibBlockOutputSignal(0, "", lcv, sigIdx)
  %assign p = LibBlockParameter(   0, "", lcv, sigIdx)
  %<y> = %<p> * %<u>;
%endroll

С директивой %roll sigIdx является начальным значением индекса текущей области списка, и lcv является "" или переменная индексации. Следующее является примерами допустимых значений:

LibBlockInputSignal(0, "", lcv, sigIdx)    rtB.blockname[0]

LibBlockInputSignal(0, "", lcv, sigIdx)    u[i]

В первом примере LibBlockInputSignal возвращает rtB.blockname[2], когда входной порт соединяется с выводом другого блока, и

Во втором примере LibBlockInputSignal returns u[i], когда текущая область списка выше порога списка и ширины входного порта, нескалярный (широкий). В этом случае Ролик, который файл TLC настраивает локальную переменную, u, чтобы указать на входной сигнал и код в текущей директиве %roll, помещается в цикле for.

Для другого примера рассмотрите блок с несколькими входными портами, где каждый порт имеет ширину, больше, чем, или равный 1 и по крайней мере одному порту имеет ширину, равную 1. Следующие кодовые наборы выходной сигнал к сумме квадратов входных сигналов.

%assign y = LibBlockOutputSignal(0, "", "", 0)
%<y> = 0;

%assign rollVars = ["U"]
%foreach port = block.NumDataInputPorts - 1
  %roll sigIdx=RollRegions, lcv = RollThreshold, block, ...
    "Roller", rollVars
  %assign u = LibBlockInputSignal(port, "", lcv, sigIdx)
  %<y> += %<u> * %<u>;
  %endroll
%endforeach

Поскольку первым параметром LibBlockInputSignal является индексированный 0, необходимо индексировать цикл foreach, чтобы начать с 0 и закончиться в NumDataInputPorts-1.

Переменная Контроля за работой пользователей (ucv) Обработка.  Это - усовершенствованный режим и обычно не требуемое авторами S-функции.

Если ucv != "", LibBlockInputSignal возвращает rvalue для входного сигнала с помощью переменной контроля за работой пользователей индексация выражения. Выражение индексации контрольной переменной имеет следующую форму:

rvalue_id[%<ucv>]%<optional_real_or_imag_part>

Чтобы получить rvalue_id, посмотрите на целую часть sigIdx. Необходимо задать sigIdx, потому что вход к этому блоку может быть прерывистым, означая, что вход может прибыть из нескольких различных областей памяти (источники сигнала), и sigIdx используется, чтобы идентифицировать сферу интересов для ucv. Можно также использовать sigIdx, чтобы определить, нужно ли к действительной или мнимой части сигнала получить доступ.

Можно получить optional_real_or_imag_part из части строки sigIdx (т.е. "re", или "im" или "").

Обратите внимание на то, что значение для lcv проигнорировано, и sigIdx должен указать на тот же элемент во входном сигнале, на который первоначально указывает ucv.

Обработка ucv с LibBlockInputSignal требует ухода. Рассмотрите прерывистый входной сигнал, питающий входной порт как в следующей блок-схеме:

Чтобы использовать ucv устойчивым способом, необходимо использовать директиву %roll с порогом списка 1 и Ролика файл TLC, который не имеет настройки заголовка/трейлера цикла для этого входного сигнала. Кроме того, необходимо использовать ROLL_ITERATIONS, чтобы определить ширину текущей области списка, как в следующем коде TLC:

{
int i;

%assign rollVars  = [""]
%assign threshold = 1
  %roll sigIdx=RollRegions, lcv=threshold, block, ...
    "FlatRoller", rollVars
  %assign u = LibBlockInputSignal( 0, "i", "", sigIdx)
  %assign y = LibBlockOutputSignal(0, "i+%<sigIdx>", "", sigIdx)
  %assign p = LibBlockParameter( 0, "i+%<sigIdx>", "", sigIdx)
  for (i = 0; i < %<ROLL_ITERATIONS()>; i++) {
    %<y> = %<p> * %<u>;
  }
%endroll
}

Обратите внимание на то, что FlatRoller не имеет настройки заголовка/трейлера цикла (rollVars проигнорирован). Его цель состоит в том, чтобы обойти RollRegions блока. Также можно обеспечить непрерывный входной сигнал к блоку путем определения

ssSetInputPortRequiredContiguous(S, port, TRUE)

в вашей S-функции.

В этом случае код TLC упрощает до

{
%assign u = LibBlockInputSignal( 0, "i", "", 0)
%assign y = LibBlockOutputSignal(0, "i", "", 0)
%assign p = LibBlockParameter(   0, "i", "", 0)

for (i = 0; i < %<LibBlockInputSignalWidth(0)>; i++) {
  %<y> = %<p> * %<u>;
  }
}

Если вы создаете свой собственный ролик, и индексация не приспосабливает пути Ролику, которым управляет файл TLC, обеспеченный MathWorks, то должен использовать ucv вместо lcv.

Обработка Входных параметров: ucv, lcv, и sigIdx

Рассмотрите следующие случаи:

Возвращенное значение зависит от того, с чем соединяется входной сигнал в блок-схеме и как функция вызывается (например, в %roll или непосредственно). В вышеупомянутом примере,

Когда названо в рамках a%roll директивы, LibBlockInputSignal смотрит на ucv, lcv, и sigIdx, текущую область списка и текущий порог списка, чтобы определить возвращаемое значение. Переменная ucv имеет наивысший приоритет, lcv имеет следующий наивысший приоритет, и sigIdx имеет самый низкий приоритет. Таким образом, если ucv задан, он используется (таким образом, когда названо в директиве %roll, это обычно - ""). Если ucv не задан, и если lcv и sigIdx заданы, возвращенное значение зависит от того, помещается ли текущая область списка в цикл for или быть расширенным. Если область списка помещается в цикл, то lcv используется; в противном случае sigIdx используется.

Прямой вызов LibBlockInputSignal (внутри или снаружи директивы %roll) использует sigIdx, когда ucv и lcv заданы как "".

Для примера LibBlockInputSignal смотрите sfun_multiport.tlc.

См. также blkiolib.tlc.

Пример

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

%assign uAddr = LibBlockInputSignalAddr(0, "", "", 0) 
%assign y = LibBlockOutputSignal(0, "", "", 0)
%<y> = myfcn(%<uAddr>);

Смотрите LibBlockInputSignalAddr в blkiolib.tlc.