background image

instruction manual

Software

WebLinx

Administrator Program 

(Version 1.1 or higher)

Summary of Contents for WebLinx

Page 1: ...instruction manual Software WebLinx Administrator Program Version 1 1 or higher ...

Page 2: ...X SOFTWARE including without limitation any if any service packs or hot fixes provided to Licensee after the expiration of the ninety 90 day Limited Warranty period are not covered by any warranty or condition express implied or statutory LICENSEE REMEDIES AMX s entire liability and Licensee s exclusive remedy shall be repair or replacement of the AMX Software that does not meet AMX s Limited Warr...

Page 3: ...SOHO Considerations NIC requirements 7 Getting Connected 9 Installing NICs and Assigning IP Addresses 9 Windows 98 and dual NIC configuration 9 Windows NT Server Workstation and single NIC configuration 10 Windows 2000 Server Workstation NIC configuration 12 WebLinx Configuration Log 12 WebLinx Pre Installation Requirements 12 Target PC Name and IP address 13 Getting AXB NET IP configuration infor...

Page 4: ...Linx Server PC 23 Sending touch panel TPD files 23 Sending Axcess NetLinx AXS program files 24 Sending Infrared Library IRL files 24 Checking the file sending status 24 Diagnostics 25 Generating equipment listings by version 25 Generating equipment listings by device number 25 Generating compare device listings 25 Sending channel commands 26 Generating device status listings 26 Sending string comm...

Page 5: ...Table of Contents iii WebLinx Administrator Program Troubleshooting 43 ...

Page 6: ...iv WebLinx Administrator Program Table of Contents ...

Page 7: ...l Controllers you can use the Administrator program to update remote system programs touch panel files and create Axcess NetLinx program libraries or backups to ensure remote systems are operating at optimal performance levels Features Secured communications and maintenance of residential commercial and industrial applications from anywhere in the world via the Internet LAN or WAN topologies Compa...

Page 8: ...erver using IE and controlling an Axcess Central Controller system via the Internet through an AXB NET FIG 1 Sample WebLinx and Axcess Central Controller application AXB NET Ethernet Gateway Communication Hub WebLinx Server and Web Server Remote Communication Control Configuration PC running Internet Explorer WebLinx controlled equipment ...

Page 9: ...perating systems inside firewall protected LAN WAN topologies Dual NICs for Windows 98 operating systems Small Office Home Office Static fixed or DHCP IP address supplied by Internet Service Provider Operating systems and Web servers The WebLinx Administrator program is compatible with any one of these operating systems Microsoft Windows 98 with PWS or equivalent Microsoft Windows 2000 PRO with Wi...

Page 10: ...lick Show Users find and add IUSR_machineName changing Type of Access to Full Control Then select OK 6 From the Directory Permissions dialog ensure that Replace Permissions on Subdirectories is checked and select OK 7 If you have already attempted to run WebLinx Administrator prior to this you may have to reboot to ensure permissions have been updated fully Axcess hardware For the WebLinx Server t...

Page 11: ...yone users entering or leaving a building network maintaining a record of each occurrence That s how firewalls protect networks and user communities A firewall can be a dedicated PC located between a network the network to be guarded and Internet ports addresses In some businesses the firewall resides between two or more internal networks to prevent access to sensitive data All data passing betwee...

Page 12: ...Product Information 6 WebLinx Administrator Program ...

Page 13: ...e www microsoft com Once the OS is selected refer to the table above to see which Web Server program and NIC configuration to use Using a single or dual NIC configuration allows designing a secure network that cannot be easily accessed by hackers Internet Browser Program Microsoft IE 4 0 or higher is used because it offers more flexibility for Dynamic HTML application Thus it is the required Inter...

Page 14: ...orld via the first DHCP or static IP address and the WebLinx Server uses the second IP address to communicate internally with the Web server program Whether using one or two NICs the design rule is there must be two IP addresses one DHCP static and one non resolvable to create a secure network and control configuration for the WebLinx system If the described two IP address configuration is not use...

Page 15: ... IP address must comply with RFC 1918 Class A B or C specifications as described earlier in this manual to create a secure network 1 Locate and single click the Network Neighborhood icon on your desktop Then right mouse click and choose Properties to open the Network dialog box 2 Click the Configuration tab default to open the list of network components Then double click TCP IP Protocol for NIC 1 ...

Page 16: ...ectly At the MS DOS prompt enter PING IP address After a brief moment you should see a reply sometimes called pong listing the IP address and reply time The IP address is probably invalid if you don t get a reply message You should check all the addresses you used for the Local IP Private IP AXB NET and Gateway using the Ping command Also check Internet Explorer for connectivity capabilities Windo...

Page 17: ...main name in the Domain field Then enter the DNS address supplied by your ISP 8 Close all open dialog boxes and return to the desktop Then reboot the PC to save the PC configuration changes to the operating system When the boot up is complete and the desktop opens verify the new IP addresses are correct as described in these steps You should record all the IP addresses in the WebLinx Configuration...

Page 18: ...bnet Mask and Gateway using the Ping command The PING command only works within the same LAN or WAN system Windows 2000 Server Workstation NIC configuration If using Windows 2000 refer to the Windows NT Server Workstation and single NIC configuration section on page 10 WebLinx Configuration Log Enter the Web Server WebLinx Server PC NIC and AXB NET device information in the configuration log see t...

Page 19: ...t of the AXB NET device and to a serial port on your PC 2 Launch AxcessX NetLinx Studio and set the communication port and speed to enable communication between the PC and AXB NET device 3 Open the Terminal Emulator mode window Enter ECHO ON and press Enter to activate the echo command to see all input and output on the window 4 Enter NET INFO and press Enter to display the IP address information ...

Page 20: ... to indicate which one is active Select Server sets the active WebLinx Server Links sets the links to Axcess NetLinx Central Controller systems Preferences Administrator account only creates and modifies user accounts and enables disables popup messages The Preferences button only appears on the main page if you are logged into the program as an administrator Administration uploads downloads touch...

Page 21: ...x Central Controller 1 Click Server Links on the main page to open the links page Then click New Link to open the Link Information dialog box 2 Choose AXB NET default or NetLinx in the Link Type drop down menu 3 Enter the system s name in the Logical Link Name field The name you enter should help you quickly identify the system This name is not used by the Web Server or WebLinx Server so you are f...

Page 22: ...right mouse button to access menu options to open the About WebLinx page launch WebLinx Administrator and Shutdown the Server Shutdown 11 A green WebLinx Server icon should start blinking in the desktop tray as shown in FIG 4 A blinking green icon means the WebLinx Server is communicating with the AXB NET Central Controller system If the icon is red there is a mismatch between the Server Settings ...

Page 23: ...m Refer to Administering user accounts subsection to add a password to the administrator account for protection 3 Click Log Out on the main page to log out of the program Logging In Out Remote PC 1 Launch IE and enter PC Name or Web Server IP address WebLinx to open the Administrator program 2 Click User Login and enter your name and password in the User Name field After you perform the required o...

Page 24: ...stem s AXB NET NetLinx device in the Host Address field 8 Enter the programmed device number assigned to the WebLinx Server The number you enter must match the WLSERVER 1 255 value for Axcess or 1 32 000 for NetLinx used in the Axcess program installed in the Central Controller This number identifies where the WebLinx Server resides on the AXlink bus and where to send receive control and communica...

Page 25: ... in the Link Type drop down menu 4 Enter the name of the target system in the Logical Link Name field 5 Enter the AXB NET or NetLinx device s non resolvable IP address in the Host Address field 6 Enter the programmed device number assigned to the WebLinx Server The number you enter must match the WLSERVER 1 255 value for Axcess or 1 32 000 for NetLinx used in the Axcess program installed in the Ce...

Page 26: ...he Server Links page Furthermore each time you make changes to the WebLinx Server information you should use the Reset Server operation to synchronize the WebLinx server with up to date information You will see a Server is Being Reset message appear until the operation is complete Shutting down the WebLinx Server The Shutdown WebLinx button shuts down the WebLinx Server and disables all communicat...

Page 27: ...eld Then enter the user s password in the Password and Verify Password fields Click Save to store the new account information Repeat this step to add additional accounts Otherwise go to step 7 5 Click the target account you want to modify in the Current Users drop down menu Then click Modify User to open the User Administrator page Modify the username and or password as required Enter the new pass...

Page 28: ...files to the WebLinx Server PC You can upload touch panel TPD Axcess AXS and Infrared Library IRL files to the WebLinx Server s PC When you upload files to the PC they are placed in the inetpub wwwroot WebLinx admin filecache folder Then you can send these files to specific Axcess equipment or to the Central Controller 1 Click Administration on the main page 2 Click Upload File to open the Upload ...

Page 29: ...ck to open the Open With dialog box 6 Click the Open With option and choose Axcess for Axcess files IRLIB for Infrared Library or TPDesign for touch panel files Then click OK to set the file associations for IE and return to your desktop 7 Launch IE and repeat steps 1 4 to download the file If a File Download dialog box opens click the Always use this program to open this type of file to set and s...

Page 30: ...age opens to show the operation s progress If you want to send additional files repeat steps 3 and 4 If not click Back to Main Sending Infrared Library IRL files You can send IRL files to specific devices connected to a linked Central Controller However before sending IRL files make sure you have a backup copy of the existing file 1 Click Administration on the main page 2 Click Send IRL File to op...

Page 31: ...mes The total time required to poll and populate the display field varies depending on Internet traffic and communication speeds 1 Click Diagnostics on the main page 2 Click Version to open the Version field and after a brief moment display a list of the Axcess devices and their assigned device numbers You can use the scroll bar to review the list Then click Back to Main Generating equipment listi...

Page 32: ...get devices and their channels are working properly Then click Back to Main Generating device status listings The Device Status option polls the target device connected to the linked system and generates an active ON channel listing 1 Click Diagnostics on the main page 2 Click Device Status to open the Device Status page Enter a device number in the Target Device field and click Send to poll the t...

Page 33: ...aneous commands The Misc Commands option is a group of common system commands The commands include Memory Date Time Have Control Have Program and Slot 1 Click Diagnostics on the main page 2 Click Misc Commands to open the Misc Commands page Then read these sub steps and choose the command you want to send to the linked Central Controller Then go to step 3 a Click Memory to display the available by...

Page 34: ...ed after all Axcess network wiring connections are checked and the problem cannot be resolved 1 Click Diagnostics on the main page 2 Click System Reset to reset the linked Central Controller When the reset is complete click Back to Main About Option You can open the About page to see the Administrator program s version build number and release date 1 Click About on the main page 2 Click anywhere o...

Page 35: ...eral internal objects required by the WebLinx Server to communicate with the AXB NET Central Controller system WLControl inc include file contains the control commands provided with the WebLinx Server program to control equipment These include files must be included in every ASP script for communications and control of the Central Controller Refer to the Sample ASP Axcess Programs section for use ...

Page 36: ...em Device Port combination within the WebLinx Server Syntax WLDecWordLevel WLHost WLPort plpdev plpport plpsys plplevel wLevelDec Arguments WLHost WebLinx Server address string WLPort WebLinx Server control port 10501 plpdev Device number on the control network 16 bit integer plpport Port on the device 16 bit integer plpsys System ID of the control network 16 bit integer plplevel Level on the Devi...

Page 37: ...ly controls out put channel states Syntax ChannelState WLGetOutputChannelState WLHost WLPort plpdev plpport plpsys plpchannel Arguments WLHost WebLinx Server address string WLPort WebLinx Server control port 10501 plpdev Device number on the control network 16 bit integer plpport Port on the device 16 bit integer plpsys System ID of the control network 16 bit integer plpchannel Channel Number 16 b...

Page 38: ...D of the control network 16 bit integer plplevel Level on the device 16 bit integer WLevelInc Value to increase level value by 8 bit integer WLOff Performs an output channel off state change in the speci fied System Device Port within the WebLinx Server The channel specified is the channel whose state changes Syntax WLOff WLHost WLPort plpdev plpport plpsys plpchannel Arguments WLHost WebLinx Serv...

Page 39: ...ations 32 bit integer WLPush Performs an input channel on state change in the specified System Device Port within the WebLinx Server The channel specified is the channel whose state changes Syntax WLPush WLHost WLPort plpdev plpport plpsys plpchannel Arguments WLHost WebLinx Server address string WLPort WebLinx Server control port 10501 plpdev Device number on the control network 16 bit integer pl...

Page 40: ...destination for the data string cannot be specified and the destination arguments are ignored This is because in a control network a device can only send data strings to the Central Controller Syntax WLSendString WLHost WLPort plpdev plpport plpsys plpDstsys plpDstdev plpDstport str Arguments WLHost WebLinx Server address string WLPort WebLinx Server control port 10501 plpdev Device number on the ...

Page 41: ...t 10501 plpdev Device number on the control network 16 bit integer plpport Port on the device 16 bit integer plpsys System ID of the control network 16 bit integer str Command string sent to the device AppendVar varName value Appends the given value to the given named variable Syntax WLDeviceCommand WLHost WLPort plpdev plpport plpsys AppendVar myVar MoreData Arguments WLHost WebLinx Server addres...

Page 42: ...g WLPort WebLinx Server control port 10501 plpdev Device number on the control network 16 bit integer plpport Port on the device 16 bit integer plpsys System ID of the control network 16 bit integer GetCount Returns the number of storage slots used Return value VAL Returns the count GetStrAt idx Retrieves the value stored at the specified 0 based index and adds a NULL termination byte Syntax VAL W...

Page 43: ...n named variable MyVar Name of variable Return value VAL Returns length in characters of value stored in given names variable GetVarSeg varName startIdx numChars Returns a substring of the value stored in the given named variable starting at the given index and including the given number of characters Syntax VAL WLDeviceCommand WLHost WLPort plpdev plpport plpsys GetVarSeg myVar string char charac...

Page 44: ... wLevelInc WLDecWordLevel lLevel wLevelDec wValue WLGetWordLevel lLevel WLSendCommand lDestDevice lDestPort lDestSystem bstrCommand WLSendString lDestSystem lDestDevice lDestPort bstrString WLDeviceCommand bstrCommand WLRun bstrFileName bstrStartInPath bstrParams lShowCmd As an example AMX WLOn 10 will turn on WebLinx output channel 10 Cur rently any return values from WLDeviceCommand cannot be re...

Page 45: ...the IR digit pulses CTON sets the pulse length for each digit and CTOF sets the time between each digit or any other pulse Syntax CH Channel Variables Channel 0 through 199 Example SEND_COMMAND IR_1 CH 18 The controller performs the following 1 Transmits IR pulses for 1 IR code 11 for the time set by CTON 2 Waits for the time set by CTOF 3 Transmits IR pulses for the IR code for 8 IR code 18 for t...

Page 46: ...ax IROFF Example SEND_COMMAND IR_1 IROFF Stops transmitting IR signals POD Disables current PON power on or POF power off command settings Channel 255 changes are enabled Syntax POD PON Sends IR function 27 if available or 9 to turn device power on After three attempts if the linked I O channel still detects a power off status the controller starts processing stored buffer commands Then if another...

Page 47: ... the IR Serial Data port for IR Serial or Data controlled devices that connect to the port Syntax SET MODE MODE Variable Mode IR SERIAL or DATA Example SEND_COMMAND IR_1 SET MODE IR Sets the IR_1 port to IR mode so that an IR controlled device can be connected to the port SET IO LINK Links an IR Serial Data port to an input output I O channel for use with PON and POF com mands The I O channel can ...

Page 48: ..._1 XCH 343 Transmits the IR code as 3 4 3 enter Mode 2 Examples SEND_COMMAND IR_1 XCH 3 Transmits the IR code as 0 0 3 SEND_COMMAND IR_1 XCH 34 Transmits the IR code as 0 3 4 SEND_COMMAND IR_1 XCH 343 Transmits the IR code as 3 4 3 Mode 3 Examples SEND_COMMAND IR_1 XCH 3 Transmits the IR code as 0 3 SEND_COMMAND IR_1 XCH 34 Transmits the IR code as 3 4 SEND_COMMAND IR_1 XCH 343 Transmits the IR co...

Page 49: ...net Options and clear the Temporary Inter net Files and History files Then close and open the page to update the cache memory Encountering problems opening and accessing WebLinx pages Locate IEs Temporary Internet files settings and set it to automatically refresh cache memory every time you open a page Internet communication is not working properly after configuring the NICs Check the Proxy setti...

Page 50: ...e the Axcess program and link settings The WebLinx Server icon on my desk top is red The AXB NET device is not set to Server mode Verify the Server LED on the AXB NET is solid red If not re program the AXB NET The AXB NET device s IP address settings are incorrect Refer to the Getting Connected section on page 9 section to make sure the WebLinx Server PC s IP addresses and AXB NET device s IP addr...

Reviews: