2.246InhibitBatLowLed:Disables or Re-enables the Batt LED.............47ResetEventsNumber:Resets Events Number.....................48SetRTCDrift:Adjust the Real Time Clock Each Week...............49Chapter 3 M238 PLCSystem Library Data Types...............513.1 PLC_R/W System Variables Data Types.........................52PLC_R_STATUS:Controller Status Codes.........53PLC_R_APPLICATION_ERROR:Detected Application Error StatusCodes .........................54PLC_R_BOOT_PROJECT_STATUS:Boot Project Status Codes ....55PLC_R_IO_STATUS:I/O Status Codes.........................56PLC_R_STOP_CAUSE:RUN to Other State Transition Cause Codes57PLC_W_COMMAND:Control Command Codes...................583.2 System Functions Data Types.................................5960BOOT_PROJECT_STATUS:GetBootProjectstatus Function61STOP_WHY:GetLaststopcause Function Output Codes ........62LOCAL_IO_GET_STATUS:GetLocalIostatus Function ParameterCodes.....63LOCAL_IO_GEN_STATUS:GetLocalIostatus Function OutputCodes ..64RIGHTBUS_GET_STATUS:GetRightBusstatus Function Parameter6566HOUR:SetRTCDrift Function Hour Parameter Type.............67MINUTE:SetRTCDrift Function Minute Parameter Type6869Appendix A Function and Function Block Representation71Differences Between a Function and a Function Block.....72How to Use a Function or a Function Block in IL Language .........73How to Use a Function or a Function Block in ST Language.........76Glossary79Index87E티00000000364 10/2010Safety InformationImportant InformationNOTICERead these instructions carefully,and look at the equipment to bee familiar withthe device before trying to install,operate,or maintain it.The following specialmessages may appear throughout this documentation or on the equipment to warnof potential hazards or to call attention to information that clarifies or simplifies aprocedure.The addition of this symbol to a Danger or Warning safety labelindicates that an electrical hazard exists,which will result in personalinjury if the instructions are not followed.This is the safety alert symbol.It is used to alert you to potentialpersonal injury hazards.Obey all safety messages that follow thissymbol to avoid possible injury or death.A DANGERDANGER indicates an imminently hazardous situation which,if not avoided,will result in death or serious injury.A WARNINGWARNING indicates a potentially hazardous situation which,if not avoided,canresult in death or serious injury.EIO000000036410/20105CAUTIONCAUTION indicates a potentially hazardous situation which,if not avoided,canresult in minor or moderate injury.CAUTIONCAUTION,used without the safety alert symbol,indicates a potentiallyhazardous situation which,if not avoided,can result in equipment damagePLEASE NOTEElectrical equipment should be installed,operated,serviced,and maintained only byqualified personnel.No responsibility is assumed by Schneider Electric for anyconsequences arising out of the use of this material.A qualified person is one who has skills and knowledge related to the constructionand operation of electrical equipment and the installation,and has received safetytraining to recognize and avoid the hazards involved.6E티00000000364 10/2010About the BookAt a GlanceDocument ScopeThis document will acquaint you with the system functions and variables offeredwithin the Modicon M238 Logic Controller.The M238 PLCSystem library containsfunctions and variables to get information and send mands to the controllersystem.This document describes the data types functions and variables of the M238PLCSystem library.The following basic knowledge is required:basic information on functionality,structure and configuration of the M238programming in the FBD,LD,ST,IL or CFC languageSystem Variables (globales variables)Validity NoteThis document has been updated with the release of SoMachine V2.0.Related DocumentsTitle of DocumentationReference NumberM238 Logic Controller Programming GuideEIO0000000384(ENG);EIO0000000385(FRE);E00000000386(GER);EIO0000000388(SPA);EIO0000000389(CHS)You can download these technical publications and other technical information fromour website at www.schneider-electric..EIO000000036410/20107Product Related InformationAWARNINGLOSS OF CONTROLThe designer of any control scheme must consider the potential failure modesof control paths and,for certain critical control functions,provide a means toachieve a safe state during and after a path failure.Examples of critical controlfunctions are emergency stop and overtravel stop,power outage and restart.Separate or redundant control paths must be provided for critical controlfunctions.System control paths may include munication links.Consideration must begiven to the implications of unanticipated transmission delays or failures of thelink.Observe all accident prevention regulations and local safety guidelines.1Each implementation of this equipment must be individually and thoroughlytested for proper operation before being placed into service.Failure to follow these instructions can result in death,serious injury,orequipment damage.1 For additional information,refer to NEMA ICS 1.1(latest edition),"SafetyGuidelines for the Application,Installation,and Maintenance of Solid State Control"and to NEMA ICS 7.1 (latest edition),"Safety Standards for Construction and Guidefor Selection,Installation and Operation of Adjustable-Speed Drive Systems"or theirequivalent governing your particular location.AWARNINGUNINTENDED EQUIPMENT OPERATIONOnly use software approved by Schneider Electric for use with this equipment.Update your application program every time you change the physical hardwareconfiguration.Failure to follow these instructions can result in death,serious injury,orequipment damage.User CommentsWe wele your ments about this document.You can reach us by e-mail attechm schneider-electric..8E目IO0000000364102010M238 System Variables1OverviewThis chapter:gives an introduction to the System Variables (see page 10)describes the System Variables (see page 16)included with the M238PLCSystem libraryWhat's in this Chapter?This chapter contains the following sections:SectionTopicPage1.1System Variables:Definition and Use101.2PLC_R and PLC_W Structures151.3SERIAL_R and SERIAL_W Structures19EIO000000036410/20109M238 System Variables1.1System Variables:Definition and UseOverviewThis section defines System Variables and how to implement them in the ModiconM238 Logic Controller.What's in this Section?This section contains the following topics:TopicPageUnderstanding System Variables11Using System Variables1310E티00000000364 10/2010M238 System VariablesUnderstanding System VariablesIntroductionThis section describes how System Variables are implemented for the controller.These variables have the following attributes:System Variables allow you to access general system information,performsystem diagnostics,and mand simple actions.System Variables are structured variables conforming to IEC 61131 definitionsand naming conventions.They may be accessed using the IEC symbolic namePLC GVL..Some of the PLC GVL variables are read-only (for example PLC R),and someare read-write (for example PLc W).System Variables are automatically declared as global variables.They havesystem-wide scope and must be handled with care because they can beaccessed by any Program Organization Unit(POU)in any task.System Variables Naming ConventionThe System Variables are identified by:a structure name which represents the category of System Variable(e.g.PLC Rrepresents a structure name of read only variables used for controller diagnosis)..a set of ponent names which identifies the purpose of the variable (e.g.i wVendorID represents the controller Vendor ID).You can access the variables by typing the structure name of the variables followedby the name of the ponent.Here is an example of System Variable implementation:VARmyctr Serial DWORD;myctr ID DWORD;myCtr FramesRx UDINT;END VARmyCtr Serial PLC R.i dwSerialNumber;myCtr ID :PLC R.i wVendorID;myCtr FramesRx :SERIAL R[0].i udiFramesReceivedOK;NOTE:The fully qualified name of the system variable in the example above isPLC GVL.PLC R.i wVendorID.The PLC GVL is implicit when declaring avariable using the Input Assistant,but it may also be entered in full.Goodprogramming practice often dictates the use of the fully qualified variable name indeclarations.EI0000000036410/201011M238 System VariablesSystem Variables Location2 kinds of system variables are defined for use when programming the Controller:·located variables·unlocated variablesThe located variables:have a fixed location in a static %MW area:%MW60000 to %MW60199 for Read only System Variables%MW62000 to %MW62199 for Read Write System Variablesare accessible through Modbus serial request both in RUNNING and STOPPEDstatesare used in SoMachine programs according to thestructure name.ponent name convention explained previously (%MWaddresses between 0 and 59999 can be accessed directly;adresses greaterthan this are considered out of range by SoMachine and can only be accessedtrough the structure_name.ponent_name convention)The unlocated variables:are not accessible through any field bus or work requests unless you locatethem in the relocation table,and only then can they be accessed in RUNNINGand STOPPED states.The relocation table uses the following dynamic %MWareas:%MW60200 to %MW61999 for Read only Variables%MW62200 to %MW63999 for Read Write Variablesare used in SoMachine programs according to thestructure name.ponent name convention explained previously (%MWaddresses between 0 and 59999 can be accessed directly;adresses greaterthan this are considered out of range by SoMachine and can only be accessedtrough the structure name.ponent name convention).12E티00000000364 10/2010