joao barraca / Mbed 2 deprecated LogicAlNucleo

A bare to the bones, SUMP compatible, simple Logical Analyser. Mainly for the F401RE platform, but portable to many other platforms.

Dependencies:   mbed

README.md@0:41db3ed6754d, 2016-03-12 (annotated)

Committer:
jpbarraca
Date:
Sat Mar 12 00:18:53 2016 +0000
Revision:
0:41db3ed6754d
v0.1.2.1

Who changed what in which revision?

UserRevisionLine numberNew contents of line
jpbarraca 0:41db3ed6754d 1 # LogicAlNucleo
jpbarraca 0:41db3ed6754d 2
jpbarraca 0:41db3ed6754d 3 A SUMP compatible Logical Analyser for the NucleoF401RE (STM32F4xx) almost up to 10MSPS, 8Ch, 32K samples memory.
jpbarraca 0:41db3ed6754d 4
jpbarraca 0:41db3ed6754d 5 This will turn any NucleoF401RE (will work with other boards but it was not tested) system into a Logical Analyser compatible with a subset of the SUMP protocol. It can be used with clients such as [PulseView](http://sigrok.org/wiki/PulseView), [sigrok-cli](http://sigrok.org/wiki/Sigrok-cli), and [LogicSniffer](http://www.lxtreme.nl/ols/). While it is not as feature complete as other products, such as the [OLS](http://dangerousprototypes.com/docs/Open_Bench_Logic_Sniffer), it can turn that STM32 board that is lying around into a no frills, bare to the bones, logic analyser.
jpbarraca 0:41db3ed6754d 6
jpbarraca 0:41db3ed6754d 7 Sampling rate up to 500KSPS should work on most platforms. Higher than that, only the F401RE, or other similar >84Mhz platform should provide results with accurate timing measurements up to 5MSPS. 10MSPS will be accepted but do not trust timing information as the board cannot really keep up with this speed. However this sampling rate can still be usefull. If you wish to add support for other platforms, please focus in creating the appropriate unrolled loops callibrated with an osciloscope.
jpbarraca 0:41db3ed6754d 8
jpbarraca 0:41db3ed6754d 9 PORTB is current used, and Pins PB_0 to PB_7 are reported. Unfortunately these pins are scattered over the board and are not contiguous. Check [this](http://developer.mbed.org/platforms/ST-Nucleo-F401RE/) diagram to find them.
jpbarraca 0:41db3ed6754d 10
jpbarraca 0:41db3ed6754d 11 This implementation was based in the [mbed](https://mbed.org/) environment in order to increase its compatibility, as new targets are expected to be supported. The focus of this implementation is compatibility and extensibility, and not only performance.
jpbarraca 0:41db3ed6754d 12
jpbarraca 0:41db3ed6754d 13 ## Features
jpbarraca 0:41db3ed6754d 14
jpbarraca 0:41db3ed6754d 15 ### Supported
jpbarraca 0:41db3ed6754d 16 - Configurable sampling rate up to 10Mhz on the F401RE platform
jpbarraca 0:41db3ed6754d 17 - Basic parallel triggers
jpbarraca 0:41db3ed6754d 18 - Generic compatibility with other platforms through the MBED API
jpbarraca 0:41db3ed6754d 19 - Test mode where PWM signals from 1us to 500ms will be generated and then captured. You can use this mode to test the accuracy of each mode.
jpbarraca 0:41db3ed6754d 20
jpbarraca 0:41db3ed6754d 21 ### Planned
jpbarraca 0:41db3ed6754d 22 - RLE support
jpbarraca 0:41db3ed6754d 23 - Serial triggers (for speeds lower than 1MSPS)
jpbarraca 0:41db3ed6754d 24 - Post trigger delay
jpbarraca 0:41db3ed6754d 25 - External test modes
jpbarraca 0:41db3ed6754d 26
jpbarraca 0:41db3ed6754d 27 ### Limitations
jpbarraca 0:41db3ed6754d 28
jpbarraca 0:41db3ed6754d 29 - Reaching 10MSPS requires the use of synchronous code (instead of a much better asynchronous, interrupt based approach, yet slower). If the sampling function is waiting for results or for a trigger, the board will be "stuck" waiting. Just push the reset and move on as nothing is wrong. The Green LED will be active if the board is waiting for the acquisition process to finish.
jpbarraca 0:41db3ed6754d 30
jpbarraca 0:41db3ed6754d 31 ## Download
jpbarraca 0:41db3ed6754d 32
jpbarraca 0:41db3ed6754d 33 Get the source code from github and compile it using the ARM toolchain available from the [Launchpad page](https://launchpad.net/gcc-arm-embedded/+download). If you have the toolchain available, the Makefile will take care of all compilation and linking.
jpbarraca 0:41db3ed6754d 34
jpbarraca 0:41db3ed6754d 35 In alternative you can also use the code in [mbed](https://mbed.org/). Just load the code without the mbed directory.
jpbarraca 0:41db3ed6754d 36
jpbarraca 0:41db3ed6754d 37 Finally download the latest precompiled binary from the [releases web page](https://github.com/jpbarraca/LogicAlNucleo/releases) and flash it. The binary file suits the NUCLEO-F401RE board.