aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorClyne Sullivan <clyne@bitgloo.com>2022-05-22 09:54:47 -0400
committerClyne Sullivan <clyne@bitgloo.com>2022-05-22 09:54:47 -0400
commit6440499396ac1b086b618ab94034581a8b218725 (patch)
treeeb6cda7d8eddb6b8fd05fd1e1c450d34add6a4b1
parent30cf6ea38bdd58b663f0b6fc56141293ec0a204e (diff)
parent3cc4b8ec2dd2daa054086ce8230dc53a4acda7ad (diff)
Merge branch 'master' of ssh://code.bitgloo.com:222/clyne/stmdsp
-rw-r--r--README.md28
1 files changed, 13 insertions, 15 deletions
diff --git a/README.md b/README.md
index dd9934b..3791874 100644
--- a/README.md
+++ b/README.md
@@ -1,25 +1,23 @@
# stmdsp
-The `stmdsp` project enables certain STM32 development boards to be used as a digital signal processing (DSP) education tool.
+The *stmdsp* project enables certain STM32 development boards to be used as a digital signal processing (DSP) education tool. The solution is portable, and can be used without any external tools or lab equipment.
-The project consists of two parts: the firmware, which allows users to upload custom DSP algorithms to process signals in real-time; and the GUI currently named [stmdspgui](https://code.bitgloo.com/clyne/stmdspgui), which facilitates algorithm design, upload, and execution, while also providing numerous analysis features.
-
-The firmware for the device is written in C++, building on top of the [ChibiOS](https://www.chibios.org/dokuwiki/doku.php) real-time operating system.
+The project consists of three parts: the firmware, which allows users to upload custom DSP algorithms to process signals in real-time; the hardware, which provides the necessary circuitry for interfacing with signals and the host computer; and the computer software, a program currently named [stmdspgui](https://code.bitgloo.com/clyne/stmdspgui) that facilitates algorithm design and execution while also providing numerous analysis features.
## Features
-* Real-time signal processing: the input channel is read from the ADC, and the processed output is sent out over the DAC.
-* Signal sampling rates from 8kS/s up to 96kS/s.
-* Custom algorithms, uploaded over USB at run-time, can be applied to the input signal.
-* The second DAC channel can act as a signal generator, should no other input be available.
-* Analysis features, including measuring algorithm execution time and logging input and output samples.
-
-## Supported development boards
+* Real-time signal processing: signal readings from the ADC are streamed through the loaded algorithm and outputted over the DAC.
+* Supports signal sampling rates from 8kS/s up to 96kS/s.
+* Supports signals between -3.3V and +3.3V, with adequate protection for the development board.
+* Custom algorithms are uploaded to the hardware at run-time, enabling a faster design and test process.
+* Parameter knobs allow for algorithm adjustments while the algorithm is running.
+* An on-board signal generator eliminates the need for external generators.
+* Numerous analysis features, including signal visualization and measuring algorithm execution time, eliminate the need for other external tools.
-This project is aided by a custom add-on board, which is designed to stack on top of STMicroelectronic's NUCLEO line of dev boards.
+## Learn more
-At the moment, only the NUCLEO-L476RG board is fully supported.
+See the [project's wiki](https://code.bitgloo.com/clyne/stmdsp/wiki/Home) for more details. The `doc` folder also contains add-on board schematics and a work-in-progress PDF guide (which may later be abandoned in favor of the wiki).
-## Programming instructions and more information
+### Licensing
-See the `doc` folder for further project documentation, including a PDF guide.
+The *stmdsp*, *stmdspgui*, and ChibiOS projects are all licensed under version three of the GNU General Public License.