KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #codex #claude-code #mcp #rust #deepseek-harness #typescript #ai-agent #cli

FutureSDR

★ 466 Open GitHub ↗

An Async SDR Runtime for Heterogeneous Architectures

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# FutureSDR

An experimental asynchronous SDR runtime for heterogeneous architectures that
is:

* **Extensible**: custom buffers (supporting accelerators like GPUs and FPGAs)
  and custom schedulers (optimized for your application).

* **Asynchronous**: solving long-standing issues around IO, blocking, and
  timers.

* **Portable**: Linux, Windows, Mac, WASM, Android, and prime support for
  embedded platforms through a REST API and web-based GUIs.

* **Fast**: SDR go brrr!

[![Crates.io][crates-badge]][crates-url]
[![Apache 2.0 licensed][apache-badge]][apache-url]
[![Build Status][actions-badge]][actions-url]

[crates-badge]: https://img.shields.io/crates/v/futuresdr.svg
[crates-url]: https://crates.io/crates/futuresdr
[apache-badge]: https://img.shields.io/badge/license-Apache%202-blue
[apache-url]: https://github.com/futuresdr/futuresdr/blob/main/LICENSE
[actions-badge]: https://github.com/futuresdr/futuresdr/workflows/CI/badge.svg
[actions-url]: https://github.com/futuresdr/futuresdr/actions?query=workflow%3ACI+branch%3Amain

[Website](https://www.futuresdr.org) |
[Guides](https://www.futuresdr.org/learn) |
[API Docs](https://docs.rs/futuresdr/latest/futuresdr) |
[Chat](https://discord.com/invite/vCz29eDbGP/)

## Overview

FutureSDR supports *Blocks* with synchronous or asynchronous implementations for
stream-based or message-based data processing. Blocks can be combined to a
*Flowgraph* and launched on a *Runtime* that is driven by a *Scheduler*.

* Single and multi-threaded schedulers, including examples for
  application-specific implementations.
* Portable GPU acceleration using WGPU (supports native and browser targets).
* Example user-space DMA integration for Xilinx Zynq FPGAs.

## Development

Since FutureSDR is in an early state of development, it is likely that SDR
applications will require changes to the runtime. We, therefore, do not
recommend to add it as a dependency in a separate project but to clone the
repository and implement the application as binary, example, or sub-crate.

## Example

An example flowgraph that forwards 123 zeros into a sink:

``` rust
use futuresdr::anyhow::Result;
use futuresdr::blocks::Head;
use futuresdr::blocks::NullSink;
use futuresdr::blocks::NullSource;
use futuresdr::macros::connect;
use futuresdr::runtime::Flowgraph;
use futuresdr::runtime::Runtime;

fn main() -> Result<()> {
    let mut fg = Flowgraph::new();

let src = NullSource::<u8>::new();
    let head = Head::<u8>::new(123);
    let snk = NullSink::<u8>::new();

connect!(fg, src > head > snk);

Runtime::new().run(fg)?;

Ok(())
}
```

## Credits

* The LoRa example is based on a Rust port of [gr-lora-sdr](https://github.com/tapparelj/gr-lora_sdr).
* The M17 example is based on the C implementation of [SP5WWP](https://github.com/M17-Project/M17_Implementations).
* The Rattlegram example is based on the [Rattelgram](https://github.com/aicodix/rattlegram) app.
* The Remez Exchange algorithm in FutureDSP is a Rust port of the [implementation of Jake Janovetz](https://github.com/janovetz/remez-exchange).
* The WLAN example is based on a Rust port of [gr-ieee802-11](https://github.com/bastibl/gr-ieee802-11).
* The ZigBee example is based on a Rust port of [gr-ieee802-15-4](https://github.com/bastibl/gr-ieee802-15-4).

## Contributing

Contributions are very welcome. Please see the (work-in-progress) [contributing
guide][contr] for more information. If you develop larger features or work on
major changes with the main intention to submit them upstream, it would be
great, if you could announce them in advance.

[contr]: https://github.com/futuresdr/futuresdr/blob/main/CONTRIBUTING.md

## Conduct

The FutureSDR project adheres to the [Rust Code of Conduct][coc]. It describes
the _minimum_ behavior expected from all contributors.

[coc]: https://www.rust-lang.org/policies/code-of-conduct

## License

This project is licensed under the [Apache 2.0 license][lic].

The main motivation for this license is that
* it better fits the Rust ecosystem
* it eases adoption; one can use (parts of) the code with close to no strings
  attached
* using Open Source and not contributing back (for the time being) seems better
  than not using Open Source at all

[lic]: https://github.com/futuresdr/futuresdr/blob/main/LICENSE

## Contributions

Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in FutureSDR, shall be licensed as Apache 2.0, without any
additional terms or conditions.

FutureSDR

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README