sigrok - User contributions [en]

DreamSourceLab DSLogic

2017-12-11T19:11:09Z

Mattvenn: continuous capture example

{{Infobox logic analyzer
| image = [[File:DSLogic.png|180px]]
| name = DreamSourceLab DSLogic
| status = supported
| source_code_dir = dreamsourcelab-dslogic
| channels = 1-16
| samplerate = 400MHz(4ch), 200MHz(8ch), 100MHz(16ch)
| samplerate_state = 50MHz
| triggers = high, low, rising, falling, edge, multi-stage triggers
| voltages = -0.6V — 6V
| threshold = configurable: 3.3V, 5V
| memory = 32MByte (2MByte/ch)
| compression = no
| website = [http://www.dreamsourcelab.com/dslogic.html dreamsourcelab.com]
}}

The '''DreamSourceLab DSLogic''' is a 16-channel USB-based logic analyzer, with sampling rates up to 400MHz (when using only 4 channels).

See [[DreamSourceLab DSLogic/Info]] for more details (such as '''lsusb -v''' output) about the device.

== Hardware ==

* [http://www.xilinx.com/products/silicon-devices/fpga/spartan-6/ Xilinx XC6SLX9] Spartan-6 FPGA (TQG144BIV13337)
* [http://www.micron.com/-/media/Documents/Products/Data%20Sheet/DRAM/256Mb_sdr.pdf Micron MT48LC16M16A2P-6A] 32MB SDRAM (IC SDRAM 256MBIT 167MHZ TSOP)
* [http://www.cypress.com/?mpn=CY7C68013A-56PVXC Cypress CY7C68013A] FX2 USB interface chip (IC MCU USB PERIPH HI SPD 56SSOP)
* [http://www.atmel.com/Images/Atmel-8719-SEEPROM-AT24C16C-Datasheet.pdf Serial EEPROM 16Kbit] U4: ATMLH348 16CM Y 3X3098, I2C/2Wire Serial EEPROM 16Kbit (2048x8) ATMEL AT24C16C
* [http://www.onsemi.com/pub_link/Collateral/CM1213A.PDF ESD Protection] U9,10,11,12,13,14 D234 ESD Protection CM1213A-04S7 TVS DIODE 3.3VWM 10VC SC746
* [http://www.ti.com/lit/ds/symlink/lm3671.pdf 1.2V 600mA LDO] U32 SBPB 1.2V 600mA 2MHz Step Down DC-DC Converter LM3671MF-1.2/NOPB
* [http://www.ti.com/lit/ds/symlink/lm3671.pdf 3.3V 600mA LDO] U31 SJEB 3.3V 600mA 2MHz Step Down DC-DC Converter LM3671MF-3.3/NOPB

== Photos ==

<gallery>
File:DSLogic.png|Device, top
File:DSLogic connector.jpg|Probe connector
File:DSLogic USB.jpg|USB connector
File:DSLogic PCB front.jpg|PCB, top
File:DSLogic PCB back.jpg|PCB, bottom
</gallery>

== Firmware ==

In order to use this device with [[libsigrok]] the [https://github.com/DreamSourceLab/DSView/raw/886b847c21c606df3138ce7ad8f8e8c363ee758b/DSView/res vendor firmare and bitstream files] (v0.97) are required.

The easiest method to install those is to use the [http://sigrok.org/gitweb/?p=sigrok-util.git;a=blob;f=firmware/dreamsourcelab-dslogic/sigrok-fwextract-dreamsourcelab-dslogic sigrok-fwextract-dreamsourcelab-dslogic] script. It will download the correct files, rename them to the correct filenames as expected by libsigrok and install them.

'''Example usage''':


$ '''PREFIX=$HOME/sr ./sigrok-fwextract-dreamsourcelab-dslogic'''


This will install the files into '''$HOME/sr/share/sigrok-fimware'''. Without '''PREFIX''', the files will be installed into '''/usr/local/share/sigrok-firmware''' by default.

If you want to avoid using the script, you can manually download and rename the files (but check [http://sigrok.org/gitweb/?p=sigrok-util.git;a=blob;f=firmware/dreamsourcelab-dslogic/sigrok-fwextract-dreamsourcelab-dslogic the script] for the correct filenames).

'''Note:''' Do '''not''' use any firmware/bitstream files newer than those linked here (v0.97), they're currently not supported. See bugs [http://sigrok.org/bugzilla/show_bug.cgi?id=905 #905] and [https://sigrok.org/bugzilla/show_bug.cgi?id=1063 #1063].

After firmware is correctly installed, you can see if it's worked like this:

<pre>
sigrok-cli --driver=dreamsourcelab-dslogic -l 5 --scan
</pre>

You should see the driver detected and uploading the firmware

<pre>
sr: [00:00.014417] resource: Opened '/usr/local/share/sigrok-firmware/dreamsourcelab-dslogic-basic-fx2.fw'.
sr: [00:00.014454] ezusb: Uploading firmware 'dreamsourcelab-dslogic-basic-fx2.fw'.
sr: [00:00.014972] ezusb: Uploaded 4096 bytes.
sr: [00:00.015481] ezusb: Uploaded 4024 bytes.
sr: [00:00.015492] ezusb: Firmware upload done.
sr: [00:00.015497] ezusb: setting CPU reset mode off...
sr: [00:00.015606] hwdriver: Scan found 1 devices (dreamsourcelab-dslogic).
The following devices were found:
dreamsourcelab-dslogic - DreamSourceLab DSLogic Basic with 16 channels: 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
sr: [00:00.015691] hwdriver: Cleaning up all drivers.
</pre>

== Capabilities ==

Use --show to fetch the current available options

<pre>
sigrok-cli --driver=dreamsourcelab-dslogic --show
</pre>

This example shows how to use sigrok-cli to capture 1k samples at 500khz on channels 0 and 1, with voltage threshold of 2.5v
<pre>
sigrok-cli -C 0,1 --driver=dreamsourcelab-dslogic -c "samplerate=500k:voltage_threshold=2.5-2.5" --samples 1k
</pre>

This example shows continuous capture (requires the device config to include 'continuous=on')
<pre>
sigrok-cli -c "samplerate=10k:voltage_threshold=2.5-2.5:continuous=on" --driver=dreamsourcelab-dslogic --continuous
</pre>

== Resources ==

* [http://www.dreamsourcelab.com Vendor website]
* [http://www.dreamsourcelab.com/wiki/index.php Vendor wiki]
* [http://www.dreamsourcelab.com/forum/index.php Vendor forum]
* [http://www.dreamsourcelab.com/techspec.html Device specs]
* [https://www.kickstarter.com/projects/dreamsourcelab/dslogic-multifunction-instruments-for-everyone Kickstarter page]

[[Category:Device]]
[[Category:Logic analyzer]]
[[Category:Supported]]

DreamSourceLab DSLogic

2017-12-11T19:06:33Z

Mattvenn: added examples

{{Infobox logic analyzer
| image = [[File:DSLogic.png|180px]]
| name = DreamSourceLab DSLogic
| status = supported
| source_code_dir = dreamsourcelab-dslogic
| channels = 1-16
| samplerate = 400MHz(4ch), 200MHz(8ch), 100MHz(16ch)
| samplerate_state = 50MHz
| triggers = high, low, rising, falling, edge, multi-stage triggers
| voltages = -0.6V — 6V
| threshold = configurable: 3.3V, 5V
| memory = 32MByte (2MByte/ch)
| compression = no
| website = [http://www.dreamsourcelab.com/dslogic.html dreamsourcelab.com]
}}

The '''DreamSourceLab DSLogic''' is a 16-channel USB-based logic analyzer, with sampling rates up to 400MHz (when using only 4 channels).

See [[DreamSourceLab DSLogic/Info]] for more details (such as '''lsusb -v''' output) about the device.

== Hardware ==

* [http://www.xilinx.com/products/silicon-devices/fpga/spartan-6/ Xilinx XC6SLX9] Spartan-6 FPGA (TQG144BIV13337)
* [http://www.micron.com/-/media/Documents/Products/Data%20Sheet/DRAM/256Mb_sdr.pdf Micron MT48LC16M16A2P-6A] 32MB SDRAM (IC SDRAM 256MBIT 167MHZ TSOP)
* [http://www.cypress.com/?mpn=CY7C68013A-56PVXC Cypress CY7C68013A] FX2 USB interface chip (IC MCU USB PERIPH HI SPD 56SSOP)
* [http://www.atmel.com/Images/Atmel-8719-SEEPROM-AT24C16C-Datasheet.pdf Serial EEPROM 16Kbit] U4: ATMLH348 16CM Y 3X3098, I2C/2Wire Serial EEPROM 16Kbit (2048x8) ATMEL AT24C16C
* [http://www.onsemi.com/pub_link/Collateral/CM1213A.PDF ESD Protection] U9,10,11,12,13,14 D234 ESD Protection CM1213A-04S7 TVS DIODE 3.3VWM 10VC SC746
* [http://www.ti.com/lit/ds/symlink/lm3671.pdf 1.2V 600mA LDO] U32 SBPB 1.2V 600mA 2MHz Step Down DC-DC Converter LM3671MF-1.2/NOPB
* [http://www.ti.com/lit/ds/symlink/lm3671.pdf 3.3V 600mA LDO] U31 SJEB 3.3V 600mA 2MHz Step Down DC-DC Converter LM3671MF-3.3/NOPB

== Photos ==

<gallery>
File:DSLogic.png|Device, top
File:DSLogic connector.jpg|Probe connector
File:DSLogic USB.jpg|USB connector
File:DSLogic PCB front.jpg|PCB, top
File:DSLogic PCB back.jpg|PCB, bottom
</gallery>

== Firmware ==

In order to use this device with [[libsigrok]] the [https://github.com/DreamSourceLab/DSView/raw/886b847c21c606df3138ce7ad8f8e8c363ee758b/DSView/res vendor firmare and bitstream files] (v0.97) are required.

The easiest method to install those is to use the [http://sigrok.org/gitweb/?p=sigrok-util.git;a=blob;f=firmware/dreamsourcelab-dslogic/sigrok-fwextract-dreamsourcelab-dslogic sigrok-fwextract-dreamsourcelab-dslogic] script. It will download the correct files, rename them to the correct filenames as expected by libsigrok and install them.

'''Example usage''':


$ '''PREFIX=$HOME/sr ./sigrok-fwextract-dreamsourcelab-dslogic'''


This will install the files into '''$HOME/sr/share/sigrok-fimware'''. Without '''PREFIX''', the files will be installed into '''/usr/local/share/sigrok-firmware''' by default.

If you want to avoid using the script, you can manually download and rename the files (but check [http://sigrok.org/gitweb/?p=sigrok-util.git;a=blob;f=firmware/dreamsourcelab-dslogic/sigrok-fwextract-dreamsourcelab-dslogic the script] for the correct filenames).

'''Note:''' Do '''not''' use any firmware/bitstream files newer than those linked here (v0.97), they're currently not supported. See bugs [http://sigrok.org/bugzilla/show_bug.cgi?id=905 #905] and [https://sigrok.org/bugzilla/show_bug.cgi?id=1063 #1063].

After firmware is correctly installed, you can see if it's worked like this:

<pre>
sigrok-cli --driver=dreamsourcelab-dslogic -l 5 --scan
</pre>

You should see the driver detected and uploading the firmware

<pre>
sr: [00:00.014417] resource: Opened '/usr/local/share/sigrok-firmware/dreamsourcelab-dslogic-basic-fx2.fw'.
sr: [00:00.014454] ezusb: Uploading firmware 'dreamsourcelab-dslogic-basic-fx2.fw'.
sr: [00:00.014972] ezusb: Uploaded 4096 bytes.
sr: [00:00.015481] ezusb: Uploaded 4024 bytes.
sr: [00:00.015492] ezusb: Firmware upload done.
sr: [00:00.015497] ezusb: setting CPU reset mode off...
sr: [00:00.015606] hwdriver: Scan found 1 devices (dreamsourcelab-dslogic).
The following devices were found:
dreamsourcelab-dslogic - DreamSourceLab DSLogic Basic with 16 channels: 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
sr: [00:00.015691] hwdriver: Cleaning up all drivers.
</pre>

== Capabilities ==

Use --show to fetch the current available options

<pre>
sigrok-cli --driver=dreamsourcelab-dslogic --show
</pre>

This example shows how to use sigrok-cli to capture 1k samples at 500khz on channels 0 and 1, with voltage threshold of 2.5v
<pre>
sigrok-cli -C 0,1 --driver=dreamsourcelab-dslogic -c "samplerate=500k:voltage_threshold=2.5-2.5" --samples 1k
</pre>

== Resources ==

* [http://www.dreamsourcelab.com Vendor website]
* [http://www.dreamsourcelab.com/wiki/index.php Vendor wiki]
* [http://www.dreamsourcelab.com/forum/index.php Vendor forum]
* [http://www.dreamsourcelab.com/techspec.html Device specs]
* [https://www.kickstarter.com/projects/dreamsourcelab/dslogic-multifunction-instruments-for-everyone Kickstarter page]

[[Category:Device]]
[[Category:Logic analyzer]]
[[Category:Supported]]

Protocol decoder:I2c

2017-12-11T19:01:48Z

Mattvenn: /* Decoder */

{{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 ==

You can show the available options with the --show command:

<pre>
$ sigrok-cli -P i2c --show
</pre>

[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]]

DreamSourceLab DSLogic

2017-12-11T18:59:17Z

Mattvenn: /* Firmware */

{{Infobox logic analyzer
| image = [[File:DSLogic.png|180px]]
| name = DreamSourceLab DSLogic
| status = supported
| source_code_dir = dreamsourcelab-dslogic
| channels = 1-16
| samplerate = 400MHz(4ch), 200MHz(8ch), 100MHz(16ch)
| samplerate_state = 50MHz
| triggers = high, low, rising, falling, edge, multi-stage triggers
| voltages = -0.6V — 6V
| threshold = configurable: 3.3V, 5V
| memory = 32MByte (2MByte/ch)
| compression = no
| website = [http://www.dreamsourcelab.com/dslogic.html dreamsourcelab.com]
}}

The '''DreamSourceLab DSLogic''' is a 16-channel USB-based logic analyzer, with sampling rates up to 400MHz (when using only 4 channels).

See [[DreamSourceLab DSLogic/Info]] for more details (such as '''lsusb -v''' output) about the device.

== Hardware ==

* [http://www.xilinx.com/products/silicon-devices/fpga/spartan-6/ Xilinx XC6SLX9] Spartan-6 FPGA (TQG144BIV13337)
* [http://www.micron.com/-/media/Documents/Products/Data%20Sheet/DRAM/256Mb_sdr.pdf Micron MT48LC16M16A2P-6A] 32MB SDRAM (IC SDRAM 256MBIT 167MHZ TSOP)
* [http://www.cypress.com/?mpn=CY7C68013A-56PVXC Cypress CY7C68013A] FX2 USB interface chip (IC MCU USB PERIPH HI SPD 56SSOP)
* [http://www.atmel.com/Images/Atmel-8719-SEEPROM-AT24C16C-Datasheet.pdf Serial EEPROM 16Kbit] U4: ATMLH348 16CM Y 3X3098, I2C/2Wire Serial EEPROM 16Kbit (2048x8) ATMEL AT24C16C
* [http://www.onsemi.com/pub_link/Collateral/CM1213A.PDF ESD Protection] U9,10,11,12,13,14 D234 ESD Protection CM1213A-04S7 TVS DIODE 3.3VWM 10VC SC746
* [http://www.ti.com/lit/ds/symlink/lm3671.pdf 1.2V 600mA LDO] U32 SBPB 1.2V 600mA 2MHz Step Down DC-DC Converter LM3671MF-1.2/NOPB
* [http://www.ti.com/lit/ds/symlink/lm3671.pdf 3.3V 600mA LDO] U31 SJEB 3.3V 600mA 2MHz Step Down DC-DC Converter LM3671MF-3.3/NOPB

== Photos ==

<gallery>
File:DSLogic.png|Device, top
File:DSLogic connector.jpg|Probe connector
File:DSLogic USB.jpg|USB connector
File:DSLogic PCB front.jpg|PCB, top
File:DSLogic PCB back.jpg|PCB, bottom
</gallery>

== Firmware ==

In order to use this device with [[libsigrok]] the [https://github.com/DreamSourceLab/DSView/raw/886b847c21c606df3138ce7ad8f8e8c363ee758b/DSView/res vendor firmare and bitstream files] (v0.97) are required.

The easiest method to install those is to use the [http://sigrok.org/gitweb/?p=sigrok-util.git;a=blob;f=firmware/dreamsourcelab-dslogic/sigrok-fwextract-dreamsourcelab-dslogic sigrok-fwextract-dreamsourcelab-dslogic] script. It will download the correct files, rename them to the correct filenames as expected by libsigrok and install them.

'''Example usage''':


$ '''PREFIX=$HOME/sr ./sigrok-fwextract-dreamsourcelab-dslogic'''


This will install the files into '''$HOME/sr/share/sigrok-fimware'''. Without '''PREFIX''', the files will be installed into '''/usr/local/share/sigrok-firmware''' by default.

If you want to avoid using the script, you can manually download and rename the files (but check [http://sigrok.org/gitweb/?p=sigrok-util.git;a=blob;f=firmware/dreamsourcelab-dslogic/sigrok-fwextract-dreamsourcelab-dslogic the script] for the correct filenames).

'''Note:''' Do '''not''' use any firmware/bitstream files newer than those linked here (v0.97), they're currently not supported. See bugs [http://sigrok.org/bugzilla/show_bug.cgi?id=905 #905] and [https://sigrok.org/bugzilla/show_bug.cgi?id=1063 #1063].

After firmware is correctly installed, you can see if it's worked like this:

<pre>
sigrok-cli --driver=dreamsourcelab-dslogic -l 5 --scan
</pre>

You should see the driver detected and uploading the firmware

<pre>
sr: [00:00.014417] resource: Opened '/usr/local/share/sigrok-firmware/dreamsourcelab-dslogic-basic-fx2.fw'.
sr: [00:00.014454] ezusb: Uploading firmware 'dreamsourcelab-dslogic-basic-fx2.fw'.
sr: [00:00.014972] ezusb: Uploaded 4096 bytes.
sr: [00:00.015481] ezusb: Uploaded 4024 bytes.
sr: [00:00.015492] ezusb: Firmware upload done.
sr: [00:00.015497] ezusb: setting CPU reset mode off...
sr: [00:00.015606] hwdriver: Scan found 1 devices (dreamsourcelab-dslogic).
The following devices were found:
dreamsourcelab-dslogic - DreamSourceLab DSLogic Basic with 16 channels: 0 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
sr: [00:00.015691] hwdriver: Cleaning up all drivers.
</pre>

== Resources ==

* [http://www.dreamsourcelab.com Vendor website]
* [http://www.dreamsourcelab.com/wiki/index.php Vendor wiki]
* [http://www.dreamsourcelab.com/forum/index.php Vendor forum]
* [http://www.dreamsourcelab.com/techspec.html Device specs]
* [https://www.kickstarter.com/projects/dreamsourcelab/dslogic-multifunction-instruments-for-everyone Kickstarter page]

[[Category:Device]]
[[Category:Logic analyzer]]
[[Category:Supported]]

DreamSourceLab DSLogic

2017-12-11T18:54:20Z

Mattvenn: /* Firmware */

{{Infobox logic analyzer
| image = [[File:DSLogic.png|180px]]
| name = DreamSourceLab DSLogic
| status = supported
| source_code_dir = dreamsourcelab-dslogic
| channels = 1-16
| samplerate = 400MHz(4ch), 200MHz(8ch), 100MHz(16ch)
| samplerate_state = 50MHz
| triggers = high, low, rising, falling, edge, multi-stage triggers
| voltages = -0.6V — 6V
| threshold = configurable: 3.3V, 5V
| memory = 32MByte (2MByte/ch)
| compression = no
| website = [http://www.dreamsourcelab.com/dslogic.html dreamsourcelab.com]
}}

The '''DreamSourceLab DSLogic''' is a 16-channel USB-based logic analyzer, with sampling rates up to 400MHz (when using only 4 channels).

See [[DreamSourceLab DSLogic/Info]] for more details (such as '''lsusb -v''' output) about the device.

== Hardware ==

* [http://www.xilinx.com/products/silicon-devices/fpga/spartan-6/ Xilinx XC6SLX9] Spartan-6 FPGA (TQG144BIV13337)
* [http://www.micron.com/-/media/Documents/Products/Data%20Sheet/DRAM/256Mb_sdr.pdf Micron MT48LC16M16A2P-6A] 32MB SDRAM (IC SDRAM 256MBIT 167MHZ TSOP)
* [http://www.cypress.com/?mpn=CY7C68013A-56PVXC Cypress CY7C68013A] FX2 USB interface chip (IC MCU USB PERIPH HI SPD 56SSOP)
* [http://www.atmel.com/Images/Atmel-8719-SEEPROM-AT24C16C-Datasheet.pdf Serial EEPROM 16Kbit] U4: ATMLH348 16CM Y 3X3098, I2C/2Wire Serial EEPROM 16Kbit (2048x8) ATMEL AT24C16C
* [http://www.onsemi.com/pub_link/Collateral/CM1213A.PDF ESD Protection] U9,10,11,12,13,14 D234 ESD Protection CM1213A-04S7 TVS DIODE 3.3VWM 10VC SC746
* [http://www.ti.com/lit/ds/symlink/lm3671.pdf 1.2V 600mA LDO] U32 SBPB 1.2V 600mA 2MHz Step Down DC-DC Converter LM3671MF-1.2/NOPB
* [http://www.ti.com/lit/ds/symlink/lm3671.pdf 3.3V 600mA LDO] U31 SJEB 3.3V 600mA 2MHz Step Down DC-DC Converter LM3671MF-3.3/NOPB

== Photos ==

<gallery>
File:DSLogic.png|Device, top
File:DSLogic connector.jpg|Probe connector
File:DSLogic USB.jpg|USB connector
File:DSLogic PCB front.jpg|PCB, top
File:DSLogic PCB back.jpg|PCB, bottom
</gallery>

== Firmware ==

In order to use this device with [[libsigrok]] the [https://github.com/DreamSourceLab/DSView/raw/886b847c21c606df3138ce7ad8f8e8c363ee758b/DSView/res vendor firmare and bitstream files] (v0.97) are required.

The easiest method to install those is to use the [http://sigrok.org/gitweb/?p=sigrok-util.git;a=blob;f=firmware/dreamsourcelab-dslogic/sigrok-fwextract-dreamsourcelab-dslogic sigrok-fwextract-dreamsourcelab-dslogic] script. It will download the correct files, rename them to the correct filenames as expected by libsigrok and install them.

'''Example usage''':


$ '''PREFIX=$HOME/sr ./sigrok-fwextract-dreamsourcelab-dslogic'''


This will install the files into '''$HOME/sr/share/sigrok-fimware'''. Without '''PREFIX''', the files will be installed into '''/usr/local/share/sigrok-firmware''' by default.

If you want to avoid using the script, you can manually download and rename the files (but check [http://sigrok.org/gitweb/?p=sigrok-util.git;a=blob;f=firmware/dreamsourcelab-dslogic/sigrok-fwextract-dreamsourcelab-dslogic the script] for the correct filenames).

'''Note:''' Do '''not''' use any firmware/bitstream files newer than those linked here (v0.97), they're currently not supported. See bugs [http://sigrok.org/bugzilla/show_bug.cgi?id=905 #905] and [https://sigrok.org/bugzilla/show_bug.cgi?id=1063 #1063].

After firmware is correctly installed, you can see if it's worked like this:


sigrok-cli -C 1 --driver=dreamsourcelab-dslogic -c "samplerate=500k" --samples 1k -l 5


== Resources ==

* [http://www.dreamsourcelab.com Vendor website]
* [http://www.dreamsourcelab.com/wiki/index.php Vendor wiki]
* [http://www.dreamsourcelab.com/forum/index.php Vendor forum]
* [http://www.dreamsourcelab.com/techspec.html Device specs]
* [https://www.kickstarter.com/projects/dreamsourcelab/dslogic-multifunction-instruments-for-everyone Kickstarter page]

[[Category:Device]]
[[Category:Logic analyzer]]
[[Category:Supported]]