%% Copyright (C) 2013 Czech Technical University in Prague
%%
%% Authors:
%%     - Carlos Jenkins <carlos@jenkins.co.cr>
%%
%% Permission is hereby granted, free of charge, to any person
%% obtaining a copy of this software and associated documentation
%% files (the "Software"), to deal in the Software without
%% restriction, including without limitation the rights to use,
%% copy, modify, merge, publish, distribute, sublicense, and/or sell
%% copies of the Software, and to permit persons to whom the
%% Software is furnished to do so, subject to the following
%% conditions:

%% The above copyright notice and this permission notice shall be
%% included in all copies or substantial portions of the Software.

%% THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
%% EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
%% OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
%% NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
%% HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
%% WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
%% FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
%% OTHER DEALINGS IN THE SOFTWARE.
%%
%% File : sfunction_lout.tlc
%% Abstract:
%%     TLC file for inlining RPP digital output block.
%%
%% References:
%%     BlockTypeSetup() : refs/rtw_tlc.pdf p. 277
%%     Start()          : refs/rtw_tlc.pdf p. 279
%%     Outputs()        : refs/rtw_tlc.pdf p. 281


%implements sfunction_lout "C"

%include "common.tlc"


%% Function: BlockTypeSetup ====================================================
%function BlockTypeSetup(block, system) void

    %% Ensure required header files are included
    %<RppCommonBlockTypeSetup(block, system)>
    %<LibAddToCommonIncludes("rpp/rpp.h")>
    %assign ::rpp_lout_present=1

%endfunction


%% Function: Start =============================================================
%function Start(block, system) Output

    %if !SLibCodeGenForSim()
        %%No initialization needed for this block
    %endif

%endfunction


%% Function: Outputs ===========================================================
%function Outputs(block, system) Output

    %if !SLibCodeGenForSim()

        %% Get pin number
        %assign pin_num = LibBlockParameterValue(p1, 0)

        %% Get IO signals
        %assign digital_out = LibBlockInputSignal(0, "", "", 0)
        %assign err_flag = LibBlockOutputSignal(0, "", "", 0)

        if (rpp_lout_set(%<pin_num>, %<digital_out>) != SUCCESS) {

            %<err_flag> = TRUE;

        } else {
            %% FIXME: Improve to call this function only once per step on the
            %%        last block.
            %%  But... what happens if the next block want to check it's
            %%  diagnostic value and is not the last LOUT block?
            if (rpp_lout_update() != SUCCESS) {
                %<err_flag> = TRUE;
            }
        }

    %endif

%endfunction

%% [EOF]