X-Git-Url: https://sigrok.org/gitweb/?p=libsigrokdecode.git;a=blobdiff_plain;f=decoders%2Fonewire_link%2F__init__.py;h=28b0194bb324796e6534d531659d255f4339d36a;hp=c1331c6322d1d6988170816f67c8896c3d9f47a9;hb=4539e9ca58966ce3c9cad4801b16c315e86ace01;hpb=24c74fd30fb161837c5f8b01baf3c0fe2dfa4ed5 diff --git a/decoders/onewire_link/__init__.py b/decoders/onewire_link/__init__.py index c1331c6..28b0194 100644 --- a/decoders/onewire_link/__init__.py +++ b/decoders/onewire_link/__init__.py @@ -1,5 +1,5 @@ ## -## This file is part of the sigrok project. +## This file is part of the libsigrokdecode project. ## ## Copyright (C) 2012 Uwe Hermann ## @@ -14,12 +14,11 @@ ## GNU General Public License for more details. ## ## You should have received a copy of the GNU General Public License -## along with this program; if not, write to the Free Software -## Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA +## along with this program; if not, see . ## ''' -1-Wire protocol decoder (link layer). +This protocol decoder handles the 1-Wire link layer. The 1-Wire protocol enables bidirectional communication over a single wire (and ground) between a single master and one or multiple slaves. The protocol @@ -29,8 +28,6 @@ is layered: - Network layer (skip/search/match device ROM addresses) - Transport layer (transport data between 1-Wire master and device) -Link layer protocol details: - Sample rate: A sufficiently high samplerate is required to properly detect all the elements of the protocol. A lower samplerate can be used if the master does not use @@ -39,7 +36,7 @@ overdrive communication speed. The following minimal values should be used: - overdrive available: 2MHz minimum, 5MHz suggested - overdrive not available: 400kHz minimum, 1MHz suggested -Probes: +Channels: 1-Wire requires a single signal, but some master implementations might have a separate signal used to deliver power to the bus during temperature conversion as an example. This power signal is currently not used. @@ -65,27 +62,6 @@ configure the following timing values (number of samplerate periods): These options should be configured only on very rare cases and the user should read the decoder source code to understand them correctly. - -Protocol output format: -TODO. - -Annotations: - -Link layer annotations show the following events: - - - NOTE/WARNING/ERROR - Possible samplerate related timing issues are reported. - - Reset/presence true/false - The event is marked from the signal negative edge to the end of the reset - high period. It's also reported if there are any devices attached to the bus. - - Bit 0/1 - The event is marked from the signal negative edge to the end of the data - slot. The value of each received bit is also provided. - -TODO: -- Check for protocol correctness, if events are timed inside prescribed limits. -- Maybe add support for interrupts, check if this feature is deprecated. ''' -from .pd import * - +from .pd import Decoder