Real-time calibration metrics reflecting current system stability, fueling balance,
and ignition behavior under load.
TARGET BOOST
12 PSI
Controlled taper
WOT AFR
11.3–11.5
Optimal range
IGNITION ADVANCE
+1.5°
Conservative midrange
MAX FBK
-1.4°
Minor transient
IAM / DAM
1.00
Fully stable
IDLE SPEED
875 RPM
Stable baseline
ECU CALIBRATION FRAMEWORK
Built for Reliability — Not Just Peak Numbers
This calibration strategy prioritizes consistent power delivery, controlled thermal behavior,
and long-term engine health—reducing risk while maintaining strong, usable performance.
BOOST CONTROL
Controlled Boost Curve
Boost is shaped for smooth midrange torque with a controlled high-RPM taper—preventing spikes,
reducing stress on components, and maintaining predictable performance under load.
RESULT: SMOOTH TORQUE + REDUCED STRESS
FUELING CONTROL
Thermal-Safe Fueling
Enriched fueling under load reduces combustion temperatures and knock risk,
while closed-loop operation maintains efficient and stable cruising behavior.
RESULT: LOWER TEMPS + KNOCK PREVENTION
Upload your ECU file to analyze your calibration and detect potential risks.
Your ECU is only as smart as the data it receives. On a WRX, the intake isn’t just a pipe—it’s a precision housing for your Mass Air Flow (MAF) sensor.
PRECISION DATA
MAF Housing Diameter
Minor variances in inner diameter between cheap brands cause “MAF Scaling” errors. If the housing is 1mm off, your ECU miscalculates the volume of air entering the engine, leading to unpredictable lean or rich conditions.
SIGNAL NOISE
Laminar Airflow Control
Quality intakes (like Cobb or Grimmspeed) use engineered air straighteners. Cheap intakes create “dirty” air turbulence across the sensor, causing erratic voltage spikes that force the ECU to pull timing and kill power.
THE CALIBRATION RISK
“Universal” parts are the enemy of stability. A high-quality intake provides a consistent, repeatable MAF voltage curve. Without that repeatability, an AI-assisted calibration system cannot distinguish between a mechanical air leak and sensor noise, making a safe 12 PSI tune nearly impossible to maintain.
Bad Hardware forces a compromise.
Quality Hardware enables the tune.
ANALYSIS CORE
Multi-Signal Correlation Engine v2.0
✓ SYSTEM_READY
Awaiting Log Telemetry Input
# Correlation Logic: Engine Safety & Stability
defanalyze_telemetry(log):
diagnostics = []
# Check for Intake Temp vs Knock relationship if log[‘IAT’].corr(log[‘FBK’]) < -0.45:
diagnostics.append(“CRITICAL: Heat Soak Induced Knock”)
The system uses Pearson Correlation and standard deviation analysis to find mechanical issues that standard logging might miss. It’s not just checking for knock—it’s finding out why it’s happening.
AI ANALYSIS MODULE
Multi-Signal Calibration Engine v2.0
A multi-layer diagnostic system that correlates AFR, knock behavior, boost control,
intake temperature, and ignition timing into a unified risk model. This engine transforms raw log data into actionable mechanical insight—identifying the root causes of instability instead of isolated symptoms.
# AI CALIBRATION CORE v2.0defcheck_heat_soak(log_data):
corr = log_data['IAT'].corr(log_data['FBK'])
return"⚠️ Heat Soak"if corr < -0.45 else"✓ Thermal OK"defcheck_afr(log_data):
std = log_data['AFR'].std()
if std > 0.5: return"⚠️ AFR Unstable"if log_data['AFR'].mean() > 12.0: return"🚨 Lean Condition"return"✓ AFR Optimal"defcheck_dam(log_data):
return"🚨 DAM Drop"if log_data['DAM'].min() < 1.0 else"✓ DAM Stable"defoverall_assessment(log_data):
results = [check_heat_soak(log_data), check_afr(log_data), check_dam(log_data)]
risk = sum("⚠️"in r or"🚨"in r for r in results)
return"HEALTHY"if risk == 0 else"UNSTABLE"
A disciplined calibration workflow built to remove guesswork, reduce risk,
and ensure every tuning decision is backed by data, validated by results,
and repeatable under real-world conditions.
STEP 1
Capture the Data
Every decision begins with logs, not assumptions—boost, AFR, knock, airflow, and temperature first.
STEP 2
Read the Pattern
Trends reveal the truth. Knock activity, fueling behavior, and airflow shape the next move.
STEP 3
Make the Change
Adjustments stay controlled, intentional, and small enough to isolate cause and effect.
STEP 4
Validate or Revert
If the result is not stable, safe, and repeatable, it gets rolled back. No ego tuning.
Capture → Interpret → Adjust → Validate
A repeatable method built for consistency, safety, and measurable progress.
SYSTEM PRINCIPLE
This Isn’t Tuning — It’s a System
Every change is logged. Every outcome is measured. Every result must prove itself.
This approach removes guesswork entirely—turning calibration into a repeatable process
that can be learned, validated, and scaled across different setups, environments,
and performance goals.
✓ THE BLACK PEARL PROTOCOL IS FOR:
[+]
Subaru / RomRaider users who demand full technical transparency over “locked” Accessport maps.
[+]
DIY Investigators who view their ECU logs as a forensic puzzle rather than just a spreadsheet.
[+]
Performance Purists tired of generic tunes that ignore the nuances of their specific EJ205 health.
✖ DISQUALIFIED IF:
[-]
You want a “Flash-and-Go” experience with zero mechanical oversight or log verification.
[-]
You are unwilling to perform the prerequisite Pre-Log Mechanical Checklist.
[-]
You prioritize Peak Dyno Numbers over combustion stability and ringland integrity.
// SYSTEM STATUS: LOGIC GATE ACTIVE // NO SHORTCUTS // NO COMPROMISES
Moderate Risk Detected
⚠️ [CRIT] Knock events detected (FBKC < -2.4) ⚠️ [WARN] AFR lean under boost (> 11.8:1) ✓ [INFO] DAM stable at 1.000
LOCAL ANALYSIS ENGINE
What is subaructl?
subaructl is a command-line diagnostic tool that processes ECU logs locally—
converting raw sensor data into structured calibration insight.
It acts as the analysis layer of the Black Pearl system, identifying knock events, AFR deviations,
boost instability, and timing behavior without relying on external services.
HOW IT WORKS
• Ingests ECU log data (RPM, AFR, boost, timing, knock)
• Correlates signals across time and load conditions
• Flags anomalies using rule-based + statistical analysis
• Outputs structured diagnostics with actionable insights
WHY IT MATTERS
Unlike generic tools, subaructl is built around calibration logic—
giving you direct visibility into what the ECU is doing and why.
// READY FOR DEPLOYMENT // SYSTEM: EJ205_REV_3 // REVISIONS: 47
CALIBRATION PLATFORM
Black Pearl — Intelligent Calibration System
Built on RomRaider, re-engineered into a structured, data-driven tuning system.
Black Pearl transforms raw ECU tables into an organized calibration environment where
every change is intentional, every adjustment is validated, and every result is measurable.
This is not a visual overhaul—it introduces a controlled workflow layer that removes guesswork
and enforces consistency across builds, conditions, and performance targets.
DECISION ENGINE
Data-Guided Adjustments
Every change is driven by log data, not assumption.
SAFETY LAYER
Built-In Constraints
Prevents unsafe adjustments before they happen.
ANALYSIS ENGINE
Log Intelligence
Identifies patterns and risk conditions automatically.
A calibration interface layer built on RomRaider—restructured into a controlled, data-driven tuning system.
The Black Pearl Interface transforms raw ECU tables into a structured workflow where every adjustment
is intentional, every log is interpreted, and every revision is tracked. This shifts tuning from manual
editing into a repeatable engineering process.
Built for consistency and safety, it integrates analysis, revision control, and real-time data ingestion
into a unified system that scales across different builds and environments.
ANALYSIS ENGINE
Log Interpretation Layer
Converts raw logs into actionable calibration insights.
REVISION SYSTEM
Versioned Control
Tracks every change with measurable outcome logging.
DATA PIPELINE
Real-Time Ingestion
Integrates OBD2 data directly into the tuning workflow.
CONTROL LAYER
Structured Map Editing
Applies controlled, validated adjustments to ECU maps.
Most tuning puts you in the passenger seat—running someone else’s map with no visibility, no control, and no way to adapt.
Black Pearl converts RomRaider into a structured calibration system where every change is transparent,
every decision is backed by data, and every result can be validated and repeated.
DECISION CONTROL
No Guesswork
Every adjustment is based on real-time log data—not assumptions.
FULL VISIBILITY
No Black Box
Understand exactly what your ECU is thinking—and why.
CUSTOM CONTROL
No Generic Maps
Calibration tailored to your setup, environment, and fuel.
SAFETY LAYER
Built-In Limits
Prevents unsafe timing or boost decisions before they flash.
OTS calibrations assume your engine is a statistical average.
Your hardware doesn’t care about averages.
VARIABLE MISMATCH
The “Average” Fallacy
Static maps can’t account for specific turbo health or regional fuel octane.
SILENT KNOCK
Zero Visibility
FBKC events accumulate until the DAM drops—or the ringland fails.
The problem isn’t the power.
It’s the lack of Intelligence.
SYSTEM OUTCOME
What Happens When You Tune With Black Pearl
You move from reactive tuning to controlled calibration. Every change is intentional,
every result is measurable, and every decision is backed by live telemetry and AI-assisted analysis.
Instead of chasing ghosts in your logs, you identify patterns early, apply structured adjustments,
and build a calibration that evolves with your hardware.
●
Selection will be used to calibrate Base Timing and Scaling Tables.
HARDWARE CONSTRAINT SYSTEM
Hardware Constraint Profiles
Calibration decisions are governed by physical limits—turbo efficiency, fueling capacity, and thermal thresholds.
Hardware Constraint Profiles define safe operating boundaries based on your specific setup.
Instead of tuning blindly, every adjustment is validated against known mechanical and thermal limits—preventing unsafe configurations before they occur.
BOOST SYSTEM
Turbo Efficiency Range
Defines safe boost levels across RPM to prevent overspin and excessive heat.
FUEL SYSTEM
Injector & Pump Limits
Prevents lean conditions by enforcing maximum fueling capacity under load.
THERMAL MODEL
Heat & Knock Thresholds
Monitors intake temps and knock to limit aggressive tuning under stress.
ENGINE LIMITS
Mechanical Boundaries
Sets safe ranges for RPM, load, and torque to protect internal components.
SYSTEM BEHAVIOR
• Adjustments exceeding hardware limits are flagged before application.
• High-load regions are dynamically constrained based on thermal and fueling capacity.
• Profiles adapt calibration strategy to match real-world hardware capability.
You’re not just tuning the map.
You’re tuning within reality.
FUELING CONTROL
Target AFR Table
Defines desired air-fuel ratio across RPM and load. This table directly controls combustion temperature,
engine safety, and power efficiency under varying conditions.
RPM
2000
3000
4000
5000
6000
7000
AFR
14.7
13.5
12.5
11.8
11.5
11.2
SYSTEM INTERPRETATION
• Stoichiometric AFR (14.7) is maintained at low load for efficiency and emissions.
• Progressive enrichment begins as load increases to control combustion temperatures.
• Richer AFR targets under boost suppress knock and protect engine components.
• Consistent transitions are critical for stable fueling and predictable engine response.
FUELING CONTROL
Air-Fuel Ratio (AFR) Targets
Controls combustion mixture under load and cruise conditions. AFR directly impacts power output,
thermal behavior, and engine safety—making it one of the most critical calibration parameters.
RPM
2000
3000
4000
5000
6000
7000
AFR
14.7
13.5
12.5
11.8
11.5
11.2
SYSTEM INTERPRETATION
• Stoichiometric (14.7) is maintained at low load for efficiency and emissions.
• Midrange enrichment reduces combustion temperatures as load increases.
• High-load regions target richer mixtures to suppress knock and protect engine components.
• Excessively lean conditions under boost significantly increase failure risk.
A sample load table demonstrating how throttle input and engine speed interact to define
calculated load values. This structured representation allows precise tuning of airflow,
fueling, and timing behavior across the powerband.
Throttle
1600
2400
3200
4000
4800
5600
6400
20%
2.5
2.7
3.0
3.2
3.5
3.8
4.0
40%
4.5
4.8
5.2
5.5
6.0
6.3
6.5
60%
6.5
6.8
7.2
7.5
8.0
8.4
8.8
80%
8.5
9.0
9.5
10.0
10.5
11.0
11.5
100%
10.5
11.0
11.5
12.0
12.5
13.0
13.5
LOAD MODEL
Throttle vs RPM Mapping
SCALING
Progressive Load Increase
VISUALIZATION
Heat-Based Cell Mapping
CALIBRATION DATA
Load Model — Throttle vs Engine Speed
This model defines how engine load is calculated across throttle input and RPM—directly shaping fueling targets, ignition timing, and boost solenoid duty cycles.
RPM \ TPS
10%
25%
50%
75%
100%
2000
0.45
0.85
1.20
1.45
1.60
4000
0.60
1.10
1.85
2.10
2.35
6000
0.75
1.40
2.15
2.40
2.65
SYSTEM INTERPRETATION
• Cruising Zones (Blue): Gradual load scaling ensures linear throttle response and maximum fuel efficiency.
• Transition Zones (Pink): Rapid load increase triggers enrichment and timing retardation to protect against transient knock.
• Peak Load (Dark Pink): High RPM/TPS cells where the “Black Pearl” system prioritizes thermal management and mechanical safety.
MAPPING LOGIC
Demand Scaling
Quantifies engine air-mass request across all conditions.
VISUAL MODEL
Heat-Mapped Risks
Instant identification of high-stress ignition cells.
This isn’t just a table. It’s the foundation of engine behavior.
BOOST CONTROL
Target Boost Table (PSI)
Defines desired boost pressure across RPM. This table directly controls torque delivery,
spool characteristics, and high-RPM taper behavior.
RPM
2000
3000
4000
5000
6000
7000
Boost
6
10
12
12
11
10
SYSTEM INTERPRETATION
• Boost ramps aggressively through midrange for torque.
• Peak boost is held briefly before tapering to reduce heat and knock risk.
• High RPM taper protects turbo efficiency and engine reliability.
BOOST TARGETING
Target Boost Table (PSI)
The Target Boost Table defines the desired boost pressure across engine speed.
It represents the ECU’s intended torque output and is the primary driver of how the engine delivers power throughout the RPM range.
RPM
2000
3000
4000
5000
6000
7000
Boost (PSI)
6
10
12
12
11
10
SYSTEM INTERPRETATION
• Boost ramps quickly through low and mid RPM to build torque.
• Peak boost is maintained briefly to maximize usable power.
• Controlled taper at higher RPM reduces heat, knock risk, and turbo stress.
• Smooth transitions between cells are critical for drivability and stability.
SYSTEM RELATIONSHIP
The Target Boost Table defines the desired outcome.
Wastegate Duty Cycle (WGDC) and other control systems work to achieve this target under real-world conditions.
RISK CONDITIONS
⚠️ Boost targets too high → Increased knock and thermal stress
⚠️ No high-RPM taper → Turbo inefficiency and overheating
⚠️ Abrupt transitions → Unstable boost behavior and drivability issues
TORQUE MODEL
Power Delivery Profile
EFFICIENCY
Turbo Operating Range
STABILITY
Smooth Boost Transitions
This is what the engine should do.
Everything else makes it happen.
BOOST ACTUATION
Wastegate Duty Cycle (WGDC)
Controls how aggressively boost is built. This table directly determines spool speed,
boost stability, and overshoot behavior.
RPM
2000
3000
4000
5000
6000
7000
WGDC %
40
65
75
70
65
60
SYSTEM INTERPRETATION
• High WGDC in midrange improves spool response.
• Gradual reduction prevents boost overshoot and instability.
• Excessive WGDC at high RPM can cause heat buildup and turbo stress.
BOOST ACTUATION
Wastegate Duty Cycle (WGDC)
Wastegate Duty Cycle controls how much boost the turbocharger produces by regulating
how long the wastegate remains closed. It is the primary actuator behind boost control,
directly influencing spool speed, boost stability, and overall engine load.
RPM
2000
3000
4000
5000
6000
7000
WGDC %
40
65
75
70
65
60
SYSTEM INTERPRETATION
• Increasing WGDC keeps the wastegate closed longer, allowing boost to build faster.
• Midrange WGDC values determine spool response and torque delivery.
• Gradual reduction at higher RPM prevents boost overshoot and thermal stress.
• Excessive WGDC without proper control can lead to unstable boost behavior.
CONTROL RELATIONSHIP
WGDC does not directly set boost—it controls the mechanism that produces it.
Final boost levels depend on turbo efficiency, load, and environmental conditions.
RISK CONDITIONS
⚠️ WGDC too high → Boost overshoot / turbo stress
⚠️ WGDC too low → Slow spool / underboost
⚠️ Inconsistent WGDC → Boost oscillation / unstable control
ACTUATION
Boost Control Mechanism
RESPONSE
Spool & Torque Behavior
STABILITY
Oscillation Prevention
Boost is the result.
WGDC is the control.
IGNITION CONTROL
Ignition Timing Advance (°)
Controls combustion timing. This directly impacts efficiency, power output, and knock sensitivity.
RPM
2000
3000
4000
5000
6000
7000
Timing
20
18
15
12
10
8
SYSTEM INTERPRETATION
• Higher timing improves efficiency at low load.
• Timing is reduced under boost to prevent knock.
• High-load high-RPM regions require conservative values for safety.
IGNITION CONTROL
Ignition Timing Table (° Advance)
Defines when the spark occurs relative to piston position. Ignition timing directly influences
engine efficiency, torque production, and knock sensitivity under varying load conditions.
RPM
2000
3000
4000
5000
6000
7000
Timing
20°
18°
15°
12°
10°
8°
SYSTEM INTERPRETATION
• Higher timing advance at low load improves efficiency and throttle response.
• Timing is progressively reduced as load and boost increase to prevent knock.
• High RPM, high load regions require conservative timing for engine safety.
• Smooth timing transitions are critical for stable combustion and drivability.
SYSTEM RELATIONSHIP
Ignition timing works in direct relationship with AFR and boost.
More boost requires richer AFR and reduced timing to maintain safe combustion.
RISK CONDITIONS
⚠️ Too much timing → Knock / detonation risk
⚠️ Too little timing → Power loss / inefficient combustion
⚠️ Abrupt timing changes → Unstable engine behavior
EFFICIENCY
Combustion Optimization
POWER
Torque Production
SAFETY
Knock Prevention
Timing creates power.
Control prevents damage.
CALIBRATION FEEDBACK LOOP
Log → Decision → Result
01 // DETECT
Raw Log Data
Fine Learning Knock detected at 5200 RPM / 2.45 Load.
02 // ANALYZE
AI Correlation
AFR measured at 11.9:1 (Target: 11.2) → Lean under boost.
03 // ADJUST
Calibration Update
+4% Fueling Enrichment -1.5° Timing (Ignition Map B)
The system doesn’t just show you logs. It interprets the mechanical state in real-time.
AI Analysis Pipeline // Neural Forensic Engine
Ollama ROM Interpretation Engine
Raw ECU hex data is processed through an offline **Llama 3** neural pipeline—deconstructing
proprietary binary memory into structured, actionable engineering insight.
• Contains all fuel, boost, timing, and control tables
• Stored in binary/hex format—not human readable
• Represents the complete behavior of the engine
• Any modification directly changes how the engine runs
THE PROBLEM
Raw hex data cannot be interpreted or tuned directly. Without structure,
this file is effectively unusable for calibration.
This is the engine’s memory.
But it’s not yet a system.
System Diagnostics // Telemetry Audit
Target vs Actual Behavior
Comparing commanded values to real-world telemetry reveals where the
system is stable—and where EJ205 ringland failure risk begins to develop.
Parameter
Commanded (Target)
Actual (Telemetry)
Status
}
Boost (PSI)
12.00
11.83
[✓] Stable
AFR (WOT)
11.30
11.91
[WARN] Lean
Total Timing
+2.00° (Base)
-1.50° (Pulled)
[WARN] Retarded
Feedback Knock
0.00° (Goal)
-2.43°
[ACTIVE] Correcting
IAM (DAM)
1.000
1.000
[✓] Validated
Critcal Insight (subaructl Analysis)
A calibration can look safe on paper, but real-world telemetry reveals hidden mechanical
risk. Without comparing commanded versus actual behavior, these
instabilities remain invisible until mechanical failure.
Project Black Pearl is an engineering-driven calibration platform focused on extracting
reliable, repeatable performance from the EJ205. Every adjustment is
derived from raw telemetry, validated through controlled revisions, and structured
to prioritize mechanical longevity over short-term gains.
This is not a tune file—it is a system. A unified workflow combining
data ingestion, forensic analysis, and decision logic into a repeatable process
for safe, consistent performance development.
Data → Analysis → Control → Repeat
v3.0 // STABILITY FIRST // NO COMPROMISES
Most WRX engines fail from bad tuning —
Black Pearl eliminates guesswork
A data-driven system designed for safe, repeatable power.
Free System Entry
Get the Black Pearl Tuning Checklist
A step-by-step calibration framework used to safely tune a WRX for reliable,
repeatable power—without risking combustion instability or engine failure.
// NO SPAM // JUST RAW TELEMETRY KNOWLEDGE
All calibration data is documented for educational purposes only. Engine tuning involves inherent risk. Proper tools and mechanical understanding are required.