ILX800-SMSG User Manual
Contents
1. 3 3 2 Commands to Execute Some Action Note If for some reason you do not want the module to send out acknowledge response text messages for the following text message commands you can set the CONFIG_ackEnabled variable to FALSE Command Action by ILX800 SMSG Response from ILX800 SMSG OUTPUTx ON Energizes controller output x OK Set OUTPUTx ON OUTPUTx OFF De energizes controller outputx OK Set OUTPUTx OFF WHITELIST ON Enables Whitelist filtering OK Set ENABLEWL ON WHITELIST OFF Disables Whitelist filtering OK Set ENABLEWL OFF ADD XXXXXXXXXX Writes a phone number to the fifth OK xxxxxxxxxx added element of the Receiver List array Note Any phone number stored in the fifth element of the Receiver List array will be overwritten by this command DELETE xxxxxxxxxx Deletes phone number from the OK Xxxxxxxxxx deleted Receiver List ProSoft Technology Inc Page 33 of 45 August 23 2012 Using Your ILX800 SMSG Plug in Module ILX800 SMSG amp Micro800 Platform User Manual for GSM Networks Page 34 of 45 ProSoft Technology Inc August 23 2012 ILX800 SMSG e Micro800 Platform Security Tips for GSM Networks User Manual 4 4 1 4 2 4 3 Security Tips In This Chapter Enable the Whitelist Feature AA 35 Implement Password Protection srrerrrnnrvenvnnvrnnnvnvrnnnrnvrrerernvenerenrentenn 35 Restrict Access to Output Control 35 Enable the Whitelist Fe2. ProSoft Technology Inc Page 23 of 45 August 23 2012 Setting Up the Controller Program ILX800 SMSG e Micro800 Platform User Manual for GSM Networks 2 7 Going Online with the Controller 1 Double click the controller icon in the Project Organizer pane 2 Click the CONNECT button in the top right corner of the tab to go online with the controller El Connected Components Workbench EEK File Edit View Build Debug Tools Communications Window Help N d se A EAEL Gr 7 19 Project Organizer Micro830 Name ml830afdemo1101 z Micro830 Program Major Fault g TOn F A Connect Disconnected JI Run Controller Mode R zogen Ee es 2080 LC30 16QWB au Manuals Help Catalog D E Initialize jl Ge eng jeoceeeeeeeed o Loci Micro830 mar a es pi Scheduled o al ParseSMSC General H o D There are no usable controls in this group Drag an item onto this text to SetTagvalu Zeen 00000 add it to the toolbox 1 a Loci GetTagVal General Properties etl agvalt ER eeng Vendor Name Allen Bradley Communication Port Loci y 7 pi Workstation RA SUPPORT MAST e Linx Gateways Ethernet Ze AB DF1 1 DEI Ze AB ETHIP 1 Ethernet E ap VEP 1 1789 417 4 Virtual Chassis s r USB ewigi Micro830 2080 LC30 160WB D 6 9 68 8 Page 24 of 45 ProSoft Technology Inc August 23 2012 ILX
3. Note For technical support calls within the United States an after hours answering system allows 24 hour 7 days a week pager access to one of our qualified Technical and or Application Support Engineers Detailed contact information for all our worldwide locations is available on the following page ProSoft Technology Inc Page 43 of 45 August 23 2012 Support Service and Warranty ILX800 SMSG amp Micro800 Platform User Manual for GSM Networks Internet Web Site www prosoft technology com support E mail address support prosoft technology com Asia Pacific Tel 603 7724 2080 E mail asiapc prosoft technology com 7 2 location in Malaysia Languages spoken include Chinese English Asia Pacific location in China Tel 86 21 5187 7337 x888 E mail asiapc prosoft technology com Languages spoken include Chinese English Europe location in Toulouse France Tel 33 0 5 34 36 87 20 E mail support EMEA prosoft technology com Languages spoken include French English Europe location in Dubai UAE Tel 971 4 214 6911 E mail mea prosoft technology com Languages spoken include English Hindi North America location in California Tel 1 661 716 5100 E mail support prosoft technology com Languages spoken include English Spanish Latin America Oficina Regional Tel 1 281 2989109 E Mail latinam prosoft technology com Languages spoken include Spanish Eng
4. Enable the Whitelist Feature 35 Using Your ILX800 SMSG Plug in Module 27 Entering a Test Phone Number 19 V G Verifying Wireless Communication 27 Going Online with the Controller 24 39 W H Whitelist 30 35 How to Contact Us 2 Y I Your Feedback Please 2 Implement Password Protection 35 Important Safety Information 3 Important User Information 3 Importing the Sample Program 15 Installing an Antenna 9 12 Installing the ILX800 SMSG Plug in Module 11 Installing the SIM Card 10 L LED Status Indicator 37 O Overview 8 P Package Contents 9 Pinouts 3 ProSoft Technology Product Documentation 2 R Receiver List 19 28 Reference 41 ProSoft Technology Inc Page 45 of 45 August 23 2012
5. LED blinks This indicates a problem with backplane communication to the controller slowly but the module Verify that does not send or The controller is in RUN or REM RUN mode respond to text The module is plugged into the slot that has been configured for it in messages the controller program The module is connected to the cellular carrier when the module boots up If there is no connection to the carrier when the module boots up the configuration message retries from the controller to the module will time out Without a configuration the module will not function properly If you suspect that this has occurred troubleshoot wireless network connectivity then reboot the module by cycling power to the controller The controller program handles all read and write situations and all four function blocks for the ILX800 SMSG are present in the Project Organizer pane The module s status Verify that variables in CCW never COW is online with the controller and in debug mode ee from U after the a There is backplane communication between the controller and the module boots up module see above Page 38 of 45 ProSoft Technology Inc August 23 2012 ILX800 SMSG e Micro800 Platform for GSM Networks Diagnostics and Troubleshooting User Manual 5 3 Status Data Useful status data for the ILX800 SMSG plug in module can be found in the Local Variables for the PSFT ILX800 SMSG program The status data is contained in
6. Ladder or Function Block programming in CCW To customize the program to the requirements of your application follow the instructions in the comments of the customizable program sections Caution We do not recommend editing any sections of the program marked DO NOT MODIFY Do not modify the four Function Blocks for the ILX800 SMSG The sample program demonstrates programming for controller digital inputs 0 and 1 and digital outputs 0 and 1 Customize your application by using the examples provided to add the logic for the inputs and outputs required by your application Note If you require assistance with programming in CCW refer to your CCW documentation 2 8 1 Sending Out an Event Triggered Text Message Among the sample program s many customizable features is the Generic Event Triggered Text Message This feature gives you the ability to send out a user defined text message triggered by any event of your choosing The text message is sent out through the module to all receivers on the Receiver List To set up an Event Triggered Text Message 1 Enter your custom text message string in the Initial Value column for the DATA_customSMSText variable This variable is found in the Local Variables folder for the PSFT_ILX800_SMSG program By default this variable contains Customize your string bere 2 Make sure the Receiver List CONFIG receiverList has at least one phone number entry 3 With CCW in debug mode you can trigger this
7. static safe workstation When not in use store the equipment in appropriate static safe packaging Caution POINT UO is grounded through the DIN rail to chassis ground Use zinc plated yellow chromated steel DIN rail to assure proper grounding Using other DIN rail materials for example aluminum plastic and so on which can corrode oxidize or are poor conductors can result in improper or intermittent platform grounding Caution When you connect or disconnect the Removable Terminal Block RTB with field side power applied an electrical arc can occur This could cause an explosion in hazardous location installations Be sure that power is removed or the area is nonhazardous before proceeding Agency Approvals and Certifications FCC CE ETSI UL Class 1 Division 2 ATEX Zone 2 CB Safety PTCRB ILX800 SMSG Micro800 Platform Contents for GSM Networks User Manual Contents Your Feedback EE 2 Howto Contact Us eege eres kee Eege 2 ProSoft Technology Product Documentation 2 Important Safety Information 3 Important User Information eierens iieiea EEEE VEERA EAEN EE EAA 3 Agency Approvals and Certifications oonrrrnnrrnnnnvnnnnnrnnnrrrnnnrnvnnnnnnnnvnnrnr renn nnnn vennen rennrrnesnnnnnennnnrennen 4 1 Start Here 7 1 1 EE 8 1 2 Package Contents oniiir E eru led sje AEN ERAN Reg SE 9 1 3 System Requirements rnannvnnnrrnnnnrnnnnnvnnnnvvnnnrnnnnnvnnannnnnnrrennnrnnannvenenrenenrnsennnnnennenennn 9 1 4 In
8. the local provider tower and enable bi directional text messaging between the controller and remote cell phones Because the module uses SMS there is no need for costly cellular data plans The SMS plug in snaps into an open slot in the front of the Micro830 controller The controller provides power and communicates with the plug in module over the backplane A sample CCW program is available at no additional cost with plug in function block drivers and a sample program provided in Structured Text Ladder and Function Block languages Programmers may use these sample programs to create their own projects for sending and receiving messages alarms and machine status updates The front mounted coax connector allows for either a direct mounted antenna or externally mounted antenna installed outside the panel or cabinet for better cellular reception Antennas must be ordered separately Tuesday June 19 Text from 1 608 692 9401 ProSoft SMS Plug in Module is ready Page 8 of 45 ProSoft Technology Inc August 23 2012 ILX800 SMSG amp Micro800 Platform Start Here for GSM Networks User Manual 1 2 Package Contents The following components are included with your ILX800 SMSG plug in module Note You will also need a SIM card and antenna not included For information on suitable antennas please see Installing an Antenna page 12 Qty Part Name Part Number Part Description 1 ILX800 SMSG plug in ILX800 SMSG SMS Te
9. 800 SMSG e Micro800 Platform Setting Up the Controller Program for GSM Networks User Manual 4 A green border around the controller icon indicates that CCW is online with the controller E Initialize i Local Variables Scheduled i Local Variables ParseSMSCmd Ul W VW Local Variables B SetTagvalue i Local Variables 5 Open the DEBUG menu and then select START DEBUGGING 6 You will now be able to see the contents of the local and global program variables in 1 red Project Organizer vax _ PSFT ILX800 SMSG VAR Name Projec ti 5 Logical Yalue Physical value II Micro830 ott p e STATUS errCount D N A UINT E Gei Programs STATUS majorRev 1 NjA INT STATUS minorRev 1 N A INT a PSFT_ILX800_SMSG z STATUS netConnFailedRetries 8 N A DINT i Local Variables STATUS networkStatus 49 N A USINT STATUS signalStrength 73 N A INT i Global Variables STATUS SIMCardStatus 1 N A USINT Se STATUS SMSRecvCount 4 NjA DINT Je Datatypes STATUS SM5SendCount 8 N A DINT g RB Furction Blocks STATUS SMSSendFailCount 0 N A DINT pr STATUS WLFiltCount 0 N A DINT ProSoft Technology Inc Page 25 of 45 August 23 2012 Setting Up the Controller Program ILX800 SMSG amp Micro800 Platform User Manual for GSM Networks 2 8 Customizing Your Controller Program Logic The sample controller program can be used as is or it can be customized Customization requires knowledge of Structured Text
10. AS BEEN SWITCHED OFF OR THE AREA IS KNOWN TO BE NON HAZARDOUS THIS DEVICE CONTAINS A TRANSMITTER MODULE FCC ID PLEASE SEE FCC ID LABEL ON BACK OF DEVICE THIS DEVICE USES AN INTERNAL COMPACT FLASH RADIO MODULE AS THE PRIMARY RADIO COMPONENT THE COMPACT FLASH RADIO MODULE DOES NOT HAVE AN FCC ID LABEL THE COMPACT FLASH RADIO MODULE HAS NO USER SERVICEABLE PARTS THIS DEVICE COMPLIES WITH PART 15 OF THE FCC RULES OPERATION IS SUBJECT TO THE FOLLOWING TWO CONDITIONS 1 THIS DEVICE MAY NOT CAUSE HARMFUL INTERFERENCE AND 2 THIS DEVICE MUST ACCEPT ANY INTERFERENCE RECEIVED INCLUDING INTERFERENCE THAT MAY CAUSE UNDESIRED OPERATION CHANGES OR MODIFICATIONS NOT EXPRESSLY APPROVED BY THE PARTY RESPONSIBLE FOR COMPLIANCE COULD VOID THE USER s AUTHORITY TO OPERATE THE EQUIPMENT Industry Canada Requirements THIS DEVICE HAS BEEN DESIGNED TO OPERATE WITH AN ANTENNA HAVING A MAXIMUM GAIN OF 24 dB AN ANTENNA HAVING A HIGHER GAIN IS STRICTLY PROHIBITED PER REGULATIONS OF INDUSTRY CANADA THE REQUIRED ANTENNA IMPEDANCE IS 50 OHMS TO REDUCE POTENTIAL RADIO INTERFERENCE TO OTHER USERS THE ANTENNA TYPE AND ITS GAIN SHOULD BE CHOSEN SUCH THAT THE EQUIVALENT ISOTROPICALLY RADIATED POWER EIRP IS NOT MORE THAN THAT REQUIRED FOR SUCCESSFUL COMMUNICATION THE INSTALLER OF THIS RADIO EQUIPMENT MUST INSURE THAT THE ANTENNA IS LOCATED OR POINTED SUCH THAT IT DOES NOT EMIT RF FIELD IN EXCESS OF HEALTH CANADA LIMITS FOR THE GENERAL POP
11. LOAD from the shortcut menu p O Open GC Build Download Ga Upload EA Import gt Export b X Delete Rename 4 25 3 _ Properties gt 5 Inthe Connection Browser window click the sign in front of the USB icon to expand it Select your controller from the list and click OK Connection Browser Autobrowse RI Workstation RA SUPPORT MAST es Linx Gateways Ethernet amp r AB_DF1 1 DEI gs AB ETHIP 1 Ethernet H E AB VBP 1 1789 A17 A Virtual Chassis USB egiidi Microg30 2080 LC30 160WB Page 22 of 45 ProSoft Technology Inc August 23 2012 ILX800 SMSG e Micro800 Platform Setting Up the Controller Program for GSM Networks User Manual 6 If the controller s mode switch is in the REM position CCW will prompt you to change to Remote Program mode Click YES Download Confirmation A The controller is in Remote Run mode Do you want to change to Remote Program mode 7 CCW will transfer the program to the processor This process may take a few minutes 8 If the controller s mode switch is in the REM position CCW will prompt you to change back to Remote Run mode when the download is complete Click YES Download Confirmation Pi Download is Complete Do you want to change the controller back to Remote Run Note If you receive an error message during these steps refer to your CCW documentation to interpret and correct the error
12. Message Commands page 31 ProSoft Technology Inc Page 29 of 45 August 23 2012 Using Your ILX800 SMSG Plug in Module ILX800 SMSG e Micro800 Platform User Manual for GSM Networks 3 2 2 Whitelist The Whitelist can hold up to five phone numbers If the Whitelist is enabled the plug in module will only respond to text message commands from phone numbers on the Whitelist If the Whitelist is disabled the plug in module will respond to text message commands from any phone number To enable or disable the Whitelist 1 Double click the LOCAL VARIABLES icon for the PSFT ILX800 SMSG program in the Project Organizer pane Click the header of the NAME column to sort the variables alphabetically Find the Boolean variable CONFIG_WHITELISTENABLED in the Name column Enter TRUE or FALSE is the Initial Value column Save build and download the program to the controller oF WD Note The Whitelist can also be enabled or disabled from a cell phone via a text message command See Text Message Commands page 31 To enter phone numbers in the Whitelist 1 Double click the LOCAL VARIABLES icon for the PSFT ILX800 SMSG program in the Project Organizer pane 2 Click the header of the NAME column to sort the variables alphabetically 3 Find the variable CONFIG_whiteList in the Name column Click the sign next to CONFIG_whiteList to expand it 4 Enter up to five phone numbers in the nitial Value column Do not enter any spaces parent
13. ProSoft NEERN DL GYT Where Automation Connects ILX800 SMSG Micro800 Platform SMS Text Plug in Module for GSM Networks August 23 2012 USER MANUAL Your Feedback Please We always want you to feel that you made the right decision to use our products If you have suggestions comments compliments or complaints about our products documentation or support please write or call us How to Contact Us ProSoft Technology 5201 Truxtun Ave 3rd Floor Bakersfield CA 93309 1 661 716 5100 1 661 716 5101 Fax www prosoft technology com support prosoft technology com Copyright 2011 ProSoft Technology Inc all rights reserved ILX800 SMSG User Manual August 23 2012 ProSoft Technology ProLinx H inRAx P ProTalk and RadioLinx are Registered Trademarks of ProSoft Technology Inc All other brand or product names are or may be trademarks of and are used to identify products and services of their respective owners ProSoft Technology Product Documentation In an effort to conserve paper ProSoft Technology no longer includes printed manuals with our product shipments User Manuals Datasheets Sample Ladder Files and Configuration Files are may be downloaded from our web site www prosoft technology com Important Safety Information The following Information and warnings pertaining to the radio module must be heeded WARNING EXPLOSION HAZARD DO NOT REPLACE ANTENNAS UNLESS POWER H
14. ULATION CONSULT SAFETY CODE 6 OBTAINABLE FROM HEALTH CANADA Important User Information Important Power must be provided from a limited power source Because of the variety of uses for the products described in this publication those responsible for the application and use of these products must satisfy themselves that all necessary steps have been taken to assure that each application and use meets all performance and safety requirements including any applicable laws regulations codes and standards In no event will ProSoft Technology be responsible or liable for indirect or consequential damage resulting from the use or application of these products Any illustrations charts sample programs and layout examples shown in this publication are intended solely for purposes of example Since there are many variables and requirements associated with any particular installation ProSoft Technology does not assume responsibility or liability to include intellectual property liability for actual use based upon the examples shown in this publication Allen Bradley publication SGI 1 1 Safety Guidelines for the Application Installation and Maintenance of Solid State Control available from your local Rockwell Automation office describes some important differences between solid state equipment and electromechanical devices that should be taken into consideration when applying products such as those described in this publication Throughout th
15. ature The Whitelist is a security feature built into the sample controller program It allows you to authorize up to five phone numbers to have access to the controller via text message commands The Whitelist is disabled by default When enabled it filters out text message commands received from any phone number that is not on the Whitelist For more information see Whitelist page 30 Implement Password Protection If you need a higher level of security you can add logic to the sample program that checks any incoming text message command for a password This feature is not built in Restrict Access to Output Control The OUTPUTx ON OFF command is a powerful feature that allows users to energize or de energize digital outputs on the controller via text message commands If your application requires higher security you can delete this feature from the sample program If you choose to leave it in you can use the Whitelist feature to restrict its use to authorized persons only ProSoft Technology Inc Page 35 of 45 August 23 2012 Security Tips ILX800 SMSG e Micro800 Platform User Manual for GSM Networks Page 36 of 45 ProSoft Technology Inc August 23 2012 ILX800 SMSG e Micro800 Platform Diagnostics and Troubleshooting for GSM Networks User Manual 5 Diagnostics and Troubleshooting In This Chapter LED Status Indicator a ororvrnrnrnrnrnrnrnrnrnrnrnrnrnrnrnrnrnrnrnrnrnrnrnrnnnvnsnsnsnsnn 37 Troub
16. bility in other environments due to conducted as well as radiated disturbance This equipment is supplied as open type equipment It must be mounted within an enclosure that is suitably designed for those specific environmental conditions that will be present and appropriately designed to prevent personal injury resulting from accessibility to live parts The interior of the enclosure must be accessible only by the use of a tool Subsequent sections of this publication may contain additional information regarding specific enclosure type ratings that are required to comply with certain product safety certifications See NEMA Standards publication 250 and IEC publication 60529 as applicable for explanations of the degrees of protection provided by different types of enclosure Also see the appropriate sections in this publication as well as the Allen Bradley publication 1770 4 1 Industrial Automation Wiring and Grounding Guidelines for additional installation requirements pertaining to this equipment Caution Preventing Electrostatic Discharge This equipment is sensitive to electrostatic discharge which can cause internal damage and affect normal operation Follow these guidelines when you handle this equipment Touch a grounded object to discharge potential static Wear an approved grounding wriststrap Do not touch connectors or pins on component boards Do not touch circuit components inside the equipment If available use a
17. ccceeeeeceeceeeeeeeeeeaeeeeeeeeeeeesaeeeeeeseneeess 33 4 Security Tips 35 4 1 Enable the Whitelist Feature A 35 4 2 Implement Password Protection cccccceceeseeeeeeeeeeeeeeseeeeeeeseeeeeeeeeneeeeeeeeeeeeeeeeeaees 35 4 3 Restrict Access to Output Control 35 ProSoft Technology Inc Page 5 of 45 August 23 2012 Contents ILX800 SMSG amp Micro800 Platform User Manual for GSM Networks 5 Diagnostics and Troubleshooting 37 5 1 LED Status Indicator uuasronnnnnnnnrononnvnnnnnvnnnnrnnnavonnnnnnnnnnnsnnrenennennnnnennnresenaeesennennnnsen 37 5 2 Troubleshooting ET 38 5 3 Status RTE 39 6 Reference 41 6 1 Radio Specifications rrrannrrnnnnrnnonvrnnnr vnr nrnnnnnnnnenrennrnnnnnrnnennnnnenresnnrneennrnssnnnnrennenn 41 6 2 Hardware Specifications vnr nrnnnnnnnnnnrnnnnrnennnnnnrnnenrrrresnnnnnsnnnnnennen 41 7 Support Service and Warranty 43 7 1 Contacting Technical Support sessseesseesseesseessrtssntetnnstnnstnnstnnssrnsnnnnnssrnssnnssrnnnns 43 72 Warranty Information espiare aeaaeae e araea E aar AERA E 44 Index 45 Page 6 of 45 ProSoft Technology Inc August 23 2012 ILX800 SMSG e Micro800 Platform Start Here for GSM Networks User Manual 1 Start Here In This Chapter EE 7 Package Contents rrrrrnrnnnnrnnnnrnnnvrnnnnvnnnnrnnsnrnnnvrnnsnrnsnrrensnrnesnrenenenssnsnne 8 System PHeouirements 9 Installing the SIM Can 9 Installing the ILX800 SMSG Plug in Module 10 Installing a
18. er should be powered off when the plug in module is installed on or removed from the controller 1 Orient the plug in module so the antenna end is toward the front of the controller 2 Align the plug in module s three tabs with the three notches in the module slot on the controller Snap the plug in module into place ProSoft Technology Inc Page 11 of 45 August 23 2012 Start Here ILX800 SMSG e Micro800 Platform User Manual for GSM Networks 1 6 Installing an Antenna An external antenna is required to connect the plug in module to the cellular network The antenna should be rated for the following frequency bands 890 960 MHz 1710 1880 MHz To install the antenna screw it into the antenna connector on the plug in module Page 12 of 45 ProSoft Technology Inc August 23 2012 ILX800 SMSG amp Micro800 Platform Setting Up the Controller Program for GSM Networks User Manual 2 Setting Up the Controller Program In This Chapter The Sample Controller Program 13 Importing the Sample Program 14 Configuring the Module s Slot Number 17 Entering a Test Phone Number 18 Connecting the Controller to Your BC 19 Downloading the Sample Program ccccsceeeseeeeeeeeeeeeeeneeeeneeseneeteaes 20 Going Online with the Controller ene 23 Customizing Your Controller Program Loge 25 ProSoft Technology Inc Page 13 of 45 August 23 2012 Se
19. esponse text message to the originator of the text message command There are two types of text message commands ProSoft Technology Inc Page 31 of 45 August 23 2012 Using Your ILX800 SMSG Plug in Module User Manual ILX800 SMSG e Micro800 Platform for GSM Networks 3 3 1 Status Information Requests Request Action by ILX800 SMSG Response from ILX800 SMSG PLCSTATUS Returns text message with Controller mode controller status data Status of outputs and inputs NETSTATUS Returns text message with cellular Signal strength in dBm network status data Network status Number of carrier connection failures MSGSTATUS Returns text message with Number of received messages message counts Number of sent messages Number of failed sent messages Number of messages received from phone numbers not on the Whitelist UPTIME Returns text message with the Controller UP Time NOTE controller s running time Controller clock resets after 20 days xxdxxhxxmxxsxxx Important The controller s clock resets after approximately 20 days OUTPUTx Returns text message with the OUTPUTx ON status of controller output x OUTPUTx OFF WHITELIST Returns text message indicating WHITELIST ON whether the Whitelist is enabled or WHITELIST OFF disabled Page 32 of 45 ProSoft Technology Inc August 23 2012 ILX800 SMSG e Micro800 Platform Using Your ILX800 SMSG Plug in Module for GSM Networks User Manual
20. g 49 RegisteredHome 50 NotRegisteredNoSearching 51 RegistrationDenied 52 Unknown 53 RegisteredRoaming STATUS signalStrength Strength dBm of received signals from the cell tower STATUS SIMGCardStatus 1 The SIM card is readable 0 The SIM card is not readable STATUS_SMSRecvCount SMS receive message count ProSoft Technology Inc August 23 2012 Page 39 of 45 Diagnostics and Troubleshooting ILX800 SMSG amp Micro800 Platform User Manual for GSM Networks Variable Description STATUS SMSSendCount SMS transmit message count STATUS_SMSSendFailCount Number of failed SMS transmit attempts STATUS WLFiltCount Number of messages received from phone numbers not on the Whitelist Note Many of these status values can also be retrieved by a cell phone via a text message command to the controller See Text Message Commands page 31 Page 40 of 45 ProSoft Technology Inc August 23 2012 ILX800 SMSG e Micro800 Platform for GSM Networks Reference User Manual 6 Reference 6 1 Radio Specifications Cellular Technology GSM SMS Text Messaging Bands 850 MHz 900 MHz 1800 MHz 1900 MHz RF Power 2W at 850 900 MHz 1W at 1800 1900 MHz RF Sensitivity 107 dBm at 850 900 MHz 106 dBm at 1800 1900 MHz 6 2 Hardware Specifications Enclosure Micro830 Plug in Module Antenna Ports 1 RP SMA connector Weight Less than 1 Ib less
21. gram for example My Documents or Desktop Select the appropriate file and click OPEN Page 16 of 45 ProSoft Technology Inc August 23 2012 ILX800 SMSG e Micro800 Platform for GSM Networks Setting Up the Controller Program User Manual 8 Click IMPORT The program function blocks and local variables will now appear in the Project Organizer pane Project Organizer Name Project Eu Micro830 a Dy Programs i Local Variables i Global variables wt DataTypes H Dy Function Blocks PSFT SMS SEND H 1 Local Variables PSFT_SMS_CONFIG WW Local Variables jl s9 PSFT_SMS_RECY Local Variables PSFT_SMS_DIAG 1 Local Variables ProSoft Technology Inc August 23 2012 Page 17 of 45 Setting Up the Controller Program ILX800 SMSG amp Micro800 Platform User Manual for GSM Networks 2 3 Configuring the Module s Slot Number Note The ILX800 SMSG plug in module cannot be configured in the Controller Properties However it is essential to correctly configure the module s slot number in the controller program 1 Double click the LOCAL VARIABLES icon for the PSFT ILX800 SMSG program in the Project Organizer pane 2 Click the header of the NAME column to sort the variables alphabetically 3 Find the variable CONFIG_SLOTID in the Name column 7 pt vpti GE EEN eremm 4 Enter the correct slot number in the Initial Value column Note The slot closest to the powe
22. heses or hyphens If CCW is online with the controller in debug mode enter the phone numbers in the Logical Value column 5 To enter an international number use followed by the country code and number KS f aterbue O pel bet r r r 1 CONFIG whiteList STRING gt 1 5 8 Read Write 16 CONFIG whiteList 1 STRING 1234567891 Read Write 16 CONFIG whiteList 2 STRING 8612345678901 Read Write 16 EET sens RN NN men KE CONFIG whiteList 4 STRING Read Write 16 CONFIG whiteList 5 STRING Read Write 16 Example To enter a phone number in China enter followed by China s country code which is 86 Then enter the phone number we will use 12345678901 for this example The entry would look like this 8612345678901 6 Save build and download the program to the controller Page 30 of 45 ProSoft Technology Inc August 23 2012 ILX800 SMSG e Micro800 Platform Using Your ILX800 SMSG Plug in Module for GSM Networks User Manual 3 3 Text Message Commands u AT amp T 3G 2 18 PM Messages 1 608 692 9 Edit Call Add to Contacts Jun 19 2012 2 11 PM ProSoft SMS Plug in Module is ready Signal strength dBm 93 Network status RegisteredHome Connection failures 2 7 Me SE AE Le The sample controller program for the ILX800 SMSG plug in module recognizes the text message commands listed in the following two tables When the module receives a text message command it sends a r
23. is publication notes may be used to make you aware of safety considerations The following annotations and their accompanying statements help you to identify a potential hazard avoid a potential hazard and recognize the consequences of a potential hazard Warning Identifies information about practices or circumstances that can cause an explosion in a hazardous environment which may lead to personal injury or death property damage or economic loss Caution Identifies information about practices or circumstances that can lead to personal injury or death property damage or economic loss Important Identifies information that is critical for successful application and understanding of the product Burn Hazard Labels may be located on or inside the equipment for example drive or motor to alert people that surfaces may be dangerous temperatures Shock Hazard Labels may be located on or inside the equipment for example drive or motor to alert people that dangerous voltage may be present Environment and Enclosure Caution This equipment is intended for use in a Pollution Degree 2 industrial environment in overvoltage Category II applications as defined in IEC publication 60664 1 at altitudes up to 2000 meters without derating This equipment is considered Group 1 Class A industrial equipment according to IEC CISPR Publication 11 Without appropriate precautions there may be potential difficulties ensuring electromagnetic compati
24. leshooting WEN 37 ZG Status Data 38 5 1 LED Status Indicator Color Status Indication Green OFF The plug in module is not receiving adequate power or is not securely plugged into the slot BLINKING RAPIDLY The plug in module is powered on and is once per second attempting to establish a connection with the service carrier BLINKING SLOWLY The plug in module is powered on and once every two communicating on the cellular network seconds ProSoft Technology Inc Page 37 of 45 August 23 2012 Diagnostics and Troubleshooting ILX800 SMSG amp Micro800 Platform User Manual for GSM Networks 5 2 Troubleshooting Use the following troubleshooting steps if you encounter problems when the plug in module is powered up If these steps do not resolve your problem please contact ProSoft Technology Technical Support Problem Description Steps to take The green LED is OFF This indicates that the module is not powered on Verify that The module is securely connected in its slot The controller is powered on The green LED This indicates that the module has not yet established a connection with continues to blink the service carrier rapidly Wait a couple of minutes to see if a connection is established Verify that a valid SIM card is properly installed in the module s SIM card holder Verify that an external antenna is securely connected to the antenna connector on the module The green
25. lish Latin America location in Puebla Mexico Tel 52 222 3 99 6565 E mail soporte prosoft technology com Languages spoken include Spanish Brasil location in Sao Paulo Tel 55 11 5083 3776 E mail brasil prosoft technology com Languages spoken include Portuguese English Warranty Information Complete details regarding ProSoft Technology s TERMS AND CONDITIONS OF SALE WARRANTY SUPPORT SERVICE AND RETURN MATERIAL AUTHORIZATION INSTRUCTIONS can be found at www prosoft technology warranty Documentation is subject to change without notice Page 44 of 45 ProSoft Technology Inc August 23 2012 ILX800 SMSG amp Micro800 Platform Index for GSM Networks User Manual Restrict Access to Output Control 35 Return Material Authorization RMA Policies and Conditions 44 Index s Security Tips 35 A Sending Out an Event Triggered Text Message 26 28 Agency Approvals and Certifications 4 Setting Up the Controller Program 13 Setting Up the Phone Number Lists 28 C Start Here 7 Commands to Execute Some Action 33 Se d Se R ER Configuring the Module s Slot Number 18 S a e Ce Ge Neneh 43 Connecting the Controller to Your PC 20 een R ee ee y Contacting Technical Support 43 PIERRE Customizing Your Controller Program Logic 26 28 T D Text Message Commande 29 30 31 40 Diagnostics and Troubleshooting 37 dn a le r E Frogram 14 16 Downloading the Sample Program 21 ESCHER E U
26. message manually by checking the box in the Logical Value column for the DATA_customSMS Trigger variable 4 You can also add logic to your project that automatically sets DATA_customSMSTrigger HIGH or TRUE when some event occurs Duplicate this program section as needed to create as many event triggered text messages as your application requires Page 26 of 45 ProSoft Technology Inc August 23 2012 ILX800 SMSG e Micro800 Platform Using Your ILX800 SMSG Plug in Module for GSM Networks User Manual 3 Using Your ILX800 SMSG Plug in Module In This Chapter Verifying Wireless Communication rrnvrnnnnrnnnvrnnnnrnnnrrnnnvrnnnrrnnsnrnnnnnne 27 Setting Up the Phone Number Uleies 27 Text Message Commandes 31 3 1 Verifying Wireless Communication When the plug in module is powered on the green LED on the module will blink about once per second The plug in module will automatically establish a connection with the service carrier When communication has been established the LED will blink much more slowly about once every two seconds ProSoft Technology Inc Page 27 of 45 August 23 2012 Using Your ILX800 SMSG Plug in Module ILX800 SMSG e Micro800 Platform User Manual for GSM Networks 3 2 Setting Up the Phone Number Lists The sample controller program for the ILX800 SMSG plug in module has two phone number lists 3 2 1 Receiver List The Receiver List can hold up to five phone numbers The
27. n Antenna A 11 To get the most benefit from this User Manual you should have the following skills Rockwell Automation Connected Components Workbench software launch the program configure program logic and transfer the program to the processor Microsoft Windows install and launch programs execute menu commands navigate dialog boxes and enter data Hardware installation and wiring safely connect the Micro830 and plug in module to a power source A You must be able to complete the application without exposing personnel or equipment to unsafe or inappropriate working conditions ProSoft Technology Inc Page 7 of 45 August 23 2012 Start Here ILX800 SMSG e Micro800 Platform User Manual for GSM Networks 1 1 Overview The ProSoft Technology SMS plug in module adds bi directional SMS text messaging capability to the Allen Bradley Micro830 family of controllers Operating over the GSM cellular network the plug in module provides a cost effective and secure method for OEMs to add remote communication features using cellular phones as the user interface to their machines and systems Applications include remote alarming environmental energy monitoring data collection machine condition inventory status alerts and production counts The SMS plug in is activated by installing a standard GSM Voice SMS SIM card contact your local GSM cellular provider for plan options and costs After activation it will associate to
28. n Module for GSM Networks User Manual To enter phone numbers in the Receiver List 1 Double click the LOCAL VARIABLES icon for the PSFT ILX800 SMSG program in the Project Organizer pane 2 Click the header of the NAME column to sort the variables alphabetically 3 Find the variable CONFIG_receiverList in the Name column Click the sign next to CONFIG_receiverList to expand it 4 Enter up to five phone numbers in the nitial Value column Do not enter any spaces parentheses or hyphens If CCW is online with the controller in debug mode enter the phone numbers in the Logical Value column vata type Dimension Atos SS f attribute tt of vg gf of vg CONFIG receiverList STRING 1 5 A Read Write 16 CONFIG_receiverList 1 STRING 1234567891 Read Write 16 CONFIG receiverList 2 STRING 8612345678901 Read Write 16 conricrecevensts 0 IESELEN CONFIG_receiverList 4 STRING Read Write 16 CONFIG receiverList 5 STRING Read Write 16 5 To enter an international number use followed by the country code and number Example To enter a phone number in China enter followed by China s country code which is 86 Then enter the phone number we will use 12345678901 for this example The entry would look like this 8612345678901 6 Save build and download the program to the controller Note You can also add a phone number to the Receiver List from a cell phone via a text message command See Text
29. ntroller Program for GSM Networks User Manual 2 2 Importing the Sample Program 1 Open Connected Components Workbench CCW 2 If you are creating a new CCW project follow the next steps If you are importing the sample program into an existing project skip to Step 6 3 Inthe Device Toolbox pane open the Catalog tab by clicking the Device Toolbox Discover Catalog 4 Click the next to the Controllers folder to expand it Find your controller in the list Device Toolbox v I Discover Catalog E yi Controllers qi 2080 LC10 12AWA JI 2080 LC10 12DWD TI 2080 LC10 12QBB JI 2080 LC10 12QWB TI 2080 LC30 10QVB JI 2080 LC30 10QWB JI 2080 LC30 164WB JI 2080 LC30 16QVB ProSoft Technology Inc Page 15 of 45 August 23 2012 Setting Up the Controller Program ILX800 SMSG amp Micro800 Platform User Manual for GSM Networks 5 Click the appropriate controller icon and drag it to the Project Organizer pane A Programs i Global variables DataTypes Ki I Function Blocks 6 Right click the controller icon then select IMPORT gt IMPORT EXCHANGE FILE from the shortcut menu me Open kal sv RE je Build Upload oi Je Import l L Import Exchange File Export X Delete Rename l Properties 7 Inthe Import Export dialog box click BROWSE to navigate to the location on your PC where you saved the sample pro
30. plug in module will send automatic text message updates to all numbers on this list When the controller boots up the plug in module sends out a user customizable greeting text message to all receivers The default greeting text message is shown below Tuesday June 19 P Text from 1 608 692 9401 ProSoft SMS Plug in Module is b ready When the controller detects a rising or falling edge on controller digital input channels 0 or 1 the plug in module sends out the following user customizable text message to all receivers Alarm detected Input x is ON OFF More digital inputs can be added to the program logic See Customizing Your Controller Program Logic page 26 A user defined text message can be triggered by a user defined event and sent out to all receivers See Sending Out an Event Triggered Text Message page 26 Note The Receiver List determines which phone numbers will receive these automatic text message updates The sample program also allows the plug in module to respond to text message commands from numbers that are not on the Receiver List A response text message is only sent to the phone number from which the text message command was received The Whitelist security feature when enabled can be used to restrict text message command access to authorized phone numbers only Page 28 of 45 ProSoft Technology Inc August 23 2012 ILX800 SMSG e Micro800 Platform Using Your ILX800 SMSG Plug i
31. r supply side of the controller is Slot 1 The next one is Slot 2 etc Page 18 of 45 ProSoft Technology Inc August 23 2012 ILX800 SMSG e Micro800 Platform Setting Up the Controller Program for GSM Networks User Manual 2 4 Entering a Test Phone Number Set up a test phone number in the sample program Once the program has been downloaded the module will send out a greeting text message on boot up to this phone number 1 Double click the LOCAL VARIABLES icon for the PSFT ILX800 SMSG program in the Project Organizer pane 2 Click the header of the NAME column to sort the variables alphabetically 3 Find the variable CONFIG_receiverList in the Name column Click the sign next to CONFIG_receiverList to expand it 4 Enter an area code and phone number in the Initial Value column Do not enter any spaces parentheses or hyphens 7 pt b i F _receiverList STRING v em 5 v 16 CONFIG_receiverList 1 STRING 1234567891 Read Write 16 CONFIG Leer STRING peeta H ET sens OE een i CONFIG SSC STRING Read Write 16 ii CONFIG receiverList 5 STRING Read Write 16 For more information about entering phone numbers in the Receiver List see Receiver List page 28 ProSoft Technology Inc Page 19 of 45 August 23 2012 Setting Up the Controller Program ILX800 SMSG amp Micro800 Platform User Manual for GSM Networks 2 5 Connecting the Controller to Your PC You will need a Type A B USB cable to connect
32. stalling the SIM Card ek 10 1 5 Installing the ILX800 SMSG Plug in Module 11 1 6 Installing an Antenna iesi oaii ia e iia a E i a 12 2 Setting Up the Controller Program 13 2 1 The Sample Controller Program annrnnannnnnnvrnnnnrnnnnnvnnnnrnnnnrnnnnnnnnennenrrrresnnrnnsnnnenrnren 14 2 2 Importing the Sample Program arenanvnnnnrrvnnnvnnnnnvnnnnvvnnnrrennnrnnnnnnnrerresnnrnnsnnnnnsnnenennne 15 2 3 Configuring the Module s Slot Number 18 2 4 Entering a Test Phone Number ernnnnnnovnnnnnnnvnnnnannvnnnnnnnnennsnnnvnnnnnnnnnnsannnnnnnnnnnenne 19 2 5 Connecting the Controller to Your PDC 20 2 6 Downloading the Sample Program ccccccceeseeceeeeeceeeeeeaeseeeeeceeeeeseaeeeeaeseeeeeeaas 21 2 7 Going Online with the Controller cc cccccceceeeeeeeeeeeeeeceeeeeaaeeeeeeeseeeeeseaeeeeeeseeeees 24 2 8 Customizing Your Controller Program Loge 26 2 8 1 Sending Out an Event Triggered Text Message 26 3 Using Your ILX800 SMSG Plug in Module 27 3 1 Verifying Wireless Communication anrrnnnrrnnnnvnnnnnvnnnrrnnnnrnnnnnrnnenrenrrrrennnrnnsnnnnrnnren 27 3 2 Setting Up the Phone Number Uleies 28 3 2 1 Reever E E AE T E A E O A E TA 28 3 2 2 ADE e EE 30 3 3 Text Message Commande rrrnnnvrnnnnvnnrnvvnnnr renn nrnnnnnnnnenrensnrnnennnnnenrenrrrneennrnnnnnnnnennen 31 3 3 1 Status Information Requests c cccecsceeeeeeeceeeeeeeaeeeeeeeceaeeeeeaeedeeeeseeeesaeeseeeseeeeess 32 3 3 2 Commands to Execute Some Action c ccc
33. than 0 45 kg Operating Temp 4 F to 149 F 20 to 65 C Humidity Up to100 RH with no condensation Vibration IEC 60068 2 6 20g 3 axis Shock IEC 60068 2 27 5g 10 Hz to 150 Hz Backplane Power 3 3 VDC at 60 mA max current draw 24 VDC at 60 mA max current draw ProSoft Technology Inc August 23 2012 Page 41 of 45 Reference ILX800 SMSG e Micro800 Platform User Manual for GSM Networks Page 42 of 45 ProSoft Technology Inc August 23 2012 ILX800 SMSG e Micro800 Platform Support Service and Warranty for GSM Networks User Manual 7 Support Service and Warranty In This Chapter Contacting Technical Gupport ee eeceeeeeeeeseeeeeeeeeneeteeeeeaeeseeeteeeeeaes 43 Warranty Information ssvroeronnronnnvnvrnnrvnnrnererevrnnrvnernnnvnvrnerersvnnenersrenennn 44 7 1 Contacting Technical Support ProSoft Technology Inc ProSoft is committed to providing the most efficient and effective support possible Before calling please gather the following information to assist in expediting this process 1 Product Version Number 2 System architecture 3 Network details If the issue is hardware related we will also need information regarding Module configuration and associated ladder files if any Module operation and any unusual behavior Configuration Debug status information LED patterns Details about the serial Ethernet or fieldbus devices interfaced to the module if any akhOND
34. the Micro830 controller to your PC 1 Connect the USB cable s Type A plug to a USB jack on your PC 2 Connect the USB cable s Type B plug to the USB jack on the controller 3 If the driver for the USB connection to the controller is not already installed on your PC Windows will launch the Found New Hardware Wizard Follow the prompts to install the driver Note RSLinx will automatically configure and start the AB VBP x driver for the USB connection Page 20 of 45 ProSoft Technology Inc August 23 2012 ILX800 SMSG e Micro800 Platform Setting Up the Controller Program for GSM Networks User Manual 2 6 Downloading the Sample Program Note The mode switch on the front of the controller must be in the REM or PRG position i 1 Click the ial icon to save the project 2 Right click the controller icon in the Project Organizer pane and select BUILD from the shortcut menu d Micro830 E KE Pi af Open Build Upload Au m LC Import D Export gt m LO X Delete m LO Rename E D c Properties 3 CCW will build the program This process may take a few minutes ProSoft Technology Inc Page 21 of 45 August 23 2012 Setting Up the Controller Program ILX800 SMSG e Micro800 Platform User Manual for GSM Networks 4 Verify the build status in the Output window When the program builds successfully with no errors right click the controller icon and select DOWN
35. tting Up the Controller Program ILX800 SMSG amp Micro800 Platform User Manual for GSM Networks 2 1 The Sample Controller Program The sample controller program contains the program logic function blocks and variables required to configure and operate the ILX800 SMSG plug in module It is provided in three languages Structured Text ST Ladder Diagram LD and Function Block Diagram FBD Download the appropriate 7z import file from www prosoft technology com Save it to a convenient location in your PC such as Desktop or My Documents File Name Language Controller memory usage KB ILX800SMSG vi 01 ST 7z Structured Text 38 ILX800SMSG vi 01 LD 7z Ladder Diagram 49 ILX800SMSG vi 01 FBD 7z Function Block Diagram 52 For your reference here is the total program memory capacity of each controller in the Micro830 family Total Memory Capacity of Micro 830 Controllers KB 10 point 56 16 point 56 24 point 140 48 point 140 Note The sample controller program is intended to demonstrate the ILX800 SMSG plug in module s full range of capabilities as a guide for creating your own application The program features are provided in a modular format enabling the selection of features that will provide the optimum balance of usability performance and memory usage for your application Page 14 of 45 ProSoft Technology Inc August 23 2012 ILX800 SMSG e Micro800 Platform Setting Up the Co
36. variables with the STATUS prefix Hint Click the header of the NAME column to sort the variable list alphabetically This will group all the STATUS variables together For these status values to be visible CCW must be online with the processor and the Debug function in CCW must be running See Going Online with the Controller page 24 Project Organizer e I xX Name Projecti Micro830 E G I Programs PSFT ILX800 5MS5G i Local Variables i Global variables me DataTypes E Ki Function Blocks PSFT ILX800 SMSG VAR Name a Logical alue STATUS_errCount 0 N A UINT STATUS majorRev 1 N A INT STATUS minorRev 1 N A INT STATUS netConnFailedRetries 8 N A DINT STATUS networkStatus 49 N A USINT STATUS signalStrength 73 N A INT STATUS SIMCardStatus 1 N A USINT STATUS SMSRecvCount 4 N A DINT STATUS SMSSendCount 8 N A DINT STATUS SMSSendFailCount 0 N A DINT STATUS WLFiltCount 0 N A DINT Variable Description STATUS errCount Number of failed messages sent from the controller to the plug in module over the backplane STATUS majorRev Major revision number of the plug in module s firmware STATUS minorRev Minor revision number of the plug in module s firmware STATUS netConnFailedRetries Number of carrier connection failures STATUS networkStatus Status of the connection between the plug in module and the service carrier 48 NotRegisteredSearchin
37. xt Plug in Module for GSM module Networks 1 3 System Requirements The ILX800 SMSG plug in module requires the following minimum hardware and software components Rockwell Automation Micro830 controller with compatible power supply Rockwell Automation Connected Components Workbench programming software version 1 01 or higher Rockwell Automation RSLinx communication software version 2 57 or higher ILX800 SMSG sample controller program download at www prosoft technology com ProSoft Technology Inc Page 9 of 45 August 23 2012 Start Here ILX800 SMSG e Micro800 Platform User Manual for GSM Networks 1 4 Installing the SIM Card 1 Turn the ILX800 SMSG plug in module over so that the circuit board is facing up 2 Orient the plug in module so that the backplane connector is toward the top Locate the SIM card holder in the middle of the board 3 Unlock the SIM card holder s clip by sliding it to the right LOCKED gt UNLOCKED Slide latch to the right to unlock 4 Lift the card holder clip and place the SIM card in the card holder matching the rounded corner of the card with that of the card holder 5 Lower the card holder clip and slide it to the left until it locks into place Page 10 of 45 ProSoft Technology Inc August 23 2012 ILX800 SMSG e Micro800 Platform Start Here for GSM Networks User Manual 1 5 Installing the ILX800 SMSG Plug in Module Important The Micro830 controll
Download Pdf Manuals
Related Search