Difference between revisions of "Fx2lafw"

Revision as of 12:41, 17 June 2012

fx2lafw is an open-source firmware for Cypress FX2 chips which makes them usable as simple logic analyzer hardware.

It is licensed under the terms of the GNU GPL (version 2, or later) and written in C, using sdcc as compiler, and fx2lib as helper library.

Hardware overview

The fx2lafw firmware is meant to work on any FX2-based hardware, including logic analyzers, FX2 eval boards, or other hardware which has this chip on-board.

Here's a quick overview of some of the relevant hardware information we have about the various devices:

Device	USB VID:PID	Probes (pins)	FX2 package	Buffer/ESD-protection	Resistor/probe	I2C EEPROM	Status
6-Lab LOGIC-U⁵	?	?	?	?	?	?	TODO
6-Lab LOGIC-U PLUS⁵	?	?	?	?	?	?	TODO
6-Lab LOGIC-U PRO⁵	?	?	?	?	?	?	TODO
6-Lab LOGIC-U ISL⁵	?	?	?	?	?	?	TODO
ARMFLY AX-Pro	08a9:0014	8 (+1 analog)	56LTXC (QFN)	?	100 Ω	Atmel ATML920 24C02N SU27 D	95%¹
ARMFLY Mini-Logic²	08a9:0014	8	56LTXC (QFN)	?	100 Ω	Atmel ATML920 24C02N SU27 D	100%
Braintechnology USB Interface V2.x	04b4:8613	8/16	56PVXC (SSOP)	none	none	Microchip 24LC64I	100%
Braintechnology USB-LPS	16d0:0498	8/16	56PVXC (SSOP)	none	? 68 Ω	Atmel ATML0816 TINY13 20SU	100%
CWAV BusBee	?	4	?	?	?	?	TODO
CWAV USBee AX-Standard	08a9:0012	?	?	?	?	?	TODO
CWAV USBee AX-Plus	08a9:0013	?	?	?	?	?	TODO
CWAV USBee AX-Pro	08a9:0014	8 (+1 analog)	?	?	?	?	95%¹
CWAV USBee DX	08a9:0015	16 (+2 analog)	?	?	?	?	TODO
CWAV USBee EX2	?	8	?	?	?	?	TODO
CWAV USBee SX	08a9:0009	8	56PVXC (SSOP)	none	560 Ω	Microchip 24LC01B	100%
CWAV USBee ZX	08a9:0005	8	56PVXC (SSOP)	none	?	?	TODO
EE Electronics ESLA100	0925:3881	8	56LFXC (QFN)	NXP 74HC245D	100 Ω	Atmel ATMLH911 02B 1	100%
EE Electronics ESLA201A	08a9:0014	8 (+1 analog)	56LFXC (QFN)	none	100 Ω	Atmel ATMLH113	95%¹
ITead Studio MiniLogic⁴	?	?	?	?	?	?	TODO
ITead Studio ITDB01	?	?	?	?	?	?	TODO
Lcsoft Mini Board	04b4:8613	8/16	56PVXC (SSOP)	none	none	Shenzhen First-Rank Technology T24C128A	95%¹
Mollex Logic Analyzer³	?	?	?	?	?	?	TODO
Noname Saleae Logic clone I	?	?	?	?	?	?	TODO
Noname Saleae Logic clone II	?	?	?	?	?	?	TODO
Noname Saleae Logic clone III	?	?	?	?	?	?	TODO
"picavr" Digital USB Analyzer v1	?	?	?	?	?	?	TODO
"picavr" A/D USB Analyzer v2	?	?	?	?	?	?	TODO
"picavr" A/D USB Analyzer v3	?	?	?	?	?	?	TODO
"picavr" A/D USB Analyzer v4	?	?	?	?	?	?	TODO
Robomotic BugLogic 2	?	?	?	?	?	?	TODO
Robomotic BugLogic 3	0925:3881	8	?	?	?	?	100%
Robomotic MiniLogic	0925:3881	8	56PVXC (SSOP)	74HC244A	?	2x Microchip 24LC02BI, 1x 24LC64I	100%
Robomotic XZL024⁷	?	?	?	?	?	?	TODO
Saleae Logic	0925:3881	8	56PVXC (SSOP)	ST DVIULC6-4SC6	?	?	100%
Sysclk Box	?	?	?	?	?	?	TODO
XZL-Studio AX	?	?	?	?	?	?	TODO
XZL-Studio DX⁶	?	?	?	?	?	?	TODO

All devices use a 24MHz crystal. For 8 probes the FX2 pins PB0-PB7 are used, for 16 probes PB0-PB7 and PD0-PD7. For analog support PD0-PD7 (plus additional hardware) is usually used.

¹ Analog signal support is not yet implemented.
² Even though this devices has the same USB VID/PID as the CWAV USBee AX-Pro, it only has 8 channels and no analog support.
³ Clone of the USBee AX and Saleae Logic. "Mollex" is the name of the guy who seems to sell it on some forum.
⁴ Clone of the USBee AX (SX?) and Saleae Logic, see also here and here. Dissection by a user here. Seems to be the same hardware as the Robomotic MiniLogic.
⁵ It seems 6-Labs has/had permission from Saleae to distribute the hardware in Ukraine (only)? Various adapters are available, for example RS422/RS232/CAN, galvanic isolation, "BNC divider".
⁶ There is apparently a post from the author of XZL-Studio DX in some forum.
⁷ There's an RS232/RS485/RS422/CAN converter board for this.

Download

$ git clone git://sigrok.git.sourceforge.net/gitroot/sigrok/fx2lafw

Usage

Build sigrok

Build and install a sigrok frontend (CLI or GUI) with libsigrok >= 0.1.1 (or latest git HEAD) for your platform as usual, see e.g. Linux, Mac OS X, FreeBSD, or Windows.

Install the udev rules file

These steps prevent the need to run sigrok as superuser.

Copy the udev rules file from sigrok/libsigrok/contrib/z60_libsigrok.rules to /etc/udev/rules.d/.
Restart udev: sudo /etc/init.d/udev restart.

Build fx2lafw

$ cd fx2lafw
$ git clone git://github.com/mulicheng/fx2lib.git
$ make
$ sudo cp hw/*/build/*.fw /usr/local/share/sigrok-firmware/

Where /usr/local is your installation prefix.

Test

$ sigrok-cli -D

If everything has worked, sigrok can now see your fx2lafw device, ready for use.

TODO

~~Digital sampling with 16 channels~~
Analog sampling
- 1-channel
- 2-channel
- Voltage meter
Trigger pin
Clock input
Clock output
Frequency/pulse counter
Signal generator

Resources

Browse Source Code
sdcc (C compiler for 8051 microcontrollers, usable for FX2)
fx2lib: SF project page, blog article, github repo, mailing list
Cypress FX2 docs:
- CY7C68013A, CY7C68014A, CY7C68015A, CY7C68016A datasheet (PDF)
- EZ-USB Technical Reference Manual (TRM) (PDF)
- EZ-USB FX2LP appnotes
- EZ-USB FX2LP errata
- GPIF Designer (Windows software, requires login)
  - CY3681 EZ-USB FX2 Development Kit (GPIF designer downloadable without login)

Difference between revisions of "Fx2lafw"

Revision as of 12:41, 17 June 2012

Contents

Hardware overview

Download

Usage

Build sigrok

Install the udev rules file

Build fx2lafw

Test

TODO

Resources

Navigation menu

@@ Line 9: / Line 9: @@
 Here's a quick overview of some of the relevant hardware information we have about the various devices:
-{| border="0" style="font-size: smaller"
+{| border="0" style="font-size: smaller" class="alternategrey sortable sigroktable"
-|- bgcolor="#6699ff"
+|-
 !Device
 !USB VID:PID
@@ Line 20: / Line 20: @@
 !Status
-|- bgcolor="#eeeeee"
+|-
 | [http://translate.google.com/translate?sl=ru&tl=en&u=http%3A%2F%2Fwww.6-lab.com%2Fen%2Flogic-u.html 6-Lab LOGIC-U]<sup>5</sup>
 | ?
@@ Line 30: / Line 30: @@
 | bgcolor="red" | TODO
-|- bgcolor="#eeeeee"
+|-
 | [http://translate.google.com/translate?sl=ru&tl=en&u=http://www.6-lab.com/en/logic-u-plus.html 6-Lab LOGIC-U PLUS]<sup>5</sup>
 | ?
@@ Line 40: / Line 40: @@
 | bgcolor="red" | TODO
-|- bgcolor="#eeeeee"
+|-
 | [http://translate.google.com/translate?sl=ru&tl=en&u=http%3A%2F%2F6-lab.com%2Fen%2Flogicupro.html 6-Lab LOGIC-U PRO]<sup>5</sup>
 | ?
@@ Line 50: / Line 50: @@
 | bgcolor="red" | TODO
-|- bgcolor="#eeeeee"
+|-
 | [http://translate.google.com/translate?sl=ru&tl=en&u=http%3A%2F%2F6-lab.com%2Fen%2Flogicuisl.html 6-Lab LOGIC-U ISL]<sup>5</sup>
 | ?
@@ Line 60: / Line 60: @@
 | bgcolor="red" | TODO
-|- bgcolor="#dddddd"
+|-
 | [[ARMFLY AX-Pro]]
 | 08a9:0014
@@ Line 70: / Line 70: @@
 | bgcolor="lime" | 95%<sup>1</sup>
-|- bgcolor="#dddddd"
+|-
 | [[ARMFLY Mini-Logic]]<sup>2</sup>
 | 08a9:0014
@@ Line 80: / Line 80: @@
 | bgcolor="lime" | 100%
-|- bgcolor="#eeeeee"
+|-
 | [[Braintechnology USB Interface V2.x]]
 | 04b4:8613
@@ Line 90: / Line 90: @@
 | bgcolor="lime" | 100%
-|- bgcolor="#eeeeee"
+|-
 | [[Braintechnology USB-LPS]]
 | 16d0:0498
@@ Line 100: / Line 100: @@
 | bgcolor="lime" | 100%
-|- bgcolor="#dddddd"
+|-
 | [[CWAV BusBee]]
 | ?
@@ Line 110: / Line 110: @@
 | bgcolor="red" | TODO
-|- bgcolor="#dddddd"
+|-
 | [[CWAV USBee AX-Standard]]
 | [http://www.mikrocontroller.net/topic/136039#1878129 08a9:0012]
@@ Line 120: / Line 120: @@
 | bgcolor="red" | TODO
-|- bgcolor="#dddddd"
+|-
 | [[CWAV USBee AX-Plus]]
 | [http://www.mikrocontroller.net/topic/136039#1878129 08a9:0013]
@@ Line 130: / Line 130: @@
 | bgcolor="red" | TODO
-|- bgcolor="#dddddd"
+|-
 | [[CWAV USBee AX-Pro]]
 | [http://www.mikrocontroller.net/topic/136039#1878129 08a9:0014]
@@ Line 140: / Line 140: @@
 | bgcolor="lime" | 95%<sup>1</sup>
-|- bgcolor="#dddddd"
+|-
 | [[CWAV USBee DX]]
 | [http://www.mikrocontroller.net/topic/136039#1878129 08a9:0015]
@@ Line 150: / Line 150: @@
 | bgcolor="red" | TODO
-|- bgcolor="#dddddd"
+|-
 | [[CWAV USBee EX2]]
 | ?
@@ Line 160: / Line 160: @@
 | bgcolor="red" | TODO
-|- bgcolor="#dddddd"
+|-
 | [[CWAV USBee SX]]
 | 08a9:0009
@@ Line 170: / Line 170: @@
 | bgcolor="lime" | 100%
-|- bgcolor="#dddddd"
+|-
 | [[CWAV USBee ZX]]
 | 08a9:0005
@@ Line 180: / Line 180: @@
 | bgcolor="red" | TODO
-|- bgcolor="#eeeeee"
+|-
 | [[EE Electronics ESLA100]]
 | 0925:3881
@@ Line 190: / Line 190: @@
 | bgcolor="lime" | 100%
-|- bgcolor="#eeeeee"
+|-
 | [[EE Electronics ESLA201A]]
 | 08a9:0014
@@ Line 200: / Line 200: @@
 | bgcolor="lime" | 95%<sup>1</sup>
-|- bgcolor="#dddddd"
+|-
 | [http://iteadstudio.com/store/index.php?main_page=product_info&cPath=2&products_id=221 ITead Studio MiniLogic]<sup>4<sup>
 | ?
@@ Line 210: / Line 210: @@
 | bgcolor="red" | TODO
-|- bgcolor="#dddddd"
+|-
 | [http://iteadstudio.com/store/index.php?main_page=product_info&cPath=1&products_id=51 ITead Studio ITDB01]
 | ?
@@ Line 220: / Line 220: @@
 | bgcolor="red" | TODO
-|- bgcolor="#eeeeee"
+|-
 | [[Lcsoft Mini Board]]
 | 04b4:8613
@@ Line 230: / Line 230: @@
 | bgcolor="lime" | 95%<sup>1</sup>
-|- bgcolor="#dddddd"
+|-
 | [http://translate.google.com/translate?sl=ru&tl=en&js=n&prev=_t&hl=de&ie=UTF-8&layout=2&eotf=1&u=http%3A%2F%2Fwww.rom.by%2Fforum%2FLogicheskij_analizator_signalov_USBee_AX_Saleae_Logic_45&act=url Mollex Logic Analyzer]<sup>3</sup>
 | ?
@@ Line 240: / Line 240: @@
 | bgcolor="red" | TODO
-|- bgcolor="#eeeeee"
+|-
 | [http://translate.google.com/translate?hl=de&sl=zh-CN&tl=en&u=http%3A%2F%2Fitem.taobao.com%2Fitem.htm%3Fid%3D6076642324 Noname Saleae Logic clone I]
 | ?
@@ Line 250: / Line 250: @@
 | bgcolor="red" | TODO
-|- bgcolor="#eeeeee"
+|-
 | [http://www.hotmcu.com/24mhz-8channel-logic-analyzerminisimpleeasy-to-use-p-15.html?cPath=3_26 Noname Saleae Logic clone II]
 | ?
@@ Line 260: / Line 260: @@
 | bgcolor="red" | TODO
-|- bgcolor="#eeeeee"
+|-
 | [https://translate.googleusercontent.com/translate_c?act=url&hl=de&ie=UTF8&prev=_t&rurl=translate.google.com&sl=zh-CN&tl=en&u=http://item.taobao.com/item.htm%3Fid%3D15872520745&usg=ALkJrhg07D21JRo3GQV7fR9Mua_yYKocfw Noname Saleae Logic clone III]
 | ?
@@ Line 270: / Line 270: @@
 | bgcolor="red" | TODO
-|- bgcolor="#dddddd"
+|-
 | [http://translate.google.com/translate?sl=ru&tl=en&u=http%3A%2F%2Fpicavr.kr1.ru%2FUSBAnalyzer%2FDigital_USB_Analyzer_v1.html "picavr" Digital USB Analyzer v1]
 | ?
@@ Line 280: / Line 280: @@
 | bgcolor="red" | TODO
-|- bgcolor="#dddddd"
+|-
 | [http://translate.google.com/translate?sl=ru&tl=en&u=http%3A%2F%2Fpicavr.kr1.ru%2FUSBAnalyzer%2FAD_USB_Analyzer_v2.html "picavr" A/D USB Analyzer v2]
 | ?
@@ Line 290: / Line 290: @@
 | bgcolor="red" | TODO
-|- bgcolor="#dddddd"
+|-
 | [http://translate.google.com/translate?sl=ru&tl=en&u=http%3A%2F%2Fpicavr.kr1.ru%2FUSBAnalyzer%2FAD_USB_Analyzer_v3.html "picavr" A/D USB Analyzer v3]
 | ?
@@ Line 300: / Line 300: @@
 | bgcolor="red" | TODO
-|- bgcolor="#dddddd"
+|-
 | [http://translate.google.com/translate?sl=ru&tl=en&u=http%3A%2F%2Fpicavr.kr1.ru%2FUSBAnalyzer%2FAD_USB_Analyzer_v4.html "picavr" A/D USB Analyzer v4]
 | ?
@@ Line 310: / Line 310: @@
 | bgcolor="red" | TODO
-|- bgcolor="#eeeeee"
+|-
 | [http://lab.robomotic.com/index.php?page=shop.product_details&flypage=flypage.tpl&product_id=22&category_id=6&vmcchk=1&option=com_virtuemart&Itemid=56 Robomotic BugLogic 2]
 | ?
@@ Line 320: / Line 320: @@
 | bgcolor="red" | TODO
-|- bgcolor="#eeeeee"
+|-
 | [[Robomotic BugLogic 3]]
 | 0925:3881
@@ Line 330: / Line 330: @@
 | bgcolor="lime" | 100%
-|- bgcolor="#eeeeee"
+|-
 | [[Robomotic MiniLogic]]
 | 0925:3881
@@ Line 340: / Line 340: @@
 | bgcolor="lime" | 100%
-|- bgcolor="#eeeeee"
+|-
 | [http://lab.robomotic.com/index.php?page=shop.product_details&flypage=flypage.tpl&product_id=26&category_id=6&vmcchk=1&option=com_virtuemart&Itemid=56 Robomotic XZL024]<sup>7</sup>
 | ?
@@ Line 350: / Line 350: @@
 | bgcolor="red" | TODO
-|- bgcolor="#dddddd"
+|-
 | [[Saleae Logic]]
 | 0925:3881
@@ Line 360: / Line 360: @@
 | bgcolor="lime" | 100%
-|- bgcolor="#eeeeee"
+|-
 | [http://www.wholesale-in-china.org/articles/article-194265.htm Sysclk Box]
 | ?
@@ Line 370: / Line 370: @@
 | bgcolor="red" | TODO
-|- bgcolor="#dddddd"
+|-
 | [http://translate.google.com/translate?sl=zh-CN&tl=en&js=n&prev=_t&hl=de&ie=UTF-8&layout=2&eotf=1&u=http%3A%2F%2Fitem.taobao.com%2Fitem.htm%3Fid%3D6321822194&act=url XZL-Studio AX]
 | ?
@@ Line 380: / Line 380: @@
 | bgcolor="red" | TODO
-|- bgcolor="#dddddd"
+|-
 | [http://www.aliexpress.com/product-fm/540565153-New-arrival-XZL-Studio-DX-usb-logic-analyzer-oscilloscope-Mixed-Signal-Oscilloscope-2-probe-P6020-4-wholesalers.html XZL-Studio DX]<sup>6</sup>
 | ?

Difference between revisions of "Fx2lafw"

Revision as of 12:41, 17 June 2012

Hardware overview

Download

Usage

Build sigrok

Install the udev rules file

Build fx2lafw

Test

TODO

Resources

Navigation menu

Search