From c71b4cffd19630e0bc6be0c05acf2c1ea8e4c063 Mon Sep 17 00:00:00 2001 From: Marcus10110 Date: Mon, 14 Nov 2016 14:05:30 -0800 Subject: [PATCH] Updated readme to contain information about how to debug on Windows. --- readme.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/readme.md b/readme.md index 627fc79..045a5b8 100644 --- a/readme.md +++ b/readme.md @@ -31,5 +31,18 @@ To build on Linux or OSX, run the build_analyzer.py script. The compiled librari python build_analyzer.py +To debug on Windows, please first review the article here: +[How do I develop custom analyzers for the Logic software on Windows?](http://support.saleae.com/hc/en-us/articles/208666946) +On Windows, it is not possible to attach a debugger to the latest software. In order to debug custom analyzers on Windows, you need to use an older version of the Windows software. +Specifically, you will need the Saleae Logic 1.1.18 Windows 32 bit standalone release. You can find it here: + +[Older Saleae Logic Beta Downloads](http://support.saleae.com/hc/en-us/articles/210245603) + +You will also need the 1.1.14 SDK, the last SDK release to support software versions 1.1.14-1.1.18. That is available on a separate branch of the Saleae AnalyzerSDK Github repository. Simply change the submodule configuration to point to that branch, and the existing visual studio project will just work. Be sure to only compile for 32 bit, since the 1.1.14 SDK was released before Saleae began targeting 64 bit Windows. This is also why the 32 bit standalone version of the 1.1.18 software is required. +It's also worth noting that you should use a #define and #ifdef to remove the contents of your Analyzer's GenerateFrameTabularText methods, because the methods ClearTabularText and AddTabularText were not yet present in the 1.1.14 SDK. + +The Sample Analyzer Project also contains a branch, 1.1.14-for-win32-debug, which already contains the updated git submodule branch. Simply merge your changes into that branch, and then you will not need to switch submodule branches. + +In the future, I would like to update this so that no branch changes are required, and the visual studio project just contains configurations for both the latest SDK and the 1.1.14 SDK.