Cooper General CAN Gateway
Installation and Configuration
Version 10 In Process
JULY 25, 2014
Welcome to our installation and configuration manual.
The Cooper General CAN Gateway (CGCG) provides an Ethernet/IP interface to Harris CAN-bus radios, models M53xx M73xx and XG-series supporting the CH721 control head.
In this version the TELEX C-Soft multicast protocol is integrated for input and output, providing Push-To-Talk Logical ID and Emergency Unit data, and supporting channel and system steering and channel scanning. We ship 1, 2, 4 and 12 port models in desktop, rack mount and DIN rail packages. This manual speaks to the 4-port CGCG with software version 3.0 or greater.
We’ve done our best to make this plug and play, however, between us, Telex and Harris there are a still good number of parameters that can conspire against success temporarily. We hope it works flawlessly the first time, but we’re always available for emails and telephone calls.
Cooper General Corporation
1785 NW 79the Avenue
Miami, Florida 33126
We want to thank our friends and colleagues at Harris and Telex for their ongoing support in the development of this product. While we think of our little gateway as a simple technical product, it has already bridged new customers and vendors together in successful alliances where none were previously contemplated. Everybody wins in our world, we hope, and we’re glad to be part of yours.
EDACS, OpenSky, Harris, are registered trademarks of Harris Corporation.
TELEX is a registered trademark of Bosch Security Systems Inc.
All other brand and product names are trademarks, registered trademarks, or service marks of their respective holders
This document was developed using Google Docs. Unfortunately (for print-copy buffs), they don’t support a page numbered index, so we added TOC links to make it easier to work with online.
Please let us know if you find any errors or omissions.
This document is published by Cooper General Corporation without any warranty. Improvements and changes to this manual necessitated by typographical errors, inaccuracies of current information, or improvements to programs and/or equipment, may be made by Cooper General Corporation at any time and without notice. Such changes will be incorporated into new editions of this manual. No part of this manual may be reproduced or transmitted in any form or by any means, electronic or mechanical, including photocopying and recording, for any purpose, without the express written permission of Cooper General Corporation.
This document is © Copyright 2014 by Cooper General Corporation, with all rights reserved.
The front panel of the CGCG has four connectors with screw-terminal plugs supplied to support four CAN-radio interfaces.
4-Port Cooper General CAN Gateway, front view, with connectors.
We ship an A.C. power module with most units, but the Cooper General CAN Gateway (CGCG) can be powered from an external 9-28 Vdc power supply. Desktop, rackmount and DIN rail packages are available.
The CGCG is usually installed on the same network as Telex Radio IP Appliances and C-Soft dispatch workstations. The IP-223/4 handles the Voice input/output and push-to-talk input converting the radio calls to VoIP, and the CGCG supports signalling and control of the attached radios.
System Block Diagram
There are four CAN bus ports, A-D from left to right on the front panel. Each CAN connector can support one radio with control head.
Screw terminal connectors are provided. You can cut a Harris-supplied CAN cable in half and connect two radios, one with each half. Connect the shield to GND one, the red (or white) conductor to CAN_H four, and the black to CAN_L two. A green LED to the left of the panel connector flashes upon CAN packet arrival to that port.
There are two CAN bus ports, A-B from left to right on the front panel. Each CAN connector can support one radio with control head.
2-PORT CAN GATEWAY
CAN TO RADIO
DB9 FEMALE PINS
The Harris M7300 audio is interfaced to a Telex IP-223 with the following cable:
M7300 PIN FUNCTION
TELEX PIN FUCTION
COR (AUX) OPT #1
PTT OPT #2
COR (AUX) OPT #1
5 & 7
8 & 29
The Harris M7200 audio is interfaced to a Telex IP-223 with the following cable:
M7200 PIN FUNCTION
TELEX PIN FUCTION
PTT OPT #2
RX AUDIO +
RX AUDIO -
TX AUDIO +
TX AUDIO -
COR (AUX) OUT OPT #1
8 & 21
The rear panel of the Gateway features the following connectors and LEDs (from left to right):
This green LED lights when voltage is being supplied.
Either barrel or two-pole Wago clamping socket can be used.
Warning: Be sure to use only one power source.
10/100 Ethernet RJ45 socket. Crossover cable required for direct PC connection.
Two available USB 1.1 interfaces for customer-specific solutions.
4 available digital inputs and 4 digital outputs, galvantcally isolated.
Factory Reset. For advanced operation.
This yellow LED lights while the gateway processes incoming CAN messages
Connect all the radio CAN cables to the CGCG. Connect RJ45 crossover cable to a test computer/laptop or regular cable to a network hub/switch, and power on the device. Wait at least one (1) minute for it to boot from power up.
The CGCG default IP address is 192.168.1.201. To change the IP address, browse to the existing IP address from a PC on that network.
You should see this screen:
If this is not seen, try Troubleshooting Tips
To configure the device, follow the links on the left of the page
NOTE: If you change any settings or IP addresses, you will need to save and reboot for the changes to take effect: Save the settings, Remove the power, re-apply power to boot the CGCG, then wait for one full minute for the device to restart. You can observe the boot progress by refreshing the Status menu item. Please be patient, there’s a lot going on under the hood at boot-time.
Use this screen to change the IP address, subnet mask and default gateway.
Note that the ARP cache of a test PC might need to be deleted to find the device with a changed IP address.
The CAN settings page controls baudrate and termination. Termination is discussed in the Troubleshooting Tips section of this document, and the baudrate should be left at the default 500 Kb
In the Multicast Settings page, select your radio system type (P25, OpenSky, EDACS) for each connected radio and the multicast address and port associated with it.
The Multicast IP addresses and ports must match those in the Telex C-Soft Configuration
The CGCG must be rebooted after any changes are saved
This page is used to load and display the Channel Steering Configuration data file created for the radio for each port. Use the Choose File button to specify the file to be loaded, and the Upload button to execute the load.
Once a file has been loaded properly, the internal data can be displayed the “Current settings” link for each port. Note: You MUST reboot (power cycle) the CGCG after Talkgroup settings are changed.
The “Download” links can be used to output the current configuration into a TAB--delimited file for review, modification and re-uploading.
The Aliases List is used to provide a radio’s ID with an alternate name, nickname, and/or a numerical value. This alternate name is what will appear on your radio/telex screen as an identifier showing who the radio ID is assigned to. Below is the Alias settings page.
Once a file has been loaded properly, the internal data can be displayed in the “Current settings” link. Column A is the radio ID, Column B is the Alias List; limited to 30 characters per line. Below is an example:
To check the status of the device there are “Status” and “Diagnostic” pages, and there is a real-time updated display on attached radio control heads.
When the CGCG is attached to a radio and configured properly, the third line on the display will scroll with the Message “Cooper General H:x F:y R:z” where x=hours running since boot, y=recorded CAN bus message failures and z=CAN bus retries. These diagnostics will provide a run-time indication of radio interface.
The Diagnostic page shows only start-up status. There you can make sure that all CAN ports were successfully connected.
Note: The start-up time is just over one minute after power up, and the CGCG is not ready to be used until the boot process is complete.
The Status page shows CAN and TCP packet counts and network errors. These values will increment on activity and can be refreshed from the browser.
This page is useful to understand the input and output conditions.
There is a debug mode available by connecting with Telnet to port # 50023. PTTID and Emergency debug messages are output in real time. The Telnet data takes the form:
PortNumber, “I” for PTTID and “E” for emergency, ID (LID)
This facility can also be used for rapid CAD system integration. Please contact the Cooper engineering team for integration options.
Please note that channel change and other diagnostic messages may be shown during the operation of the CGCG.
To check firmware versions and updates, visit the “Firmware” web page.
To update Firmware:
1. Enter IP address of CGCG in your browser address bar
2. Click the “firmware update” tab, then click the “chose file” button.
3. Choose the latest file online
4. Select “upload” then wait for the firmware update screen to reload
5. Your multicastSoftVersion date should reflect the downloaded firmware.
Please have the version numbers of your software available if you contact us for support.
We have implemented a small delay for ID updates in C-Soft to optimize performance with C-Soft. The default setting (100 mSec) is appropriate for version 6.3 C-Soft, and may be optimized over time.
To add/adjust an update delay:
Type the address bulleted below in the address bar with the CGCG ip address to add or change a time delay on each port. Make sure to check the box to activate the time delay.
The CGCG settings must match those of the Telex console environment. This section of the manual assumes the reader is familiar with the Telex setup and configuration process, and only explains in overview. For more information please contact your local Telex dealer, or Cooper General for professional support services.
To check the Telex C-Soft configuration, run the CSoftDesigner.exe program. Open your .veg file. and Edit -> Setup Per Line Parameters:
Note: Demo_c-soft.veg is the c-soft file that interfaces with the CAN gateway and radio demo.
Set the Line Names for the radios and Multicast addresses and port numbers to map to the IP-223/224 connected here.
The RX Port number here must be set the same as in the Multicast Settings page of the CGCG and uniquely for each radio on the network.
The “Freq” settings for changing channels and scanning are described in the Channel Steering section of this document.
NOTE: Push-To-Talk keying is accomplished via the IP-223/IP-224 appliance, directly using external push to talk into the radio. Program the radios for EXTPTT input with the INP1 signal using the Harris RPM software.
To receive an Emergency event, you need a button to acknowledge and clear the event from the screen. Add an Active Emergency Window for that:
Place a button somewhere; change font and colors as needed.
For radio modules requiring the ability to change channels, create a Frequency control UI element in C-Soft Designer:
Adjust the properties to suit the target dispatch environment:
Place the button on the dispatch design and save the C-Soft .veg file.
Radios associated with C-Soft Line modules can have a button can be created to control pre-programmed radio scanning.
To control radio Scan start and stop, create a button in C-Soft Designer:
Adjust the colors and button characteristics, and save the .veg file.
This section addresses the Telex “Freq” settings and CGCG configuration to match the programming layout of the attached radios.
The CGCG can control the talkgroup and system of connected radios from the C-Soft console software. This requires that the Telex C-Soft Configuration be set with data matching that of the CGCG.
Harris radios are configured with Systems and Groups, which are mapped to Frequencies, in Telex vernacular. We have developed a simple means to import radio configuration files into the CGCG. These files can be created in a spreadsheed based on output exported from the Harris RPM radio programming software.
The data file to import radio configuration into the CGCG is a TAB-delimited file that takes the following form:
Important Note: The System Name MUST NOT contain spaces, whereas Channel/Group Name can contain spaces. Both Channel/Group Name and System Name MUST be no longer than eight characters. All changes need to be reflected in your radio personality.
Note: CGCG_DEMO.csv is the demo Talkgroup for the CAN Gateway, as displayed above.
This radio shows 1 defined System with a number of talkgroups in use for a P25 system. These equate to 18 “Freqs” in the Telex C-Soft dispatch configuration.
Column A is a number that equates to the Telex C-Soft Frequency/channel number.
(Lines leading with “#” characters are comments, and are ignored)
Column B is the System number in the radio to be accessed.
Column C is the System name that appears on the first (top) line of the radio display (unless it is OpenSky, in which case it appears on the second line)
Column D is System type and can only be one of the following:
Column E is the group number, in the display order of the radio to be managed. All groups in the host radios “system” must be included here.
Column F is the group name that appears on the second line of the radio (unless it’s OpenSky, in which case it is the the first line).
Use TAB field delimiting and NO text delimiter when exporting the radio configuration file from a spreadsheet.
Note: If desired, you can add two diagnostic messages into the CGCG and C-Soft configurations:
System 0: CC SCAN will show CC SCAN on the C-Soft Display
System 0 REGISTER will show P25 registration events.
These two messages can be added to provide dispatcher indication of CC Scan and Registration events.
To import the radio configuration file to the CGCG, use the Talkgroup Settings page described elsewhere in this document.
Remember: TAB field delimiting and NO text delimiter (these are not normal defaults)
The Per-Line Parameters page of the C-Soft Configuration has a Freq button:
Here the frequency names are defined for the C-Soft line modules. The Load File button can be used to import the CSV file.
Note: “Demostat.csv” is the frequency name list included for the demo C-Soft configuration..
Column A has a 1 entered to have the channel Enabled, and a 0 for channels to be Disabled and remain hidden from the dispatcher.
Column B contains the name that will be displayed for each radio channel/talkgroup on the C-Soft line display.
This section of the document describes the TELEX C-Soft runtime operations.
Start the Telex C-Soft dispatch application. Key up a radio, and when receiving audio, you should see an ID appear in the module mapped to that radio.
In the event of a received Emergency, the Active Emergency Window will pop up:
Clear or ACKnowledge the emergency:
NOTE: The Cooper General CAN Gateway attempts to pass the correct ID with the Emergency call. However it receives ID and emergency events at different times from a radio. If they are close to each other in arrival-times (ID is seen less than 250 milliseconds before Emergency, or the ID is shown within 5 seconds after Emergency) then CGCG sends that ID with the emergency event. Otherwise it sends a '*RXEMER*' message. Please pay close attention to this in internal testing and operations training to understand the systems limitations before placing into production service.
To reiterate: Emergency ID is an attempt to correlate an ID with an emergency declaration, but it cannot be guaranteed in all circumstances.
If the Frequency Control Button has been set up correctly for a given radio, the dispatch user will be able to change Talkgroups and Systems, according to the mapping set up in the Channel Steering Configuration section.
In this example the left and right arrows will scroll through the pre-programmed Groups/Systems (Freq’s in TELEX-talk). When scrolling through the list with these arrows, a one second pause will cause the radio to switch to the selected Group/System.
Single-clicking on the displayed name will open up the C-Soft pre-programmed list created during the C-Soft Channel Names Import step.
Clicking on any of these names will immediate change to the designated Group and System in the radio.
The CGCG supports turning on and off pre-programmed scanning in the radios. The attached radios must be properly programmed and enabled for scanning. The CGCG will virtually “press” the “Scan” button on a radio based on dispatcher input.
If a Scan Button is programmed into the C-Soft Designer for a dispatch position it will toggle on/off under user control:
If the Channel is changed while Scan is On, it will be turned off. This will be reflected on the C-Soft button accordingly, showing “Scan Off” after a channel change.
NOTE: Scanning should only be done on non-critical channels, not primary dispatch. The channel/freq name in C-Soft the module display will be updated when the radio receives a scan call, however it may not reflect the actual channel during scanning on the consoles between calls.
Please test this feature carefully in your dispatch environment and make note in operations training about the limitations and safety concerns with scanning.
We have created demo files for the CAN Gateway, radios programming, and Telex configuration, largely used in this documentation.for reference and testing.
These files can be found here: http://www.coopergeneral.net/cgcg-library/
If C-Soft is running and receiving and transmitting audio, you’ve set up C-Soft properly, but no incoming LIDs are shown, here’s some things to try.
From a web browser go to the IP address of the device. The default is: http:\\192.168.1.201
If you don’t get a screen that looks like this:
Either the box is broken, or the network gurus must be summoned. If the box is broken, please give us a call.
If none of that solved your problem, and your Telex console has audio but no ID’s, and the radios are showing ID’s, and termination is correct, and the green LEDs are flashing normally, and the protocol is correct for the radio, and you’ve rebooted and checked the settings afterwards, we’ve got issues...give us a call or email with the keyword: UnknownError
Elsewhere in this manual we have asked to reboot the CGCG by cycling the power. This procedure returns the device to factory settings; please don’t do this unless we give you specific instructions.
In order to restore the default factory settings, hold the RESET for approx. 10 seconds. If the device is reset successfully, the yellow LED blinks until the RESET is released.
The default factory settings are activated immediately without a restart of the device:
IP address 192.168.1.201
Address type static
Network mask 255.255.255.0
END OF DOCUMENT
© Copyright 2013, 2014 Cooper General Corporation Page of