User guide

P/N: 021-00154, Rev. A.6 - updated for V4.7 Tools Page | 22
Use meaningful variable names.
The limit on variable size is 32 characters. A variable that isn’t an input or output device is called an internal
variable. An internal variable that is for Valve1 minimum current setting for the program loader monitor could be
labeled Valve1MinCurA_PLM_IV. This naming convention could be used throughout the program. An EEmem
variable for a valve’s minimum current setting could be named Valve1MinCurB_eem. Below are some other
examples.
Valve1ctl_AI2 – analog input#2. Variable names in capitol letters designate an abbreviation.
Cross_valve_UI2 – universal input #2.
Output_shaft_RPM_PI1 – rpm pulse input#1.
Pump#2_milling_pwm_OG1 – output group #1, pwm controlled motor.
OK_to_begin_led_OG3 – output group #3, discrete(bang bang) output to control LED.
Engine_rpm_lo_J1939 – The low byte of the engine rpm from the j1939 network.
Engine_temp_J1939 – The engine temperature from the j1939 network.
Network_status_eem - EEmem variable.
Mast_into_position1_IV – internal variable.
EEmem_spare_128 – eemem variable that doesn’t have a specific name because unused. Makes programmer
aware of spare EEmem addresses.
Declare all variables in one location
Have one area of one bubble that is executed once to declare all variable names. This area would include
unsigned integers (Uint), EEmemory variables (EEmem), Timers (timer), constants (const) and others. Declare
all 128 EEmem variables. Variables that aren’t used could be name EEmem_spare_89, or such. An exception
would be a variable that is decared private, this would have to be declared in the bubble used. Declaring all the
variables in one location could make it easier to add another variable at a later time, and provides for a cleaner,
more structured program.
Comment important information into the program
Information such as Programmer’s name, date of program creation, revision history, and any description of
something that is difficult to understand is appreciated by anyone offering assistance in troubleshooting the
program. Explaining a complex math equation can be beneficial at a later date to refresh the programmers
memory of why a function was built the way it was and to assist in troubleshooting. Comment as much or little
as necessary. Comments do not contribute to the compiled program (.pgm) file size. Remember to add a colon
(‘) before starting comments. The Intella software interprets the (‘) that the information to the right is not to be
compiled.
‘Programmer’s Name: Paul Programmer
‘Program creation date: 5/28/2007
‘Revision history: 5/28/07 – initial release
‘ 6/12/07 – modified Always code to add temperature sensor to engine coolant
‘ 2/25/08 – modified ‘Tank level’ bubble to add logic and hydraulic fluid level sensor
‘Program description: This program will…
‘ The math function for the tank level takes into consideration the ….
1.16 Circuit Protection
Each of the
modules require adequate circuit protection. Use AGC type fuse. Each module requires 150mA for
internal circuitry. These modules also include the dvc61. If the module is capable of driving an output, then the
current required for that output is added to the 150mA. For instance, if a dvc7 is driving a 2 independent
cylinders, and the valves for the cylinders require 1.7A, then the total current for the dvc7 module would be
Dvc7 requirements 150mA