Skip to content

Professional ECU Diagnostics & Tuning Suite - Built by antx at Bad Antics Development

License

Notifications You must be signed in to change notification settings

bad-antics/blackflag-ecu

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

2 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🏴 BlackFlag ECU - Professional Automotive Diagnostic & Tuning Suite

Advanced ECU Diagnostics | Performance Tuning | Real-Time Data Analysis

.NET 8.0 Platform License Built by


πŸš€ Overview

BlackFlag ECU is a comprehensive, native Windows application for automotive diagnostics, ECU tuning, and performance optimization. Built with C# and WPF on .NET 8.0, it provides professional-grade tools for mechanics, tuners, and automotive enthusiasts.

✨ Key Features

  • πŸ” ECU Scanner - Scan and identify ECU types across all major manufacturers
  • πŸ”“ ECU Unlock - Unlock write-protection on supported processors (Tricore, MPC5xx, SH7xxx)
  • πŸ“Š Live Data - Real-time voltage meter and diagnostic data streaming
  • 🎯 VIN Decoder - Comprehensive vehicle identification and specs lookup
  • πŸ”Œ Wiring Diagrams - Interactive pinout diagrams for connectors and modules
  • ⚑ Tune Manager - Create, edit, and flash custom ECU tunes
  • πŸ’Ύ ECU Cloning - Backup and restore complete ECU configurations
  • πŸ“ˆ Performance Dashboard - Real-time charts for horsepower, torque, boost, and AFR

πŸ“‹ System Requirements

  • OS: Windows 10/11 (64-bit)
  • .NET: .NET 8.0 Runtime (included in standalone build)
  • RAM: 4GB minimum, 8GB recommended
  • Storage: 200MB available space
  • Hardware: J2534-compatible interface (for live diagnostics)

πŸ”§ Installation

Standalone Executable

  1. Download BlackFlag.exe from the Releases page
  2. Run BlackFlag.exe - No installation required
  3. All dependencies are included in the single-file executable

First Launch

On first launch, BlackFlag will create the following directories:

%LOCALAPPDATA%\BlackFlag\
β”œβ”€β”€ vehicles.json     # Vehicle database
β”œβ”€β”€ history.json      # Scan/tune history
β”œβ”€β”€ ecuprofiles.json  # ECU profile library
β”œβ”€β”€ tunes.json        # Custom tune library
└── settings.json     # Application settings

🎯 Quick Start Guide

1. Dashboard

The main dashboard provides quick access to all features and displays recent activity.

2. VIN Decoder

  • Enter a 17-character VIN
  • Instantly retrieve vehicle specs (make, model, year, engine, transmission)
  • View supported ECU types and systems

3. ECU Scanner

  • Connect J2534 interface to OBD-II port
  • Select communication protocol (CAN, K-Line, J1850)
  • Click Scan to identify ECU type and software version
  • View live diagnostic codes

4. Tune Manager

  • Load stock ECU file
  • Modify parameters (boost, timing, fuel, rev limit)
  • Preview changes in real-time
  • Flash to ECU with progress tracking

5. ECU Unlock

  • Select processor vendor (Infineon, NXP/Freescale, Renesas, STMicroelectronics)
  • Choose specific processor model
  • Click Unlock to disable write protection
  • Monitor unlock progress

πŸ“Š Features Overview

ECU Support

Supported Manufacturers:

  • Bosch (EDC17, MED17, ME17, MD1)
  • Denso
  • Continental
  • Delphi
  • Magneti Marelli
  • Siemens/Continental
  • Hitachi
  • OEM-specific ECUs (Ford, GM, Chrysler, etc.)

Supported Processors:

  • Infineon Tricore (TC1766, TC1796, TC1797, TC1798)
  • NXP/Freescale MPC5xx (MPC5534, MPC5554, MPC5566)
  • Renesas SH7xxx (SH7058, SH7059, SH72531)
  • STMicroelectronics ST10

Communication Protocols

  • CAN Bus (ISO 15765, High/Mid/Low Speed)
  • K-Line (ISO 9141, ISO 14230 KWP2000)
  • J1850 PWM/VPW
  • LIN Bus
  • FlexRay (read-only)

Diagnostic Features

  • DTC Reading - Read and clear diagnostic trouble codes
  • Live Data - Real-time sensor values (O2, MAF, MAP, IAT, ECT, TPS, etc.)
  • Freeze Frame - Capture engine state at fault occurrence
  • Oxygen Sensor Tests - Monitor O2 heater and response
  • EVAP Tests - Leak detection and purge valve control
  • Readiness Monitors - Emissions system readiness status

🎨 Themes

BlackFlag includes 4 professionally designed themes:

  1. Dark Theme - Modern dark mode (default)
  2. Retro Green Theme - Classic terminal aesthetic
  3. Ford Blue Theme - OEM Ford blue styling
  4. Orange Tech Theme - High-contrast orange accents

Switch themes from Dashboard β†’ Theme Selector


πŸ› οΈ Technical Details

Architecture

  • Framework: .NET 8.0 Windows Desktop
  • UI: WPF (Windows Presentation Foundation)
  • Charts: LiveChartsCore v2.0.0-rc2
  • Serial: System.IO.Ports
  • JSON: Newtonsoft.Json
  • Size: 155.56 MB (standalone executable)

Data Storage

All data is stored in JSON format in %LOCALAPPDATA%\BlackFlag\:

  • vehicles.json - 900+ vehicle database entries
  • ecuprofiles.json - ECU configuration profiles
  • tunes.json - Custom tune files
  • history.json - Scan and flash history

πŸ”’ Security & Legal

Safety Features

  • Read-Only Mode - Preview ECU data without modification
  • Backup Before Flash - Automatic ECU backup before any write operation
  • Checksum Validation - Verify tune file integrity before flashing
  • Live Monitoring - Abort flash if voltage drops or connection lost

Legal Notice

BlackFlag ECU is intended for off-road use, racing, and professional tuning only.

  • Modifying emissions-related systems may violate local laws
  • Users are responsible for compliance with EPA, CARB, and local regulations
  • Warranty on modified vehicles may be voided
  • Use at your own risk

πŸ“ License

MIT License - Free and Open Source

Copyright (c) 2025 Bad Antics Development

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

🀝 Support


πŸš€ Version History

v2.1 (Current)

  • Initial standalone release
  • 155.56 MB single-file executable
  • 900+ vehicle database
  • 4 premium themes
  • Full J2534 support
  • ECU unlock for Tricore, MPC5xx, SH7xxx processors

🏴 BlackFlag ECU - Professional Automotive Power

Built by Bad Antics Development