Rockwell Automation 1789-L10_L30_L60 SoftLogix 5800 System User Manual - Manual (Page 117)

Rockwell Automation Publication 1789-UM002J-EN-P - December 2012 117
Develop External Routines Chapter 7
How the Project Stores and Downloads an External Routine
To use an external routine, you must associate (also known as ‘map’) a DLL file to
an external routine that you create in the Controller Organizer of a project (as
shown in
Chapter 6 ). You choose the DLL file that contains the function you
want to execute. RSLogix 5000 software makes a copy of that DLL and stores it
in the external routine folder located in the project directory, in a sub-folder
named the same as the project file. For example, if the project MyProject.ACD is
in C:\RSLogix 5000\Projects, mapping a DLL to that project stores a copy of the
DLL file in the directory:
C:\RLogix5000\Projects\ExternalRoutines\MyProject\.
When the you download the project to the controller, the mapped DLL is also
downloaded to the target controller and a copy of the DLL is placed in the slot
directory of the controller. For example, if you download MyProject.ACD to a
controller in slot 4, the external routine DLL file is downloaded to the location
C:\Program Files\Rockwell Automation\SoftLogix 5800\Data\slot04 on the
SoftLogix controller.
Because this process creates copies of the original DLL file, you can execute
different versions of the same DLL on SoftLogix controllers in different slots of
the same virtual chassis. The DLL used by a controller in one slot is completely
independent of the DLL used by a controller in another slot. For this reason, if
you update a DLL, you re-map the DLL in each project and re-download the
updated projects to the appropriate controllers.
Linking an individual DLL file to a specific controller and slot can be useful for
debugging changes or testing new versions of an external routine. You can load
different versions into controllers in different slots without having to actually
update controllers that are performing plant control.
Create Synchronous, Single-
threaded External Routines This type of external routine runs synchronously in the process space of the
control engine. Use this type of routine when the execution time of the function
does not significantly impact the overall ladder scan time or cause a watchdog
fault in the controller. A watchdog fault is a major fault that occurs because a scan
of the routine did not complete within the expected amount of time.
Create a Visual Studio Project
Complete these steps to create a project in Visual Studio.
1. Launch Visual Studio software.
IMPORTANT If you want to use a copy of a project on another workstation, take care when
making a copy of a project that includes an external routine. In addition to the
ACD file, you must also copy the external routines folder that contains all of the
DLL files associated with that ACD file.