5.1 KiB
tinySA - tiny Spectrum Analyzer
About
tinySA is very tiny handheld Spectrum Analyzer (SA). It is standalone with lcd display, portable device with battery. This project aim to provide an useful instrument for the RF enthusiast.
This repository contains source of tinySA firmware.
Support
General tinySA support questions should be posted here: https://groups.io/g/tinysa/messages
Use github issue list only for firmware bugs and preferrably cross post to: https://groups.io/g/tinysa/messages
Prepare ARM Cross Tools
The released firmware is built with Arm GNU Toolchain 11.3.Rel1 (arm-none-eabi-gcc 11.3.1 20220712), on Windows the "GNU Tools ARM Embedded\11.3 2022.08" toolchain of ChibiStudio. Use exactly this version. Parts of the firmware depend on how fast the compiled code runs, and firmware built with other gcc versions is known to show noise or fail the self test (issues #70 and #152).
All versions are on the Arm GNU Toolchain downloads page. Check the version in use with
$ arm-none-eabi-gcc --version
MacOSX
Install the cross tools and the firmware updating tool.
$ curl -LO https://developer.arm.com/-/media/Files/downloads/gnu/11.3.rel1/binrel/arm-gnu-toolchain-11.3.rel1-darwin-x86_64-arm-none-eabi.tar.xz
$ sudo tar xfJ arm-gnu-toolchain-11.3.rel1-darwin-x86_64-arm-none-eabi.tar.xz -C /usr/local
$ PATH=/usr/local/arm-gnu-toolchain-11.3.rel1-darwin-x86_64-arm-none-eabi/bin:$PATH
$ brew install dfu-util
Linux (ubuntu)
$ wget https://developer.arm.com/-/media/Files/downloads/gnu/11.3.rel1/binrel/arm-gnu-toolchain-11.3.rel1-x86_64-arm-none-eabi.tar.xz
$ sudo tar xfJ arm-gnu-toolchain-11.3.rel1-x86_64-arm-none-eabi.tar.xz -C /usr/local
$ PATH=/usr/local/arm-gnu-toolchain-11.3.rel1-x86_64-arm-none-eabi/bin:$PATH
$ sudo apt install -y dfu-util
Fetch source code
Fetch source and submodule.
$ git clone https://github.com/erikkaashoek/tinySA.git
$ cd tinySA
$ git submodule update --init --recursive
Build
Just make in the directory.
$ make
For tinySA Ultra use this command
$ make TARGET="F303"
Build firmware using docker
Using this docker image and without installing arm toolchain, you can build the firmware. Note that this image has gcc 8.2, not the release toolchain (see above).
$ cd tinySA
$ docker run -it --rm -v $(PWD):/work edy555/arm-embedded:8.2 make
Flash firmware
First, make device enter DFU mode by one of following methods.
- Jumper BOOT0 pin at powering device
- Select menu Config->DFU (needs recent firmware)
Then, flash firmware using dfu-util via USB.
$ dfu-util -d 0483:df11 -a 0 -s 0x08000000:leave -D build/ch.bin
Or simply use make.
$ make flash
Update from the SD card (tinySA Ultra)
The tinySA Ultra can install a new firmware from its SD card, without DFU:
- Copy the firmware
.binfile to the root folder of the SD card, for example with STORAGE→USB DISK. Eject the drive when the copy is done. - Select STORAGE→UPDATE FIRMWARE, pick the file and confirm with UPDATE.
- The tinySA checks the file, programs it in about 10 seconds and restarts. Do not switch it off or remove the SD card during the update. If the card is removed anyway, the update waits and continues when it is inserted again.
Settings, calibration and presets are kept. The shell command fwupdate {file} checks a file without changing anything, fwupdate {file} flash installs it.
Only firmware that contains the update header (from this version on) can be installed from the SD card; older versions and the tinySA basic firmware are refused. If an update is interrupted, the tinySA does not start: hold the jog button while switching on to enter DFU mode and flash the firmware with a PC as above.
Companion Tools
There are several numbers of great companion PC tools from third-party.
- Soon to come by Erik
- tinySASaver by Erik
Documentation
Reference
Note
tinySA is a trademark owned by its respective owner. Unauthorized use the the name tinySA not permitted