RSLogix 5000 Add-On Instructions Instructions by John Schop One of the most powerful newer features of the RSLogix 5000 program is the ability to create Add-On Instructions. This allows a programmer to define an instruction that contains a commonly used function or algorithm (as a set of instructions), and use it as one instruction. To illustrate how this works, I am going go ing to create an instruction that operates a cylinder, and because I¶m making an add-on add-o n instruction, I can use that same instruction to control any number of cylinders in my application Assuming that these cylinders have two solenoids (one for µin¶, one for µout¶), and two proximity switches (one for«ah well, you get the t he picture), I want to create an add-on add-o n instruction that has the common logic in it, so I can just execute that instruction instruction for each c ylinder. After all, whatever the cylinders size or function is in the machine, every cylinder basically has the same pro perties and commands. Let¶s start with creating a new add-on instruction: instruction:
Right click on the Add-On Instructions folder in the controller organizer, and click µNew AddOn Instruction¶. In the screen that pops up, you can dream up a name for your instruction, add a description, choose a revision number, and add some notes:
As you can see, I kept the checkbox for µOpen Definition¶ checked, which means that in the next step I¶ll be working on the definition of my cylinder. Click OK, and you will get the µInstruction Definition¶ window:
If you go to the µParameters¶ tab, you can define the para meters your instruction will use to do its magic. As you can see in the screenshot below, I¶ve defined my parameters. Don¶t panic if you don¶t know exactly which parameters you¶re going to need for your add-on, you can still change everything later. The E nableIn and E nableOut are two parameters that every instruction has, and are automatically created for you. I added command bits, status bits, a fault bit, a maximum travel time, a clear fault bit, and the I/O my cylinder is going to have. For each parameter, you¶ll have to choose if it is an input for the instruction or an output, or maybe even an in and output. Also, you can identify here if the parameter is required, and if it is visible. I decided that all my parameters are going to be required, which auto matically also makes them visible:
On the µLocal Tags¶ tab, I included a timer, which I will use to t ime the moves of the cylinder:
Let¶s not worry about the other tabs at this point, we have enough to create our instruction. It¶s time to use our add-on instruction! When I want to use my instruction, I simply go to the rung where I want it, then look up my new instruction in the µLanguage element¶ tool bar (or you could press Alt-Insert on the keyboard):
(If you hover your mouse over the button where it says µCylinder¶, you will get a preview of what the instruction is going to look like). I click the button, and voila, there¶s my instruction:
Now I only need to add some data to the parameters:
In this example, I¶ve added inputs from an input card (Local:1) for the co mmands (pushbuttons or something like that), and o f course for the I/O from the cylinder. The rest are just tags I created, and for µTime¶ I entered a value of 3000 (milliseconds). Pay attention to the tag at the very top, called µC yl1¶. This is a tag of the type µCylinder¶. The data type was created automagically when we created the instruction, but you need to define one tag of that type for every instance, so the program can store data in there. (For you Siemens addicts, it¶s like an Instance DB). Now that we have all our parameters wired up, we need to do something with them. Our add-on instruction needs some logic! In the controller organizer, find your add-on instruction, and then open up the editor by double clicking on µLogic¶.
The next part of this article is of course just my interpretation of what a c ylinder should do; you can of course use your own interpretation to create whatever functionality you want here. Letµs look at my first two rungs:
Here you see that if there is a command to go in (which we hooked up to the CmdIn parameter) then I turn on the output to move the cylinder in (O_In) and keep it energized, un less there is a fault, or the cylinder is in (StsIn). The same go es for moving out of course, in the second rung. The next three rungs make the status bits:
If either one of the outputs is on, the cylinder is moving (StsMoving), and when the input for cylinder in or cylinder out is true (and the other one is NOT, which is a security I usually build in), the StsIn or StsOut parameters are set to true. Next, Iµm going to determine if I should trigger the Fault bit:
First I set the preset value of the timer to the value that was passed to my instruction in the µTime¶ parameter. In the next rung, I let the StsMoving bit start that timer. Once the t imer is done, it will keep itself energized unt il somebody resets the fault with the ClrFault parameter. Also, the fact that the timer is done (FaultTimer.DN), or the fact that the cylinder is in and out at the same time, triggers the µFault¶ bit that is used in the first couple of rungs to turn the commands off. That¶s all the logic I wanted to show you. Use our imagination, and you can see a whole lot of fancy alarm and diagnostic bits, and maybe even a position sensor. A great benefit of this is, that once you¶ve made a solid piece of code, you can re-use that add-on instruction in other projects as well, by expo rting and importing the instruction, and even bu ild a library of instructions for common parts of your applications. The sky is the limit here. You can think about pieces of equipment, like valves or motors, or even pieces o f functionality, like for example recipe management, or complex calculations. And of course, as we all know, during the project, the required funct ionality will change. If you used add-on instructions, you¶ll only have to change the logic once, to change the behavior of every piece of equipment t hat uses the instruction.
