ade7758: README: Rearrangements and consistency fixes.

1 files changed, 45 insertions, 12 deletions

diff --git a/spi/ade7758/README b/spi/ade7758/README
index 2b491fe..0bd189d 100644
--- a/spi/ade7758/README
+++ b/spi/ade7758/README
@@ -1,21 +1,54 @@
-50MHz capture of an ADE7758 SPI communications.
+-------------------------------------------------------------------------------
+Analog Devices ADE7758
+-------------------------------------------------------------------------------
+
+This is a set of example captures of ADE7758 SPI communications.
+
 Note that Chip Select is _optional_ on this device, provided that you are
-careful to only use valid, full length spi read/write requests.
+careful to only use valid, full length SPI read/write requests.
+
+Details:
+http://www.analog.com/en/products/analog-to-digital-converters/integrated-special-purpose-converters/energy-metering-ics/ade7758.html
+
+
+Logic analyzer setup
+--------------------
+
+The logic analyzer used was a Saleae Logic16 clone (at 50MHz):
+
+  Probe       ADE7758 pin
+  -----------------------
+  0           CLK
+  1           MISO
+  2           MOSI
+  3           IRQ
+
+
+Data
+----
 
 In this case, the chip is configured to provide interrupts on voltage zero
 crossings, and the host MCU is reading the status register, and then the
 appropriate (phase B) voltage/current registers.
 
-It is largely an example of SPI without CS, in spi mode 0,1.
+It is largely an example of SPI without CS, in SPI mode 0,1.
+
+Correct decodings with the ADE7758 decoder should show:
+
+  RSTATUS: 0x400
+  FREQ: 0x0 (frequency is from phase A, not connected on this device)
+  BVRMS: 0x10cd0c (context) or 0x10ccfa (nocontext)
+  BIRMS: 0x2ac    (context) or 0x2a8    (nocontext)
+
+
+ade7758-phaseB-zx-irq-context.sr
+--------------------------------
+
+Trigger with precapture on the IRQ pin falling edge.
+
 
-Two captures are provided.
-ade7758-phaseB-zx-irq-context.sr: trigger with precapture on the IRQ pin falling edge.
-ade7758-phaseB-zx-irq-nocontext.sr: trigger on spi CLK rising edge.
+ade7758-phaseB-zx-irq-nocontext.sr
+----------------------------------
 
-Correct decodings with the ADE7758 decoder should show
-RSTATUS: 0x400
-FREQ: 0x0 (frequency is from phase A, not connected on this device)
-BVRMS: 0x10cd0c (context) or 0x10ccfa (nocontext)
-BIRMS: 0x2ac    (context) or 0x2a8    (nocontext)
+Trigger on SPI CLK rising edge.
 
-Anything else has gotten the SPI decoding wrong due to the lack of chip select.