Skip to content

Latest commit

 

History

History
185 lines (119 loc) · 8.17 KB

README.md

File metadata and controls

185 lines (119 loc) · 8.17 KB

DragonSync iOS

Revolutionize your airspace awareness. Bridge the power of WarDragon to your iOS device. Stay ahead with real-time monitoring & alerts.

TestFlight is open: Join the beta

Features

  • Real-Time Airspace Monitoring
    Keep an eye on the status and location of Remote ID-compliant drones on your iOS device. You can see their flight paths and get all the decoded data from any RID broadcast. Everything in the app is updated in real time.

  • Spoof Detection Refined algorithms to spot any unusual patterns in flight data. It gives you a confidence score and all the juicy details when it detects spoofing.

    image

  • MAC Randomization Alerts Associates all addresses to the origin ID for full source transparency.

    image

  • Transmission Identification Decodes the source information and displays the type of signal (WiFi, Bluetooth, or SDR) it originated from, along with the corresponding MAC addresses.

    image

  • Instant System Alerts
    Keep an eye on your system’s performance and location with real-time updates. You’ll get info on memory, GPS, CPU, temperature, and more. WarDragon Pro even shows ANTSDR dio temperatures.

image

  • Encounter History Stores seen drones automatically. Search, review and export CSV & KML files. View flight data & more by selecting it from the History tab.

    image

  • Detect the Undetectable:

    SDR-Powered Drone Detection & Decoding with WarDragon Pro- Support for Ocusync and other difficult signals

OcuSync's advanced frequency-hopping and encrypted communication make it nearly invisible to standard detection tools.

  • Seamless WarDragon Integration
    Designed to work seamlessly with the WarDragon DragonOS platform, it can also be used with other applications that use the same stack as WarDragon Pro. It comes with a user-friendly interface that’s ready to use out of the box.

  • Flexible Protocol Support
    Supports ZMQ and Multicast configurations, tailored to your operational needs.

Requirements

Option 1. WarDragon/Pro

Option 2. DIY

Hardware

  • ESP32
  • Sniffle compatible BT dongle
  • ANTSDR E200
  • GPS unit

Software

Usage

Note

It's important to be using the latest versions of @alphafox02 DroneID and DragonSync repos listed above.

To update, navigate to the folders in the WarDragon directory in the home directory of the dragon (or in your location) using the command line. Run git pull inside both.

Connection

The app supports two connection formats:

ZMQ Server (JSON)

  • Recommended Includes all data available. Easy setup with direct ZMQ connection and minimal configuration.

Multicast (CoT)

  • Experimental Limited data compared to ZMQ. Lacks data needed for ID Type and many other features. Needs additional script running and network setup for multicast. Supports multiple sources at once on same network.

Using Direct ZMQ

  • Ensure that your device is connected to the same network as your WarDragon or host system.
  • Launch the app & choose ZMQ from settings
  • Tap the address and enter the IP of the WarDragon or host system
    • If not using WarDragon, start the zmq_decoder, WiFi/BT sniffer, and wardragon_monitor scripts from the DroneID and DragonSync repos
  • Start the listener
  • Status and drone detection will happen automatically for WarDragon.

Multicast: CoT Data Only

  • Start dragonsync.py and wardragon-monitor.py from the DragonSync repo.
  • From the DroneId repo start zmq_decoder.py and WiFi/BT sniffer.

Refer to dragonsync.py for detailed instructions & commands

Detection

Once activated, detected drones appear in the Drones and History tabs.

Drones View

  • Tap the map to view a live feed of drone flight paths from the current session. Select the text to open the detail view, which displays collected data, including takeoff and operator locations when available.

Encounter History

  • Swipe left on each row to delete it. To export a CSV file or delete the history, use the icon in the top right corner.
  • Select a row to visualize the flight data. To export a KML file or change the map style, use the icon in the top right corner.

Settings

Warning dials set the value at which dashboard elements change or appear. These differ from the static defaults in the status view.

image

  • Temps and usage will show red when settings are exceeded
  • Drones nearby warning is based on the proximity warning value.

Build/Install

  1. Clone the Repository
    Clone the project repository to your local machine using the following command:
    git clone https://github.com/Root-Down-Digital/DragonSync-iOS.git

  2. Install Dependencies
    Navigate to the project directory and install CocoaPods dependencies:
    cd DragonSync-iOS
    pod install

  3. Open the Project in Xcode
    Open the workspace file generated by CocoaPods:
    open WarDragon.xcworkspace

  4. Build and Run the Project

    • Connect your iOS device to your computer.
    • In Xcode, select your device from the build target options.
    • Click the Build and Run button to install and launch the app on your device.

Credits

We extend our gratitude for their contributions to the open-source community, which have been instrumental in the laying the foundation for this app to exist.

Foundational: DragonSync and DroneID.

A big thanks to the devs at Sniffle. And of course to @alphafox02 for creating the WarDragon, DragonOS, the above scripts- and showing me how to make this work. Thanks to @bkerler for the work on DroneID repo.

Disclaimer

Warning

This software is provided as-is, without warranty of any kind. Use at your own risk. Root Down Digital and associated developers are not responsible for any damages, legal issues, or misuse that may arise from the use of DragonSync. Always operate in compliance with local laws and regulations. Ensure compatibility with your WarDragon system and associated hardware.

License

This project is licensed under the MIT License. See the LICENSE.md file for details.

Contributing

We welcome contributions to DragonSync. If you have suggestions or improvements, please submit a pull request or open an issue in this repository.

Contact

For support or inquiries, please contact the development team by opening an issue.

Additional Notes

Note

DragonSync is currently in active development. Some features may be incomplete or subject to change.

Important

Ensure that your WarDragon DragonOS image is updated for optimal compatibility with DragonSync.

Tip

Keep your iOS device and WarDragon system on the same local network to ensure seamless communication.

Caution

Always operate in compliance with local regulations and guidelines to ensure safety and legality.

Warning

Unauthorized use of this application with systems other than WarDragon may result in unexpected behavior or system instability