Alpha Technologies Cordex CXC HP Assembly Instructions

Cordex HP Controller
Modbus Integrator Guide
Technical Guide: 0350114-J0
Effective: 08/2020

Contents
List of Figures............................................................................................................................................... 3
List of Tables.................................................................................................................................................4
1. Introduction............................................................................................................................................. 7
1.1. Overview.........................................................................................................................................7
1.2. Purpose and Audience...................................................................................................................7
1.3. Knowledge and Permissions..........................................................................................................7
2. Using Modbus.........................................................................................................................................8
2.1. Modbus Capabilities on the CXC HP............................................................................................ 8
2.2. Modbus Setup................................................................................................................................ 8
2.3. Modbus Data................................................................................................................................11
2.3.1. Limited Data Set................................................................................................................ 11
2.3.2. Full System Data Set.........................................................................................................11
2.4. How to Create Identical Modbus Structure..................................................................................13
2.5. Modbus Reference....................................................................................................................... 14
2.5.1. Full System Data Set Data Points.....................................................................................14
2.5.2. Limited Data Set Data Points............................................................................................ 37
3. Glossary.................................................................................................................................................40
Page 2 0350114-J0 Rev G

Modbus Integrator's Guide for the CXC HP
List of Figures
Figure 1: Enabling Modbus.......................................................................................................................... 9
Figure 2: Modbus Connection Configuration..............................................................................................10
Figure 3: Modbus Data Example............................................................................................................... 10
0350114-J0 Rev G Page 3

Modbus Integrator's Guide for the CXC HP
List of Tables
Table 1: Configuration...................................................................................................................................9
Table 2: Modbus Address Allocation for Common Controller Data............................................................11
Table 3: Modbus Address Allocation for DC System Data........................................................................ 11
Table 4: Modbus Address Allocation for AMPS HP System Data............................................................. 12
Table 5: Controller Data Points.................................................................................................................. 14
Table 6: Custom Data Data Points.............................................................................................................15
Table 7: Timers Data Points.......................................................................................................................15
Table 8: Counters Data Points................................................................................................................... 15
Table 9: User Alarms Data Points..............................................................................................................16
Table 10: L-ADIO Data Points....................................................................................................................16
Table 11: 6I-ADIO Data Points................................................................................................................... 17
Table 12: HV-ADIO Data Points.................................................................................................................18
Table 13: I/M1-ADIO Data Points...............................................................................................................18
Table 14: PSU-ADIO Data Points.............................................................................................................. 19
Table 15: Shunt Mux-ADIO Data Points.................................................................................................... 20
Table 16: 8R8D-ADIO Data Points.............................................................................................................20
Table 17: BDFB-ADIO Data Points............................................................................................................ 21
Table 18: E2-ADIO Data Points................................................................................................................. 23
Table 19: DC System Data Points............................................................................................................. 24
Table 20: DC System Battery Data Points.................................................................................................26
Table 21: DC System Loads Data Points.................................................................................................. 27
Table 22: DC System Disconnects Data Points.........................................................................................28
Table 23: DC System Shunts Data Points................................................................................................. 28
Table 24: DC System Current Transducer (CT) Data Points..................................................................... 28
Table 25: DC System Rectifiers Data Points............................................................................................. 28
Table 26: AMPS HP System Data Points.................................................................................................. 28
Table 27: AMPS HP System Bypass Switch Data Points..........................................................................36
Table 28: AMPS HP System Breakers/Fuse Data Points.......................................................................... 36
Table 29: AMPS HP System T2S Data Points.......................................................................................... 36
Table 30: AMPS HP System TSI Inverters Data Points............................................................................ 36
Table 31: Limited Data Set Data Points.....................................................................................................38
Page 4 0350114-J0 Rev G

Preface
Note:
Photographs contained in this manual are for illustrative purposes only. These photographs may not
match your installation.
Note:
Operator is cautioned to review the drawings and illustrations contained in this manual before proceeding.
If there are questions regarding the safe operation of this powering system, contact Alpha Technologies or
your nearest Alpha representative.
Note:
Alpha shall not be held liable for any damage or injury involving its enclosures, power supplies,
generators, batteries, or other hardware if used or operated in any manner or subject to any condition
inconsistent with its intended purpose, or if installed or operated in an unapproved manner, or improperly
maintained.
For technical support, contact Alpha Technologies:
Canada and USA: 1-888-462-7487
International: [phone]
Copyright
Copyright © 2017 Alpha Technologies Ltd. All rights reserved. Alpha is a registered trademark of Alpha
Technologies.
No part of this documentation shall be reproduced, stored in a retrieval system, translated, transcribed, or
transmitted in any form or by any means manual, electric, electronic, electromechanical, chemical, optical,
or other-wise without prior explicit written permission from Alpha Technologies.
This document, the software it describes, and the information and know-how they contain constitute the
proprietary, confidential and valuable trade secret information of Alpha Technologies, and may not be
used for any unauthorized purpose, or disclosed to others without the prior written permission of Alpha
Technologies.
The material contained in this document is for information only and is subject to change without notice.
While reasonable efforts have been made in the preparation of this document to assure its accuracy,
Alpha Technologies assumes no liability resulting from errors or omissions in this document, or from the

use of the information contained herein. Alpha Technologies reserves the right to make changes in the
product design without reservation and without notification to its users.

1. Introduction
1.1. Overview
The purpose of this manual is to provide information on how to use Alpha Technologies Cordex™
High Performance System Controller (CXC HP) and software along with Modbus. This guide contains
information on setup, and operation of Modbus using Alpha’s CXC HP controller.
1.2. Purpose and Audience
The audience for this manual are engineers, technicians, IT professionals and network operation
personnel who are tasked with remote monitoring of the power system using Modbus. They should be
well versed in the Modbus protocol as well as the network management, remote monitoring or network
operations center software and tools that will be used to monitor the controller.
1.3. Knowledge and Permissions
It is assumed that you have a good working knowledge of, and access to, the following:
•Modbus monitoring software and tools
•Ethernet cables and TCP/IP settings needed to connect your computer to the CXC HP controller
•Current version of Chrome, Firefox, Internet Explorer (9+) or Safari
•Power system that the controller currently controls
•Controller admin password, and the appropriate level of permissions
0350114-J0 Rev G Page 7

2. Using Modbus
2.1. Modbus Capabilities on the CXC HP
A Modbus client connects to the controller over an Ethernet TCP/IP connection to request data. Modbus
RTU is not directly supported, but 3rd party devices are available to translate from TCP/IP to RTU and
vice versa. A Modbus request consists of a device ID, a register code, a register address, and a length.
The controller Modbus agent:
•Supports multiple device IDs. The DC system limited data set ID and a full data set ID for the DC
system and each AMPSHP2 system. The data mapped to these sets are shown in the Modbus
Reference section.
•Represents data in the coil status and input status registers as boolean data (0 or 1)
•Represents data in the input register as 32-bit floating point values. There is one exception to this:
serial numbers of modules like ADIO or rectifiers are displayed as 32-bit integer.
•Value returned for a register that does not contain data is 0.
•Value returned for a register that has unknown data, corresponding to ‘---’ on the CXC HP UI, is
0xFFFFFFFF (or -1).
The Modbus agent supports three of the four common registers per device ID:
1. Coil Status (01) to hold status of relays, range 1 to 9999
2. Input Status (02) to hold status of boolean data like alarms or digital inputs, range 10001 to 19999
3. Input Register (04) to hole numeric values, range 30001 to 39999
The Holding Register (03), commonly used to write data, is not supported.
2.2. Modbus Setup
To enable Modbus TCP/IP on the controller, you need to configure certain parameters.
1. To enable Modbus, go to Controller > Configure Controller > Communications > Modbus, and
then select the byte order.
Page 8 0350114-J0 Rev G

Modbus Integrator's Guide for the CXC HP | 2 - Using Modbus
Figure 1. Enabling Modbus
Table 1. Configuration
Name Description
Modbus Agent Enables or disables Modbus service. When enabled, the service is initialized and
the controller is ready to accept requests.
The default configuration is Disabled.
Byte Order Changes the byte order of 32-bit data. This setting is used to change whether the
most or least significant byte comes first. This setting should be set according
to the requirements of the Modbus client. The client will decode and format data
needed to understand the correct byte order. The default configuration is Least
significant bytes first.
Limited Data Set ID This ID is a small set of DC system data. See the Modbus reference section for
the data mapping. The default is 247, the range is 241 to 250.
System Device IDs This table has a device ID for each supported system. Device IDs are automatical-
ly assigned when systems are created. The devices IDs must be unique. See the
Modbus reference section for the data mapping. The range is 1 to 240.
Client Application Setup
Client applications connect to the controller through TCP/IP via a Modbus client. The standard Modbus
service port 502 is used. The sample application used for the following figure, is Modscan32 available via:
WinTech Software Design - www.win-tech.com.
0350114-J0 Rev G Page 9

Modbus Integrator's Guide for the CXC HP | 2 - Using Modbus
Figure 2. Modbus Connection Configuration
Once a connection is made, data is polled automatically at the given device id, address and length as
shown in Figure 3.
Figure 3. Modbus Data Example
Device ID: provides specific data of interest for that device ID.
Address: provides the starting address of the data block.
Length: provides he length of the data block.
Modbus Point Type: The register channel of the data. The example shows Command code 04 - Input
Register (read-only data).
Note: The data shown have “unknown” values represented as the floating point value of
0xFFFFFFFF (-1.#QB). Non-available data or data addresses that are not populated display as 0.
Page 10 0350114-J0 Rev G

Modbus Integrator's Guide for the CXC HP | 2 - Using Modbus
2.3. Modbus Data
There are two types of data available over Modbus: limited data set and a full system data set for the DC
system and each AMPS HP system.
2.3.1. Limited Data Set
The Limited Data Set has a small number of DC system related parameters. This data set uses only the
input registers table (04). The default Device ID is 247. For a list of available data refer to the Limited
Data Set Data Points section.
2.3.2. Full System Data Set
A full system data set is available for the DC system and each AMPS HP system. This data set has all
parameters related to the system as well as other data such as custom, data, timers, counters and ADIO
readings. Three Modbus registers are used: coils status(01), input status (02), input register (04). The
default device id is 1.
The structure of a full system data set is much different than for the Limited Data Set. When working with
the controller, it is possible to create and remove inventory to match a physical system, or to create and
remove things like user alarms, custom data, timers and counters. Because of this dynamic nature there
are limits to the number of item that can be assigned Modbus addresses.
The data available for each device ID always includes controller data. The following tables show the types
of data contained in the Modbus table, the starting address for each type of data, and the limitation to the
number of data supported. Note that system data always starts at address 5001.
Table 2. Modbus Address Allocation for Common Controller Data
Source Maximum Number
of Source Items
Start of Coil Status
Register (01)
Start of Input Status
Register (02)
Start of Values Reg-
ister (04)
Controller 1 1 10001 30001
Custom Data 128 203 10203 30203
Timers 128 717 10717 30717
Counters 128 1231 11231 31231
User alarms 64 1745 11745 31745
reserved 1 2003 12003 32003
ADIO 24 3541 13541 33541
Table 3. Modbus Address Allocation for DC System Data
Source Maximum Number
of Source Items
Start of Coil Status
Register (01)
Start of Input Status
Register (02)
Start of Values Reg-
ister (04)
DC System 1 5001 15001 35001
0350114-J0 Rev G Page 11

Modbus Integrator's Guide for the CXC HP | 2 - Using Modbus
Table 3. Modbus Address Allocation for DC System Data (continued)
DC System: Battery 1 5157 15157 35157
DC System: Loads 120 5183 15183 35183
DC system: Shunt 120 6385 16385 36385
DC system: CT 120 6627 16627 36627
DC system: Discon-
nect
10 6869 16869 36869
DC system: Rectifier 256 6991 16991 36991
Table 4. Modbus Address Allocation for AMPS HP System Data
Source Maximum Number
of Source Items
Start of Coil Status
Register (01)
Start of Input Status
Register (02)
Start of Values Reg-
ister (04)
AMPS HP System 1 5001 15001 35001
AMPS HP System :
Breakers/Fuses
10 6503 16503 36503
AMPS HP System :
Bypass Switch
5 6625 16625 36625
AMPS HP System :
T2S
4 6707 16707 36707
AMPS HP System :
Inverters
32 6773 16773 36773
This table shows:
•Source item that has Modbus data available,
•Maximum number of items that can be viewed over Modbus in each register,
•Starting address for each type of data.
Note:
Modbus client software sometimes requires addresses to be entered in the range 1 - 9999. If this
is the case, drop the leftmost digit for addresses that are greater than 9999. The Modbus client
software will then use the combination of register and address to formulate the correct address for
the query.
Not all register addresses will be populated with data. For example, the controller does not actually have
any coils (relays). A request for coil data at address 1 will return zero.
Page 12 0350114-J0 Rev G

Modbus Integrator's Guide for the CXC HP | 2 - Using Modbus
The Modbus reference table on the CXC HP web interface provides specific addresses for particular data
points.
Modbus addressing follows these rules when changing system configuration:
•When an item is created, such as custom data, or a shunt, the item is assigned Modbus addresses
for its data. These addresses will not change unless the item is removed, or the Re-number
Modbus Table by Name button is pressed.
•Removing an item leaves a gap in the address table. If a new item is created, it will fill the next
available address. If there are not gaps, it is added to the end
•Modbus addresses are local to the controller. They cannot be transfered. If necessary, to align
Modbus addresses between identical or similar systems, see the procedure in the How to Create
Identical Modbus Structure section.
•When importing a configuration, the newly imported items are sorted by name first, then assigned
the first available Modbus address. Existing Modbus addresses are not changed.
2.4. How to Create Identical Modbus Structure
The dynamic nature of creating and configuring a controller means that Modbus addresses may not
be identical between identical systems. These instructions describe how to create the same Modbus
structure between identical systems. If using the Limited Data Set only, then the Modbus addresses are
already static and it is not necessary to follow these instructions. If using a full Modbus system data set,
follow these instructions:
1. Create your system and configure all it's inventory, custom data, timers, counters, user alarms,
ADIO.
2. Name all your inventory (shunts, loads etc.), custom data, timers, counters, user alarms, ADIO with
a number as a prefix. For example, suppose you have two loads that you have already named:
“Radio (150W)” and “Juniper Router”. Change the names to “(01) Radio (15W)” and “(02) Juniper
Router”. This prefix helps to explicitly define the order of the Modbus data. Note the format of the
number(“01”) has a preceding zero. If there are more than 9 items of the same type, this preceding
0350114-J0 Rev G Page 13

Modbus Integrator's Guide for the CXC HP | 2 - Using Modbus
zero is required to ensure that the sorting is correct. If there are more than 99 items of the same
type, two preceding zeros are required (“001”).
It is not possible to apply names to power modules
3. Press the Re-number Modbus Table By Name button on the Full Data Set table. This sorts all the
Modbus data of the same type alphanumerically and reassigns addresses
4. Export a clone of the system and import to another system. On import the Modbus items are sorted
in the same way as is done when the Re-number Modbus Table By Name is pressed.
5. Perform Replace ADIO operation to transfer ADIO configuration of imported ADIO to existing ADIO
After importing the clone, the Modbus structure on the two identical systems is the same.
2.5. Modbus Reference
2.5.1. Full System Data Set Data Points
This section gives the data points for each type of item that is available through Modbus. Because of the
dynamic nature of the configuration, it is not possible to show a static Modbus table with addresses for a
system. Use the Export to CSV button on the web interface to generate and download a Modbus table
with addresses for a specific system. Each table has three columns:
•Name: the name of the data.
•Register: the Modbus register where the data resides.
•Format: the format of the data. To display data correctly, Modbus clients must have the right data
format specified in the correct order.
2.5.1.1. Data Points
Table 5. Controller Data Points
Name Register Format
Disk Almost Full 02:Input Status Boolean
Clock Error 02:Input Status Boolean
CAN Devices In Bootloader 02:Input Status Boolean
ADIO Comms Lost 02:Input Status Boolean
Temporary License In Use 02:Input Status Boolean
Temporary License Expired 02:Input Status Boolean
Required Feature License Missing 02:Input Status Boolean
Unassigned Modules 02:Input Status Boolean
Page 14 0350114-J0 Rev G

Modbus Integrator's Guide for the CXC HP | 2 - Using Modbus
Table 5. Controller Data Points (continued)
Name Register Format
Duplicate SNMP Component Refer-
ence
02:Input Status Boolean
Restart Required 02:Input Status Boolean
Number Of Bit Errors High 02:Input Status Boolean
Memory Usage High 02:Input Status Boolean
CAN Module Communication Lost
Count High
02:Input Status Boolean
CAN Module Communication Lost
Count Very High
02:Input Status Boolean
Controller: Time Since Restart 04:Input Register 32-bit Floating Point
Table 6. Custom Data Data Points
Name Register Format
Custom Data: Result as Numeric 04:Input Register 32-bit Floating Point
Table 7. Timers Data Points
Name Register Format
Interval Timer: Output 02:Input Status Boolean
Delay Timer: Output 02:Input Status Boolean
Delay Timer: Delay Time Remain-
ing
04:Input Register 32-bit Floating Point
Table 8. Counters Data Points
Name Register Format
Down Counter: Input 02:Input Status Boolean
Up Counter: Input 02:Input Status Boolean
Down Counter: Output 04:Input Register 32-bit Floating Point
Up Counter: Output 04:Input Register 32-bit Floating Point
0350114-J0 Rev G Page 15

Modbus Integrator's Guide for the CXC HP | 2 - Using Modbus
Table 9. User Alarms Data Points
Name Register Format
Threshold User Alarm/835: User-
Defined
02:Input Status Boolean
Digital User Alarm/547: User-De-
fined
02:Input Status Boolean
Table 10. L-ADIO Data Points
Name Register Format
K1 01:Coil Status Boolean
K2 01:Coil Status Boolean
K3 01:Coil Status Boolean
K4 01:Coil Status Boolean
K5 01:Coil Status Boolean
K6 01:Coil Status Boolean
K7 01:Coil Status Boolean
K8 01:Coil Status Boolean
K9 01:Coil Status Boolean
K10 01:Coil Status Boolean
K11 01:Coil Status Boolean
K12 01:Coil Status Boolean
D1 02:Input Status Boolean
D2 02:Input Status Boolean
D3 02:Input Status Boolean
D4 02:Input Status Boolean
D5 02:Input Status Boolean
D6 02:Input Status Boolean
D7 02:Input Status Boolean
D8 02:Input Status Boolean
Temperature Sensor #1 Failure 02:Input Status Boolean
Page 16 0350114-J0 Rev G

Modbus Integrator's Guide for the CXC HP | 2 - Using Modbus
Table 10. L-ADIO Data Points (continued)
Name Register Format
Temperature Sensor #2 Failure 02:Input Status Boolean
Temperature Sensor #3 Failure 02:Input Status Boolean
Temperature Sensor #4 Failure 02:Input Status Boolean
CAN Serial Number 04:Input Register 32-bit Integer
V1 04:Input Register 32-bit Floating Point
V2 04:Input Register 32-bit Floating Point
V3 04:Input Register 32-bit Floating Point
V4 04:Input Register 32-bit Floating Point
T1 04:Input Register 32-bit Floating Point
T2 04:Input Register 32-bit Floating Point
T3 04:Input Register 32-bit Floating Point
T4 04:Input Register 32-bit Floating Point
I1 04:Input Register 32-bit Floating Point
I2 04:Input Register 32-bit Floating Point
I3 04:Input Register 32-bit Floating Point
I4 04:Input Register 32-bit Floating Point
Table 11. 6I-ADIO Data Points
Name Register Format
CAN Serial Number 04:Input Register 32-bit Integer
I1 04:Input Register 32-bit Floating Point
I2 04:Input Register 32-bit Floating Point
I3 04:Input Register 32-bit Floating Point
I4 04:Input Register 32-bit Floating Point
I5 04:Input Register 32-bit Floating Point
I6 04:Input Register 32-bit Floating Point
0350114-J0 Rev G Page 17

Modbus Integrator's Guide for the CXC HP | 2 - Using Modbus
Table 12. HV-ADIO Data Points
Name Register Format
K1 01:Coil Status Boolean
K2 01:Coil Status Boolean
K3 01:Coil Status Boolean
K4 01:Coil Status Boolean
K5 01:Coil Status Boolean
K6 01:Coil Status Boolean
D1 02:Input Status Boolean
D2 02:Input Status Boolean
D3 02:Input Status Boolean
D4 02:Input Status Boolean
Temperature Sensor #1 Failure 02:Input Status Boolean
Temperature Sensor #2 Failure 02:Input Status Boolean
Ground Fault Resistance Low 02:Input Status Boolean
Ground Fault Current High 02:Input Status Boolean
CAN Serial Number 04:Input Register 32-bit Integer
GFD Current 04:Input Register 32-bit Floating Point
V1 04:Input Register 32-bit Floating Point
V2 04:Input Register 32-bit Floating Point
T1 04:Input Register 32-bit Floating Point
T2 04:Input Register 32-bit Floating Point
I1 04:Input Register 32-bit Floating Point
DCCT1 04:Input Register 32-bit Floating Point
DCCT2 04:Input Register 32-bit Floating Point
Table 13. I/M1-ADIO Data Points
Name Register Format
K1 01:Coil Status Boolean
K2 01:Coil Status Boolean
Page 18 0350114-J0 Rev G

Modbus Integrator's Guide for the CXC HP | 2 - Using Modbus
Table 13. I/M1-ADIO Data Points (continued)
Name Register Format
K3 01:Coil Status Boolean
K4 01:Coil Status Boolean
D1 02:Input Status Boolean
D2 02:Input Status Boolean
Temperature Sensor #1 Failure 02:Input Status Boolean
Temperature Sensor #2 Failure 02:Input Status Boolean
CAN Serial Number 04:Input Register 32-bit Integer
V1 04:Input Register 32-bit Floating Point
V2 04:Input Register 32-bit Floating Point
T1 04:Input Register 32-bit Floating Point
T2 04:Input Register 32-bit Floating Point
I1 04:Input Register 32-bit Floating Point
Table 14. PSU-ADIO Data Points
Name Register Format
K1 01:Coil Status Boolean
K2 01:Coil Status Boolean
K3 01:Coil Status Boolean
K4 01:Coil Status Boolean
K5 01:Coil Status Boolean
D1 02:Input Status Boolean
D2 02:Input Status Boolean
Temperature Sensor #1 Failure 02:Input Status Boolean
Temperature Sensor #2 Failure 02:Input Status Boolean
CAN Serial Number 04:Input Register 32-bit Integer
V1 04:Input Register 32-bit Floating Point
V2 04:Input Register 32-bit Floating Point
T1 04:Input Register 32-bit Floating Point
0350114-J0 Rev G Page 19