{"id":13994594,"url":"https://github.com/rsadsb/dump1090_rs","last_synced_at":"2025-07-22T19:32:55.629Z","repository":{"id":36994242,"uuid":"408615790","full_name":"rsadsb/dump1090_rs","owner":"rsadsb","description":"Multi-SDR supported Rust translation of the popular dump1090 project for ADS-B demodulation","archived":false,"fork":false,"pushed_at":"2024-08-09T11:48:50.000Z","size":1627,"stargazers_count":96,"open_issues_count":10,"forks_count":7,"subscribers_count":9,"default_branch":"master","last_synced_at":"2024-08-10T14:16:33.207Z","etag":null,"topics":["adsb","aircraft","dsp","rtlsdr","rust"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rsadsb.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["wcampbell0x2a"]}},"created_at":"2021-09-20T22:16:23.000Z","updated_at":"2024-08-03T18:47:39.000Z","dependencies_parsed_at":"2023-12-15T20:06:55.343Z","dependency_job_id":"b71d6f56-29cd-44ae-af66-6e4a0282fbdc","html_url":"https://github.com/rsadsb/dump1090_rs","commit_stats":{"total_commits":164,"total_committers":6,"mean_commits":"27.333333333333332","dds":"0.15243902439024393","last_synced_commit":"d2e60a824df459b736cbc660701c019ddc670a6c"},"previous_names":[],"tags_count":11,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rsadsb%2Fdump1090_rs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rsadsb%2Fdump1090_rs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rsadsb%2Fdump1090_rs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rsadsb%2Fdump1090_rs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rsadsb","download_url":"https://codeload.github.com/rsadsb/dump1090_rs/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227166817,"owners_count":17740986,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adsb","aircraft","dsp","rtlsdr","rust"],"created_at":"2024-08-09T14:02:58.153Z","updated_at":"2024-11-29T16:31:37.677Z","avatar_url":"https://github.com/rsadsb.png","language":"Rust","funding_links":["https://github.com/sponsors/wcampbell0x2a"],"categories":["Rust"],"sub_categories":[],"readme":"# dump1090_rs\n[\u003cimg alt=\"github\" src=\"https://img.shields.io/badge/github-rsadsb/dump1090_rs-8da0cb?style=for-the-badge\u0026labelColor=555555\u0026logo=github\" height=\"20\"\u003e](https://github.com/rsadsb/dump1090_rs)\n[\u003cimg alt=\"build status\" src=\"https://img.shields.io/github/actions/workflow/status/rsadsb/dump1090_rs/main.yml?branch=master\u0026style=for-the-badge\" height=\"20\"\u003e](https://github.com/rsadsb/dump1090_rs/actions?query=branch%3Amaster)\n\nDemodulate a ADS-B signal from a software defined radio device tuned at 1090mhz and\nforward the bytes to applications such as [adsb_deku/radar](https://github.com/rsadsb/adsb_deku).\n\n- See [quickstart-guide](https://rsadsb.github.io/quickstart.html) for a quick installation guide.\n- See [rsadsb-2024.09.02](https://rsadsb.github.io/2024.09.02.html) for latest major release details.\n\n## Tested Support\n\nThrough the use of the [rust-soapysdr](https://github.com/kevinmehall/rust-soapysdr) project,\nwe support [many different](https://github.com/pothosware/SoapySDR/wiki) software defined radio devices.\nIf you have tested this project on devices not listed below, let me know!\n(you will need to add gain settings to [config.toml](dump1090_rs/config.toml) or use `--custom-config`)\n\n| Device                | Supported/Tested | Recommend | argument          |\n| --------------------- | :--------------: | :-------: | ----------------- |\n| rtlsdr                |        x         |     x     | `--driver rtlsdr` |\n| HackRF                |        x         |           | `--driver hackrf` |\n| uhd(USRP)             |        x         |           | `--driver uhd`    |\n| bladeRF 2.0 micro xA4 | x                |           | `--driver bladerf`|\n\n\n## Usage\n**Minimum Supported Rust Version**: 1.74.0\n\n## Build\n\nInstall `soapysdr` drivers and library and `libclang-dev`.\n\n### Note\nUsing `debug` builds will result in SDR overflows, always using `--release` for production.\n\n### Ubuntu\n```\n\u003e apt install libsoapysdr-dev libclang-dev\n```\n\n### Cross Compile\nUse [hub.docker.com/r/rsadsb](https://hub.docker.com/r/rsadsb/ci/tags) for cross compiling to the following archs.\nThese images already have `soapysdr` installed with the correct cross compilers.\nThis uses [cross-rs](https://github.com/cross-rs/cross).\n```\n\u003e cargo install cross\n\u003e cross build --workspace --target x86_64-unknown-linux-gnu --relese\n\n# Used for example in Raspberry Pi (raspios) 32 bit\n\u003e cross build --workspace --target armv7-unknown-linux-gnueabihf --release\n\n# Used for example in Raspberry Pi (raspios) 64 bit\n\u003e cross build --workspace --target aarm64-unknown-linux-gnu --release\n```\n\n### Release Builds from CI\nCheck the [latest release](https://github.com/rsadsb/dump1090_rs/releases) for binaries built from the CI.\n\n## Run\nRun the software using the default rtlsdr.\n```\n\u003e cargo r --release\n```\n\n### help\n\nSee `--help` for detailed information.\n```\nADS-B Demodulator and Server\n\nUsage: dump1090_rs [OPTIONS]\n\nOptions:\n      --host \u003cHOST\u003e                    ip address to bind with for client connections [default: 127.0.0.1]\n      --port \u003cPORT\u003e                    port to bind with for client connections [default: 30002]\n      --driver \u003cDRIVER\u003e                soapysdr driver name (sdr device) from default `config.toml` or `--custom-config` [default: rtlsdr]\n      --driver-extra \u003cDRIVER_EXTRA\u003e    specify extra values for soapysdr driver specification\n      --custom-config \u003cCUSTOM_CONFIG\u003e  Filepath for config.toml file overriding or adding sdr config values for soapysdr\n  -h, --help                           Print help (see more with '--help')\n  -V, --version                        Print version\n```\n\n## Performance tricks\n\nTo enable maximum performance, instruct rustc to use features specific to your cpu.\n```\n\u003e RUSTFLAGS=\"-C target-cpu=native\" cargo r --release\n```\n\nAlways use the latest rust releases including nightly, currently this gives around a 5-10% performance\nboost.\n\n## Testing\n```\n\u003e cargo t --workspace --release\n```\n\n## Benchmark\n\nReading from a 512KB iq sample to ADS-B bytes takes ~3.0 ms, but feel free to run benchmarks on your own computer.\n```\n\u003e RUSTFLAGS=\"-C target-cpu=native\" cargo bench --workspace\n```\n\n### Intel i7-7700K CPU @ 4.20GHz\n```\n01                      time:   [3.6691 ms 3.6950 ms 3.7264 ms]\n02                      time:   [3.5941 ms 3.5987 ms 3.6040 ms]\n03                      time:   [3.4930 ms 3.4961 ms 3.4994 ms]\n```\n\n# Changes\nSee [CHANGELOG.md](https://github.com/rsadsb/dump1090_rs/blob/master/CHANGELOG.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frsadsb%2Fdump1090_rs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frsadsb%2Fdump1090_rs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frsadsb%2Fdump1090_rs/lists"}