From: norly <ny-git@enpas.org>
Date: Mon, 18 Feb 2019 20:38:04 +0000 (+0100)
Subject: readme.rst: Add rationale behind the chosen configuration
X-Git-Url: https://git.enpas.org/?a=commitdiff_plain;h=98a440e3f0152d1f4b4a28f8960f7443579a78bd;p=elmcan.git

readme.rst: Add rationale behind the chosen configuration

Plus minor fixes.
---

diff --git a/readme.rst b/readme.rst
index 2023d07..d2aced2 100644
--- a/readme.rst
+++ b/readme.rst
@@ -241,8 +241,8 @@ For this to function, the controller must be configured for 11 bit CAN
 ID sending mode (using "``AT PB``", see code or datasheet).
 
 
-Once a frame has been sent and wait-for-reply mode is on (ATR1,
-configured on listen-only=off), or when the reply timeout expires and
+Once a frame has been sent and wait-for-reply mode is on (``ATR1``,
+configured on ``listen-only=off``), or when the reply timeout expires and
 the driver sets the controller into monitoring mode (``ATMA``), the ELM327
 will send one line for each received CAN frame, consisting of CAN ID,
 DLC, and data::
@@ -268,6 +268,31 @@ incomplete) data frame::
 
 
 
+Rationale behind the chosen configuration
+------------------------------------------
+
+``AT E1``
+  Echo on
+
+  We need this to be able to get a prompt reliably.
+
+``AT S1``
+  Spaces on
+
+  We need this to distinguish 11/29 bit CAN addresses received.
+
+  Note:
+  We can usually do this using the line length (odd/even),
+  but this fails if the line is not transmitted fully to
+  the host (BUFFER FULL).
+
+``AT D1``
+  DLC on
+
+  We need this to tell the "length" of RTR frames.
+
+
+
 To Do list for future development
 ----------------------------------