X-Git-Url: http://sigrok.org/gitweb/?a=blobdiff_plain;f=onewire%2Fowfs%2FREADME;h=6f856c849018c90aaa9a933fbc4f8f2313f557f6;hb=37b5193ae56f60ee5413d0cc0b6f56a7a8f3e7f2;hp=b2bc5b63e3c5237d9739ec661cff9803cc0251a6;hpb=3e5a7b35ce7d0a14d998e34fa2fc530ca1ba615b;p=sigrok-dumps.git

diff --git a/onewire/owfs/README b/onewire/owfs/README
index b2bc5b6..6f856c8 100644
--- a/onewire/owfs/README
+++ b/onewire/owfs/README
@@ -1,64 +1,73 @@
-This directory contains waveforms generated with OWFS
+-------------------------------------------------------------------------------
+Onewire/OWFS dumps
+-------------------------------------------------------------------------------
 
+This directory contains 1-Wire aveforms generated with OWFS.
 
-Tools:
+Details:
+TODO.
 
-- Logic Analyzer: Tektronix TLA 613
-- Sowtware:
-  - Ubuntu 12.04 (Precise Pangolin)
-  - owfs 2.8p15
-- 1-Wire master: home made from:
-  - PL2303 (USB to UART)
-  - DS2480B (UART to 1-Wire)
+Tools used:
 
+ - Logic Analyzer: Tektronix TLA 613
+ - Software: owfs 2.8p15
+ - 1-Wire master: home made from
+   - PL2303 (USB to UART)
+   - DS2480B (UART to 1-Wire)
 
 1-Wire MicroLan:
 
 Two thermometers were attached to the bus (only the data line was connected,
 power was not):
-- DS28EA00 (1-Wire Digital Thermometer with Sequence Detect and PIO)
-- DS18B20 (Programmable Resolution 1-Wire Digital Thermometer)
+
+ - DS28EA00 (1-Wire Digital Thermometer with Sequence Detect and PIO)
+ - DS18B20 (Programmable Resolution 1-Wire Digital Thermometer)
 
 The server was started as:
-$ owserver -d /dev/ttyUSB0
+
+ $ owserver -d /dev/ttyUSB0
 
 
-Three dumps were created:
+owdir.sr (samplerate = 1MHz)
+----------------------------
 
-1) "owdir.sr" (samplerate = 1MHz)
 A request to list devices connected to the bus was performed:
-$ owdir
-/28.9BCFC8000000
-/42.A8A603000000
-/bus.0
-/uncached
-/settings
-/system
-/statistics
-/structure
-/simultaneous
-/alarm
 
-2) "DS18B20.sr" (samplerate = 1MHz)
-A read temperathure request was performed for the specified device:
-$ owread /28.9BCFC8000000/temperature
-        25.5
+ $ owdir
+ /28.9BCFC8000000
+ /42.A8A603000000
+ /bus.0
+ /uncached
+ /settings
+ /system
+ /statistics
+ /structure
+ /simultaneous
+ /alarm
+
+
+ds18b20.sr (samplerate = 1MHz)
+------------------------------
+
+A read temperature request was performed for the specified device:
+
+ $ owread /28.9BCFC8000000/temperature
+         25.5
+
 
-2) "DS28EA00.sr" (samplerate = 1MHz)
-A read temperathure request was performed for the specified device:
-$ owread /42.A8A603000000/temperature
-      26.875
+ds28ea00.sr (samplerate = 1MHz)
+-------------------------------
 
+A read temperature request was performed for the specified device:
 
-Conversion from TXT to sigrok dumps:
+ $ owread /42.A8A603000000/temperature
+       26.875
 
-The provided dumps were exported from Flextronix TLA 613 logic analizer as text
-files. A simple Python script was used to convert this dumps first into a
-binary file and then into a sigrok standard dump.
 
+Conversion from TXT to sigrok dumps
+-----------------------------------
 
-Decoding 1-Wire dumps
+The provided dumps were exported from a Flextronix TLA 613 logic analyzer
+(as text files). A simple Python script was used to convert these dumps,
+first into a binary file and then into a sigrok session file.
 
-sigrok-cli -i owdir.sr -a onewire:owr=0
-sigrok-cli -i DS18B20.sr -a onewire:owr=0
-sigrok-cli -i DS28EA00.sr -a onewire:owr=0