Main Content

Specify the Initialization, Output, and Termination Behavior

The setupImpl and stepImpl methods hook the C/C++ functions to the System object™. See Write the Hardware-Specific C/C++ Code for more information on creating C/C++ device driver code. The initialization of a digital pin as output needs to be done only once at model initialization. Hence, the MW_gpioInit function is called in setupImpl. To update the logic state of the digital output pin, a call to MW_gpioWrite is made from stepImpl method. At termination, a call to MW_gpioTerminate is made from releaseImpl method to release the hardware resource. Follow these steps to update the initialization, output, and termination code sections of the DigitalWrite System object you created in Select a System Object Template.

  1. In the MATLAB® Editor, open DigitalWrite.m class file.

  2. Update the setupImpl method using the following code.

    methods (Access=protected)
        function setupImpl(obj) %#ok<MANU>
            if isempty(coder.target)
                % Place simulation setup code here
            else
                % Call C-function implementing device initialization
                coder.cinclude('MW_gpio.h');
                coder.ceval('MW_gpioInit', 9, 1);
            end
        end
        ...
    end

    The coder.ceval function executes calls to the C wrapper functions in digitalio_arduino.h. The second argument and third arguments of coder.ceval are the hardware pin number and pin mode values, respectively.

  3. Update the BuildInfo method using the following code.

    methods (Static)
        ...
        function updateBuildInfo(buildInfo, context)
            if context.isCodeGenTarget('rtw')
                % Update buildInfo
                srcDir = fullfile(fileparts(mfilename('fullpath')),'src'); %#ok     
                includeDir = fullfile(fileparts(mfilename('fullpath')),'include');                 
                addIncludePaths(buildInfo,includeDir);
                % Use the following API's to add include files, sources and linker flags
                addSourceFiles(buildInfo,'MW_gpio.c', srcDir);
            end
        end
        ...
    end
  4. Update the stepImpl method with the following code.

    methods(Access=protected)
        ...
        function stepImpl(obj,u) %#ok<INUSD>
            if isempty(coder.target)
                % Place simulation setup code here
            else
                % Call C-function implementing device output
                coder.ceval('MW_gpioWrite', 9, u);
            end
        end
        ...
    end
  5. Update the releaseImpl method with the following code.

    methods(Access=protected)
        ...
        function releaseImpl(obj) %#ok<MANU>
            if isempty(coder.target)
                % Place simulation termination code here
            else
                % Call C-function implementing device termination
                coder.ceval('MW_gpioTerminate', 9);
            end
        end
        ...
    end

In the next section, you will Test System Object on MATLAB Command Line.

See Also

| |