e.com so TL TELMA DESKTOP CLIENT SOFTWARE USER GUIDE 22oct13

e.com so TL133009 TELMA DESKTOP CLIENT SOFTWARE USER GUIDE 22oct13 TL133009 Telma Desktop Client Software User Guide THIS DOCUMENT IS TO BE USED ...
7 downloads 0 Views 1018KB Size
e.com so

TL133009 TELMA DESKTOP CLIENT SOFTWARE USER GUIDE

22oct13

TL133009 Telma Desktop Client Software User Guide

THIS DOCUMENT IS TO BE USED AS A STARTING POINT OR GUIDELINE FOR THE INSTALLATION OF AND SETUP OF THE TELMA DESKTOP CLIENT SOFTWARE. FURTHER TRCM INFORMATION IS AVAILABLE IN THE TECHNICAL SUPPORT AREA OF WWW.TELMAUSA.COM

TABLE OF CONTENTS Section 1: Introduction………………………………………………………………………………3 1.1 Telma Retarder Control Module (TRCM)……………………………………………….3 1.2 Telma Desktop Client Software………………………………………………………….3 Section 2: 2.1 2.2 2.3 2.4 2.5

Setup……………………………………………………………………………………….4 Connecting to the Vehicle………………………………………………………………..4 Software installation from a CD………………………………………………………….5 Software installation without CD…………………………………………………………6 COM Port Configuration – Serial Cable (No USB)…………………………………….7 COM Port Configuration – USB to Serial Adapter Cable……………………………..8

Section 3: 3.1 3.2 3.3 3.4

Operations………………………………………………………………………………10 Overview………………………………………………………………………………….10 Configuration Tab………………………………………………………………………..12 Recommended TRCM Settings………………………………………………………..14 Diagnostics Tab………………………………………………………………………….15

Page 2 of 16___________________________________________________________________________________22oct13

TL133009 Telma Desktop Client Software User Guide

SECTION 1

INTRODUCTION

1.1 Telma Retarder Control Module (TRCM) The Telma Retarder Control Module (TRCM) is a new control module with modernized architecture and features such as PC interface for diagnostics and configuration as well as the ability to obtain speed, ABS, and other information by listening to the vehicle CAN bus. The TRCM is capable of receiving analog or digital inputs. Four digital (on/off) inputs are available that can be used with air brake system pressure switches, Telma hand control switch, or Telma foot control switch for hydraulic brakes. Also available is an analog (variable voltage) input for use with a pressure transducer installed in the air brake system instead of air pressure switches. The TRCM has the ability to obtain speed, ABS, and other information by listening to the vehicle CAN bus which can reduce Telma system installation time by eliminating the need to make most individual hard wired connections to the chassis.

1.2 Telma Desktop Client Software The Telma Desktop Client Software establishes a connection between the TRCM and a PC interface to allow configuration and diagnostics of the TRCM using a computer. The Telma Desktop Client Software has been proven to be a useful tool for testing and troubleshooting the Telma control system. The latest version of the Telma Desktop Client Software and driver updates are available on our Technical Website at www.telmausa.com.

Page 3 of 16___________________________________________________________________________________22oct13

TL133009 Telma Desktop Client Software User Guide

SECTION 2

SETUP

DO NOT CONNECT THE USB TO SERIAL ADAPTER CABLE TO THE COMPUTER UNTIL PROMPTED. DO NOT OPEN TELMA DESKTOP CLIENT SOFTWARE UNTIL PROMPTED.

2.1 CONNECTING TO THE VEHICLE The Telma Retarder Control Module (TRCM) is connected to the Telma cab harness which was installed as part of the retarder control system. A 9-pin serial receptacle can be found on the cab harness near the TRCM. A standard DB9 serial cable is used to connect the Telma cab harness to the PC containing the Telma Desktop Client Software. If the PC does not have a serial RS232 port then a USB to serial adapter may be used. It is recommended to use the USB to serial adapter cable available from Telma as it has gone through multiple tests and has proven to be compatible with the Telma Desktop Client Software. This cable is available from Telma as part number TIG01027. Option 1: Computer w/ RS232 Port

DB9 straight through serial cable

Telma Cab Harness DB9 receptacle

Telma TIG01027 USB/Serial Adapter

Telma Cab Harness DB9 receptacle

Option 2: Computer w/ USB Port

Page 4 of 16___________________________________________________________________________________22oct13

TL133009 Telma Desktop Client Software User Guide

2.2 SOFTWARE INSTALLATION FROM A CD

Insert the CD and launch the setup.exe file to begin installation of the Telma Desktop Client Software. The welcome screen will be displayed as shown. Version 12.28.2012.0 is shown in this manual but may be different from your version. ¾

Click “Next”

The installer will prompt you to choose the components which you want to install. “Install Program” will be checked by default. You may choose to add an icon to the start menu group as well as add an icon to the desktop. ¾ ¾ ¾

Check the box to “Add Startmenu Group” Check the box to “Add Desktop Icon” Click “Next”

The installer will create a new folder in the Program Files folder of the computers C:\ drive. ¾

Click “Next”

The installation progress screen is displayed. The software installation may take a few minutes to complete.

The installation is complete. Leave the box checked next to “Run Telma Desktop Client Software” to open the software. ¾ ¾

Click “Finish” to close the installer Continue to section 2.4

Page 5 of 16___________________________________________________________________________________22oct13

TL133009 Telma Desktop Client Software User Guide

2.3 SOFTWARE INSTALLATION WITHOUT A CD

The Telma Desktop Client Software is available for download from the technical support section of www.telmausa.com. Version 12.28.2012.0 is shown in this manual but may be different from your version. ¾ ¾ ¾

Download the desktop client software Open the “setup.exe” file Click “Next”

The installer will prompt you to choose the components which you want to install. “Install Program” will be checked by default. You may choose to add an icon to the start menu group as well as add an icon to the desktop. ¾ ¾ ¾

Check the box to “Add Startmenu Group” Check the box to “Add Desktop Icon” Click “Next”

The installer will create a new folder in the Program Files folder of the computers C:\ drive. ¾

Click “Next”

The installation progress screen is displayed. The software installation may take a few minutes to complete.

The installation is complete. Leave the box checked next to “Run Telma Desktop Client Software” to open the software. ¾ ¾

Click “Finish” to close the installer Continue to section 2.4

Page 6 of 16___________________________________________________________________________________22oct13

TL133009 Telma Desktop Client Software User Guide

2.4 COM Port Configuration – Serial Cable (No USB) The COM port must be configured in the Telma Desktop Client Software to allow the software to communicate with the TRCM. Section 2.4 will guide you in establishing a connection between the PC and TRCM using a serial cable. Begin by connecting one end of the serial cable to the Telma harness, and the other end to the serial port on the computer. Do not open the Telma Desktop Client software until prompted to do so. ¾ ¾

Click the Windows “Start” Button and select “Run” Type in “devmgmt.msc” and click “OK”

The device manager should now be open. Locate the COM port number as follows: ¾ ¾

Click the “+” box next to “Ports (COM & LPT) The COM port number will be displayed next to the device ID. In this case, the COM port is “COM1”

Once the COM port number has been identified, it is time to configure the Telma Desktop Client Software. ¾ ¾ ¾ ¾

Open the Telma Desktop Client Software Click on “File” and select “Configuration” Use the drop down menu next to “Port” to select the COM port number found in the previous step Click “Ok”.

IF THE COMPUTER HAS MORE THAN ONE SERIAL PORT BE SURE TO CONNECT TO THE SAME SERIAL PORT PRIOR TO USE OF THE TELMA DESKTOP CLIENT SOFTWARE. CONNECTING TO A DIFFERENT SERIAL PORT WILL CHANGE THE COM PORT NUMBER AND REQUIRE RE-CONFIGURATION OF THE COM PORT WITHIN THE DESKTOP CLIENT SOFTWARE.

Now that the COM port has been configured, we are ready to begin use of the Telma Desktop Client Software. ¾

Continue to section 3 of this manual

Page 7 of 16___________________________________________________________________________________22oct13

TL133009 Telma Desktop Client Software User Guide

2.5 COM Port Configuration – USB to Serial Adapter Cable The COM port must be configured in the Telma Desktop Client Software to allow the software to communicate with the TRCM. Section 2.5 will guide you in establishing a connection between the PC and TRCM using the USB to serial adapter cable (Telma p/n TIG01027). Do not open the Telma Desktop Client software until prompted to do so. DO NOT CONNECT THE USB TO SERIAL ADAPTER CABLE TO THE PC UNTIL PROMPTED TO DO SO.

The device driver for the USB to serial adapter cable will need to be installed manually if using the Windows XP or Windows Vista operating system. The device drivers typically install automatically on PC’s running Windows 7 and later. Follow the steps below to install the device driver manually. If the PC is running Windows 7 or later skip this page and continue to the next page. The device driver files for the USB to serial adapter cable are included in the Telma Desktop Client Software CD. Note that there is a mini CD included with the USB to serial adapter cable. You do not need to use this CD if you have the Telma Desktop Client Software CD. In addition, the device drivers are also available from the www.TelmaUSA.com web page.

Manually install the device driver: ¾

¾

Insert CD and open the “TIG01027 Drivers” folder o For Windows XP – open “PL-2303 Driver Installer – Windows XP 32 bit.exe” o For Windows Vista – open “PL-2303 Vista Driver Installer.exe” Click “Next”

The license agreement for use of the device driver is now displayed. ¾

Click “Yes” to agree to the terms of use

The driver installation will begin. Confirmation of a successful installation should appear once the driver installation is complete. ¾ Click “Finish”

It is recommended that you restart your computer at this time even if not prompted to do so. Once the computer has restarted, continue to the next page to configure the COM port number of the USB to Serial Adapter cable.

Page 8 of 16___________________________________________________________________________________22oct13

TL133009 Telma Desktop Client Software User Guide

Plug in the USB to serial adapter cable. For PC’s running Windows 7 and later, the device driver installation will begin automatically. Wait for the message indicating that the device drivers have installed successfully. This will be displayed on the lower right hand side of the screen. If the drivers were installed manually you will see a message on the lower right hand side of the screen notifying you that the device is not ready for use. The COM Port number of the USB to serial adapter cable can be determined through the device manager. ¾

Open the device manager o Click the Windows “Start” Button and select “Run” o Type in “devmgmt.msc” and click “OK”

The device manager should now be open. Locate the COM port number as follows: ¾ ¾ ¾

Click the “+” box next to “Ports (COM & LPT) The COM port number will be displayed next to the device ID. In this case, the COM port number is COM 7, as shown next to “Prolific USB-to-Serial Comm Port” If “Prolific USB-to-Serial Comm Port” is not an option under ports, or if there is a exclamation point next to it, the device drivers are not installed correctly.

Once the COM port number has been identified, it is time to configure the Telma Desktop Client Software. ¾ ¾ ¾ ¾

Open the Telma Desktop Client Software Click on “File” and select “Configuration” Use the drop down menu next to “Port” to select the COM port number found in the previous step Click “Ok”.

IF THE COMPUTER HAS MORE THAN ONE USB PORT BE SURE TO CONNECT TO THE SAME USB PORT PRIOR TO USE OF THE TELMA DESKTOP CLIENT SOFTWARE. CONNECTING TO A DIFFERENT USB PORT WILL CHANGE THE COM PORT NUMBER AND REQUIRE RE-CONFIGURATION OF THE COM PORT WITHIN THE DESKTOP CLIENT SOFTWARE.

Now that the COM port has been configured, we are ready to begin use of the Telma Desktop Client Software. ¾

Continue to section 3 of this manual

Page 9 of 16___________________________________________________________________________________22oct13

TL133009 Telma Desktop Client Software User Guide

SECTION 3

OPERATIONS

3.1 Overview Upon opening the Telma Desktop Client Software, the Telma Configuration and Diagnostics Interface is displayed. This is considered to be the main menu of the software.

Configuration: When communication is established between the software and the TRCM, the configuration tab displays the current configuration of the TRCM and allows the user to make changes to the configuration. The configuration tab is explained in section 3.2 of this manual. Diagnostics: The diagnostics tab provides an overview of the Telma control system and is a useful tool for checking and troubleshooting the retarder control system. The diagnostics tab is explained in section 3.4 of this manual.

Page 10 of 16___________________________________________________________________________________22oct13

TL133009 Telma Desktop Client Software User Guide Data On: The start button below “Data On” initiates the communication between the software and the TRCM. Upon pressing “Start” communication is established with the TRCM. Once communication has been established, this button turns red and is labeled “Stop”. Pressing “Stop” terminates communication between the software and the TRCM. Always press “Stop” before exiting the software. Send All Config: The send button below “Send All Config” is rarely used. This button should only be used in cases where the current values do not automatically change when the configuration is edited. This will be explained further in section 3.2. Data Status: A green check mark should be displayed when communication is established between the TRCM and software. Upon clicking the start button, the data status should display a green check mark. If a green check mark is not displayed, there is either no power to the TRCM or there is a bad connection between the PC and the cab harness. CAN Status: A green check mark should be displayed when communication is established between the TRCM and vehicle. Upon clicking the start button, the CAN Status should display a green check mark. If a green check mark is not displayed, and the vehicle is intended to have CAN communication, the configuration for the CAN settings may need to be changed to a different setting to match the vehicle. See section 3.4 for recommended settings. If the vehicle is not connected to CAN, the configuration for CAN will be off and “off” will be displayed for the CAN status. Firmware Version: The firmware version of the TRCM is displayed when communication is established with the TRCM. Telma Engineering may ask for this number if you call technical support for assistance with the TRCM or software trouble shooting.

Page 11 of 16___________________________________________________________________________________22oct13

TL133009 Telma Desktop Client Software User Guide

3.2 Configuration Tab The configuration tab is split in two sections. The left hand side, titled “Edit Configuration” allows users to make changes to the configuration in real time while communicating with the TRCM. The “Current Values” displayed on the right hand side of the configuration tab, shows the current settings of the TRCM. It is recommended that all users have thoroughly read and understood this manual before making any changes to the configuration.

When communication is established between the software and the TRCM, the current settings of the TRCM are shown on the right hand side. If “N/C” is displayed for any category in the current values section, the software is not receiving any data from the TRCM. Check to be sure you have a green check mark for data status. The TRCM configuration may be changed on the left hand side of the screen under “Edit Configuration.” There are drop down menus next to all categories in this section. Use the drop down menus to make changes to the configuration if necessary. Any changes made on the left hand side should instantly change the configuration of the TRCM. The current values side will automatically update and show any changes that have been made on the left hand side. IF THE CURRENT VALUES DO NOT IMMEDIATELY UPDATE UPON A CONFIGURATION CHANGE ON THE LEFT HAND SIDE, PRESS THE SEND ALL BUTTON. IF THE CURRENT VALUES STILL DO NOT CHANGE, PRESS STOP AND THEN POWER CYCLE THE TRCM BY TURNING THE IGNITION ON AND OFF.

Page 12 of 16___________________________________________________________________________________22oct13

TL133009 Telma Desktop Client Software User Guide Low/High: When set to high, stages one and two of the Telma turn on at the same time, i.e. input one turns on output 1 and output 2, input two turns on output 3, input four turns on output 4. When set to “Low” input one turns on output 1, input two turns on output 2, input three turns on output 3, and input four turns on output 4. This setting can be used to change from 25% off throttle to 50% off throttle for vehicles using the off throttle activation.

CAN: This category allows the user to change which CAN messages the TRCM looks for. The CAN messages will differ for different vehicle makes or models. For applications where the control system has not been connected to the CAN network, CAN should be set to “Off.”

Low Speed Threshold The low speed threshold determines the speed at which the Telma turns off. For CAN applications, the low speed threshold is measured in MPH. For non-CAN applications the low speed threshold is set in Hz. The low speed threshold may be set to 0 MPH or 0 Hz for testing purposes only. For retarder control system testing and troubleshooting, setting the low speed threshold to 0 MPH or 0 Hz will make the system operable at a stand still. No vehicle should be released or driven with the low speed threshold set to 0 MPH or 0 Hz.

Transducer Voltage Set Points: These are the voltages related to the brake air pressure which activates each stage of the Telma system. The TRCM is shipped with the default recommended set points from Telma. Contact Telma technical support before making changes to these set points.

Page 13 of 16___________________________________________________________________________________22oct13

TL133009 Telma Desktop Client Software User Guide

3.3 Recommended TRCM Settings The following chart displays the recommended TRCM settings for various applications:

INPROPER SETTINGS MAY CAUSE OPERATIONAL PROBLEMS WITH THE RETARDER SYSTEM. CONFIGURATION CHANGES SHOULD ONLY BE MADE BY EXPERIENCED TECHNICIANS. CONTACT TELMA TECHNICAL SUPPORT IN REGARD TO ANY PROBLEMS OR CONCERNS WITH TRCM SETTINGS.

Page 14 of 16___________________________________________________________________________________22oct13

TL133009 Telma Desktop Client Software User Guide

3.4 Diagnostics Tab The diagnostics tab is useful for testing the Telma control system. When communication is established between the TRCM and the PC, the diagnostics tab displays real time control system and vehicle data.

Stage Outputs: The stage outputs section of the diagnostics tab displays the inputs to the TRCM as input 1 through input 4. These inputs relate to the ground signal that is sent to the TRCM from the Telma foot switch, hand control, or air pressure switches. When the TRCM receives a ground signal to input 1, “ON” is displayed. Output 1 will turn on when input 1 is on (and TRCM is set to Low) if the conditions are right, i.e. speed is above low speed threshold, throttle position is 0.0%, and there is no ABS event.

Page 15 of 16___________________________________________________________________________________22oct13

TL133009 Telma Desktop Client Software User Guide The transducer voltage will turn on the output for each stage when conditions are right. The photo below shows a transducer voltage of 1.53 V. Output 1 and output 2 turn on corresponding to the transducer voltage set points as shown in the configuration tab.

Note that when an ABS event occurs, the outputs from the TRCM to the relay box will turn off. Once the ABS event is cleared, the outputs will come back on progressively (1st stage immediately and stages 2,3,4 with one second intervals). In addition to an ABS event, the outputs will turn off if throttle position is greater than 0.0% as well as if the speed drops below the low speed threshold. The photo below shows that the transducer is calling for the retarder to be active, however an ABS event is occurring which prevents the outputs from turning on.

CONTACT TELMA ENGINEERING WITH ANY QUESTIONS OR CONCERNS WITH TRCM CONFIGURATION AND DIAGNOSTICS.

Page 16 of 16___________________________________________________________________________________22oct13