feat: Add SBS-1/BaseStation format output module

- Implement complete SBS-1/BaseStation CSV format on port 30004
- Add --sbs1 and --sbs1-port command line arguments
- Support MSG types 1,3,4,5 for identification, position, and velocity
- Include proper timestamp formatting and ICAO address parsing
- Add comprehensive documentation with protocol references
- Maintain compatibility with BaseStation and Virtual Radar Server
- Integrate with existing dynamic output module architecture

References:
- BaseStation Protocol: http://woodair.net/sbs/article/barebones42_socket_data.htm
- SBS-1 Data Format: http://www.homepages.mcb.net/bones/SBS/Article/Barebones42_Socket_Data.htm

Author: ccustine

CLAUDE.md

@@ -9,17 +9,17 @@ AviAware is an ADS-B (Automatic Dependent Surveillance–Broadcast) decoder writ
 ## Build and Run Commands
 
 ```bash
-# Build and run in release mode (recommended for actual use)
-cargo run --release
+# Development build and run (recommended for actual use)
+cargo run
 
 # Build only
-cargo build --release
+cargo build
 
-# Development build and run
-cargo run
+# Build and run in release mode
+cargo run --release
 
 # Run with custom parameters (see listen-adsb binary for all options)
-cargo run --release -- --gain 40.0 --preamble-threshold 12.0
+cargo run -- --gain 40.0 --preamble-threshold 12.0
 ```
 
 ## Architecture
@@ -76,4 +76,55 @@ For testing/replay:
 cargo run --release -- --file samples.cf32
 ```
 
-Input files should be Complex32 format at any sample rate ≥ 2 MHz.
+Input files should be Complex32 format at any sample rate ≥ 2 MHz.
+
+## Output Formats
+
+AviAware supports multiple output formats for compatibility with various ADS-B tools and applications:
+
+### BEAST Format (Port 30005)
+- **Default**: Enabled by default
+- **Description**: Binary format compatible with dump1090's BEAST mode
+- **Usage**: `--beast` / `--no-beast`, `--beast-port <PORT>`
+- **Protocol**: Binary messages with timestamps and signal levels
+- **Compatibility**: dump1090, tar1090, FlightRadar24 feeders
+
+### Raw Format (Port 30002)
+- **Default**: Enabled by default
+- **Description**: Simple hex format compatible with dump1090's raw output
+- **Usage**: `--raw` / `--no-raw`, `--raw-port <PORT>`
+- **Protocol**: `*{hexdata};\n` format
+- **Compatibility**: dump1090 port 30002, simple monitoring tools
+
+### AVR Format (Port 30003)
+- **Default**: Disabled by default
+- **Description**: Text format with timestamps and signal levels
+- **Usage**: `--avr`, `--avr-port <PORT>`
+- **Protocol**: `@{timestamp}\n*{hexdata};\n` format
+- **Compatibility**: dump1090 AVR format, debugging tools
+
+### SBS-1/BaseStation Format (Port 30004)
+- **Default**: Disabled by default
+- **Description**: CSV format compatible with BaseStation and SBS-1 receivers
+- **Usage**: `--sbs1`, `--sbs1-port <PORT>`
+- **Protocol**: Comma-separated values with aircraft data
+- **Compatibility**: BaseStation, Virtual Radar Server, PlanePlotter
+- **References**: 
+  - [BaseStation Protocol](http://woodair.net/sbs/article/barebones42_socket_data.htm)
+  - [SBS-1 Data Format](http://www.homepages.mcb.net/bones/SBS/Article/Barebones42_Socket_Data.htm)
+
+## Example Usage
+
+```bash
+# Run with defaults (BEAST + Raw)
+cargo run
+
+# Enable all output formats
+cargo run -- --avr --sbs1
+
+# Custom ports to avoid conflicts
+cargo run -- --beast-port 40005 --raw-port 40002 --sbs1-port 40004
+
+# Enable only SBS-1 output
+cargo run -- --no-beast --no-raw --sbs1
+```

Cargo.toml

@@ -25,6 +25,7 @@ soapy = ["futuresdr/soapy"]
 adsb_deku = "0.7"
 anyhow = "1.0"
 async-trait = "0.1"
+chrono = "0.4"
 clap = { version = "4", features = ["derive"] }
 futuresdr = { version = "0.0.38", features = ["seify"] }
 serde = { version = "1", features = ["derive"] }

src/bin/listen_adsb.rs

@@ -1,6 +1,6 @@
 use adsb_demod::DEMOD_SAMPLE_RATE;
 use adsb_demod::{OutputModuleConfig, OutputModuleManager};
-use adsb_demod::{BeastOutput, AvrOutput, RawOutput};
+use adsb_demod::{BeastOutput, AvrOutput, RawOutput, Sbs1Output};
 use adsb_demod::Decoder;
 use adsb_demod::Demodulator;
 use adsb_demod::PreambleDetector;
@@ -68,6 +68,12 @@ struct Args {
     /// Port for raw format output
     #[arg(long, default_value_t = 30002)]
     raw_port: u16,
+    /// Enable SBS-1/BaseStation format output (port 30004 compatible)
+    #[arg(long)]
+    sbs1: bool,
+    /// Port for SBS-1/BaseStation format output
+    #[arg(long, default_value_t = 30004)]
+    sbs1_port: u16,
 }
 
 fn sample_rate_parser(sample_rate_str: &str) -> Result<f64, String> {
@@ -196,6 +202,19 @@ async fn main() -> Result<()> {
         }
     }
 
+    if args.sbs1 {
+        let config = OutputModuleConfig::new("sbs1", args.sbs1_port).with_buffer_capacity(1024);
+        match Sbs1Output::new(config).await {
+            Ok(module) => {
+                println!("SBS-1/BaseStation format server started on port {}", args.sbs1_port);
+                output_manager.add_module(Box::new(module));
+            }
+            Err(e) => {
+                eprintln!("Failed to start SBS-1 server: {}", e);
+            }
+        }
+    }
+
     // Create tracker with dynamic output module system
     let prune_after = args.lifetime.map(Duration::from_secs);
     let tracker = Tracker::new_with_modules(prune_after, output_manager);

src/lib.rs

@@ -37,6 +37,9 @@ pub use avr_output::{AvrBroadcaster, AvrMessage, AvrServer, AvrOutput, AvrOutput
 mod raw_output;
 pub use raw_output::{RawBroadcaster, RawMessage, RawServer, RawOutput, RawOutputBuilder};
 
+mod sbs1_output;
+pub use sbs1_output::{Sbs1Broadcaster, Sbs1Message, Sbs1Server, Sbs1Output, Sbs1OutputBuilder};
+
 mod output_module;
 pub use output_module::{OutputModule, OutputModuleBuilder, OutputModuleConfig, OutputModuleManager, OutputModuleRegistry};