GenLink-DCP: Analog Input Channel

(See your user notes for this page.)
 This form is used to set up channel scaling, alarms, trending, event logging and anything else to do with analog channels. It is the most complex form in GenLink-DCP and we recommend you read the PM-DCP Technical manual before changing critical settings on this page. The settings are protected so that only inconsequential settings can be changed without passwords.

(The color coded access levels are explained on the Security Access page.)

There are presently 43 analog readings (channels) which these settings can be applied to. Some of these channels are simple, physical input channels while others are derived, analog measurements such as "power". These measurements have been calculated from other channel readings but are included here so that they can be scaled, displayed and programmed to cause alarms in the same way as is done with the simple input channels.

To navigate between channels use the "Next" or "Previous" buttons, or, enter a channel number into the "Channel No" box and press "Goto".

Typical channel allocations

Keep in mind that this is only a typical channel arrangement, based on a diesel engine controller. Refer to your customer manual for the exact configuration of your product.

Channel Connector-Pins
(+, rtn)
Function Wires
+, rtn
AN1 J3-(1,2) Oil Temperature 523V,523R
AN2 J3-(3,4) Coolant Temperature 68V,68R
AN3 J3-(5,6) Oil Pressure 69V,69R
AN4 J3-(7,8) Throttle position sensor feedback 766V,766R
AN5 J3-(9,10) 4-20mA User config. channel 5  
AN6 J3-(11,12) 4-20mA User config. channel 6  
AN7 J3-(13,14) 4-20mA User config. channel 7  
AN8 J3-(15,16) 4-20mA User config. channel 8  
AN9 J3-(17,18) CAC Bypass Position 763V,763R
AN10 J3-(19,20) Coolant Level 85V,85R
AN11 J3-(21,22) Fuel Level 575V,575R
AN12 J3-(23,24) 4-20mA Aux 1 Input channel 12 AI1S,AI1R
AN13 J3-(25,26) 4-20mA Aux 2 Input channel 13 AI2S,AI2R
AN14 J3-(27,28) 4-20mA User config. channel 14  
AN15 J3-(29,30) 4-20mA User config. channel 15  

Changing the channel name and units

Each channel can be given a user programmable name of up to 20 characters. This name is the one used both to display readings and to report an alarm (or warning). Some channels are pre-defined by Generac to have certain functions, Changing the name of these channels should be avoided.

Each channel has a 6 character field to hold the text used for displaying units for the reading. Note that this does not scale the reading itself, it is just a text field.

Output as an analog channel

Any analog channel can be mapped or copied to an analog output channel. Mapping is performed after all calibration, scaling and functions have been applied. There are 8 output channels that can be used, however some channels are internal to the controller only and others are in PWM format. Channels 0-3 are true analog 4 and 5 are internal analog test points, 6 & 7 are PWM only.
            CH0 is J5 pin 29
            CH1 is J5 pin 30
            CH2 is J5 pin 31
            CH3 is J5 pin 32
            CH4 is an internal test point
            CH5 is an internal test point
            CH6 is J5 pin 25
            CH7 is J5 pin 26
    

Use the pull down menu to allocated a mapping channel, "NULL_ASSIGN" means no mapping will occur and this is the default case.

Trending

SEE ALSO: TRENDING HELP

Selecting a channel for "Trending" really means local trending, in a local memory buffer. This setting is not used for remote trending. By checking this box, you are selecting this reading to be stored at regular intervals for later analysis. The start and stop conditions for trending, and the trending interval are set in the trending menu. You can select up to 4 variables to trend at any one time. You can use this method to generate graphs of readings vs time, such as power vs time. You can also produce plots of frequency response while applying and removing load to the generator.

Alarm/Warning configuration

There are several steps to be followed to program alarms or warnings for any channel. First decide how many you want and what the criteria for each one are. Note that some conditions such as "active when" apply to groups of alarms, so you may have to juggle your criteria. You can have a total of 4 alarms or warnings per channel. You can only have a total of two "less than" types and two "grater than" types. GenLink polices this requirement so as you start filling out the form, it gray's out some options. Again you may have to juggle your choices.

For each alarm or warning, start at the left of the page and work to the right along the same line. Once you have selected the alarm types and setpoints, choose from the "active when" box as to when the alarms become active. Note that all "greater than" types have the same active when condition as do all "less than" types.
ALWAYS ENABLEDAlways enabled
HOLDOFFEnabled after a time delay (HOLDOFF TIME) which only begins after the engine has started.
IMMEDIATEEnabled as soon as the engine starts
The HOLDOFF TIME parameter is found in the Engine Configuration menu

Now fill in the appropriate delays for each alarm / warning.

NOTE THAT FOR THE 2 DIALOUT CHECKBOXES:

Dialout1
is a group control and applies to both possible alarms for this channel
Dialout2
is a group control and applies to both possible warnings for this channel

Non shutdown Alarms will not be cleared until they have been acknowledged via the "alarm acknowledge" button on the main display screen, or from the unit's front panel and the alarm condition has gone away. This means the audible alarm will sound until the alarm acknowledge button is pressed.

Shutdown alarms are cleared by the above method but can only be cleared with the keyswitch in the "off" position.

Shutdown alarms can be remotely cleared via GenLink via the "Reset alarm" button on the main display screen, without having to put the keyswitch into the "off" position. This is for convenience at geographically remote sites and will allow the genset to restart automatically.

Warnings are like non shutdown alarms except they are not latched. When a warning occurs, the audible alarm will sound and a warning message displayed, when the condition goes away, the audible alarm will stop and the message will disappear.

    

Common settings

1) Sensor failure check: is used to enable testing of this channel for an attached sensor failure. As most channels have 4-20mA signal conditioning applied, any input out of this range will be deemed to have failed. This will not apply to all channels and that has this option checked will generate an alarm on failure and optionally shut down the system. 2) Shutdown on sensor failure: Checking this box will cause the generator to shutdown if the sensor on this channel fails. 3) Hysteresis: If a "greater than setpoint" alarm/warning occurs, in order for the alarm to go away, the reading must drop to a value less than setpoint minus the hysteresis value. If a "less than setpoint" alarm/warning occurs, in order for the alarm to go away, the reading must increase to a value greater than than setpoint plus the hysteresis value. The hysteresis value is in display units, e.g. in degrees F for temperatures or psi for oil pressure. 4) Delays: All alarms/warnings can have delays associated with them. If a delay is selected, then the alarm must be present for the length of the delay time before it is deemed active. You can set two fixed delays per channel and then separately associate each alarm or warning with this delay, or choose no delay. There are 4 possible alarms/warnings you can program for each channel, so you may need to share these delays.

Scaling and calibration

This section defines how the raw reading is processed to produce the displayed reading. Reference to the PM-DCP technical manual is advised. ANALOG MATH Each of the 43 channels is processed by a set of measuring rules using constants that are set via GenLink. Usually these constants can be changed by the customer. In the following illustration, the measurement is represented by M and the GenLink constants are in italics. The measurement is processed in the following order and the result is then stored for customer display or use. FIRST: Apply calibration to compensate for circuit inaccuracies. M = M * calibration factor Where calibration factor is a number such that 1024 is equivalent to 1, so it's really M * calibration factor / 1024 GenLink will hide this computation so you can enter floating point numbers such as 1.1 or 0.987 etc. SECOND: Apply conversion equation to convert reading to usable number. M = M processed by function X Where X can be the following types: 1) THERMISTOR 2) PRESSURE 3) CFM SENSOR 4) CURRENT 5) CAL_SCALE 6) LINEAR 7) POLY_1ST 8) POLY_2ND 9) POLY_3RD 10) POLY_1ST_N1 11) POLY_1ST_N2 12) GEN_FP_POLY b>WARNING: Contact Generac before using this selection. The function X may use any of the coefficients 1, 2, 3 and in some cases will use calibration factor as a 4th coefficient (in this case use scaling factor for calibration). The coefficients are used to allow adjustment of the basic functions to cater to future or alternate sensors. They perform different tasks in different functions, see FUNCTIONS for further details. Note: If calibration factor is used as a coefficient, it will be shown (and entered) by GenLink as (actual coefficient / 1024). Example: If the coefficient is -378, it will be displayed as -0.36914 THIRD AND LAST: Apply scaling - similar to calibration, but used for adjusting final value. This is used primarily for adjusting RMS Voltage readings to account for resolution optimized electronics. For example: on a 240 Volt machine, it is set to 0.5 since the firmware interprets the reading to be 480 Volts. M = M * scaling factor Where scaling factor is a number such that 1024 is equivalent to 1, so it's really M * scaling factor / 1024 GenLink will hide this computation so you can enter floating point numbers such as 1.1 or 0.987 etc.

FUNCTIONS

The User Configurable Analog Inputs have several parameters that affect the value interpreted from the A/D reading. In general, the following equation determines the final User Configurable Analog Input result: Result = Scale ( Function ( Calibrate ( Raw A/D reading ) ) ) For functions that need 4 coefficients for a polynomial, the calibration factor has to be incorporated in the polynomial coefficients. In this case, the following equation determines the final User Configurable Analog Input result: Result = Scale ( Function ( Raw A/D reading ) ) Tests have shown that the A/D readings for the User Configurable Analog Inputs can have an offset error as well as a ratio inaccuracy. Due to limitations on data space for each input, it was decided that the ratio would usually suffice for adjusting the raw value for hardware inaccuracies. Since there are conversion functions for these inputs, any offset can be built into the coefficients of the functions with some difficulty. The RMS Analog Inputs have a calibration parameter and a scaling parameter that affect the value interpreted from the A/D reading. The following equation determines the final RMS Analog Input result: Result = Scale ( Calibrate ( RMS Function ( Raw A/D reading ) ) ) Tests have shown that the A/D readings for the RMS Analog Inputs can have an offset error as well as a ratio inaccuracy. Due to limitations on data space for each input and processing speed requirements, it was decided that the ratio would suffice for adjusting the raw value for hardware inaccuracies. At this time there are no selectable functions applied to these inputs. Therefore, the offset cannot be adjusted out. However, the voltage only needs to be accurate around the setpoint and the calibration ratio can attain that accuracy. It should also be noted that the inaccuracies tend to be difficult to determine due to the RMS canceling out positive and negative inaccuracies. If this is not adequate, future software can be added to allow a function to be selected. The coefficient space is already reserved. Although the calibration and scaling adjustments exist for the remaining Analog Inputs(i.e. derived channels), it is unlikely they will be used. The remaining Analog Inputs are derived from other analog inputs that have already been adjusted. If further adjustment is needed, then the following equation determines the final Analog Input result: Result = Scale ( Function ( Calibrate ( Raw A/D reading ) ) ) These derived inputs have more complex interactions with the hardware, so care should be taken if adjustments are used. The conversion functions are described below. One of these functions is a 16 bit floating point polynomial - GEN_FP_POLY. This function should only be used as an extreme last resort as it is processor time intensive. Also, Generac should be contacted before using this selection. It is possible that future versions of software will not accept the GEN_FP_POLY type. The other integer polynomial functions should be sufficient for converting the A/D input data. The coefficients for the conversion functions need to be adjusted for working in the A/D counts realm as opposed to the voltage realm. Multiply A/D reading voltage by 1023/5 to convert to A/D reading counts. Also, the coefficient scaling is in powers of 2 to expedite processing of math operations using shifts instead of multiply and divide.The following types of Analog Input functions are implemented in the software as of September 17, 2003: THERMISTOR: PRESSURE: POLY_3RD: Third order polynomial with 4 coefficients and a scaling factor X = raw_analog ( AX^3 + BX^2 + CX + D ) * S Where: A, B, C, D are polynomial coefficients S is the scaling factor Coefficient 3 = A * 1024^3 Coefficient 2 = B * 1024^2 Coefficient 1 = C * 1024 Calibration = D / 1024 Scaling = S POLY_2ND: Second order polynomial with 3 coefficients, a scaling factor, and a calibration factor X = M * raw_analog ( AX^2 + BX + C ) * S Where: M is the calibration factor A, B, C are polynomial coefficients S is the scaling factor Calibration = M Coefficient 3 = A * 1024^2 Coefficient 2 = B * 1024 Coefficient 1 = C Scaling = S LINEAR: POLY_1ST: First order polynomial with 2 coefficients, a scaling factor, and a calibration factor X = M * raw_analog ( AX + B ) * S Where: M is the calibration factor A, B are polynomial coefficients S is the scaling factor Calibration = M Coefficient 2 = A * 1024 Coefficient 1 = B Scaling = S POLY_1ST_N1: First order polynomial with 3 coefficients, a scaling factor, and a calibration factor X = M * raw_analog ( A + BX + CX^-1 ) * S Where: M is the calibration factor A, B, C are polynomial coefficients S is the scaling factor Calibration = M Coefficient 3 = C Coefficient 2 = B * 1024 Coefficient 1 = A Scaling = S POLY_1ST_N2: First order polynomial with 4 coefficients and a scaling factor X = raw_analog ( A + BX + CX^-1 + DX^-2 ) * S Where: A, B, C, D are polynomial coefficients S is the scaling factor Coefficient 3 = D Coefficient 2 = C Coefficient 1 = B * 1024 Calibration = A / 1024 Scaling = S CFM_SENSOR: First order polynomial with 4 coefficients and a scaling factor X = raw_analog - learned_offset ( A + BX + CX^-1 + DX^-2 ) * S Where: A, B, C, D are polynomial coefficients S is the scaling factor Coefficient 3 = D / 32 Coefficient 2 = C Coefficient 1 = B * 32768 Calibration = ( A * 64 ) / 1024 Scaling = S CURRENT: CAL_SCALE: Implements a scaling factor and a calibration factor X = M * raw_analog X * S Where: M is the calibration factor S is the scaling factor Calibration = M Scaling = S GEN_FP_POLY: Third order polynomial with 4 coefficients WARNING: Generac should be contacted before using this selection. It may not be available in future firmware versions. X = raw_analog AX^3 + BX^2 + CX + D Where: A, B, C, D are 16 bit floating point polynomial coefficients Coefficient 3 = A Coefficient 2 = B Coefficient 1 = C Calibration = D Bits 15 - Bit 5 = Signed Mantissa where bit 15 = the sign Bits 4 - Bit 0 = Signed Power of 4 where bit 4 = the sign Amplitudes from 0.00000005961 (256 E-16) to 1,098,437,885,952 (1023 E+15) are possible with this representation with at least 9 significant bits.

Event logging

An "event" is a condition which when met, causes a record to be made in the event log. The condition can be something like "oil temperature >240 deg. F" or "Switched to off" for a digital event. In order to generate an analog event you must select which channels you wish to generate the events by checking the "Log Event" checkbox. You must then set the conditions to be met for the event. These conditions consist of a setpoint (in display units) and a comparison type e.g. greater than setpoint . The comparison type is selected from the a pull down menu with the following options: GT = GREATER THAN GE = GREATER THAN OR EQUAL LT = LESS THAN LE = LESS THAN OR EQUAL EQ = EQUAL NE = NOT EQUAL An event can only re-occur once the condition has become not true.


(See your user notes for this page.)

GenLink-DCP Main Help Page