How to configure custom parameters reading?

  • 1.9K Views
  • Last Post 03 November 2017
Administrator posted this 16 December 2014

How to configure custom parameters reading?

inCarDoc posted this 03 November 2017

Step-by-step guide for creating custom protocol description.

1. Create folder with the name of your protocol at your android device at \Android\data\com.pnn.obdcardoctor(_full)\files\desc_ECU
Protocol name will later appear as possible selection marker in app settings

2. In a folder one need to create all or some files with protocol description, 
    all file names should follow the pattern N#name.csv, 
    where
         N is number encoding the type of the protocol part (0, 1 or 5)
         name is text label of the protocol used in app (for example "Dynamic parameters", "Diagnostics")

2.1. Init file, id 0, for example 0#init.csv

type:50 
version:1   - version, only 1 is supported 
ping: (command)  - "neutral" command to keep connection alive(for example ATRV)
init: (coma separated commands line)  - protocol init sequence (for example ATZ,ATD,ATE0,ATSP5,ATAL,ATIB10,ATSH8110F1,ATST32,ATSW00,ATFI)

2.2. Dynamic parameters set, id 1, for example 1#iDynamic parameters.csv

type:51 
version:1  
displacement: (number)  - global shift for reading data, bytes from response string beginning
description:id,Name,ModeAndPID,Equation,Min Value,Max Value,Units,Header
*****
(id),(Name),(ModeAndPID),(Equation),(Min Value),(Max Value),(Units),(Header)
.....

(id) - unique id of command (for example #0111)
(name) - parameter name as it will be shown in app
(
ModeAndPID) - request parameter reading command
(
Equation) - response decoding formula, (for example A-40 $A=10, A is 10's byte in response, and result is valueof(A)-40)
(Min Value) - minimal possible parameter value
(Max Value) - maximal possible parameters value
(Units) - abbreviation of measurement units
(Header) - not used now

example


#011,Cooling temperature,2101,A-40 $A=10 ,-40,215, °C,OFF

 

*** You could copy and use one of the reconfigured custom protocols in \Android\data\com.pnn.obdcardoctor(_full)\files\desc_ECU as a template for your experiments

3. After creation of appropriate configuration file for custom protocol,

one could set app to use this protocol with Settings-Protocol-Protocol type-(custom protocol name)