sigrok - User contributions [en]

Protocol decoder:I2c

2017-10-11T12:45:47Z

Ipolit: /* Decoder */ Add another decoder usage

{{Infobox protocol decoder
| id = i2c
| name = Inter-Integrated Circuit
| description = Two-wire, multi-master, serial bus
| status = supported
| license = GPLv2+
| source_code_dir = i2c
| image = [[File:Pd i2c example.png|250px]]
| input = logic
| output = i2c
| probes = SCL, SDA
| optional_probes = —
| options = address_format
}}

The '''i2c''' protocol decoder supports the [https://en.wikipedia.org/wiki/I%C2%B2C Inter-Integrated Circuit] (I²C) bidirectional, multi-master serial protocol.

== Protocol ==

The Inter-Integrated Circuit (I²C) bus is a bidirectional, multi-master bus using two signals (SCL = serial clock line, SDA = serial data line).

There can be many devices on the same bus. Each device can potentially be master or slave (and that can change during runtime). Both slave and master can potentially play the transmitter or receiver role (this can also change at runtime).

Possible maximum data rates:

* Standard mode: 100 kbit/s
* Fast mode: 400 kbit/s
* Fast-mode Plus: 1 Mbit/s
* High-speed mode: 3.4 Mbit/s

Basic protocol:
* START condition: SDA = falling, SCL = high
* Repeated START condition: same as START condition
* Data bit sampling: SCL = rising
* STOP condition: SDA = rising, SCL = high

All data bytes on SDA are exactly 8 bits long (transmitted MSB-first). Each byte has to be followed by a 9th ACK/NACK bit. If that bit is low, that indicates an ACK, if it's high that indicates a NACK.

After the first START condition, a master sends the device address of the slave it wants to talk to. Slave addresses are 7 bits long (MSB-first). After those 7 bits, a data direction bit is sent. If the bit is low that indicates a WRITE operation, if it's high that indicates a READ operation.

Later an optional 10bit slave addressing scheme was added.

== Decoder ==

[http://www.eevblog.com/forum/testgear/ds1000z-series-serial-decode/msg536854/#msg536854 EEVblog forum post] showing how to use the '''i2c''' decoder, among other things (like reading the input from a CSV file, stacking decoders, binary output).

Another example of i2c decoder usage with sigrok-cli is:

<pre>
$ sigrok-cli -P i2c:scl=D1:sda=D0:address_format=unshifted -i trace.sr -A i2c=address-read:address-write:data-read:data-write
i2c-1: Write
i2c-1: Address write: A0
i2c-1: Data write: 01
i2c-1: Data write: 50
i2c-1: Read
i2c-1: Address read: A1
i2c-1: Data read: FF
i2c-1: Data read: 11
i2c-1: Data read: 22
i2c-1: Data read: 33
i2c-1: Data read: 44
i2c-1: Data read: 55

</pre>

== Resources ==

* [https://en.wikipedia.org/wiki/I%C2%B2C Wikipedia: I²C]
* [http://www.nxp.com/documents/other/UM10204_v5.pdf NXP: I2C-bus specification and user manual] (v5)

__FORCETOC__

[[Category:Protocol decoder]]

LeCroy oscilloscope series

2017-10-03T06:09:32Z

Ipolit: /* Devices */

{{Infobox oscilloscope
| image = [[File:LeCroy_WaveSurfer_24Xs-A_front.png|180px]]
| name = LeCroy oscilloscope series
| status = supported
| source_code_dir = lecroy-xstream
| website = [http://teledynelecroy.com/oscilloscope/ Teledyne LeCroy]
}}

LeCroy sells everything from entry-level to very high-end oscilloscopes, making use of own designs as well as contract manufacturers such as Iwatsu and Siglent. One feature that's common to all of those models is the support for LeCroy's waveform template, a data format used to retrieve waveform data using GPIB/SCPI commands. For this reason, this page isn't about a single oscilloscope in particular but all scopes belonging to the X-Stream family.

== Devices ==

Virtually all devices listed on http://teledynelecroy.com/oscilloscope/ should work (except for the 8-channel, 10-bit and 12-bit models).

{| class="wikitable"
!Family || Manufacturer || OS || Bandwidth || Connectivity || Tested?
|-
|| WaveAce 1000 || Atten || ? || 40 - 100 MHz || USB || No
|-
|| WaveAce 2000 || Siglent || ? || 70 - 300 MHz || USB || No
|-
|| WaveJet 300 || Iwatsu || ? || 350 - 500 MHz || USB || No
|-
|| WaveSurfer 10 || ? || Windows || 1 GHz || LAN || No
|-
|| WaveSurfer 400 || Iwatsu || Windows || 200 - 500 MHz || LAN || No
|-
|| WaveSurfer 3000 || Siglent || Windows Embedded || 200 - 750 MHz || USB, LAN, GPIB || No
|-
|| WaveSurfer (M)Xs || Iwatsu || Windows XP || 200 MHz - 1 GHz || LAN || Yes
|-
|| WaveRunner 6 Zi || ? || Windows 7 || 400 MHz - 4 GHz || USB, LAN || No
|-
|| WaveRunner 6000 || Iwatsu || Windows 2000 || 350 MHz - 2 GHz || LAN || No
|-
|| WaveRunner 8000 || ? || Windows || 500 MHz - 4 GHz || LAN || No
|-
|| WaveRunner (M)Xi || Iwatsu || Windows XP || 400 MHz - 2 GHz || LAN || Yes
|}

The digital channels aren't supported yet.

== Protocol ==

The protocol is based on SCPI commands and there is a USB-GPIB converter available which you can use on all Windows-based models.

== Resources ==

* [http://teledynelecroy.com/doc/docview.aspx?id=9905 WaveSurfer 3000 family remote control manual]
* [http://cdn.teledynelecroy.com/files/manuals/wa1k2k_remote-control_manual.pdf WaveAce family remote control manual]

[[Category:Device]]
[[Category:Oscilloscope]]
[[Category:Mixed-signal oscilloscope]]
[[Category:Supported]]

LeCroy oscilloscope series

2017-09-29T10:01:58Z

Ipolit: /* Devices */

{{Infobox oscilloscope
| image = [[File:LeCroy_WaveSurfer_24Xs-A_front.png|180px]]
| name = LeCroy oscilloscope series
| status = supported
| source_code_dir = lecroy-xstream
| website = [http://teledynelecroy.com/oscilloscope/ Teledyne LeCroy]
}}

LeCroy sells everything from entry-level to very high-end oscilloscopes, making use of own designs as well as contract manufacturers such as Iwatsu and Siglent. One feature that's common to all of those models is the support for LeCroy's waveform template, a data format used to retrieve waveform data using GPIB/SCPI commands. For this reason, this page isn't about a single oscilloscope in particular but all scopes belonging to the X-Stream family.

== Devices ==

Virtually all devices listed on http://teledynelecroy.com/oscilloscope/ should work (except for the 8-channel, 10-bit and 12-bit models).

{| class="wikitable"
!Family || Manufacturer || OS || Bandwidth || Connectivity || Tested?
|-
|| WaveAce 1000 || Atten || ? || 40 - 100 MHz || USB || No
|-
|| WaveAce 2000 || Siglent || ? || 70 - 300 MHz || USB || No
|-
|| WaveJet 300 || Iwatsu || ? || 350 - 500 MHz || USB || No
|-
|| WaveSurfer 10 || ? || Windows || 1 GHz || LAN || No
|-
|| WaveSurfer 400 || Iwatsu || Windows || 200 - 500 MHz || LAN || No
|-
|| WaveSurfer 3000 || Siglent || Windows Embedded || 200 - 750 MHz || USB, LAN, GPIB || No
|-
|| WaveSurfer (M)Xs || Iwatsu || Windows XP || 200 MHz - 1 GHz || LAN || Yes
|-
|| WaveRunner 6 Zi || ? || Windows || 400 MHz - 4 GHz || USB, LAN || No
|-
|| WaveRunner 6000 || Iwatsu || Windows 2000 || 350 MHz - 2 GHz || LAN || No
|-
|| WaveRunner 8000 || ? || Windows || 500 MHz - 4 GHz || LAN || No
|-
|| WaveRunner (M)Xi || Iwatsu || Windows XP || 400 MHz - 2 GHz || LAN || Yes
|}

The digital channels aren't supported yet.

== Protocol ==

The protocol is based on SCPI commands and there is a USB-GPIB converter available which you can use on all Windows-based models.

== Resources ==

* [http://teledynelecroy.com/doc/docview.aspx?id=9905 WaveSurfer 3000 family remote control manual]
* [http://cdn.teledynelecroy.com/files/manuals/wa1k2k_remote-control_manual.pdf WaveAce family remote control manual]

[[Category:Device]]
[[Category:Oscilloscope]]
[[Category:Mixed-signal oscilloscope]]
[[Category:Supported]]

LeCroy oscilloscope series

2017-09-29T06:12:04Z

Ipolit: /* Protocol */

{{Infobox oscilloscope
| image = [[File:LeCroy_WaveSurfer_24Xs-A_front.png|180px]]
| name = LeCroy oscilloscope series
| status = supported
| source_code_dir = lecroy-xstream
| website = [http://teledynelecroy.com/oscilloscope/ Teledyne LeCroy]
}}

LeCroy sells everything from entry-level to very high-end oscilloscopes, making use of own designs as well as contract manufacturers such as Iwatsu and Siglent. One feature that's common to all of those models is the support for LeCroy's waveform template, a data format used to retrieve waveform data using GPIB/SCPI commands. For this reason, this page isn't about a single oscilloscope in particular but all scopes belonging to the X-Stream family.

== Devices ==

Virtually all devices listed on http://teledynelecroy.com/oscilloscope/ should work (except for the 8-channel, 10-bit and 12-bit models).

{| class="wikitable"
!Family || Manufacturer || OS || Bandwidth || Connectivity || Tested?
|-
|| WaveAce 1000 || Atten || ? || 40 - 100 MHz || USB || No
|-
|| WaveAce 2000 || Siglent || ? || 70 - 300 MHz || USB || No
|-
|| WaveJet 300 || Iwatsu || ? || 350 - 500 MHz || USB || No
|-
|| WaveSurfer 10 || ? || Windows || 1 GHz || LAN || No
|-
|| WaveSurfer 400 || Iwatsu || Windows || 200 - 500 MHz || LAN || No
|-
|| WaveSurfer 3000 || Siglent || Windows Embedded || 200 - 750 MHz || USB, LAN, GPIB || No
|-
|| WaveSurfer (M)Xs || Iwatsu || Windows XP || 200 MHz - 1 GHz || LAN || Yes
|-
|| WaveRunner 6 Zi || ? || Windows || 400 MHz - 4 GHz || LAN || No
|-
|| WaveRunner 6000 || Iwatsu || Windows 2000 || 350 MHz - 2 GHz || LAN || No
|-
|| WaveRunner 8000 || ? || Windows || 500 MHz - 4 GHz || LAN || No
|-
|| WaveRunner (M)Xi || Iwatsu || Windows XP || 400 MHz - 2 GHz || LAN || Yes
|}

The digital channels aren't supported yet.

== Protocol ==

The protocol is based on SCPI commands and there is a USB-GPIB converter available which you can use on all Windows-based models.

== Resources ==

* [http://teledynelecroy.com/doc/docview.aspx?id=9905 WaveSurfer 3000 family remote control manual]
* [http://cdn.teledynelecroy.com/files/manuals/wa1k2k_remote-control_manual.pdf WaveAce family remote control manual]

[[Category:Device]]
[[Category:Oscilloscope]]
[[Category:Mixed-signal oscilloscope]]
[[Category:Supported]]

LeCroy oscilloscope series

2017-09-28T11:42:10Z

Ipolit: /* Protocol */

{{Infobox oscilloscope
| image = [[File:LeCroy_WaveSurfer_24Xs-A_front.png|180px]]
| name = LeCroy oscilloscope series
| status = supported
| source_code_dir = lecroy-xstream
| website = [http://teledynelecroy.com/oscilloscope/ Teledyne LeCroy]
}}

LeCroy sells everything from entry-level to very high-end oscilloscopes, making use of own designs as well as contract manufacturers such as Iwatsu and Siglent. One feature that's common to all of those models is the support for LeCroy's waveform template, a data format used to retrieve waveform data using GPIB/SCPI commands. For this reason, this page isn't about a single oscilloscope in particular but all scopes belonging to the X-Stream family.

== Devices ==

Virtually all devices listed on http://teledynelecroy.com/oscilloscope/ should work (except for the 8-channel, 10-bit and 12-bit models).

{| class="wikitable"
!Family || Manufacturer || OS || Bandwidth || Connectivity || Tested?
|-
|| WaveAce 1000 || Atten || ? || 40 - 100 MHz || USB || No
|-
|| WaveAce 2000 || Siglent || ? || 70 - 300 MHz || USB || No
|-
|| WaveJet 300 || Iwatsu || ? || 350 - 500 MHz || USB || No
|-
|| WaveSurfer 10 || ? || Windows || 1 GHz || LAN || No
|-
|| WaveSurfer 400 || Iwatsu || Windows || 200 - 500 MHz || LAN || No
|-
|| WaveSurfer 3000 || Siglent || Windows Embedded || 200 - 750 MHz || USB, LAN, GPIB || No
|-
|| WaveSurfer (M)Xs || Iwatsu || Windows XP || 200 MHz - 1 GHz || LAN || Yes
|-
|| WaveRunner 6 Zi || ? || Windows || 400 MHz - 4 GHz || LAN || No
|-
|| WaveRunner 6000 || Iwatsu || Windows 2000 || 350 MHz - 2 GHz || LAN || No
|-
|| WaveRunner 8000 || ? || Windows || 500 MHz - 4 GHz || LAN || No
|-
|| WaveRunner (M)Xi || Iwatsu || Windows XP || 400 MHz - 2 GHz || LAN || Yes
|}

The digital channels aren't supported yet.

== Protocol ==

The protocol is based on SCPI commands and there is a USB-GPIB converter available which you can use on all Windows-based models. To allow communicating properly the parameter '''COMM_HEADER''' has to be turn '''OFF'''. Otherwise, the device will echo the command and won't allow to be recognized.

== Resources ==

* [http://teledynelecroy.com/doc/docview.aspx?id=9905 WaveSurfer 3000 family remote control manual]
* [http://cdn.teledynelecroy.com/files/manuals/wa1k2k_remote-control_manual.pdf WaveAce family remote control manual]

[[Category:Device]]
[[Category:Oscilloscope]]
[[Category:Mixed-signal oscilloscope]]
[[Category:Supported]]