|
|
|
Mode | Description |
($01) | Request ALDL data frame |
($02) | Memory dump (64/2 byte address) |
($03) | Examine memory (2 byte address) |
($04) | Device control |
($08) | Suspend chatter |
($09) | Resume chatter |
($0A) | Clear diagnostic trouble codes |
Code
A unique code that identifies the request. EFILive V4 labels requests with
this code to identify them during macro editing.
Description
A short description of the request's purpose.
Reply
Check this field if the module to which the request is addressed will send a
reply frame.
Process
Check this field if the reply frame should be processed as part of the
logged data. Typically only replies from mode $01 requests should be processed
as logged data.
Frame length
If this frame is defined for 160 baud ALDL data then the number of bytes in
the frame, exclusing the Start Of Frame (SOF) marker, must be specified here.
This value is usually around 20-30 bytes. Any value entered will be ignored for
8192 baud ALDL data.
Parameters
Parameters are used to provide information to requests.
Mode $01 requests require one parameter; the table number of the data that is being requested. The table number is specified as a single decimal or hexadecimal number. In the above example table $00 is being requested.
Mode $02 requests only return 64 bytes of memory. To create a macro that returns larger blocks of memory, EFILive needs to be able to automatically increment the request parameters to retrieve multiple contiguous 64 byte blocks of memory. To achieve this, four address placeholders, :B1, :B2, :B3 and :B4 can be used. The address placeholders are replaced in the command frame by an address value, calculated by multiplying the macro item's iteration counter with the request's Factor and adding the request's Offset. (See Mode $02 below)
Override $XX
Mode
$04 command parameter values need to be changed often, This can be achieved by
replacing the parameter to be changed with the value placeholder: $XX (:XX also
is acceptable). When you double click on the macro item that invokes the request
you will be prompted (if the prompt field is not empty) to supply a value that
will be used to replace the $XX value placeholder. (See Mode $04 below)
Units
The units of the override parameter.
Factor
The multiplication factor to be applied to the user supplied parameter value
before it replaces the $XX value placeholder or the :Bn address placeholders.
Offset
The offset to be added to the user supplied parameter value before it
replaces the $XX value placeholder or the :Bn address placeholders.
Prompt
The prompt that EFILive will display to the user when requesting the
parameter value to replace the $XX value placeholder.
Frame
The command frame that will be sent to the destination module when this
request is invoked by a macro item.
Comments
A longer description of the purpose of the request.
If this request is invoked by a macro item that has 256 iterations then it will dump a 16Kb block of memory from address $C000 to $FFFF inclusive.
The start
address is specified in Offset as 49152 ($C000).
The number of iterations
(256) is specified in the macro item that contains this request. 256 was chosen
because 256*64 bytes is 16,384 bytes which is the size of the block of memory
from $C000 to $FFFF.
The address placeholders :B2,:B1 are replaced with the starting address of the 64 byte block of memory that is to be retrieved. For each of the 256 iterations it is calculated as (iteration*64)+49152
The command frames that would be sent to the ECM when the macro is executed are shown below with the calculated addresses highlighted.
Iteration |
Command frame to be sent to ECM |
0 | $F4,$58,$02,$C0,$00,$F2 |
1 | $F4,$58,$02,$C0,$40,$B2 |
2 | $F4,$58,$02,$C0,$80,$72 |
... | |
253 | $F4,$58,$02,$FF,$40,$73 |
254 | $F4,$58,$02,$FF,$80,$33 |
255 | $F4,$58,$02,$FF,$C0,$F3 |
Requests that control (or override) the normal functioning of the ECM/PCM sometimes require the user to provide a value without resorting to changing the underlying request. To do this a number of fields must be set up:
The Override $XX field is used to specify the default override value.
If the Prompt field is not empty and if the user double clicks on the
macro item that invokes this request then the user will be "prompted"
to supply a new override value.
If the Prompt field is empty, double clicking will have no effect.
The value that is entered by the user is multiplied by Factor, added to Offset and then used to replace the $XX value placeholder in the command frame.
You can see the updated command frame by right clicking on the macro item and selecting "More info..."
Clear diagnostic trouble codes takes no parameters.
Copyright 1998-2006 EFILive Limited |