
Logic Sniffer
An alternative OLS client
Welcome to the project page of Logic Sniffer alternative Java client. This page will
provide some documentation and, of course, download links.
Table of contents
Introduction
The alternative OLS-client provides a software client for the Open Bench Logic Sniffer logic
analyser hardware.
The Open Bench Logic Sniffer is the result of a collaboration between Gadget Factory and Dangerous
Prototypes. They created a cheap custom implementation of the SUMP
client (developed by Michael Poppitz), and released it as Open Source project.
The original SUMP project already contained a workable client of its own. While this client was feature complete
and working quite well, it was no longer actively developed and maintained. Being a developer and loving Open
Source, I immediately started hacking and tweaking it. The result? An alternative SUMP client.
News
- February 7th, 2011, OLS version 0.9.3 SP1 released. This service pack fixes some severe bugs that crept into the
last release. Use this release instead of the 0.9.3 release!;
- February 6th, 2011, OLS version 0.9.3 released. Major highlights: better support for RLE encoding, JTAG decoder tool added, generic device added;
- December 19th, 2010, OLS version 0.9.2 released. Major highlights: 1-Wire decoder tool added, better support for OS X Leopard;
- November 1st, 2010, OLS version 0.9.1 released. Major highlights: several bugfixes regarding image exporting on Linux and Windows platforms;
- October 23rd, 2010: OLS version 0.9.0 released. Major highlights: added export to image and VCD.
What other people say about...
I had to rock some intense LAing today, and I just wanted to say that the latest version is fantastic! I've completely
abandoned the old version for yours, and moved it to the top of the wiki software list :) It's a joy to use and it doesn't
feel like Java
. In my opinion this is nicer and richer than the Saleae client (I use the Saleae a lot too).
Great work! Thank you so much! — Ian (Dangerous Prototypes)
It keeps getting better and better! I've officially started using your client exclusively, I just spent the last couple
days troubleshooting some SPI output from the AVR8 Soft Processor core project and your client didn't miss a beat —
Jack Gasset (Gadget Factory)
Features
The alternative Java client provides the following features:
- Cross platform: the client runs on Mac OSX (32/64-bit), Windows (32/64 bit) and Linux (32/64 bit);
- Simple installation: no longer fiddling with the serial libraries (RXTX) in order to get the client
up and running. The client embeds the suitable serial libraries for several operating systems;
- Pluggable: adding new functionality on the fly is possible and as easy as copying files to a single
directory;
- Look good, and feel good: the client has a good look and feel, aiming at being as usable as
possible.
Documentation
TO DO...
FAQ
Some frequently asked questions, as found in the support forums.
Software
- Your client does not run. It cannot find the classes and/or complaints about incorrect version numbers!
- The OLS client is written in and for Java 6. Ensure you have installed the latest Java 6 version on your system.
For Windows/Linux, see http://www.oracle.com/technetwork/java/javase/downloads/index.html;
for OSX, see http://support.apple.com/kb/DL972 and
http://support.apple.com/kb/DL971, or use your regular Software
Update mechanism.
- Your client crashes with an OutOfMemoryException: heap space!
- If you're performing large captures (e.g. with RLE turned on) it can be that the client hasn't enough memory
by default to store all samples. For now, you can enlarge the memory settings by adding -Xmx1024m to the
Java command in the run.bat, run.sh, or the
VMOptions option in your Info.plist.
As of 0.9.2, these options are added by default!
- I get a warning about RXTX version mismatches!
- While the message is not really nice, you can consider it harmless. The reason for this message is that the
client uses an "unofficial" version of the RXTX library.
Hardware
- I cannot capture anything; nothing happens (perhaps exceptions in the console)!
- If you've played with the original SUMP client, you installed the RXTX libraries separately. Try deleting the
RXTX libraries from your Java installation as they might interfere with the libraries included with this client.
- My OLS-device isn't recognized by your client. It does not appear in the list of devices!
- Try entering the device name of your device (e.g. /dev/ttyACM0, /dev/tty.usbmodemfd142,
COM13) directly as port name.
- I've got multiple serial devices that go mad when/no longer react after opening the device list!
- The RXTX library shortly opens and closes each port in its detection routines. Try entering the device
name directly as port name.
- Opening the device list takes a very long time!
- The RXTX library probes lists of possible devices, for example, on Windows, it tries to open COM1 through
COM256(!). Try entring the device name directly as port name.
Tools and user interface
- How can I decode only parts of my captured signal(s)?
- Mark the area you want to decode with cursors 1 and 2; this will cause most decoding tools to decode only that
part of your signals.
- How can I remove (all) cursors?
- Removing a cursor is done by opening the context menu, and selecting the cursor again. This will remove the cursor.
To remove all cursors, use the "remove all cursors" option from the context menu.
Download
The current release of Logic Sniffer is 0.9.3 SP1.
Older releases, for historical reasons:
- ols-0.9.3 SP1 [tar.gz] [zip] [dmg] released February 7th, 2011, 2.3M;
ols-0.9.3 [tar.gz] [zip] [dmg] released February 6th, 2011, 2.3M;
- ols-0.9.2 [tar.gz] [zip] [dmg] released December 19th, 2010, 2.3M;
- ols-0.9.1 [tar.gz] [zip] [dmg] released November 1st, 2010, 2.2M;
- ols-0.9.0 [tar.gz] [zip] [dmg] released October 23rd, 2010, 2.2M;
- ols-0.8.5 [tar.gz] released October 1st, 2010, 2.1M;
- ols-0.8.4 [tar.gz] released September 9th 2010, 1.5M;
- ols-0.8.3 [tar.gz] released August 26th 2010, 1.5M;
- ols-0.8.2 [tar.gz] released August 22nd 2010, 1.5M;
- ols-0.8.1 [tar.gz] released August 07th 2010, 1.4M;
- ols-0.8.0 [tar.gz] released August 24th 2010, 1.4M;
- ols-0.7.0 [tar.gz] released August 9th 2010, 1.3M.
Changelog
The most recent list of changes can always be found on GitHub.
Screenshots
Screenshots of the 0.8.5 release, running on Mac OSX (10.6, 64-bit):
Development
Currently, the project is developed by me, Jan Willem. If you want to contribute, drop me a line.
All development of this project is shared through GitHub, and the main repository can be found on
http://github.com/jawi/ols.
License
The alternative Java client is developed and released under the General Public License, version 2.
For the license details, see the full license
text.
Links
Tip jar
This project is open source, and written in my (sparse) free time. You can use it free of charge
and without any fees. However, if you want to, you can show your appreciation on this project by
making a small donation. You can do this by clicking one of the following buttons:
© Copyright 2010, 2011 - J.W. Janssen.