EfiO2Meter Commands

From efiHacks Wiki
Jump to: navigation, search

Contents

ASCII Data Commands Details

Since the efiO2Meter is serial data stream based with wireless bluetooth connectivity, we decided to keep the commands user friendly with a very basic token parser (64k code space keeps the pricetag low).
This way any user has the ability to control the efiO2Meter even from a terminal emulator.

Some of our Host Computer Applications have these ASCII commands already wrapped up in GUI form and the user only sets parameters and presses a button to transfer the settings. However the underlying mechanism is described here.

While the efiO2Meter has binary data package transfer ability to the host computer, the commands are simple 1 to 4 letter mnemonic type commands along with the required numeric parameters. Not all parameters are always necessary to input and the software remembers the previous parameters on a per command basis to make command repetition easier.
A parameter skip in favor of using the previous input, or default parameter, can be accomplished by using 2 token separators i.e. cmd , p0 , , p2.
Separators are most non alpha and non numerical chars. Multiple spaces count as one separator.
The whole command will get echoed and the command monitor typically repeats the command and it's parameters in function style mnemonic parentheses followed by a possible result and or error.
Use <cr> or <lf> or <cr><lf> to execute the command.
Ctrl-X erases a command line.
Ctrl-U repeates the previous command line.

Available commands :

Command descriptions showing an "e" at the end save the data in EE-Memory and have the ability to detect EE-Memory errors indicated by a non 0 value at the end of the repeated cmd mnemonics
Note : do not type the "e" since it's only for illustration purpose.

Letters in brackets indicate parameters.

Parameters :

cj, CJ125 or LSU 4.x channel selection, 0 or 1
sel, the command specific selection
min, max, dat0, dat1 ... minimum and maximum values
typ, the command specific type
ena, 0 = disable, 1 = enable

Command List

  1. HELP : or ? :
    List HELP Menu
  2. ECHO [ena] :
    Command ECHO enable
  3. ECLX [clr] :
    Error CLear and eXec flags
  4. HSTW [tiw] e
    Heater Set Time Warm-up, set the heater condense water evaporation warm-up time [tiw] (ms), min = 5000, max = 60000.
  5. HSCV [cj][sel][val] e
    Heater Set Control Value, set the heater PID [sel] = 0 P-Term or [sel] = 1 I-Term [val], min = 20, max 500.
  6. IAPI e
    In Application Programming ID, get the CPU part ID.
  7. IAPB e
    In Application Programming Boot, get the CPU Boot Code Version.
  8. IAPU e
    In Application Programming UID, get the CPU UID Words, used for board authentication.
  9. LSUC [cj][clr] :
    LSU Check errors, CJ125 error code (inverted), [clr] = 1 clears error
  10. LSUE [cj][ena] e
    LSU Eable CJ125 channel, only applies to dual channel units [ena].
  11. LSUS [cj][sen] e
    LSU Select LSU 4.x sensor type, LSU 4.9 [sen] = 1, LSU 4.2 [sen] = 0.
  12. LSUF [sel] e
    LSU Fuel sel, select fuel type display units [sel].
    Note : be aware that the LSUF index needs to match by measurement unit types (fuel type) and LSUR range index selection.
  13. LSUR [sel] e
    LSU Range sel, select 1 of 5 Measurement and PWM Analog Output Ranges [sel].
    Note : be aware that the LSUR range index selection needs to match the LSUF index by measurement unit types (fuel type).
  14. LSUV [cj][sel][min][max] e
    LSU Pwm Volt, set pwm-out and pwm-sim [sel] min / max voltages.
  15. LSUD [cj][sel][dat0][dat1] e
    LSU Data Set, set pwm-out and pwm-sim [sel] dat0 / dat1 lambda endpoints.
    Note : these LSUV... LSUD... command settings only applies to the LSUR = 4, Custom Measurement Range selection, LSUR command.
  16. AINV [idx][in0][in1] e
    Analog INput Volt, select the Input Voltage reference points for a linear 2 point calibration
  17. AIND [idx][out0][out1] e
    Analog INput Data, select the Input Data reference points for a linear 2 point calibration
  18. AINS [idx][sel] e
    Analog INput Set, sets the Input Data reference point for the currently measured input voltage
  19. RPMD [div] e
    RPM Divisor setup
  20. RPMA [acc] e
    RPM Acceleration config
  21. STRE [ena][tim] e
    STReam Ena, enable streamed data output (ASCII), this is mutually exclusive to the PKGE cmd and automatically disables it.
  22. PKGE [ena] :
    PacKaGe Ena, enable data package output (binary), this is mutually exclusive to the STRE cmd and automatically disables it.
  23. ASCI [ena] :
    ASCIi ena, this enables / disable the data package ASCII (debug) / binary format.
  24. ECLR [cj][clr] :
    Error CLeaR, Clear Errors (clr=1)
  25. RUN [run] :
    The RUN performs a measurement Start (run=1) / Stop (run=0)
  26. V33 [3v3] e
    Set the 3.3 V ADC reference Voltage.
  27. VBAT [v12] e
    not supported at this time.
  28. PADJ [cj][sel][adj] e
    Pwm ADJust calibration, used to trim zero-offset voltage
  29. PTST [cj][tst][tim] :
    Pwm TeST, used to select between normal operation and 3 factory analog diagnostic modes.
  30. PHTR [cj][mod][pwm] :
    Pwm HeaTeR, can be used to diagnose parts of the sensor heater circuit. referenced only for documentation completeness and please do NOT use it since it easy to heat-damage (burn out) the sensor heater and sensor circuitry.
  31. POUT [cj][mod][pwm] :
    Pwm analog OUTout
  32. PSIM [cj][mod][pwm] :
    Pwm analog SIMulation, calibration, test and diagnostic
    POUT and PSIM both share the same control code and are only different by the command mnemonic.
  33. RESC :
    RESet Config to Factory Defaults.
  34. RESR :
    RESet Reference Data to Factory Defaults.

PKGE and ASCII should not be used with terminal emulation software, since it's sole purpose is for high bandwidth communications to application software. This software will issue these commands to start it's packetized data transfer.

Note : there is only one fixed transmission speed, Baud Rate at 57600 Bd. Anything higher could possibly use processing power used for the analytical and measurement tasks at no real benefit.

Command Processing

There are 3 utility commands as follows.

HELP : or ? :

List HELP Menu.

ECHO [ena] :

Command ECHO enable.

ECLX [clr] :

Error CLear and eXec flags.

[clr] = 1, command clears the Erx flag and the Cmx Command Exec Count.
[clr] = 0 or omitting the [clr] parameter displays the Erx flag and the Cmx Command Exec Count only.

Sensor Heater Configuration

The Heater P-term and I-Term only serve the purpose to react to any major changes in the thermal sensor environment where it might be necessary to fine tune the PID heater control parameters.
Please DO NOT CHANGE anything unless you really know what you're doing, since more damage can be done then good in case of failures.

Any data changes in the Heater commands will be written to the EE-Memory.
Errors will be indicated as explained in each command example


HSTW [tiw] e

Heater Set Time Warm-up, set the heater condense water evaporation warm-up time [tiw] (ms), min = 5000, max = 60000. Any value outside of the min / max limits will be changed to the exceeded limit.

get data command example :

>hstw hstw () 07500 07500

typed cmd echo : hstw ... omitting the data parameter [tiw] selects the get data command type

parsed cmd and params : hstw () 007500 07500 ... the returned values show the result for both sensors, even the set command only provides as single set data for both sensors

set data command example :

>hstw 7500 hstw (07500) 0

typed cmd echo : hstw 7500 ... 7500 specifies 7500 ms sensor warm-up time

parsed cmd and params : hstw (07500) 0 ... the 0 at the end indicates no error

the new values will be stored in EE-Memory


HSCV [cj][sel][val] e

Heater Set Control Value, set the heater PID [sel] = 0 P-Term or [sel] = 1 I-Term [val], min = 20, max 500. Any value outside of the min / max limits will be changed to the exceeded limit.

get data command example :

>hscv 0 1 hscv (0, 1) 095

typed cmd echo : hscv 0 1 ... 0 selects sensor 0 as the target, 1 selects I-Term and omitting the data parameter [val] selects the get data command type

parsed cmd and params : hscv (0, 1) 095 ... 0 shows the selected sensor 0 as the target, 1 selects I-Term and the returned value 095 shows the [val] data result

set data command example :

>hscv 0 95 hscv (0, 1, 095) 0

typed cmd echo : hscv 0 1 95 ... 0 selects sensor 0 as the target, 1 selects I-Term and 95 as the value for new I-term

parsed cmd and params : hscv (0, 1, 095) 0 ... the 0 at the end indicates no error

the new values will be stored in EE-Memory

The Heater P-term and I-Term only serve the purpose to react to major changes in the sensor's thermal environment, and this change being very different from a standard exhaust pipe and standard fuel setup. Normally there is no need to deviate from the standard factory setting.

CPU Inquiry Commands

These CPU In Application Programming commands only provide CPU related data and no configuration is performed.

IAPI :

In Application Programming ID, get the CPU part ID.

get data command example :

>iapi iapi () 0x08020543 0

typed cmd echo : iapi ... cmd has no parameters

parsed cmd and params : iapi () 0x08020543 0 ... 0x08020543 is the CPU identifier and the 0 at the end indicates no error


IAPB :

In Application Programming Boot, get the CPU Boot Code Version.

get data command example :

>iapb iapb () 0x0502 0

typed cmd echo : iapb ... cmd has no parameters

parsed cmd and params : iapb () 0x0502 0 ... 0x0502 is the CPU Boot Code Version and the 0 at the end indicates no error


IAPU :

In Application Programming UID, get the CPU UID Words, used for board authentication.

get data command example :

>iapu iapu () 0x1818291f 0x53580254 0x4fa2b022 0xf5000003 0

typed cmd echo : iapu ... cmd has no parameters

parsed cmd and params : iapu () 0x1818291f 0x53580254 0x4fa2b022 0xf5000003 0 ... 0x1818291f 0x53580254 0x4fa2b022 0xf5000003 is the CPU UID and the 0 at the end indicates no error


LSU 4.x Sensor related Commands

LSUC [cj] :

LSU Check errors, CJ125 error code (inverted), [clr] = 1 clears error

get data command example :

>lsuc 0 lsuc (0) 0x00

typed cmd echo : lsuc 0 ... 0 selects sensor 0 as the target and omitting the data parameter

parsed cmd and params : lsuc (0) 0x00 ... 0 shows the selected sensor 0 as the target and the returned value 0x00 shows no CJ125 errors

set data command example :

>lsuc 0 1 lsuc (0, 1) 0x00

typed cmd echo : lsuc 0 1 ... 0 selects sensor 0 as the target and 1 as clear CJ125 errors

parsed cmd and params : lsuc (0, 1) 0x00 ...


LSUE [cj][ena] e

LSU Eable CJ125 channel, only applies to dual channel units [ena].

The dual channel daughter board support is already built into the Firmware and Host Control Application Software. However the physical board is still under design.

get data command example :

>lsue 0 lsue (0) 1

typed cmd echo : lsue 0 ... 0 selects sensor 0 as the target and omitting the data parameter

parsed cmd and params : lsue (0) 1 ... 0 shows the selected sensor 0 as the target and the returned value 1 shows the [ena] data result

set data command example :

>lsue 0 1 lsue (0, 1) 0

typed cmd echo : lsue 0 1 ... 0 selects sensor 0 as the target and 1 as the enable

parsed cmd and params : lsue (0, 1) 0 ... the 0 at the end indicates no error

the new values will be stored in EE-Memory


LSUS [cj][sen] e

LSU Select LSU 4.x sensor type, LSU 4.9 [sen] = 1, LSU 4.2 [sen] = 0.

get data command example :

>lsus 0 lsus (0) 1

typed cmd echo : lsus 0 ... 0 selects sensor 0 as the target and omitting the data parameter [xp] selects the get data command type

parsed cmd and params : lsus (0) 1 ... 0 shows the selected sensor 0 as the target and the returned value 1 shows the [sen] sensor type selection, 0 = LSU 4.2, 1 = LSU 4.9

set data command example :

>lsus 0 1 lsus (0, 1) 0

typed cmd echo : lsus 0 1 ... 0 selects sensor 0 as the target and 1 as the [sen] sensor type selection, 0 = LSU 4.2, 1 = LSU 4.9

parsed cmd and params : lsue (0, 1) 0 ... the 0 at the end indicates no error

the new values will be stored in EE-Memory


LSUF [sel] e

LSU Fuel sel, select 1 of 9 fuel type display units [sel] for both sensors.

Note : be aware that the LSUF index needs to match by measurement unit types (fuel type) and LSUR range index selection.

  • eLambda, /* 0 */
  • eO2Percent, /* 1 */
  • eGasoline, /* 2 */
  • eE85Ethanol, /* 3 */
  • eE100Ethanol, /* 4 */
  • eMethanol, /* 5 */
  • ePropane, /* 6 */
  • eDiesel, /* 7 */
  • eCustom, /* 8 */

get data command example :

>lsuf lsuf () 2 2 Gasoline

typed cmd echo : lsuf ... omitting the data parameter [sel] selects the get data command type

parsed cmd and params : lsuf () 2 2 Gasoline ... the returned value 2 2 shows the [sel] fuel type selection Gasoline for both sensors.

set data command example :

>lsuf 2 lsuf (2) Gasoline 0

typed cmd echo : lsuf 2 ... 2 as the [sel] fuel type selection for Gasoline.

parsed cmd and params : lsuf (2) Gasoline 0 ... the 0 at the end indicates no error

the new values will be stored in EE-Memory


LSUR [sel] e

LSU Range sel, select 1 of 5 analog output ranges [sel] for both sensors.

Note : be aware that the LSUR range index selection needs to match the LSUF index by measurement unit types (fuel type).

  • eLambda_065_150, /* 0 */
  • eLambda_100_1000, /* 1 */
  • eAirFuelRatio, /* 2 */
  • eO2percent, /* 3 */
  • eCustom, /* 4 */

get data command example :

>lsur lsur () 0 0 650_1500

typed cmd echo : lsur ... omitting the data parameter [sel] selects the get data command type

parsed cmd and params : lsur () 0 0 650_1500 ... the returned value 0 0 shows the [sel] range type selection lambda 0.650 to 1.500 for both sensors.

set data command example :

>lsur 0 lsur (0) 650_1500 0

typed cmd echo : lsur 0 ... 0 as the [sel] range type selection lambda 0.650 to 1.500.

parsed cmd and params : lsur (0) 650_1500 0 ... the 0 at the end indicates no error

the new values will be stored in EE-Memory


LSUV [cj][sel][min][max] e

LSU Volt, set pwm-out = 0 and pwm-sim = 1 [sel] and [min] / [max] voltages.

get data command example :

>lsuv 0 1 lsuv (0, 1) 0000 1650

typed cmd echo : lsuv 0 1 ... omitting the data parameters [min][max] selects the get data command type

parsed cmd and params : lsuv (0, 1) 0000 1650 ... the returned values 0000 1650 show the [min][max] data limits.

set data command example :

>lsuv 0 1 200 1700 lsuv (0, 1, 0200, 1650) 0

typed cmd echo : lsuv (0, 1, 0200, 1650) 0 ... 0200 as the [min] voltage output limit and since 1700 would exceed the output voltage limit for channel 1 (O2 simulation out), 1650 as the [max] voltage output limit.

parsed cmd and params : lsuv (0, 1, 0200, 1500) 0 ... the 0 at the end indicates no error

the new values will be stored in EE-Memory


LSUD [cj][sel][dat0][dat1] e

LSU Data Set, set pwm-out = 0 and pwm-sim = 1 [sel] and [dat0] / [dat1] lambda endpoints.

Note : these LSUD... command settings only applies to the LSUR = 4, Custom Measurement Range selection, LSUR command.

get data command example :

>lsud 0 1 lsud (0, 1) 00950 01050

typed cmd echo : lsud 0 1 ... omitting the data parameters [dat0][dat1] selects the get data command type

parsed cmd and params : lsud (0, 1) 00950 01050 ... the returned values 00950 01050 show the [dat0][dat1] data limits.

set data command example :

>lsud 0 1 850 950 0 lsud (0, 1, 00850, 00950) 0

typed cmd echo : lsud (0, 1, 00850, 00950) 0 ... 00850 as the [dat0] lambda input limit and 00950 as the [dat1] lambda input limit.

parsed cmd and params : lsud (0, 1, 00850, 00950) 0 ... the 0 at the end indicates no error

the new values will be stored in EE-Memory


TPS, EXT Analog Input related Commands

AINV [sel][in0][in1] e

Analog INnputs Volt, TPS idx = 0, Ext idx = 1


AIND [sel][out0][out1] e

Analog INnputs Data, TPS idx = 0, Ext idx = 1


AINS [sel][idx] e

Analog INnputs Set


RPM Pulse Input related Commands

RPMD [div] e

RPM Divisor setup, pulse count (Divisor) for 2 crank-shaft turns

get data command example :

>rpmd rpmd () 1

typed cmd echo : rpmd ... omitting the data parameter [div] selects the get data command type

parsed cmd and params : rpmd () 1 ... the returned value 1 shows the [div] pulse count per 2 engine turns.

set data command example :

>rpmd 16 rpmd (16) 0

typed cmd echo : rpmd 16 ... 16 as the [div] pulse count divisor for 2 engine turns.

parsed cmd and params : rpmd (16) 0 ... the 0 at the end indicates no error

the new values will be stored in EE-Memory


RPMA [acc] e

RPM Acceleration config

get data command example :

>rpma rpma () 1

typed cmd echo : rpma ... omitting the data parameter [acc] selects the get data command type

parsed cmd and params : rpma () 1 ... the returned value 1 shows the [acc] acceleration conversion factor.

set data command example :

>rpma 50 rpma (50) 0

typed cmd echo : rpma 50 ... 50 as the [acc] acceleration conversion factor.

parsed cmd and params : rpma (50) 0 ... the 0 at the end indicates no error

the new values will be stored in EE-Memory

not fully implemented at this point


Serial Communication Operation related Commands

STRE [ena][tim] e

STReam Ena, enable streamed data output (ASCII), this is mutually exclusive to the PKGE cmd and automatically disables it.

  • eHz20_0 = 1, /* 0, Hz 20.0 */
  • eHz10_0 = 2, /* 1, Hz 10.0 */
  • eHz05_0 = 4, /* 2, Hz 5.0 */
  • eHz02_0 = 10, /* 3, Hz 2.0 */
  • eHz01_0 = 20, /* 4, Hz 1.0 */
  • eHz00_5 = 40, /* 5, Hz 0.5 */
  • eHz00_2 = 100, /* 6, Hz 0.2 */
  • eHz00_1 = 200, /* 7, Hz 0.1 */

get data command example :

>stre stre (0) 0

typed cmd echo : stre ... omitting the data parameter [tim] selects the get data command type

parsed cmd and params : stre (0) 0 ... the returned value 0 shows the [tim] data stream repetition time index.

set data command example :

>stre 1 3 stre (1, 3) 0

typed cmd echo : stre 1 3 ... 1 as the [ena] stream data enable and [tim] being the stream repetition time index.

parsed cmd and params : stre (1, 3) 0 ... the 0 at the end indicates no error

only the [tim] value will be stored in EE-Memory.


PKGE [ena][tim] :

PacKaGe Ena, enable data package output (binary), this is mutually exclusive to the PKGE cmd and automatically disables it.

get data command example :

>pkge pkge (0) 0

typed cmd echo : pkge ... omitting the data parameter [tim] selects the get data command type

parsed cmd and params : pkge (0) 0 ... the returned value 0 shows the [tim] package repetition time index.

set data command example :

>pkge 1 3 pkge (1, 3) 0

typed cmd echo : pkge 1 3 ... 1 as the [ena] stream data enable and [tim] being the stream repetition time index.

parsed cmd and params : pkge (1, 3) 0 ... the 0 at the end indicates no error

only the [tim] value will be stored in EE-Memory.

the [tim] variable is not implemented at this time.


ASCI [ena] :

ASCIi ena, this enables / disable the data package ASCII (debug) / binary format.

get data command example :

>ascii ascii() 0

typed cmd echo : ascii ... omitting the data parameter [ena] selects the get data command type

parsed cmd and params : ascii ()0 ... the returned value 0 shows the [ena] ASCII Enable State.

set data command example :

>ascii 1 ascii(1)

typed cmd echo : ascii 1 ... 1 as the [ena] ASCII setting.

parsed cmd and params : ascii() 1 ...

the [ena] state will NOT be stored in EE-Memory.


Error Clear Operation

ECLR [cj][clr] :

ECLR Clear Errors

get data command example :

>eclr 1 eclr(1) 003.000.00

typed cmd echo : eclr 1 ... omitting the data parameter [clr] selects the get data command type

parsed cmd and params : eclr(1) 003.000.00 ...

set data command example :

>eclr 0 1 eclr(0, 1)

typed cmd echo : eclr 0 1 ... 1 as the [clr] error setting.

parsed cmd and params : eclr(0, 1) 003.000.00 ... shows the errors before clear


Start / Stop Measurement Operations related Commands

RUN :

RUN performs a measurement Start (run=1) / Stop (run=0) This command as well as the Start Signal on connector J1 determine independently the Start / Stop conditions based upon which source, Start Signal Change or Run Command issued was given last.

get data command example :

>run run() 0

typed cmd echo : run ... omitting the data parameter [run] selects the get data command type

parsed cmd and params : run() 0 ... the returned value 0 shows the [run] Start Measurement State.

set data command example :

>run 1 run(1)

typed cmd echo : run 1 ... 1 as the [run] run setting.

parsed cmd and params : run() 1 ...

the [run] state will NOT be stored in EE-Memory.


Analog Measurement Calibration related Commands

V33 [3v3] e

Set the 3.3 V ADC reference Voltage. this is factory preset and does not need to be changed, unless being drifted away over time (weeks) or major change in environment (change in temperature).

a procedure explained at link-missing needs to be observed to perform the operation.

get data command example :

>v33 v33 () 3300

typed cmd echo : v33 ... omitting the data parameter [3v3] selects the get data command type

parsed cmd and params : v33 () 3300 ... the returned value 3300 shows the [3v3] 3.3 V reference voltage.

set data command example :

>v33 3270 v33 (3270) 0

typed cmd echo : v33 3270 ... 3270 as the [3v3] 3.3 V reference voltage calibration value in mV.

parsed cmd and params : v33 (3270) 0 ... the 0 at the end indicates no error

the new values will be stored in EE-Memory


VBAT [v12] e

not supported at this time.


PWM Analog Output related Commands

PADJ [cj][sel][adj] e

Pwm ADJust calibration, used to zero-offset voltage. analog output sel = 0, analog NB-Sensor Simulation Out sel = 1. used in conjunction with POUT and PSIM command

get data command example :

>padj 0 0 padj (0, 0) 045

typed cmd echo : padj 0 0 ... omitting the data parameter [adj] selects the get data command type

parsed cmd and params : padj (0, 0) 045 ... the returned value 045 shows the [adj] zero-offset voltage in mV.

set data command example :

>padj 0 0 47 padj (0, 0, 047) 0

typed cmd echo : padj 0 0 47 ... 47 as the [adj] zero-offset correction voltage in mV.

parsed cmd and params : padj (0, 0, 047) 0 ... the 0 at the end indicates no error

the new values will be stored in EE-Memory


PTST [cj][tst][tim] :

Pwm TeST, used to select between normal operation and 3 factory analog diagnostic modes. [tst] = 0 provides normal analog in / out operation

[tst] = 1 provides the TPS input voltage as a simulated Sensor Input current to test the analog POUT and analog PSIM output voltages in the Transfer-Function settings. All Sensor data is driven by the TPS test voltage ... to re-enable the Sensors for input, issue a PTST 0 0, PTST 0 1 command.

[tst] = 2 connects the TPS input voltage to the analog POUT output as well as the EXT input to the analog PSIM output. the measured input voltage is being output on the corresponding PWM output with the restriction of the PSIM output of 0 V - 1.65 V.
An added measured Voltage field be output at the Stream Data Output.

[tst] = 3 connects the TPS input voltage to the analog POUT output as well as the EXT input to the analog PSIM output.
The measured input voltage is being used as an amplified voltage source for an IP-Current simulation and a string of AFR, Lambda and IP-current will be output as an added ASCII string to the Stream Data Output.

[tst] = 4 provides the ability to program the POUT and PSIM analog outputs with the POUT and PSIM commands.

[tim] is the data stream repetition time index.

get data command example :

>ptst 0 ptst (0) 0

typed cmd echo : ptst 0 ... omitting the data parameter [tst] selects the get data command type

parsed cmd and params : ptst (0) 0 ... the returned value 0 shows the [tst] selected PWM test mode.

set data command example :

>ptst 0 2 ptst (0, 2)

typed cmd echo : ptst 0 2 ... 2 as the [tst] PWM test mode 2.

parsed cmd and params : ptst (0, 2) ...

since these are test commands, NONE of the parameter values will be stored in EE-Memory


PHTR [cj][mod][pwm] :

Pwm HeaTeR, can be used to diagnose parts of the sensor heater circuit. referenced only for documentation completeness and please do NOT use it since it easy to heat-damage (burn out) the sensor heater and sensor circuitry.

POUT [cj][mod][pwm] :

Pwm analog OUTout

PSIM [cj][mod][pwm] :

Pwm analog SIMulation, calibration, test and diagnostic

POUT and PSIM both share the same control code and are only different by the command mnemonic. [mod] selects the desired pwm units,

  • 0 = pwm raw value 0 - 4095 (12 bit)
  • 1 = pwm volt value on CPU PWM output referenced to the 3.3 V reference voltage (theoretical and not measurable value)
  • 2 = pwm volt value on Sallen Key Active Filter Output, which is the actual POUT and PSIM analog output
  • 3 = pwm data value on Sallen Key Active Filter Output, but in selected Lambda ... O2Percent ... etc ... units, not implemented at this moment, maybe not too useful at all.

the get data commands (read operation) can be used regardless of any selected PTST [tst] mode

get data command example :

>pout 0 2 pout vlt(0) 00000

typed cmd echo : pout 0 2 ... omitting the data parameter [pwm] selects the get data command type

parsed cmd and params : pout vlt(0) 00000 ... the returned value 00000 shows the [pwm] output data.

set data command example :

>psim 0 2 1200 psim vlt(0, 01200)

typed cmd echo : psim 0 2 1200 ... 1200 as the [pwm] PSIM analog out voltage in mV.

parsed cmd and params : psim vlt(0, 01200) ...

since these are test commands, NONE of the parameter values will be stored in EE-Memory


Restore Factory Default Values related Commands

RESC :

RESet Config to Factory Defaults.

this command resets all user data to the factory default values.

2 reboot (power-up) operation are necessary for the factory default values to be available from the EE-Memory.


RESR :

RESet Reference Data to Factory Defaults.

this command resets all factory calibration data to the factory default values.

measurement and re-calibration (V33 command) of the 3.3 V reference value can possibly provide better measurement and analog data output accuracy

measurement and re-calibration (PADJ command) of the PWM analog output zero offset correction value can possibly provide better analog data output accuracy

2 reboot (power-up) operation are necessary for the factory default values to be available from the EE-Memory.


more cmds to come as we finish the firmware communications interface.




Note : All published design documentation is Copyright efiLabs.com and its use is without exception FOR NON COMMERCIAL PURPOSE ONLY. For commercial licenses contact efilabs.com ... try us, we're reasonable :)

Personal tools
Namespaces

Variants
Actions
Navigation
Toolbox