Specify the Initialization, Output, and Termination Behavior

Step 4 of 7 in Create a Digital Write Block

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.