NIRA I7r Handbook A6
NIRA I7r Handbook A6
NIRA I7r Handbook A6
Handbook
Release 2015-12-01
The purpose of this handbook is to serve as a guide during installation and calibration
of NIRA i7r. Descriptions, content and specifications in this handbook may be
changed at any time. This handbook could contain errors – therefore it should not be
regarded as a definitive installation guide. Nira Control AB is not responsible for any
personal or property damages due to errors in this handbook, the professional
installing NIRA i7r is responsible for the installation.
Misuse of NIRA i7r and/or NIRA rk can cause severe personal injury and engine
damage. Nira Control AB is not responsible for any injuries, accidents or damages due
to misuse or ignorance.
Repairs of NIRA i7r, e.g. replacement of parts, will affect the safety of the product and
are not allowed under any circumstances. Nira Control AB is not responsible for any
problems, accidents etc, caused by non-approved parts or repairs not carried out by
Nira Control AB.
NIRA i7r must be installed by professional automotive technicians in accordance with
the instructions in this handbook, following good practice.
NIRA i7r is only intended for racing use and not for use on public roads. It is not
certified for use on vehicles subject to emission standards unless the appropriate
waivers have been issued. Please check with the relevant authorities for more
information.
NIRA rk is protected by applicable software copyright laws. You may not distribute
this software without the written consent of Nira Control AB. You may not copy this
software. Your purchase of NIRA i7r includes a single license to use NIRA rk together
with NIRA i7r.
NIRA rk is the calibration software that allows you to setup and configure a large
number of parameters in NIRA i7r. It is designed to run on a PC using the Windows
operating system and communicates with NIRA i7r via a Kvaser CAN-dongle.
The many functions of NIRA rk are described in detail starting in chapter 4.
NIRA rk is protected by applicable software copyright laws. You may not distribute
this software without the express written consent of Nira Control AB. You may not
copy this software other than for personal use. Your purchase of NIRA i7r includes a
single license to use NIRA rk together with NIRA i7r.
The Kvaser CAN-dongle connects NIRA i7r to the PC running NIRA rk software. The
CAN-dongle connects to your PC via a USB port. Drivers for the Kvaser USB-CAN
dongle are delivered together with the NIRA rk application software. Run the Kvaser
USB-CAN installer file before attempting to connect to NIRA i7r.
1.2 Glossary
BC Boost Control
1.3.1 Sensors
NIRA i7r processes the input signals and controls the output signals in order to
manage the following actuators.
8 Fuel injectors (amount and sequence)
Fuel Pressure Control (controls pressure control and/or volume control valve)
Boost pressure control valve (controls boost pressure H bridge or PWM output)
Fuel pump relay
Main relay (for actuator power supply)
Fan relay (for controlling radiator fan)
FlexiPorts™ - a very advanced function that controls fuel injection and boost
pressure in relation to input axes configured during calibration
Start fuel Handling – allows precision control of fuel injection during cranking
based ECT, engine speed derivate and cranking time
Alarms – adjustable alarm thresholds reduce the risk of engine damage
Limp home – any input sensor value out of range is replaced with a reasonable
value to keep the engine running, albeit at reduced power. Sets error code
Diagnostics – read error codes
2
Combustion, Lambda and
Measurement Principles
For combustion to take place, oxygen needs to be available. The oxygen content of
the air changes with air temperature and pressure.
Thus diesel engines runs on excess amount of air, the volumetric efficiency and A/F
calc is used to avoid smoke
The engine angular position of the crank shaft is crucial for accurate engine control.
The most common types of sensors used for angular positioning in automotive
applications are
Hall sensors
Inductive sensors
Example of CKP & CMP hall sensors plotted over one revolution. “CKP is a 24-1 pattern”
Inductive sensor
The inductive sensor or VR sensor (Variable Reluctance) uses the phenomenon of
induced voltage in the sensor. The voltage is induced when ferrite steel passes the
sensor and changes the flux through the sensor’s built in magnet. Therefore the
sensor is not in need of any power supply. The output voltage from the sensor will go
from negative to positive values. The output levels from the sensor will increase
proportionally to the speed of the tooth passing the sensor.
Example of an inductive CKP sensor signal when a ”2 lost” is detected from a pulse wheel with a ”60 –
2 lost” pattern
Example of wrong polarity at inductive sensor. The level transition through the gap is falling and the
zero crossing will be undefined in the blue circled area.
When installing NIRA i7r it is recommended that you follow the directions below.
Begin by determining if additional sensors are needed and where to install them.
Make sure any existing sensors you expect to use with NIRA i7r are in good working
order. The NIRA i7r wiring harness has markings in clear text on each wire to simplify
the work of connecting all the sensors.
Each sensor and actuator will need an appropriate connector attached to the harness.
The connector terminals should be crimped for best performance and rubber seals
should be used where the wires enter the connector housing. (Your NIRA i7r dealer
sells seals for all sensors.) If proper crimp tools are not available, soldering may be
used. Poorly crimped terminals are a common source of intermittent problems. Always
cover any soldered splices with heat shrinkable tubing.
Note that the MAP, MAT and ECT sensors sold by your NIRA i7r dealer have been
pre-calibrated in NIRA rk. These are recommended. Other sensors will need to be
calibrated separately. Calibration is done using one of the Wizards in NIRA rk.
Connection of Injector
Type Injector Pin Nira i7r pin Wire
Injector1 + E.64
Injector 1
Injector1 - E.85
Injector2 + E.22
Injector 2
Injector2 - E.1
Injector3 + E.65
Injector 3
Injector3 - E.86
Injector4 + E.23
Injector 4
Injector4 - E.2 Make sure that the wiring meets the
electrical and environmental
Injector5 + E.66 requirements
Injector 5
Injector5 - E.87
Injector6 + E.24
Injector 6
Injector6 - E.3
Injector7 + E.67
Injector 7
Injector7 - E.88
Injector8 + E.25
Injector 8
Injector8 - E.4
The Volume Control Valve (VCV) is fitted on the high pressure pump. The volume flow
through the valve is related the current through the actuator.
Connection of VCV
Variation Actuator Pin NIRA i7r pin Name
Connection of PCV
Variation Actuator Pin NIRA i7r pin Name
Use the original crank and cam sensor installation if possible. An accurate signal from
the crank position sensor is crucial. Therefore, it is very important to install the CKP
sensor with diligence. A faulty installation or a bad combination of CKP sensor and
pulse wheel causes an unreliable signal. In turn, an unreliable signal will make the
engine run poorly.
It’s important that the sensor mounting bracket is solid and that the trig wheel is 100
% aligned with the crankshaft.
The signal from the CKP sensor should resemble the pattern in the image above. It is
recommended to use an oscilloscope to study the signal.
NIRA i7r works with the majority of standard pulse wheels that has
one or two pulses “removed” as a reference point. On engines where such a pulse
wheel is factory fitted it is recommended to keep the factory installation. The picture
above and right is showing a pulse wheel of the type “60 – 2 lost” that is a standard
pulse pattern. This pulse wheel has 58 teeth and a gap that is created by the removal
of 2 teeth in the otherwise symmetrical pattern. Hence the name “60 – 2 lost”. NIRA
i7r is designed to handle pulse wheels of the types “60 – 2 lost”, “60 – 1 lost”, “ and
symmetrical pulse wheels down to “16 – 2 lost” and “16 – 1 lost”. Symmetrical pulse
wheels have teeth that are equally distributed around the pulse wheel with the
exception of a reference point where one or two teeth are missing. The table below
describes the pulse wheels that are compatible with NIRA i7r.
NIRA i7r reads symmetrical pulse wheels that are split into a maximum of 60 sections (60 – 1 lost, 60 – 2
lost) and a minimum of 16 sections (16 – 1 lost, 16 – 2 lost). All symmetrical patterns in between are
compatible with NIRA i7r.
Pulse wheel with a ”60 – 1 lost” pattern and a peak instead of a valley as reference point.
Pulse wheels having a peak instead of a valley or a hole as a reference point are more
error prone since vibrations can cause false trigs when the reference point passes the
sensor. If you are fitting a new pulse wheel when installing NIRA i7r, always choose a
pulse wheel with a valley as reference point.
The trigger wheel mounts on the face of the crank pulley. If the crank pulley is also a
harmonic balancer, verify that it is in good condition and isn’t slipping. Make sure the
trig wheel is aligned on the pulley. If it is not centered properly, the signal strength
from the CKP sensor will vary and ignition timing will drift back and forth.
The example below is given for fitting a “60 – 2 lost” pulse wheel: When figuring out
the angular placement of the trigger wheel, first turn the engine to TDC for cylinder 1.
Then place the trigger wheel such that the angle between the “2-lost” window and
the place where you plan on mounting the CKP sensor is around 90-120 degrees. See
picture 3-1 below. You will later need to measure the exact angle, see section 3.3.2.
Once the trigger wheel has been fitted, mount the CKP sensor. The gap between the
CKP sensor and the trigger wheel should be 0.5-1.0mm. If the gap is greater than 1.0
mm, the signal strength from the CKP sensor will vary too much and timing will drift
back and forth. Mount the sensor in a bracket that allows for slight adjustments.
Turn the engine so that cylinder 1 is at TDC. Measure the angle between the center of
the CKP and the trailing edge of the 2-lost (or 1 lost) window. See picture 3-1. Each
tooth on the trigger wheel is 3 degrees and each window is 3 degrees. Make a note of
the angle, as you will need to enter it into NIRA rk later.
In order to create a well-defined trig point for the CMP sensor, drill and tap a hole in
the cam gear. Insert a screw into the hole such that the screw head faces the sensor.
The sensor works best if the screw material is magnetic, such as galvanized steel. The
distance between the screw and the sensor may need to be adjusted in order for the
sensor output voltage to be high enough. The output voltage from the CMP sensor
needs to be at least 3V. Do not place the trig point in a place that gives a CMP signal
at the same time that the reference point of the crankshaft pulse wheel passes the
CKP sensor.
Sometimes it’s possible to use one of the camshaft lobes as a trigger.
To avoid that condensed liquids are collected in the sensor, a horizontal inclination of
10 degrees is needed. Due to the temperature limits, mount the sensor after the
turbine with at least 10 degrees vertical inclination.
Maximum exhaust gas temperature for the LSU 4.9 is 930 ºC.
Maximum temperature for the hexagon of the LSU 4.9 is 600 ºC
Mount the sensor as close to the engine as possible, regarding to the
temperature limits.
Make sure that sensor placement and installation is tested in real conditions
and the sensor provide accurate measurement
Mount sensor down slopes
Avoid pockets in exhaust system before system (accumulation of condensated
water)
Do not run the engine or sensor without sensor heating.
Tighten the sensor with approx. 40-60Nm
Avoid heat soak of the sensor wiring after engine swtish off
10 degrees
Accepted
mounting
angles
10 degrees
5 6
3 4
1 2
Picture 3-5: The NIRA EGTC sensor probe mounts where the headers collect, before the turbo.
All inputs to NIRA i7r, including the Aux inputs, can be filtered using the “Advanced”
setting in NIRA rk.
Sometimes this is useful when dealing with noisy input signals in order to improve
readability during data logging.
Before applying filtering to MAP, MAT and TPS inputs, make sure that you have an
understanding of the effects of adjusting the filter. These input signals should normally
never need to be filtered.
VGT or VNT turbines with position feedback and bidirectional drive is supported.
Se the boost control chapter for more information.
Smart actuators with built in position feedback is used at some applications. The
actuator do only need PWM signal where duty cycle refers to requested position.
W
Turbine
Boost R
Actuator Engine
Compressor
C
Throttle
Air Cleaner
Boost control valves have three port and two or three connection pins
NIRA i7r controls the boost pressure actuator by giving the valve a PWM-signal. A
pressure drop that depends on the PWM-signal is created over the R-port and thus
the pressure that reaches the waste gate actuator is controlled. NIRA i7r can be
0% duty 100%
duty
Bypass flow through the Boost Pressure Actuator dependent on the PWM through the actuator coil
Boost control valves either have two or three connection pins. The type of waste gate
used and the type of boost control valve determines how the valve should be
connected.
Connection of the sourcing and ground cables is arbitrary on two pin valves. If the
waste gate clock gives a higher boost pressure when the W-port has a lower pressure,
the cables can be connected according to the table below. The table below assumes
that the boost control valve is made for 12 V sourcing.
Regular Waste Gate Clock
Pin 1 Boost Actuator supply
Pin 2 Boost Actuator
Kl 86 Kl 85
Kl 30
4
NIRA rk Software
NIRA rk is used to calibrate NIRA i7r. NIRA rk is also used to log data for subsequent
analysis while the engine is running. By using NIRA rk and applying your knowledge of
engine tuning you can prepare for the calibration effort by entering certain
parameters for your specific engine. This gives you a base calibration which will save
you time later when you connect NIRA rk to NIRA i7r.
NIRA rk installs on a PC and connects to NIRA i7r via the Kvaser CAN dongle
connected to your USB port.
To install NIRA rk on your PC, execute the NIRA-rk.exe file supplied on the memory
stick that is part of your NIRA i7r package. This will launch the NIRA rk Setup Wizard,
which will guide you through the installation process. Follow the directions in the
dialog boxes.
Once the installation is finished, NIRA rk i7r Street should be listed in your “programs”
list on the start menu. The NIRA rk icon launches NIRA rk.
Click on the Nira RkMotorsport icon in the installation directory (default is C:\Nira).
Once you have launched NIRA rk, you will see the Welcome Screen.
In this screen you can choose among several options. Open File... lets you open an
existing i3d file (a file with calibration data.) Read from NIRA i7r loads calibration data
from NIRA i7r into NIRA rk. Start from Default starts NIRA rk with default settings.
If you are using an i3d-file supplied by your NIRA dealer, it’s recommended that you
first make a copy of the file before making any changes. This way you can always
return to the original file.
If you select ”Start from Default”, NIRA rk will start in a default mode and all
adjustments have to be done by you.
4.2.3 Wizards
If you opted to start NIRA rk in default mode (see previous section), you must go
through all Wizards before you can load any calibration data to NIRA i7r. This is
necessary in order to ensure that you’ve entered appropriate values for all Engine
Setup-parameters before you start mapping. Otherwise, the calibration effort may be
unsuccessful, should it turn out that you’ve been calibrating with inaccurate basic
engine setup parameters.
You can re-run any of the Wizards later, e.g. in order to read the extensive on-line
help available in the Wizards or if you’ve changed one of the sensors. All Wizards are
available under “Wizards” in the main menu.
Any changes you make inside a Wizard only become permanent after you’ve selected
”Finish” on the last page of the Wizard. You can cancel out of the Wizard at any time
by closing the window (clicking on the “X” in the top right hand corner of the
window.)
It’s very important that you go through all pages of all Wizards and enter
correct values.
Once you’ve gone through all Wizards and entered correct values, it’s recommended
that you save all current settings as an i3d-file. Use “Save As...” under ”File” in the
main menu, or hit F4. Try to give the i3d-file a descriptive name, perhaps including
the date, since this will make it easier to find the file later.
Before attempting to connect to NIRA i7r, ensure that the drivers for the Kvaser USB-
CAN dongle are installed on your computer. These drivers are available on the USB
stick delivered together with NIRA i7r.
If you can’t connect to NIRA i7r, check the connection settings by clicking on
”Settings…”. This lets you choose the port to which NIRA i7r is connected. You can
also launch ”Auto Find Target”, which searches all ports and selects the one to which
NIRA i7r is connected.
A useful shortcut key to remember is F2. Holding down F2 brings up the Keyboard
Help dialog box. The dialog box shows what can be done in the current view (and
thus, it changes depending on the view.)
4.3.2 Tabs
NIRA rk uses tabs to organize different views of parameters, graphs, tables etc. When
a new window is opened a new tab is added. This allows for quick switching between
views. Each new tab gets a number in addition to a name.
You can switch tabs by clicking on the tab with the mouse or by hitting the G key on
the keyboard, which brings up the Change Page dialog box (see below) and then
selecting the desired tab using the up and down arrows on the keyboard. Shift-G
takes you directly to the next tab in order.
Picture 4-7: 'G' (or '5' on the numeric keypad with NumLock off) brings up the "Change Page" dialog
box.
You can close a tab by hitting Esc or right-clicking on the tab and selecting "Close".
The first five tabs can never be closed.
While in the Change Page dialog box, you can also close a page by selecting it and
hitting the Del key on the keyboard.
Parameter values written in green can be changed. Those written in black cannot.
At the left edge of the Mappings tab is a folder view of all available parameters. The
parameters are grouped into logical sets, such as Fuel, Ignition, Engine Start, etc.
Subfolders further separate calibration parameters to make it easier to find and access
the relevant parameters.
NIRA rk starts in Standard mode. If you feel that variables are missing you can select
Advanced mode from the drop down list at the top of the main window. This setting
exposes more calibration variables. It’s recommended that you leave the mode
setting as Standard.
4.4.2 Searching
You can search for a parameter by clicking on the magnifying glass icon ( ) or by
hitting F on the keyboard. To go to the next parameter matching your search
criterion, hit R.
You can search for multiple parts of a parameter name by separating the search
criteria with spaces. E.g. ”th po” gives you a match for ”Throttle Position” and "sens
la" would give you a match for “Lambda Sensor”. As you type in the letters, the
search result is updated continuously.
4.4.3 Alarms
In addition to the built-in diagnostic alarms in NIRA i7r, which, among other things,
check input signal levels, it’s possible to set user alarms using NIRA rk. Hit F5 or right-
click on a parameter and choose “Set Alarm…”
4.4.4 Flags
As a tool to mark parameters, e.g. which parameters still need calibration, there’s a
flag feature available. Flag a parameter either by clicking in the flag column of the
parameter or by clicking on the “Toggle Flag” button. Monitor parameters (see
section 4.4) cannot be flagged.
All parameters that have been flagged can be viewed in the “Flagged Items” folder in
the tree view to the left. Unflagged parameters can be viewed in the “Unflagged
Items” folder.
4.4.5 Favourites
You can add parameters to a special folder called “Favourites”. This lets you collect
parameters of particular interest for quick access later.
In order to change a parameter value, highlight it and then hit Enter on the keyboard.
Alternatively, double-click on the parameter name. If you’re online with NIRA i7r at the
time, any changes in the parameter value will be uploaded to NIRA i7r immediately.
Otherwise, the changes will be uploaded next time you connect to NIRA i7r.
Picture 4-10: Double-clicking or hitting Enter lets you change a parameter value.
The delta is unique for each parameter, so if you want the same delta to apply to a
number of parameters, you need to enter this value for each parameter.
4.4.7 Tables
Some parameter names are preceded by a grid icon ( ). This icon indicates that the
parameter is a table. Tables can be two- or three-dimensional.
Tables control output values from NIRA i7r based on other parameter values.
Typically these parameter values are sensor values, such as rpm or MAP.
Depending on the number of parameter values, the table is one- or two-dimensional.
A typical one-dimensional table is the engine temperature sensor. The output is a
function of a single parameter. When you map the temperature sensor you enter the
temperature for different sensor signal voltages.
Picture 4-11: A two-dimensional table; it uses rpm and MAP as input variables.
A two-dimensional table uses two input signals; one on the x-axis and one on the y-
axis. The output signal is a function of both input signals, e.g. rpm and MAP.
To edit tables, double-click on the parameter name or highlight the name and hit
Enter. A new tab will open up displaying the table contents.
As always, F2 opens a window that lists all possible functions in this view.
There are multiple ways of changing table values. One way is to edit the content of
each individual cell. Right-clicking on a table cell opens up a menu listing different
options for editing the value.
Picture 4-12: Enter the delta/ratio increase/decrease for the +, -, * and / keys.
The boxes above the table show the absolute increase/decrease of the cell values (for
the + or – keys) or the %-age increase/decrease of the cell values (for the * or / keys.)
In the case above, the value would increase with 0.1 if you hit the + key and increase
10% if you hit * key. If multiple cells are highlighted, they will all be affected.
Filling Cells
If multiple cells are highlighted, they can be filled with the same value using a few
different techniques.
Hit M to set all cells to the same value as the cell in focus. This cell is blue in
the picture above. The color may be different depending on the color scheme
chosen for Windows
Fill cells in one direction. It’s possible to fill cells to the right, to the left, upward
or downward. Choose direction by right-clicking and selecting “Fill >” from the
menu that opens up, or hit Ctrl-R, Ctrl-L, Ctrl-U or Ctrl-D respectively
More advanced fill patterns can be set up if you right-click and select “Fill
Series...” from the menu that opens up, or hit I on the keyboard. A dialog box
appears in which you can choose to interpolate horizontally or vertically, to fill
all cells with the same value or to fill the cells with stepwise increasing values in
different directions
To add more points, right-click on an axis value, use ”Insert Column...” or “Insert
Row…” respectively. You can also hit the Insert key on the keyboard. Both methods
bring up a dialog box in which the new axis value can be entered. Note that the new
value must be between the values to the immediate left and right or up and down.
The new column/row will automatically get interpolated table values, based on the
new axis value. This way, the overall calibration doesn’t actually change until you
change the table values explicitly.
Note: When a new column or row is added, the rightmost column or the bottom row will
fall off the edge.
The entire column or row will be marked green. Once you let go of the mouse button
or the Ctrl key, a dialog box will appear in which you can choose among different fill
methods.
Undo/Redo
It’s always possible to undo any changes you’ve made to a table. As long as the table
is open in a tab, NIRA rk remembers all changes and highlights any changed cells with
an orange frame.
You can also undo undo, as long as you haven’t made any new changes. This is called
redo and is only available if you’ve undone something at least once.
The standard Windows Ctrl-Z och Ctrl-Shift-Z shortcuts also work, as well as U for undo
och J for redo.
Copy/Paste
It’s possible to copy and paste cells within a table or between tables. You can also
copy and paste from other programs, such as Microsoft Excel.
When pasting cells, you have to mark the cells into which you want to paste data. This
is different from software such as Excel and offers a level of protection against
accidental changes.
Axis cells can also be copied and pasted. Mark the cells with Shift-Left arrow or Shift-
Right arrow or Shift-click with the mouseIt’s not possible to drag and drop with the
mouse due to the Drag Fill function described above.
Graphical View
By hitting the F5 key (NumPad: Ins) you can switch to a graphical view of a table.
The graphical presentation is different for one-dimensional tables and multi-
dimensional tables. Picture 4-17 below shows an example of the graphical view of a
multi-dimensional table where the two axes create a 3-D surface.
One-dimensional tables are shown as graphs. In the graph, the x-axis represents the
axis cells and the y-axis represents the table cells.
Picture 4-18: F5 or the "Toggle Graphics"-button switches to a graphical view of the table. This is a
one-dimensional table.
While in the graphical view, it’s possible to move among the cells and change their
value with the + and – keys, just like in the table view.
Picture 4-19: Jumping to the operating point using the Space key.
If ”Follow” is enabled (see above), or if you use Space to jump to the operating point,
four cells around the operating point will be highlighted. The operating point is
marked as a red bullet. If you use the +, –, / or * keys to modify the cell values, they will
be modified in a weighted fashion, with greater weight given to cells closer to the
operating point.
Example: In picture 4-19 above, the operating point is farther to the right than
the left and thus, when using the +, -, / or * keys to modify the values, the cells
to the right will be adjusted more than those to the left.
The operating point is visible in the graphical view as well and the same type of
adjustments described above can be made in the graphical view.
Saving/Opening Tables
It’s possible to save an individual table in a file, an mtx-file. This file can be opened
independently of the global i3d-file.
It’s also possible to associate a particular mtx-file with a quick-access button. There
are four round, green quick-access buttons to the left above the cells in any open
table. They are numbered 1-4. You make the associon by clicking on the small down-
arrow to the right of the corresponding quick-access button. The file can be loaded
later by clicking on the quick-access button, or by hitting Ctrl-1 through Ctrl-4 on the
keyboard.
A PID controller is named after the Proportional, Integral and Derivative control
modes it uses. PID controllers are used in most automatic process control applications
in industry and automotive. PID controllers can be used to regulate flow, temperature,
pressure, level, and many other industrial process variables.
Using a feed forward table is a prediction technique that estimates the output from
the proportional-integral-derivative (PID) control algorithm without waiting for the PID
algorithm to respond. If the feed forward prediction can estimate the control output
closely, the PID algorithm, whose job it is to minimize the error between the current
state of the system and the desired state, will need to do less to correct the error. This
reduces the error faster or keeps the error smaller than relying on the PID algorithm
alone.
The proportional factor is easiest to understand: The output of the proportional factor
is the product of gain and measured error. Hence, larger proportional gain or error
makes for greater output from the proportional factor. Setting the proportional gain
too high causes a controller to repeatedly overshoot the setpoint, leading to
oscillation.
The downside to a proportional-only loop is that when error becomes too small, loop
output becomes negligible. Therefore, even when the proportional loop reaches
steady state, there is still error. The larger the proportional gain, the smaller the
steady state error, but the larger the proportional gain, the more likely the loop is to
become unstable. This dilemma leads to inevitable steady-state error called offset.
Think of the integral factor as a basket in which the loop stores all measured error.
Remember that error can be positive or negative, so sometimes error fills the basket
(when positive error is added to positive error or negative error is added to negative)
and sometimes it empties the basket, as when positive error is added to negative, or
vice versa.
When the integral factor functions properly in the control loop, the basket is nearly
empty. Even when error is so small that the proportional factor is no longer effective,
the integral is still hard at work, collecting error until it is large enough to matter, as
part of the integral's function is to eliminate steady-state offset.
The derivative factor is the least understood and used of the three factors. In fact, a
majority of PID loops in the real world are really just PI loops. That does not negate
the fact that there are certain applications in which the derivative plays a very
important role. The proportional corrects instances of error, the integral corrects
accumulation of error, and the derivative corrects present error versus error the last
time it was checked.
In other words, the derivative is looking at the rate of change of the error. The more
error changes or the longer the derivative time, the larger the derivative factor
becomes. The effect of the derivative is to counteract the overshoot caused by P and
I. When the error is large, the P and the I will push the controller output. This
controller response makes error change quickly, which in turn causes the derivative to
more aggressively counteract the P and the I. A properly used derivative allows for
more aggressive proportional and integral factors. Larger derivative time makes the
derivative more aggressively dampen P and I.
4.6 Gauges
NIRA rk offers a number of different ways to view input signals, e.g. from sensors.
Sensor Bar is the name of the panel at the bottom of the screen. The selection of
parameters in the bar is fixed. However, there are a number of different Sensor Bars
available, each with a different selection of parameters. Switch among the different
types by hitting T on the keyboard until you find the appropriate one for your current
mapping situation. You can also hide the sensor bar, e.g. if you want the extra space
on the screen or if you feel that other parameters on the screen are updated too
slowly.
4.6.2 Dashboard
There’s a predefined dashboard in NIRA rk. It contains a few standard gauges. The
selection of gauges offer an easy general system check, and they’re also very useful to
display on your notebook computer when you’re testing NIRA i7r in a vehicle or dyno.
4.6.3 Panels
Unlike the Dashboard, the Panel tab is completely flexible. You can add any
parameter of interest in the form of a gauge. The selection of gauges can be saved as
presets so you can quickly switch among different panel setups.
Picture 4-22: The Panel tab allows you to add any parameter of interest.
To add a gauge to the panel, hit Ins on the keyboard or click on in the top left
corner.
Picture 4-23: By moving the mouse pointer over a gauge, display options are shown as buttons that can
be clicked.
In the Gauge, Plot and Bar modes, there’s a ”Set” button. Double-click on it or hit
Enter to modify the range of the gauge or to revert to the default range.
As always, F2 opens a dialog box listing all possible short cut keys.
4.7.1 Inspect
At the heart of the logging function is a function called Inspect. Inspect allows you to
select a set of parameters at which you want to take a closer look, e.g. by logging
them.
Parameters being inspected are shown with min and Max values, even when actual
logging isn’t active. This can be useful when you calibrate your engine.
Inspect resides in a separate window at the bottom of the screen. The window has
three display modes; full view, partial view and minimized view. You can cycle through
the modes with F6, or by clicking on the Zoom button at the far right of the Inspect
window. You can also resize it by clicking and dragging the top of the window up and
down.
Picture 4-24: Inspect. Cycle through the different display modes using F6 or the Zoom button.
Selecting Parameters
To add a parameter to the Inspect window, highlight it in the Mappings tab and click
on the ”Add to Inspect” button at the top of the window, alternatively hit I on the
keyboard.
If you would like to add more parameters from within the Inspect window, you can use
the -button. To remove a parameter, use the Del key on the keyboard or use the
-button.
To start logging of the parameters in Inspect, hit F8 on the keyboard. This can be
done from anywhere in NIRA rk, whether you’re calibrating a table, showing gauges or
reading help screens.
Note: When logging is active, no parameters are updated in NIRA rk. The reason is
that NIRA rk instead tries to sample the logging parameters as fast as possible. The
operating point is updated, though, and all alarms are still active.
Parameter values that aren’t being updated while logging is active change to dashes,
"--", so you can always trust any number that’s shown.
Picture 4-25: The top of the Inspect window turns red when logging is active.
To stop logging, hit F8 on the keyboard. This will also open up a dialog box, which
gives you the option of saving the log as a file for later analysis.
You can open an existing log file by selecting ”Load log file…” under File in the main
menu or by hitting Ctrl-F8 on the keyboard.
Note: You can also load NIRA rk log files in MATLAB.
Data from multiple parameters can share the same plot window. Each parameter has
its own, adjustable y-axis at the left edge of the window.
Removing an Axis
Removing an axis (and the associated sampled parameter) can be done by clicking on
the X at the top right corner of the axis in question. You can deactivate an axis by un-
checking the checkbox to the immediate left of the Set-button at the bottom of the
axis.
Adding an Axis
To add an axis, click on .
Positive values will be added to the boost setpoint and negative values will subtracted
from the boost setpoint.
If open loop control is used there is a correlating table for that.
NIRA i7r controls Fuel Mass, Injection angles for two injections (Pilot and Main) and
Fuel Pressure.
Example:
The FMSP Fuel Mass Setpoint [Requested Fuel Mass] = 30%
Bv Fuel Mass Cycle Max = 600 mg/cycle
Bv Cylinder Count = 6 [numbers of cylinder]
The fuel mass injected each cycle (2 revolution) is calculated:
600mg/cycle * (30% / 100) = 180 mg/cycle
The fuel mass injected each stroke (eg. per cylinder)
180 mg/cycle / 6 = 30 mg/stroke
Fuel Pressure Control (FPC) and Boost Controller (BC) will relate to the percentage
fuel mass.
5.1.1 Demand
Engine
Engine
Speed
Speed
Demand
Controller
-ESC
-ESC FMR
Setpoint
Torque / Speed
- demand
A
IF Limitation
Fuel Mass
Torque B
B> Setpoint
Demand A
-Demand
FMR
A number of limitations will be compared to the requested fuel mass. If any limitation
requests less fuel mass, this limitation will take effect.
Limitation due to
− Manifold air Temperature
− Coolant Temperature
− Oil Temperature
− Ambient air pressure
− Ambient air temperature
− Smoke (e.g. a certain A/F)
− Exhaust gas temperature.
− Engine speed (e.g. over speed or rev limit)
− Fuel Mass Rate of change
2D
Va FML Torque AP
Ambient Air pressure
FML Torque FMR max AP
2D
Va FML Torque ECT
Coolant temperature
FML Torque FMR max ECT
2D
Va FML Torque EOT
Oil temperature
FML Torque FMR max EOT
2D
FMSP
FML Smoke lim af
2D
100 % +
+
FML ExTemp FMR max
Ca FML ExTemp Int Max 0
P-term
BV_FMR_Setpoint
∑
2D
+
+
Va FML ExTemp Max +
-
I-term
Exhaust Temperature
Ca FML ExTemp Int Max
Matrix and labels related to the Fuel Mass Setpoint Change Rate
Mappings -> 1. Fuel -> 1. Basic -> FMSP xxx
− FMSP Change Rate Max [FMSP Rate Of Change Limitation]
− FMSP Change Rate Min [FMSP Rate Of Change Limitation]
Cyl 1 Tdc
Main injection angle, when no Pilot injection is active, is mainly controlled by the
table:
Mappings -> 1. Fuel -> 1. Injection Control -> Inj Angle Main.
Positive angles is Before TDC
Three different compensations can be added to the main angle
When the fuel mass for the pilot makes the injection time greater than the minimum
injection time, the pilot injection will be executed.
When the pilot is active, the system will immediately switch over to use the
“Inj Angle Main2” table.
Main injection angle, when Pilot injection is active, is mainly controlled by the table:
Mappings -> 1. Fuel -> 1. Injection Control -> Inj Angle Main2
Positive angles are indicate positions before TDC
Three different compensations could be added to main angle
Matrix and labels related to the Injection angles without pilot injections
Mappings -> 1. Fuel -> 2. Injection Control-> Inj xx
− Inj Angle Main [Inj angle main based on Requested fuel and Engine
Speed]
− Inj Angle Main Boost [Boost Error Max Ange Comp]
− Inj Angle Main Boost factor [% of Maximum Boost Error angle to be used]
− Inj Angle Main ECT Comp [ECT Max Angle compensation]
− Inj Angle Main ECT Factor [% of Maximum ECT angle to be used]
− Inj Angle Main Comp. [General Compensation based on Fuel temp,
Ambient Pressure and Manifold Air Temp]
Matrix and labels related to the Injection angles with pilot injections
Mappings -> 1. Fuel -> 2. Injection Control-> Inj xx
− Inj Angle Main2 [Inj angle main based on Requested fuel and Engine
Speed]
− Inj Angle Main Boost [Boost Error Max Ange Comp]
− Inj Angle Main Boost factor [% of Maximum Boost Error angle to be used]
− Inj Angle Main ECT Comp [ECT Max Angle compensation]
− Inj Angle Main ECT Factor [% of Maximum ECT angle to be used]
− Inj Angle Main Comp. [General Compensation based on Fuel temp,
Ambient Pressure and Manifold Air Temp]
− Inj Angle Pilot 1 [Inj angle pilot based on Requested fue and
Engine Speed]
− Inj Angle Pilot 1 ECT [ECT Max Angle compensation]
− Inj Angle Pilot 1 ECT Factor [% of Maximum ECT angle to be used]
− Inj Angle Pilot 1 Comp. [General Compensation based on Fuel temp,
Ambient Pressure and Manifold Air Temp]
− Inj MassPilot 1 [Inj mass pilot based on actual fuel mass/stroke and
Engine Speed]
− Inj Mass Pilot 1 ECT [ECT Max Mass compensation]
− Inj Mass Pilot 1 ECT Factor [% of Maximum ECT Mass to be used]
ECU
Pressure
Control vale
Fuel tank
Fuel
≤ Ambient air pressure
Electrical
Electric wire
The function for calculating the fuel pressure set point is described below. The
function uses a base value and ad user defined corrections.
There are corrections for
Engine coolant temperature
Fuel temperature
Manifold air pressure
Manifold air temperature
Fuel pressure setpoint has a total maximum and minimum limitation and a rate limiter.
FPC_PS_Max FPC_PS_Rate_Max
RPM 2D RATE
+ + + + Fuel Pressure Setpoint
+ + + +
Fuel Mass Request
1D
Colant temperature
1D
IAT
1D
Fuel Temperature
1D
MAP
The layout of the FPC PID follows Nira General PID controller (see Appendix A).
The PID controller output is transferred through a linearization matrix which makes it
possible to both invert the output and compensate for non-linear behaviour of the
actuator as well as changing battery voltage which affect the current going through
the actuator coil.
In the software labels and matrixes marked
PCV refers to PID controller and output CCO3
VCV refers to open loop and the output CCO4
BV_Fuel_pressure >
FPC_PRS_Pressure
OR
BV_Engine_speed >
FPC_PRS_Engine_speed
0
0
FPC Integrator
FPC Integrator
1
FPC_PRO 0
2D
va_DO_CCO3_duty
Battery Voltage
1
FPC PCV Linearization
RPM 0
2D
va_DO_CCO4_duty
Input/sensors
Engine Setup -> Sensors -> xxx
Actuator Control
Mappings -> 1. Fuel -> 4. Pressure Control -> xxx
− Fpc VCV Duty [Duty cycle for the VCV-valve (open loop)]
− Fpc VCV Duty Max Rate [Duty cycle maximum rate of change]
− Fpc VCV Period [Period time for VCV valve]
The NIRA i7r boost control calculates a regulator output using a closed loop PID
controller. The regulator output can be used to control either a vacuum valve or a
electric motor actuator, the latter is commonly used on e.g. VGT turbo systems.
The boost actuator output.
Mappings -> 3. Boost Control -> 1. Fixed Duty -> Bac OutX Ctrl Mode
0 – Fixed duty.
Control the duty with Bac OutX Fixed Duty
1 – Open Loop.
The output from the Boost Controller is transferred through the
o BAC Out Setp Scale
o BAC Out Setp Sclae Comp
2 – Closed Loop
The output from the Boost Controller is transferred through the
o BAC Out Setp Scale
o BAC Out Setp Sclae Comp
And used as an input to the position feedback PID controller
PID 2
Bac OutX Max
1D
BC Reg Output + Bac OutX Setpoint
+
Bc Setp Boost 2D
Engine Speed
BAC OutX Setp Scale Comp
The Manifold boost setpoint is chosen from a matrix as a function of fuel and rpm. It’s
corrected by air temperature and air pressure. The function includes a PI regulator
that limits the compressor outlet temperature by limiting and reducing the boost
setpoint. Last calculation is a rate of change handler limitation.
Boost Setpoint
The Surge protection will indicate surge mode through a Boolean label. The purpose
is to open up the boost actuator when the pressure ratio is high and the fuel is
decreased
BC_surge will handle a timer for how long the surge label can be set to TRUE. Time
out or increment rate of fuel over a limit value will set the surge label to FALSE.
7
Starting the Engine
If you’ve read the previous chapters and followed the installation instructions, NIRA i7r
should be installed in your vehicle and you have an understanding of how NIRA rk is
used. This chapter describes how to start the engine in a safe manner.
Warning! It is absolutely essential that you set up all parameters correctly under the
Engine Setup tab. Failure to do so can easily cause permanent damage to your
engine, and also cause risks of personal injury.
It’s essential that the Crank & Cam settings are set properly to get synchronization of
the Crank & Cam relationship. All labels in the “Crank Cam” folder are named with
the prefix “Tpu”. This means that they are handled by a dedicated part of the CPU.
Changing these labels implies that KEY has to be switched off and on for the changes
to take effect.
Crank and cam related labels are found under.
Scope picture of 24-1 crank wheel and a cam wheel with one tooth
Example. The picture shows a scope picture of two crank revolutions with Hall
sensors at both crank and cam.
It is a 24-1 wheel. Every tooth is 360/24 = 15 degrees/tooth
Tpu Crank Lost Teeth should be set to 1
Tpu Crank Polarity is Falling. The system looks for the first falling edge after the
lost gap. (see red vertical lines)
Tpu Crank Sensor Select should be set to Hall
Tpu Crank Total Teeth should be set to 24-1 = 23
The blue opaque field shows an area where the cam shaft sensor gives a rising
edge
Tpu Cam Sensor Select should be set to Hall
Tpu Cam Window Start correspond to teeth nr 6: 6 * 15 = 90 degrees
Tpu Cam Window With correspond to teeth nr 4: 4 * 15 = 50 degrees
Tpu Cam Polarity correspond to the cam signal transition from low to high level
within the blue field: Rising
Engine Specifications is related to the engine hardware. Values entered in this section
are used for air mass, fuel mass calculations and cylinder individual timing.
Bv Cylinder Count
The numbers of cylinders
Bv Key Source
0 = Normal Key operation by ignition key.
1 = Key input sent by CAN, contact Nira for more information.
Demand Mode
Torque = Acceleration Pedal Position is used for to demand a fuel mass.
Speed = Acceleration Pedal Position is used for to demand an engine speed setpoint.
Example of a four cylinder engine with symmetrical firing order 1-3-4-2 and 90 degrees offset to tdc at
cylinder 1.
Example. The picture shows a scope picture of two crank revolutions of an inline,
four cylinder, engine.
It is a 24-1 wheel. Every tooth is 360/24 = 15 degrees/tooth
Tpu Tdc Cyl1 from Lost Teeth. In this case the relationship between crank wheel
mounting made the offset to 90 degrees (6 teeth).
The fuel injector parameters are used control the injectors and calculate the injector
opening time based on the requested fuel volume.
The setup differs if you have a piezo injector version (i7rp) or if you have a solenoid
version (i7rs).
Injector Conv
The Injector conversion table is used to convert actual fuel pressure and requested
fuel volume to the injection time.
The injector has to be measured in a test rig to determine the injector characteristic.
It’s crucial that injector drivers is properly set up to make the injector correspond to
the Conv table
The Injector Conv is individual for each type of injector.
Contact Nira for more information
Fuel specifications are used to recalculate the Fuel mass to Fuel Volume, and to
calculate the A/F-based smoke limitation.
All sensors that are necessary for engine control are found in this category.
Pressure Sensors
Enter the minimum and maximum defined voltage in the x-axis. Enter the
corresponding pressure to the minimum respectively maximum voltage in the table.
Pressure output will be linearized for voltage measurement in between the min and
max voltage value. Note: It’s only allowed to edit axis value while you’re offline.
Each pressure sensors has a low pass (LP) filter possibility for smoothing out and
filtering disturbances.
The filter constant for the LP filter is named Bv XX Pressure Filter. The unit is mS and
values between 0 and 3276,7 mS are allowed.
Temperature sensors
Characterize the temperature sensor by entering the correct temperature for the given
resistance.It’s possible to adapt both axis value and table value to achieve the right
sensor curve.
Note: It’s only allowed to edit axis value while you’re offline.
Relay Control uses hysteresis. The Relay Control only switches when the matrix output
is one or zero.
The red arrow shows direction of movement in Fan relay matrix when Coolant temp increases
To activate the relay output, the output from the matrix has to reach 1. In the example
matrix above, the coolant temperature has to reach a temperature higher than 90
degrees Celsius to enable relay activation.
For deactivation the matrix has to reach an output equal to zero. In the example
matrix above, the relay output will stay active until the temperature reaches a value
lower than 80 degreases Celsius.
Between 80 and 90 degrees the output from the matrix will be in between one and
zero and the output will not be affected.
Change the values in the matrix axis to achieve a more narrowband hysteresis.
2. At the top of the main window in NIRA rk is the online/offline status bar. In
order to go online, click on the little green flash icon in the top left corner of
the main window in NIRA rk. If the parameters in NIRA rk are different from the
parameters previously uploaded to NIRA i7r, you will see the following
dialogbox:
3. Select Update NIRA i7r in order to upload all the data to NIRA i7r. This may
take as long as two minutes.
Later you can select Read NIRA i7r if you want to download all the settings
from NIRA i7r into NIRA rk so you can save them as an i3d file. (This is very
handy if, for some reason, your PC were to hang while you’re in the middle of
calibrating the engine since you can always go back and download the most
recently used calibration.)
4. Once you have uploaded the data to NIRA i7r, the system goes online, the
status bar changes colors to green and the text changes to Online.
5. When the system is in the Online mode, it’s important to first go to the
Mappings tab and select the Monitor Output folder in the tree to the left and
then select Alarm and DG Hst Fault. If any value in the table differs from 255 an
error code is set.
7. Go back to the Mappings tab, select the Monitor Output folder and the
”General” subfolder. Make sure all sensors are calibrated correctly. If they are
not, return to the Engine Setup tab, select the Sensors folder and correct the
problem.
ECT and MAT sensor values should show ambient temp, or else they’re
calibrated wrongly.
MAP should say approximately 100kPa, which is ambient pressure.
You can now start the engine. Select Toggle Dashboard under the Tools menu in the
main menu, or hit the F7 key. Crank the engine. You should see the tach needle jump
up to about 200 rpm or else the CKP sensor signal is missing and you won’t be able to
start the engine.
Your engine should start fairly quickly and show reasonable values on the dash. If any
instrument is showing an unreasonable value or if an Alarm icon appears, something is
wrong in one of the parameters in Engine Setup, or the electrical installation is
problematic.
8.1 Input
Vinput_min = 6V
12v supply Vinput_max = 32V Pull Up 4.7 kohm
Vinput_transient = 70V during 0.5s
Vstartup = 8V
224.7 kohm in parallell with 0.01
Vshut_down = 2 V, software
KEY mA sink current
override possible
Ambient air temp sig Rnominal = 2-3 Kohm @ 25°C Pull Down 100 kohm 12 bit A/D
AS7 Input voltage range 0-5V Pull Down 100 kohm 12 bit A/D
Aux Ainput 2 signal Input voltage range 0-5V Pull Down 100 kohm 12 bit A/D
Aux Ainput 3 signal Input voltage range 0-12V Pull Down 100 kohm 12 bit A/D
Aux Ainput1 Input voltage range 0-5V Pull Down 100 kohm 12 bit A/D
Aux temp 6 signal Rnominal = 1 Kohm @ 25°C Pull Up 1.5 kohm 12 bit A/D
Boost temperature Rnominal = 2-3 Kohm @ 25°C Pull Up 3.0 kohm 12 bit A/D
Coolant temp signal Rnominal = 2-3 Kohm @ 25°C Pull Up 3.0 kohm 12 bit A/D
Fuel Pressure Signal Input voltage range 0-5V Pull Up 4.7 kohm 12 bit A/D
Fuel temp sig Rnominal = 2-3 Kohm @ 25°C Pull Down 100 kohm 12 bit A/D
MAP signal Input voltage range 0-5V Pull Down 100 kohm 12 bit A/D
MAT signal Rnominal = 2-3 Kohm @ 25°C Pull Up 3.0 kohm 12 bit A/D
Oil pressure signal Input voltage range 0-5V Pull Up 3.0 kohm 12 bit A/D
Oil Temperature signal Rnominal = 2-3 Kohm @ 25°C Pull Up 3.0 kohm 12 bit A/D
APP 1 signal Input voltage range 0-5V Pull Down 100 kohm 12 bit A/D
APP 2 signal Input voltage range 0-5V Pull Down 100 kohm 12 bit A/D
8.3 Communication
Electric
Communication Type Comment
charachteristic
Actual Value
(measured)
2D
P-term
2D
+
Integrator
Integratorhandling
handling
+
+
I-term
2D
d
dt D-term
EXE_TIME
RPM
Feed Forward
Integrator MAX
2D 0
Setpoint
1
∑
I-term
Integrator MIN
Integrator Scale
= 2 ^ scale
Aritmetic shift
0 A
IF
B
A≠B
Tracking Error
Tracking Gain
Tracking scale
= 2 ^ scale
Aritmetic shift
Tracking
10
Appendix B