LONWORKS ® PCLTA-20 PCI LonTalk Adapter User’s Guide ® Version 2 E Corporation 078-0179-01B
Echelon, LON, LONWORKS, LonTalk, LonBuilder, NodeBuilder, LONMARK, Neuron, LonManager, 3120, and 3150 are trademarks of Echelon Corporation registered in the United States and other countries. Other brand and product names are trademarks or registered trademarks of their respective holders.
FCC NOTICE (for USA only) Federal Communications Commission Radio Frequency Interference Statement Warning: This equipment has been tested and found to comply with the limits for a Class B digital device, pursuant to part 15 of the FCC Rules. These limits are designed to provide reasonable protection against harmful interference in a residential installation.
Contents 1 PCLTA-20 Adapter Introduction Introduction Audience Content Related Documentation 2 Installing the PCLTA-20 Adapter PCLTA-20 Adapter Software Installation Windows® 95/98 Software Installation Procedure Windows NT® Software Installation Procedure Software Installation Results Windows 95/98 Software Removal Procedure Windows NT Software Removal Procedure Windows 95/98 Virtual-Mode DOS Driver Installation Results Windows NT Virtual-Mode DOS Driver Installation Results PCLTA-20 Adapter Hardware Ins
Transceiver… Diagnostics… General Settings System Image Path Layer2 and Layer6 Buffering Enable PC Card Reset PCLTA-20 Diagnostics Driver Status Diagnostic Commands Test Comm Service Restart Reset 3-4 3-5 3-5 3-5 3-5 3-5 3-6 3-6 3-7 3-7 3-8 3-9 3-9 3-9 4 Developing with the PCLTA-20 Adapter 4-1 Initializing the PCLTA-20 Adapter Canceling the Flush State Configuring the PCLTA-20 Adapter with a Network Address Installing a PCLTA-20 Adapter on a LONWORKS Network Installing with an LNS Tool Installing with
1 PCLTA-20 Adapter Introduction Echelon’s PCLTA-20 PCI LonTalk® Adapter (Models 74401, 74402, 74403, 74404, and 74405) is a high-performance LONWORKS® interface for desktop, and embedded personal computers equipped with a 32-bit PCI interface and a compatible operating system. Designed for use in LONWORKS control networks that require a PC to monitor, manage, or diagnose the network, the PCLTA-20 adapter is ideal for industrial control, building automation, and process control applications.
Introduction The PCLTA-20 adapter provides any host processor equipped with a 32-bit PCI interface and compatible operating system with access to a LONWORKS network. Installation software for the PCLTA-20 adapter is provided in the Connectivity Starter Kit Model 58030-01 (which must be purchased separately), and provides a software-based control panel and a software driver for Microsoft Windows 95, 98, or NT operating systems. Installation software also is available on Echelon’s web site at www.echelon.
priority processing. Separating the application layer of the LonTalk protocol from the lower layers makes the PCLTA-20 adapter independent of its host application. The host application, including its network variables, can be changed at any time without modifying the adapter. The PCLTA-20 adapter combined with the host PC can also be used with nodes that require more processing power, memory, input/output capability, or network variable connections than are provided by the Neuron® Chip alone.
1-4 Introduction
2 Installing the PCLTA-20 Adapter This chapter describes the procedures for installing the PCLTA-20 adapter in a PC or embedded host with a compatible operating system.
PCLTA-20 Adapter Software Installation There are two versions of the PCLTA-20 installation software, one for Windows 95/98, and one for Windows NT. Each version installs the files required by the associated Windows operating system to recognize the PCLTA-20 adapter, as well as the downloadable NSI and MIP images. ! Therefore, installation of the software must occur before insertion of the PCLTA-20 adapter into a PC’s PCI slot.
during PCLTA-20 Configuration. See Chapter 3, Configuring and Testing the PCLTA-20 Adapter. 7. When the 16-bit Application Support prompt appears, select “Yes” to enable the use of 16-bit applications with the PCLTA-20 adapter. This causes the installation program to add references to the DOS CONFIG.SYS file for the “stub” device drivers named PCCLON1 and PCCLON2. This allows existing 16-bit applications to recognize these device names and use the PCLTA-20 adapter as a network interface.
. ! Only install the PCLTA-20 adapter after the software has been installed. ! 1. Close all open programs. 2. Insert the installation diskette into the PC. 3. In Windows NT 4.0 or later, click the Start button on the Windows NT task bar and select the run command. In Windows NT 3.51 select “Run...” from the file menu of the Program Manager. 4. When prompted for a program name, enter the following: a:\SETUP.
9. Software installation is complete. At the prompt to restart the computer, remove the PCLTA-20 installation diskette, turn off power, install the PCLTA-20, and then reboot the computer. Software Installation Results The installation software for the PCLTA-20 adapter loads a selection of new files and updated versions of existing files to different locations on the PC’s hard drive. The function and location of these files can be found in the on-line help file.
Windows 95/98 Virtual-Mode DOS Driver Installation Results The Windows 95 PCLTA-20 adapter installation software will prompt the installer to automatically add the virtual-mode DOS driver. This driver is small in size, and allows a DOS session under Windows to have access to the PCLTA-20 through the device driver running as a part of Windows. The driver will not function unless a Windows session is running and the PCLTA-20 device driver is installed. The following line will be added to the CONFIG.
PCLTA-20 Adapter Hardware Installation ! ESD Warning This product contains devices which are sensitive to static electricity. Before installing or removing the PCLTA-20 adapter or the network cables, discharge any static electricity which may have accumulated to earth ground. 1. Turn off the PC and remove the power cord. 2. Open the PC case and locate an empty 32-bit PCI slot. Remove the corresponding blank panel from the rear of the PC. Set aside the screw. 3.
Installing the PCLTA-20 Adapter Before Software Installation The following section applies to Windows 95/98 only. If the PCLTA-20 adapter was inserted into the PC prior to PCLTA-20 software installation, the Windows operating system will be unable to associate a device driver with the adapter. When Windows 95/98 starts up, a “New Hardware Found” window will appear. Click the Cancel button, then install the PCLTA-20 software as described above.
IRQ resource problems may generally be resolved by disabling another device in the system. More information can be found in the Hardware Conflict troubleshooting portion of the Windows 95/98 on-line Help file. Access the hardware conflict troubleshooter through the procedure outlined below: 1. Open the Windows 95/98 on-line help by clicking the Windows Start button and selecting “Help.” 2. In the Help Topics window, choose the Contents tab, or from another Help window, choose the Contents button. 3.
of 0x204-0x207. If this problem is suspected, manually move the PCLTA-20 adapter’s I/O range to a safer location to prevent I/O overlap. Solving Conflicts under Windows NT The device driver PNPLON.SYS works with the Windows NT operating system to locate PCLTA-20 cards. The driver is completely Plug n’ Play, and because the device is a PCI card, the system BIOS will determine a useable I/O port and IRQ setting. There is no user-configurable resources setting from the Windows NT operating system.
1. Open the file named ECHELON.INI, which should reside in the WINDOWS directory. If this file does not exist, then create one with a text editor. 2. Create a driver alias section in the file, by adding the following line: [DRIVERALIAS] 3. On the following line, add the driver alias: aliasname=devicename where aliasname is the device name accessed by the software, such as “LON1”, and devicename is the device to be used. 4. Add additional aliases, as necessary.
The PCLTA-20 will now be renamed LON2 and the named device conflict will be resolved. Under certain circumstances the LONWORKS Plug ‘n Play control panel diagnostics functions states that the PCLTA-20 and driver are functioning; however, the LonMaker for Windows Integration Tool or any other LNS-based tool do not work. You will notice that when the network is open the tool indicates that it is unable to communicate with the PCLTA-20 NSI.
3 Configuring and Testing the PCLTA-20 Adapter This chapter explains how to configure and test the PCLTA-20 adapter using the Control Panel installed in Chapter 2.
PCLTA-20 Configuration PCLTA-20 configuration is accomplished by using the LONWORKS PCLTA-20 control panel. Open the control panel by selecting the “LonWorks® Plug ‘n Play” icon in the Control Panel. Figure 3.1 PCLTA-20 control panel and icon The LONWORKS PCLTA-20 control panel is divided into three parts: a device selection area, a general settings area, and a control section.
Device Specific Settings The PCLTA-20-specific options consist of five separate controls (figure 3.2). These controls are defined as follows: Figure 3.2 PCLTA-20-specific Controls Device Selected Controls which PCLTA-20 adapter is selected for configuration. The PCCLON1 and PCCLON2 drivers are installed by the installation software. If additional drivers have been manually installed, PCCLON3 and/or PCCLON4 will also be available.
no PCLTA-20 adapter currently installed in a PCI-bus slot, a message appears stating that the operating system has removed, or has not loaded, the PCLTA-20 device driver. Figure 3.3 PCLTA-20 Transceiver dialog box The Transceiver selection box specifies the transceiver type for the selected PCLTA20 adapter. The default transceiver is an FT-10-compatible transceiver. Other standard transceiver configurations, and a custom configuration, may be chosen using this selection box.
General Settings The PCLTA-20-generic options consist of four controls (figure 3.4). These controls are defined as follows: Figure 3.4 PCLTA-20 generic controls System Image Path Specifies the full directory path for the PCLTA-20 system images. This path is set by the PCLTA-20 Installation Software but may be modified by the user. Layer2 and Layer6 Buffering Controls the number of 4Kbyte operating system pages that are allocated for message buffering within the driver.
LonWorks® PCC10/PCLTA10/PCLTA20 Device Driver Version: 1.25 Card Type: PCLTA-20 Driver Status: Number of Free LTA Output BuffersNon-Priority: 3, riority: P 3 Loaded Image ize:S49408 Interrupt Count: 4 Figure 3.
The diagnostic commands are invoked by selecting one of the buttons displayed in figure 3.6. If a diagnostic command results in the “Image file not found” error message, close the Diagnostics dialog box by selecting the OK button, then click the Apply button in the PCLTA-20 control panel. This re-initializes the adapter and allows use of the diagnostic commands. Figure 3.6 Diagnostics dialog box commands Test The Test button retrieves status and error counts from the PCLTA-20 adapter.
-- Network Interface Node Status -CRC Errors: [00000] TX Timeouts: [00000] Lost (APP) Messages: [00000] Missed (NET) Messages: [00000] Node State: Unconfigured Most recent error: 0 Reset Cause: External Figure 3.7 Example Network Diagnostics Status Response Comm The Comm button verifies communications between the PCLTA-20 adapter and another node on the network.
The network wiring may work for this test but may fail if multiple nodes are communicating. Be sure to verify that the proper termination is used when troubleshooting communication problems. The Comm feature is not designed to work across routers. Service The Service button will cause the PCLTA-20 adapter to broadcast a service pin message on the network. The service pin message will not be sent if the adapter is in the post-reset flush state (see Automatic Flush Cancel).
3-10 Configuring and Testing the PCLTA-20 Adapter
4 Developing with the PCLTA-20 Adapter This chapter provides an overview of how to develop and use host software with the PCLTA-20 adapter.
Initializing the PCLTA-20 Adapter Once a PCLTA-20 adapter and PC are powered, the host application must initialize the PCLTA-20 adapter. If you are using a LonManager or LNS software product, you may skip to the next section. When a PCLTA-20 adapter is initially powered, it disables network communications by entering the FLUSH, unconfigured state. The FLUSH state prevents the adapter from responding to network management messages before the host application has initialized the adapter.
interface. In this case the PC running the network application sends a local message to the PCLTA-20 adapter to change its state to configured. Alternately, the PCLTA-20 adapter may be installed in a network by some other network tool or a Network Services Server (NSS). In this case, the network tool or server sends a message to the PCLTA-20 adapter across the network to change its state and to assign it an address.
Chapter 6 of the LonBuilder User’s Guide2 describes how to define and install nodes in a development network using the LonBuilder Network Manager. A prerequisite to creating application node target hardware and node specifications is to define the channel that will be included in the network as defined under Defining Channels in Chapter 10 of the LonBuilder User's Guide2. Be sure to correctly set the minimum clock rate field. If this field is set incorrectly, excessive collisions will occur.
Rebooting a PCLTA-20 Adapter During development, a programming or installation error may cause a host application to corrupt the EEPROM memory within a PCLTA-20 adapter. If an error occurs, indicating that the PCLTA-20 adapter has detected a fatal error or is experiencing watchdog resets, then the adapter firmware must be forced to reboot its internal state. In most cases, it will be possible to reboot the PCLTA-20 adapter over the network by using a network tool to zero the adapter’s Boot ID.
Table 4.
5 Electrical and Mechanical Interfaces This chapter describes the hardware interfaces and mechanical layout of the PCLTA-20 adapter.
PLCTA-20 Adapter Board Layout Figure 5.1 shows the layout of the PLCTA-20 adapter models 74401, 74402, 74403, and 74404. Model 74404 (TP-RS485) includes jumpers that must be configured to set the correct speed on the RS-485 channel (figure 5.2). 1 JP2 JP3 JP1 JP2 JP3 JP1 Figure 5.
Figure 5.3 shows the layout of the PCLTA-20 adapter model 74405. The model 74405 adapter is equipped with a header connector for an SMX transceiver; this adapter does not have an integral transceiver. Attach the SMX transceiver in accordance with the manufacturer’s instructions – see the document LONWORKS® SMX™ Transceiver Installation Instructions document 078-0145-01 version D or later if using an Echelon SMX transceiver. Figure 5.
accept 12 to 26AWG (1.2mm to 0.45mm) wire. The terminals are connected as follows (with terminal 3 being closest to the service LED): Terminal Connection 3 Shield 2 RS-485 - 1 RS-485 + ! Use only shielded cabling suitable for an RS-485 channel. The use of unshielded cabling could result in damage to the adapter due to common mode voltage associated with differences in ground potential between different nodes. Mechanical Considerations PLCTA-20 models 74401 – 74404 measure 3.87” (9.8cm) H x 5.
6 References This chapter provides a list of the documents referenced in this manual.
Reference Documentation [1] LONWORKS® FTT-10A Free Topology Transceiver User’s Guide, Echelon Corporation. [2] LonBuilder User’s Guide, Echelon Corporation. [3] Neuron® Chip Data Book, as published by Motorola,Toshiba, and Cypress. [4] LONWORKS® Host Application Programmer's Guide, Echelon Corporation. [5] NodeBuilder® User’s Guide, Echelon Corporation.
E DECLARATION OF CONFORMITY PC LonTalk® Adapater, PCLTA-20 Application of Council Directive: 89/336/EEC Manufacturer’s Name: Echelon Corporation Manufacturer’s Address: 4015 Miranda Avenue Palo Alto, CA 94304 USA Manufacturer’s Address: in Europe Echelon BV Printerweg 3 3821 AP Amersfoort The Netherlands Product Model Number: 74401, 74402, 74403, 74404, 74405 Type of Equipment: Information Technology Equipment Standards to which: Conformity is Declared EN 60950:1992; EN 55022:1994/A1-1995 EN
