Rearrange the repository and add a library.properties file to make this installable as a .ZIP library in the Arduino IDE.

Fix off by one on the capture buffer due to earlier debugging. I finally realized I was checking if an unsigned int was less than zero. Thanks Szilárd for the correct indexes in the issue comments.
Add a sketch with Sigrok support. Basically returning the capture buffer in the opposite order.
2026-05-06 14:17:28 +03:00 · 2023-10-05 22:32:52 -05:00 · 2023-10-03 23:48:07 -05:00 · 2023-10-03 23:00:05 -05:00 · 2021-12-21 13:28:29 -06:00 · 2021-12-21 12:51:32 -06:00
18 changed files with 60216 additions and 107 deletions
--- a/22
+++ b/22
@@ -0,0 +1,22 @@
+Copyright (c) 2011,2012,2013,2014,2015,2016,2017,2018,2019,2020,2021,2022,2023 Andrew Gillham
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+1. Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+
+THIS SOFTWARE IS PROVIDED BY ANDREW GILLHAM ``AS IS'' AND ANY EXPRESS OR
+IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
+OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
+IN NO EVENT SHALL ANDREW GILLHAM BE LIABLE FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
+NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
+THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
--- a/37
+++ b/37
@@ -1,19 +1,24 @@
 #
-# Makefile for an Arduino based logic analyzer using the 'arduino-core'
-# package and makefiles.
+# Makefile for an Arduino based logic analyzer using the arduino-cli
 #
-#	$Id: Makefile,v 1.3 2011-03-07 02:47:26 gillham Exp $
+
+TARGET	= logic_analyzer
+FQBN	= arduino:avr:diecimila
+SERIAL	= /dev/ttyUSB*
+
+
+all:
+	@echo ""
+	@echo "---> run 'make build' to compile for Arduino Duemilanove"
+	@echo "---> run 'make upload' to upload to /dev/ttyUSB*"
+	@echo ""
+
+build:
+	arduino-cli compile --fqbn $(FQBN) $(TARGET)
+
+upload:
+	arduino-cli upload --fqbn $(FQBN) --port $(SERIAL) $(TARGET)
+
+#
+# end-of-file
 #
-ARDUINO_DIR  = /usr/share/arduino
-
-TARGET       = logic_analyzer
-ARDUINO_LIBS = 
-
-MCU          = atmega328p
-F_CPU        = 16000000
-ARDUINO_PORT = /dev/ttyUSB*
-AVRDUDE_ARD_BAUDRATE = 57600
-AVRDUDE_ARD_PROGRAMMER = arduino
-
-include /usr/share/arduino/Arduino.mk
-
--- a/84
+++ b/84
@@ -1,84 +0,0 @@
-SUMP compatible logic analyzer for Arduino
-==========================================
-
-This Arduino sketch implements a SUMP protocol compatible with the standard
-SUMP client as well as the alternative client from here:
-	http://www.lxtreme.nl/ols/
-
-The alternative client version is highly recommended.  Download version
-"ols-0.9.7" or newer for built-in device profiles.
-
-This SUMP protocol compatible logic analyzer for the Arduino board supports
-5 channels consisting of digital pins 8-12, which are the first 5 bits (0-4)
-of PORTB. Arduino pin 13 / bit 5 is the Arduino LED, bits 6 & 7 are the
-crystal oscillator pins.
-
-Uncomment CHAN5 below if you want to use the LED pin as an input and have
-6 channels.
-
-On the Arduino Mega board 8 channels are supported and 7k of samples.
-Pins 22-29 (Port A) are used by default.
-
-To use this with the original or alternative SUMP clients,
-use these settings:
-
-Sampling rate: 4MHz (or lower) (no 2MHz on ATmega168)
-Channel Groups: 0 (zero) only
-Recording Size:
-   ATmega168:  532 (or lower)
-   ATmega328:  1024 (or lower)
-   ATmega2560: 7168 (or lower)
-Noise Filter: doesn't matter
-RLE: disabled (unchecked)
-
-Triggering is still a work in progress, but generally works for samples
-below 1MHz.  1MHz works for a basic busy wait trigger that doesn't store
-until after the trigger fires.
-Please try it out and report back.
-
-Debugging
-=========
-
-You can uncomment the '#define DEBUG_MENU' line to add some diagnostic menu
-options for capturing or dumping the capture buffer.
-You can uncomment the '#define DEBUG' and '#define DEBUG_MENU' for a couple
-extra menu options and logging of the received commands.  The DEBUG option
-is generally only useful for development, while the DEBUG_MENU option is
-good for troubleshooting when the logic_analyzer sketch isn't working for you.
-Both are disabled by default to conserve RAM for improved stability.
-
-Older Notes
-===========================================================================
-NOTE: With v0.11 you can now sample at 4MHz & 2MHz rates in addition to the 
-      previous 1MHz and lower rates.  This is done via unrolled loops which
-      makes the source code huge and the binary takes much more of the flash.
-      v0.11 is just slightly to big for an ATmega168's flash.  You can comment
-      out either captureInline2mhz() or captureInline4mhz() and it will fit.
-      [ The code automatically skips the 2MHz code now, this isn't needed. ]
-
-NOTE: v0.09 switched the channels BACK to pins 8-13 for trigger reliability.
-      Please report any issues.  Uncomment USE_PORTD for pins 2-7.
-
-NOTE: The device profiles should be included with this code.  Copy them to the
-      'plugins' directory of the client.  The location varies depending on the
-      platform, but on the mac it is here by default:
-      /Applications/LogicSniffer.app/Contents/Resources/Java/plugins
-      [ These are included in ols-0.9.7 or newer so do not copy them. ]
-
-NOTE: If you are using the original SUMP client, then you will get a
-      "device not found" error.
-      You must DISABLE the Arduino auto reset feature to use this logic analyzer
-      code. There are various methods to do this, some boards have a jumper,
-      others require you to cut a trace.  You may also install a *precisely*
-      120 Ohm resistor between the reset & 5V piins.  Make sure it is really
-      120 Ohm or you may damage your board.  It is much easier to use the
-      alternative SUMP client referenced above.
-      [ This is not needed with ols-0.9.7 or newer. ]
-      [ DO NOT use this resistor unless absolutely necessary on old clients. ]
-
-NOTE: This master branch now supports Arduino 1.0 only.
-      Checkout branch logic_analyzer_v0_5 for Arduino 22 support.
-
-
-Release: v0.14 December 16, 2015.
-
--- a/README.md
+++ b/README.md
@@ -0,0 +1,142 @@
+SUMP compatible logic analyzer for Arduino
+==========================================
+
+This Arduino sketch implements a SUMP protocol compatible logic analyzer.
+This implementation is compatible with the standard SUMP client as well as
+an alternative OLS client.  More recently support has been added to Sigrok.
+
+This logic analyzer for Arduino supports 6 channels consisting of digital
+pins 8-13, which are the first 6 bits (0-5) of PORTB.
+Arduino pin 13 / bit 5 is the Arduino LED, bits 6 & 7 are the crystal
+oscillator pins. Comment out CHAN5 if you don't want to use the
+LED pin for an input.
+
+On the Arduino Mega board 8 channels are supported and 7k of samples.
+Pins 22-29 (Port A) are used by default.
+
+Installation
+============
+
+You can use the GitHub 'Download ZIP' feature to get an installable "library"
+for use with the Arduino IDE.  Select 'Sketch -> Include Library -> Add .ZIP Libary'
+from the Arduino IDE 2.x and select the zip file you downloaded from GitHub, then select open.
+
+Once installed you can use the 'File -> Examples -> LogicAnalyzer' menu to find
+different versions of the sketches.  You might want to start with `logic_analyzer_sigrok`
+and use PulseView.
+
+Client Software
+===============
+
+Sigrok support via the 'ols' device configuration has been added. This
+mostly involved returning the capture buffer in the reverse order.
+
+Use the `logic_analyzer_sigrok` sketch.  Since the OLS alternative client
+mentioned below has some issues with newer Java versions, Sigrok is currently
+the only practical way to use this logic analyzer.  If you use an older machine
+with an older operating system and older Java you can probably use the OLS client.
+
+Sigrok support seems to work fairly well so I would currently recommend it for
+anyone interested in trying this sketch.
+
+Run PulseView like this on Linux: (I'll add Windows options after more testing)
+```
+PulseView --driver=ols:conn=/dev/ttyUSB0 --dont-scan
+```
+
+It may be necessary to exit and relaunch PulseView to get it to recognize the device.
+An easy way to test the device is using the `sigrok-cli` utility. The command below
+samples channel 2 at 1MHz.  If you get a device not found error, but /dev/ttyUSB0 exists,
+run this command a couple times and usually it will start working. Due to the way opening
+the serial port resets the Arduino there are some issues/bugs to work out yet.
+```
+sigrok-cli --driver=ols:conn=/dev/ttyUSB0 --config samplerate=1Mhz --config pattern=External --samples 1024 --channels 2
+```
+
+The OLS alternative client hasn't had an official release recently so you will
+need to compile it yourself.
+
+Follow the build instructions here: https://github.com/jawi/ols
+
+
+Older details on the OLS client is available at the project page:
+https://lxtreme.nl/projects/ols/
+
+Direct link to older releases of the OLS alternative client:
+http://www.lxtreme.nl/ols/
+
+The alternative client version is highly recommended.  You can tried the older
+release ols-0.9.7.2 but most likely need to build it yourself. Use "ols-0.9.7"
+or newer for built-in device profiles.
+
+To use this with the original or alternative SUMP clients,
+use these settings:
+```
+Sampling rate: 4MHz (or lower) (no 2MHz on ATmega168)
+Channel Groups: 0 (zero) only
+Recording Size:
+   ATmega168:  532 (or lower)
+   ATmega328:  1024 (or lower)
+   ATmega2560: 7168 (or lower)
+Noise Filter: doesn't matter
+RLE: disabled (unchecked)
+```
+
+Using the Logic Analyzer
+========================
+Triggering is still a work in progress, but generally works for samples
+below 1MHz.  1MHz works for a basic busy wait trigger that doesn't store
+until after the trigger fires.
+
+Please try it out and report back.  Please provide a detailed bug report
+if you file an issue.
+
+Debugging
+=========
+
+You can uncomment the `#define DEBUG_MENU` line to add some diagnostic menu
+options for capturing or dumping the capture buffer.
+You can uncomment the `#define DEBUG` and `#define DEBUG_MENU` for a couple
+extra menu options and logging of the received commands.  The DEBUG option
+is generally only useful for development, while the DEBUG_MENU option is
+good for troubleshooting when the logic_analyzer sketch isn't working for you.
+Both are disabled by default to conserve RAM for improved stability.
+
+CLI compiling
+=============
+
+If you want to use the `arduino-cli` tool to compile this using the Makefile,
+you'll need to install the tool first following instructions here:
+https://arduino.github.io/arduino-cli/
+
+Once installed you can simple type `make` and you should get some simple help:
+```bash
+$ make
+---> run 'make build' to compile for Arduino Duemilanove
+---> run 'make upload' to upload to /dev/ttyUSB*
+```
+
+
+Other Notes
+===========================================================================
+```
+NOTE: Starting with v0.11 you can sample at 4MHz & 2MHz rates in addition to the 
+      previous 1MHz and lower rates.  This is done via unrolled loops which
+      makes the source code huge and the binary takes much more of the flash.
+      v0.11 is just slightly too big for an ATmega168's flash. The code 
+      automatically skips the 2MHz code on ATmega168
+
+NOTE: v0.09 switched the channels BACK to pins 8-13 for trigger reliability.
+      Please report any issues.  Uncomment USE_PORTD for pins 2-7.
+
+NOTE: If you are using the original SUMP client, then you will get a
+      "device not found" error.
+      You must DISABLE the Arduino auto reset feature to use this logic analyzer
+      code. There are various methods to do this, some boards have a jumper,
+      others require you to cut a trace.  You may also install a *precisely*
+      120 Ohm resistor between the reset & 5V piins.  Make sure it is really
+      120 Ohm or you may damage your board.  It is much easier to use the
+      alternative SUMP client referenced above.
+      [ This is not needed with ols-0.9.7 or newer. ]
+      [ DO NOT use this resistor unless absolutely necessary on old clients. ]
+```
--- a/examples/logic_analyzer/logic_analyzer.ino
+++ b/examples/logic_analyzer/logic_analyzer.ino
@@ -2,7 +2,7 @@
 *
 * SUMP Protocol Implementation for Arduino boards.
 *
- * Copyright (c) 2011,2012,2013,2014,2015 Andrew Gillham
+ * Copyright (c) 2011,2012,2013,2014,2015,2016,2017,2018,2019,2020,2021,2022,2023 Andrew Gillham
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
@@ -62,7 +62,7 @@
 * until after the trigger fires.
 * Please try it out and report back.
 *
- * Release: v0.14 December 16, 2015.
+ * Release: v0.17 October 5, 2023.
 *
 */

@@ -82,7 +82,8 @@ void get_metadata(void);
 void debugprint(void);
 void debugdump(void);
 void prettydump(void);
-
+void captureInline4mhz(void);
+void captureInline2mhz(void);

 /*
 * Should we use PORTD or PORTB?  (default is PORTB)
@@ -155,6 +156,9 @@ void prettydump(void);
 #if defined(__AVR_ATmega1280__) || defined(__AVR_ATmega2560__)
 #define DEBUG_CAPTURE_SIZE 7168
 #define CAPTURE_SIZE 7168
+#elif defined(__AVR_ATmega32U4__)
+#define DEBUG_CAPTURE_SIZE 2048
+#define CAPTURE_SIZE 2048
 #elif defined(__AVR_ATmega328P__)
 #define DEBUG_CAPTURE_SIZE 1024
 #define CAPTURE_SIZE 1024
@@ -467,7 +471,7 @@ void loop()
         * This runs a sample capture at 500KHz.
       * delayTime = 2ms for 500KHz.
       */
-      delayTime = 1;
+      delayTime = 2;
      captureMicro();
      Serial.println("");
      Serial.println("500KHz capture done.");
@@ -945,7 +949,7 @@ void get_metadata() {
  Serial.write('0');
  Serial.write('.');
  Serial.write('1');
-  Serial.write('3');
+  Serial.write('7');
  Serial.write((uint8_t)0x00);

  /* sample memory */
--- a/examples/logic_analyzer/logic_analyzer_inline_2mhz.ino
+++ b/examples/logic_analyzer/logic_analyzer_inline_2mhz.ino
@@ -2,7 +2,7 @@
 *
 * SUMP Protocol Implementation for Arduino boards.
 *
- * Copyright (c) 2011,2012,2013,2014,2015 Andrew Gillham
+ * Copyright (c) 2011,2012,2013,2014,2015,2016,2017,2018,2019,2020,2021,2022,2023 Andrew Gillham
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
--- a/examples/logic_analyzer/logic_analyzer_inline_4mhz.ino
+++ b/examples/logic_analyzer/logic_analyzer_inline_4mhz.ino
@@ -2,7 +2,7 @@
 *
 * SUMP Protocol Implementation for Arduino boards.
 *
- * Copyright (c) 2011,2012,2013,2014,2015 Andrew Gillham
+ * Copyright (c) 2011,2012,2013,2014,2015,2016,2017,2018,2019,2020,2021,2022,2023 Andrew Gillham
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
--- a/examples/logic_analyzer_leonardo/Makefile
+++ b/examples/logic_analyzer_leonardo/Makefile
@@ -0,0 +1,24 @@
+#
+# Makefile for an Arduino based logic analyzer using the arduino-cli
+#
+
+TARGET	= logic_analyzer_leonardo
+FQBN	= arduino:avr:leonardo
+SERIAL	= /dev/ttyUSB*
+
+
+all:
+	@echo ""
+	@echo "---> run 'make build' to compile for Arduino Leonardo"
+	@echo "---> run 'make upload' to upload to /dev/ttyUSB*"
+	@echo ""
+
+build:
+	arduino-cli compile --fqbn $(FQBN) $(TARGET)
+
+upload:
+	arduino-cli upload --fqbn $(FQBN) --port $(SERIAL) $(TARGET)
+
+#
+# end-of-file
+#
--- a/examples/logic_analyzer_leonardo/logic_analyzer_inline_2mhz.ino
+++ b/examples/logic_analyzer_leonardo/logic_analyzer_inline_2mhz.ino
--- a/examples/logic_analyzer_leonardo/logic_analyzer_inline_4mhz.ino
+++ b/examples/logic_analyzer_leonardo/logic_analyzer_inline_4mhz.ino
--- a/examples/logic_analyzer_leonardo/logic_analyzer_leonardo.ino
+++ b/examples/logic_analyzer_leonardo/logic_analyzer_leonardo.ino
--- a/examples/logic_analyzer_sigrok/logic_analyzer_inline_2mhz.ino
+++ b/examples/logic_analyzer_sigrok/logic_analyzer_inline_2mhz.ino
--- a/examples/logic_analyzer_sigrok/logic_analyzer_inline_4mhz.ino
+++ b/examples/logic_analyzer_sigrok/logic_analyzer_inline_4mhz.ino
--- a/examples/logic_analyzer_sigrok/logic_analyzer_sigrok.ino
+++ b/examples/logic_analyzer_sigrok/logic_analyzer_sigrok.ino
--- a/extras/ols.profile-agla.cfg
+++ b/extras/ols.profile-agla.cfg
--- a/extras/ols.profile-aglam.cfg
+++ b/extras/ols.profile-aglam.cfg
--- a/library.properties
+++ b/library.properties
@@ -0,0 +1,9 @@
+name=LogicAnalyzer
+version=0.17.0
+author=Andrew Gillham <gillham@roadsign.com>
+maintainer=Andrew Gillham <gillham@roadsign.com>
+sentence=A SUMP protocol compatible logic analyzer firmware
+paragraph=These firmware sketches provide a 6 channel logic analyzer for use with the SUMP protocol based OLS clients. There is also a Sigrok compatible firmware using the OpenBench Logic Sniffer (ols) driver .
+category=Signal Input/Output
+url=https://github.com/gillham/logic_analyzer
+architectures=avr
--- a/src/use_examples_for_logic_analyzer.h
+++ b/src/use_examples_for_logic_analyzer.h
@@ -0,0 +1,2 @@
+// This is a placeholder. Use File->Examples->LogicAnalyzer menu
+// for the logic analyzer sketches.
Author	SHA1	Message	Date
Andrew Gillham	ed0666863b	Rearrange the repository and add a library.properties file to make this installable as a .ZIP library in the Arduino IDE.	2023-10-05 22:32:52 -05:00
Andrew Gillham	739144d57e	Fix off by one on the capture buffer due to earlier debugging. I finally realized I was checking if an unsigned int was less than zero. Thanks Szilárd for the correct indexes in the issue comments.	2023-10-03 23:48:07 -05:00
Andrew Gillham	0b2651864e	Add a sketch with Sigrok support. Basically returning the capture buffer in the opposite order.	2023-10-03 23:00:05 -05:00
Andrew Gillham	71b7c4790d	Move README to README.md and update it.	2021-12-21 13:28:29 -06:00
Andrew Gillham	016eabdc12	Add a LICENSE file.	2021-12-21 12:51:32 -06:00
Andrew Gillham	1cdc52febc	Add a LICENSE file.	2021-12-21 12:35:18 -06:00
Andrew Gillham	a426e85f0d	Bump the metadata version to 0.15 also.	2021-12-21 12:01:55 -06:00
Andrew Gillham	b919640c7e	Add a note about needing to compile the OLS client yourself.	2021-12-21 11:43:55 -06:00
Andrew Gillham	636df223a4	Bump release to 0.15 now that we have re-organized.	2021-12-21 11:36:21 -06:00
Andrew Gillham	57b1f18900	Move the main ATMega328P sketch into a sub-directory and add the Leonardo sketch to a sub-directory from the branch. Helps folks that download the repository via ZIP file and will allow different board support that is not easily done via ifdef checks.	2021-12-21 11:27:31 -06:00
Andrew Gillham	4f7f86f6d4	Convert Makefile to use arduino-cli since that replaces arduino-core and arduino-builder.	2021-12-21 11:11:38 -06:00
gillham	bd1fbe504e	Merge pull request #51 from qaxi/master Wrong delayTime in 500KHz menu	2021-12-20 15:14:22 -06:00
Petr Klíma	cfacce1758	500KMz 500KHz line was mistakenly 1MHz	2019-12-15 19:08:39 +01:00
gillham	11b8b5bbda	Merge pull request #27 from dhiltonp/master Give Leonardo-type Arduinos 2k sample size.	2016-02-02 10:03:21 -08:00
David P Hilton	4233770315	Give Leonardo-type arduinos 2048 storage	2016-02-02 11:14:06 -05:00
Andrew Gillham	1e3f0696af	Update for CLI compiling. Add function declarations for the inline capture functions and add a note to the README explaining how to compile from the CLI using the ‘arduino-mk’ package. Known to work on Debian 8, but untested elsewhere.	2015-12-16 11:47:31 -08:00