Main Content

Simulation and Code Generation of Motion Instructions

You can use Simulink® PLC Coder™ software for the behavioral simulation and structured text code generation for the Rockwell Automation® RSLogix™ motion control instructions.

Workflow for Using Motion Instructions in Model

This workflow uses the Simulate and Generate Structured Text Code for Rockwell Automation Motion Instructions example in the plccoderdemos folder. This example provides a template that you can use with motion instructions. It contains the files listed in this table:

NameDescription
MotionControllerExample.slx

Simulink model containing an example Stateflow® chart for modeling motion instructions.

DriveLibrary.slx

Simulink library with a Stateflow chart that is used for modeling a real world drive (axis) with trajectories, delays, and other parameters.

MotionTypesForSim.mat

MAT-file containing the bus data types for the AXIS_SERVO_DRIVE and MOTION_INSTRUCTION. The MotioncontrollerExample.slx model loads the content of the MAT-file into the workspace. If you are creating a model you, must load this MAT-file for simulation and code generation.

Trajectory.m

MATLAB® class file for implementing trapezoidal velocity profile. This file is used to simulate the behavior of the Motion Axis Move (MAM) command.

MotionApiStubs.slx

Supporting file for code generation.

MotionInstructionType.m

MATLAB enumeration class file that represents the type of motion API calls. For example, isMAM, isMSF. This file is used only during simulation.

plc_keyword_hook.m

Helper file to avoid name mangling and reserved keyword limitations.

plcgeneratemotionapicode.p

Function that transforms the chart in the model to make it suitable for code generation.

Before you start, copy the files in the example to the current working folder.

  1. Create a Simulink model with a Stateflow chart.

  2. Load the bus data types from the MotionTypesForSim.mat file into the workspace by using the load function.

  3. Create data that represents the drive and motion instructions for the chart. For information on adding data to Stateflow charts, see Add Stateflow Data (Stateflow)

  4. Copy the drive(axis) model from the DriveLibrary.slx file into the Stateflow chart. You must copy the drive model as an atomic subchart.

    The drive logic Stateflow chart models a real world drive with parameters such as trajectory and delay. Any drive subchart has this data:

  5. In the Subchart Mappings dialog box, to map the drive subchart data store memory data with the local data of the appropriate names in the container chart. For more information, see Map Variables for Atomic Subcharts and Boxes (Stateflow).

  6. Use graphical functions to create motion API instructions. For example, for the Motion Servo On (MSO) instruction:

    The mapping between the inputs to the outputs is through pass by reference.

  7. Create the controller logic in another subchart and use the motion instructions created in the previous step in the chart. In the example, Controller1 has this Stateflow chart.

Simulation of Motion API Model

You can run simulation on the model containing the motion instructions and see the state changes in the controller chart and the Drive subchart. You can also log the local data of the chart, such as AXIS and the MOTION_INSTRUCTION variables. For more information, see Log Simulation Output for States and Data (Stateflow).

At the end of simulation, the logged signals are captured in the base workspace as a variable called logsout. You can import the logged signals into Simulation Data Inspector. For more information, see View Simulation Data in Simulation Data Inspector.

Structured Text Code Generation

To prepare the model for code generation and generate structured text code, use the plcgeneratemotionapicode function. The plcgeneratemotionapicode takes the full path name of subsystem containing the original chart as an input and creates a model from which you can generate structured text code.

Add Support for Other Motion Instructions

The plcdemo_motion_api_rockwell example supports only these motion instructions:

  • MAM

  • MAS

  • MSF

  • MSO

To use other Rockwell Automation RSLogix motion instructions in the model (for example, Motion Axis Jog (MAJ)), :

  1. Because the MAJ instruction is similar to MAM instruction, create a bus for MAJ with elements similar to that of MAM. See Type Editor.

  2. Update the MotionTypesForSim.mat file with the new definitions for MAJDATA and AXIS_SERVO_DRIVE.

  3. In the Stateflow chart, create a graphical function representing MAJ (similar to MAM). Assign the appropriate inputs and outputs.

  4. Create a single transition with commands to set the output values.

  5. Remove the transition commands and copy the graphical function to the MotionApiStubs.slx.

  6. Update the functionName variable in the getDriveTemplateNames.m file to include MAJ.

  7. Update the DriveLibrary.slx file to respond to MAJ calls during simulation.

    • Create a isMAJ graphical function (similar to isMAM).

    • Update the Drive subchart to respond to MAJ by implementing required transitions etc (similar to MAM as shown).

  8. Create or update the controller logic as required. Create a new state and add MAJ instruction to it (similar to the MAM ).

  9. Perform simulation and generate code using the steps described earlier.