ncsdummy.pdf

(1340 KB) Pobierz
NCS DUMMY VERSION 0.6.0.4
COPYRIGHT © 2014 REVTOR
NCS Dummy – Taking the expert out of NCS Expert
NCS Dummy should make life with NCS Expert a bit easier. NCS Dummy parses keyword trace files
(
FSW_PSW.TRC
) or nettodata trace files (
NETTODAT.TRC
) and retrieves all possible parameters, control unit
data and order options for each function. The parsed trace files can be viewed and modified in a graphical
trace editor or exported to text files. NCS Dummy can be used to compare two trace files and show the
differences. Furthermore NCS Dummy can disassemble and assemble NCS Expert data files to achieve
functionality that is not possible with a stock NCS Expert installation.
This user manual is for
NCS Dummy version 0.6.0.4.
Always check the NCS Dummy thread at
bimmerforums.com (
http://forums.bimmerforums.com/forum/showthread.php?t=1553779
) to make
sure you have the latest version of both application and user manual.
If you find bugs or experience any problems with NCS Dummy, please post to the NCS Dummy thread at
bimmerforums.com or contact the author at
. When reporting bugs, always include the
NCS Dummy log (right click on the log and select "Copy Log" from the menu to put the entire log on the
clipboard) and if applicable the keyword trace file (
FSW_PSW.TRC
) or nettodata trace file (
NETTODAT.TRC
) you
are trying to parse. Please stay on-topic - NCS Dummy only! Questions concerning where to get or the usage
of NCS Expert, what parameters to change to achieve certain functionality on your car,... will not be
answered!
-1-
NCS DUMMY VERSION 0.6.0.4
COPYRIGHT © 2014 REVTOR
1. Table of Contents
1. Table of Contents .............................................................................................................................................2
2. Downloading and First Start .............................................................................................................................3
2.1. Reset Configuration ...............................................................................................................................4
2.2. Uninstall .................................................................................................................................................4
3. Modules and Traces..........................................................................................................................................5
3.1. Module Functions ......................................................................................................................................5
3.1.1. Translations ........................................................................................................................................7
3.1.2. Control Unit Data ................................................................................................................................8
3.1.3. Order Options .....................................................................................................................................9
3.1.4. Adding New Parameters ...................................................................................................................10
3.2. Trace Functions........................................................................................................................................11
3.2.1. FSW/PSW ..........................................................................................................................................14
3.2.2. Nettodata .........................................................................................................................................15
3.2.3. Adding custom data ..........................................................................................................................16
3.3. Trace Differences .....................................................................................................................................17
3.4. Searching in the Graphical Trace Editor ..................................................................................................20
3.4.1 Shortcut Keys for Search ...................................................................................................................21
3.5. Filter Modules by Keyword......................................................................................................................21
3.6. Filter Modules by Trace File ....................................................................................................................22
4. Disassembly and Checksums ..........................................................................................................................23
4.1. DATEN files ..............................................................................................................................................23
4.1.1. Disassembly and assembly of DATEN files .......................................................................................23
4.1.2. Updating checksums in ZST files .......................................................................................................26
4.2. NFS files ...................................................................................................................................................26
4.2.1. Updating checksums in NFS files ......................................................................................................26
5. Options ...........................................................................................................................................................28
6. NCS Expert ......................................................................................................................................................30
6.1. Reading FSW_PSW.TRC and NETTODAT.TRC trace files..........................................................................31
6.2. Coding modules with FSW_PSW.MAN trace manipulation file ..............................................................32
6.3. Coding modules with NETTODAT.MAN trace manipulation file .............................................................32
6.4. Common NCS Expert errors .....................................................................................................................33
7. Examples .........................................................................................................................................................34
7.1. Digital speed display in the instrument cluster .......................................................................................34
7.2. Video in motion for the iDrive Professional Navigation (CIC) .................................................................35
8. Changelog .......................................................................................................................................................38
-2-
NCS DUMMY VERSION 0.6.0.4
COPYRIGHT © 2014 REVTOR
2. Downloading and First Start
First of all make sure your system meets the minimum requirements for NCS Dummy:
Microsoft Windows XP or later
Microsoft .NET Framework 3.5 Service Pack 1 or Microsoft .NET Framework 4
Minimum display resolution of 800x600 for Windows XP/2003, 1024x768 for Windows
Vista/2008/7/8 (at 96 dpi - higher dpi settings require higher resolutions)
Local or remote access to the NCS Expert "DATEN" folder
Download NCS Dummy
(
http://revtor.be/ncsdummy/ncsdummy.zip
) and extract the contents of the
downloaded archive to a local folder on your hard disk. Double-click
NcsDummy.exe
to start the application.
If NCS Dummy throws an application error,
"The application failed to initialize properly (0xc0000135)",
you
are missing the .NET Framework. Download and install the Microsoft .NET Framework 3.5 Service Pack 1
(
http://www.microsoft.com/en-us/download/details.aspx?id=22
) or Microsoft .NET Framework 4
(
http://www.microsoft.com/en-us/download/details.aspx?id=17113
). If you do not yet have the
Microsoft .NET Framework installed and don't need other applications that use framework, it doesn't really
matter which version you install. If your computer is running an older version of the .NET Framework NCS
Dummy will ask you to update to version 3.5 service pack 1.
On the first launch NCS Dummy checks for the existence of folder
C:\NCSEXPER\DATEN\
. If the path is not
found NCS Dummy automatically switches to the "Options" tab and asks to enter the path to the NCS Expert
DATEN folder. After the path has been set NCS Dummy is ready for use.
A lot of information in NCS Dummy can be exported to text files. By default NCS Dummy will open these text
files with Microsoft Notepad. If you have a third party plain text editor you prefer, like Notepad++ or
UltraEdit, now is a good time to set this in NCS Dummy. Point "Path to custom text file viewer" on the
"Options" tab to the text editor's executable and (if necessary) specify the text editor's command line
arguments in "Text file viewer arguments" (the default
"%1"
works for most applications).
While the NCS Dummy graphical trace editor is quite comfortable to use in Windows XP/2003 on a 1024x768
pixels display (at 96 dpi), the larger scaling of Windows Vista/2008/7/8 leaves only a limited amount space
available to the graphical trace editor. If you have such a small display and want to squeeze out a few extra
rows in the graphical trace editor, launch NCS Dummy with command line argument
/smalldisplay
:
NcsDummy.exe /smalldisplay
This will slightly decrease the font size (on Windows Vista/2008/7/8) and reduce the log height to maximize
the available space for the graphical trace editor. It's not a huge difference but can really make a difference
on small displays. If you like the result create a shortcut to the NCS Dummy executable that appends this
argument.
-3-
NCS DUMMY VERSION 0.6.0.4
COPYRIGHT © 2014 REVTOR
2.1. Reset Configuration
NCS Dummy remembers its settings, window size and location between sessions by saving the information
to the Windows Registry. You can reset the NCS Dummy configuration by deleting registry key
HKEY_CURRENT_USER\Software\revtor\NCS Dummy\
or launching NCS Dummy with command line
argument
/reset
:
NcsDummy.exe /reset
2.2. Uninstall
You can uninstall NCS Dummy by removing files
NcsDummy.exe
,
NcsDummy.exe.config
,
Translations.csv
and deleting registry key
HKEY_CURRENT_USER\Software\revtor\NCS Dummy\
. Alternatively launch NCS
Dummy with command line argument
/uninstall
:
NcsDummy.exe /uninstall
-4-
NCS DUMMY VERSION 0.6.0.4
COPYRIGHT © 2014 REVTOR
3. Modules and Traces
There are three main scenarios of use for NCS Dummy Modules and Traces:
Module Functions
- Without a trace file loaded the graphical trace editor can be used to view what
coding functionality a module offers. In this mode it's even possible to add new parameters to
functions and update the NCS Expert data files with these changes.
Trace Functions
- Once a trace file is loaded in NCS Dummy, the graphical trace editor shows the
currently selected coding options with checkboxes. If you want to make changes to the coding, select
the desired options with the checkboxes and then export the modified trace file for coding with NCS
Expert.
Trace Differences
- When loading two trace files the graphical trace editor shows the differences
between both.
Starting from NCS Dummy 0.6.0.0 the graphical trace editor is no longer limited to viewing traces only but
because the component is commonly known by that name this manual will keep referring to it as graphical
trace editor even when no trace is displayed.
3.1. Module Functions
After selecting a chassis and module NCS Dummy is in the module functions mode. In this mode you can
view the coding functionality of a module.
-5-
Zgłoś jeśli naruszono regulamin