**An Unofficial Python API for the tinySA Device Series**

A Non-GUI Python API for the tinySA series of spectrum analyzer devices. This library provides programmatic control over tinySA devices for automated measurements, data collection, and analysis.

A Non-GUI Python API for the tinySA series of spectrum analyzer devices. This library provides programmatic control over tinySA devices for automated measurements, data collection, and analysis.

[](https://badge.fury.io/py/tsapython)

[](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html)

pip install tsapython

from tsapythonimport TinySA

Popular features:

tsa= TinySA()

tsa.set_verbose(True)

tsa.set_error_byte_return(True)

-**Device Discovery**: Automatic detection and serial connection to tinySA devices

-**Frequency Sweeps**: Collect data across specified frequency ranges

-**Multiple Modes**: Support for both input and output modes (device dependent)

-**Data Export**: Easy integration with matplotlib, pandas, and numpy

-**Error Handling**: Error checking and verbose output options

-**Device Control**: Full programmatic control of tinySA settings and measurements

found, connected= tsa.autoconnect()

if connected:

print("Device connected!")

device_id= tsa.get_device_id()

print(f"Device ID:{device_id}")

start_freq=100e6# 100 MHz

stop_freq=500e6# 500 MHz

n_pts=101

tsa.pause()

freq_vals= tsa.hop(start_freq, stop_freq, n_pts,1)# Get frequencies

power_vals= tsa.hop(start_freq, stop_freq, n_pts,2)# Get power data

tsa.disconnect()

print("Data collection complete!")

else:

print("Could not connect to device")

This repository uses official resources and documentation but is**NOT** endorsed by the official tinySA product, owner, or company. Refer to official resources and support for product information. This library was built for the official tinySA device line(s), so any knock-off or custom devices may not be compatible with the library. Unofficial devices have not been tested.

import matplotlib.pyplotas plt

x_val= [float(x)for xin freq_vals.decode('utf-8').split()]

y_val= [float(x)for xin power_vals.decode('utf-8').split()]

[](https://badge.fury.io/py/tsapython)

[](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html)

plt.plot(x_val, y_val)

plt.xlabel("Frequency (Hz)")

plt.ylabel("Power (dBm)")

plt.title("tinySA Frequency Sweep")

plt.show()

Examples are provided for all of the following:

The README on the[main GitHub repo](https://github.com/LC-Linkous/tinySA_python) has provides examples for all of the following:

* Direct device interfacing and control

* Realtime and static waterfall plots

* Exporting data to CSV files

* Plotting live scan data

-**Device Discovery**: Automatic detection and connection to tinySA devices

-**Frequency Sweeps**: Collect data across specified frequency ranges

-**Multiple Modes**: Support for both input and output modes

-**Data Export**: Easy integration with matplotlib, pandas, and numpy

-**Error Handling**: Error checking and verbose output options

-**Device Control**: Full programmatic control of tinySA settings and measurements

- tinySA Basic

- tinySA Ultra

- (other devices pending testing)

Sample functions for device operation. See[GitHub](https://github.com/LC-Linkous/tinySA_python) for more examples.

-`autoconnect()` - Automatic device discovery and connection

-`disconnect()` - Clean disconnection from device

-`hop(start, stop, points, outmask)` - Collect measurement data over frequency range

-`scan(start, stop, points, outmask)` - Perform frequency scans

-`data()` - Get trace data from device screen

-`capture()` - Requests a screen dump to be sent in binary format of HEIGHTxWIDTH pixels of each 2 bytes

-`pause()` /`resume()` - Control measurement sweeps

-`set_marker_color(ID, RGB24color)` - Sets colors of traces

-`marker_on(ID)` / marker_off(ID)` - Turn marker on or off

-`restart_device()` - reset the device

-`set_verbose(enabled)` - Enable/disable detailed output

-`get_device_id()` /`set_device_id(id)` - Device identification

-`info()` - Get device firmware and hardware information

- Python 3.8+

- numpy

- pandas

- matplotlib

For comprehensive documentation, advanced examples, and troubleshooting:

-**GitHub Repository**:[https://github.com/yourusername/tsapython](https://github.com/yourusername/tsapython)

-**Official tinySA Documentation**:[https://tinysa.org/wiki/](https://tinysa.org/wiki/)

-**Library GitHub Repository**:[https://github.com/LC-Linkous/tinySA_python/](https://github.com/LC-Linkous/tinySA_python/)

-**Official tinySA Documentation**:[https://tinysa.org/wiki/](https://tinysa.org/wiki/), not associated with this library

1.**Windows**: Check Device Manager for COM port

2.**Linux**: Look for`/dev/ttyACM0` or similar, may need permissions:`sudo chmod a+rw /dev/ttyACM0`

3.**Multiple Devices**: Library will connect to first device found

try:

found, connected= tsa.autoconnect()

ifnot connected:

print("No device found")

exceptExceptionas e:

print(f"Error:{e}")

finally:

tsa.disconnect()

This is an unofficial community project. Contributions welcome!

- Report bugs and request features on[GitHub](https://github.com/LC-Linkous/tinySA_python)

- Check the official tinySA community at[https://groups.io/g/tinysa](https://groups.io/g/tinysa)

- For device information and OFFICIAL resources, check the official tinySA community at[https://groups.io/g/tinysa](https://groups.io/g/tinysa)

- Please do NOT request features or report bugs on the official community! This is an unofficial project and they do not maintain it.

- tinySA device creators and community, who have created an awesome device

- Official tinySA documentation and resources, especiallywww.tinysa.org/wiki/

- All contributors to this library, including those who have contributed code and reached out with questions.

- All contributors to this library, including those who have contributed code and reached out with questions