========================================================================
RONIN SUITE v2.4 - MULTI-ECU QUICKSTART & CALIBRATION SAFETY GUIDE
Official Documentation | https://flasher.roninip.co.za
Platform Host: wranglr.co.za | Web Calibrator: https://roninip.co.za
========================================================================

1. SUPPORTED BMW PLATFORMS & CAPABILITY MATRIX
------------------------------------------------------------------------
Ronin Suite is an integrated engineering desktop workstation for BMW engine
management systems, featuring 989 native calibration tables, live cell
tracing, factory EDIABAS DTC diagnostics, and fail-closed OBD protocols.

[A] BOSCH BMS46 (BMW E46 316i, 318i - M43TU 1.9L 4-Cylinder SOHC)
    - OBD K-Line Memory Read : Supported (32KB Partial & 256KB Full ROM)
    - OBD K-Line Flashing    : SUPPORTED - PARTIAL CALIBRATION ONLY!
                               (32KB sector 0x008010 to 0x00FFFF; ~12 sec fast flash
                               at 125,000 baud or standard 9,600 baud. Full write is
                               strictly locked for bootloader protection.)
    - Native Table Database  : 223 Verified Tables (Zero external XDF required)
    - Live Map Cell Tracer   : Supported (Real-time Fuel & Ignition operating point)
    - DTC Diagnostics        : Full Read & Clear (EDIABAS German/English definitions)
    - Actuator Bench & EWS   : Supported (ICV, DISA, Fuel Pump, EWS-DME alignment)

[B] SIEMENS MS43 (BMW E46 320i, 325i, 330i - M54 2.2L-3.0L 6-Cylinder DOHC)
    - OBD K-Line Memory Read : Supported (64KB Partial Calibration & 512KB Full ROM)
    - OBD K-Line Flashing    : NOT SUPPORTED (Flash writing is strictly blocked and
                               gated; zero destructive packets are dispatched.)
    - Native Table Database  : 169 Verified Tables (Fuel, Spark, Vanos, Limiters)
    - Live Map Cell Tracer   : Supported
    - DTC Diagnostics        : Full Read & Clear (Native EDIABAS definitions)

[C] SIEMENS MS42 (BMW E46 320i, 323i, 328i - M52TU 2.0L-2.8L 6-Cylinder DOHC)
    - OBD K-Line Memory Read : Supported (32KB Partial Calibration & 512KB Full ROM
                               with safe padding across unmapped 32KB hardware gap)
    - OBD K-Line Flashing    : NOT SUPPORTED (Flash writing is strictly blocked.)
    - Native Table Database  : 597 Verified Tables across 60 categories
    - Live Map Cell Tracer   : Supported
    - DTC Diagnostics        : Full Read & Clear (Native EDIABAS definitions)

[D] ONGOING ACTIVE DEVELOPMENT & FUTURE PLATFORMS
    - Ronin Suite is under continuous active engineering development.
    - Additional BMW DME/DDE platforms (including MS45, MSD80, and expanded flashing
      protocols) are currently undergoing rigorous bench validation for future releases.
    - All future platform upgrades and software releases are included free with your
      one-time lifetime license.


2. MINIMUM HARDWARE & CABLE REQUIREMENTS
------------------------------------------------------------------------
- Operating System : Windows 10 or Windows 11 (64-bit)
- Interface Cable  : BMW K+DCAN USB Cable with genuine FTDI FT232R chipset
                     (Pre-2001 models with under-hood round 20-pin diagnostic port
                     require a 20-pin adapter with pin 7 and pin 8 bridged)
- Battery Supply   : Regulated automotive battery maintainer (>12.5V under load)


3. MANDATORY FTDI LATENCY CONFIGURATION
------------------------------------------------------------------------
To ensure reliable serial framing and prevent OBD packet timeouts:
1. Connect your FTDI USB cable to your PC.
2. Open Windows Device Manager (Win + X -> Device Manager).
3. Expand "Ports (COM & LPT)" and double-click "USB Serial Port (COMx)".
4. Select "Port Settings" tab -> click "Advanced...".
5. Change "Latency Timer (msec)" from default 16 down to 1.
6. Click OK to confirm.


4. FREE VS LICENSED WORKSTATION CAPABILITIES
------------------------------------------------------------------------
FREE (NO LICENSE OR PAYMENT REQUIRED):
- Full OBD Memory Reading: BMS46 (32KB/256KB), MS43 (64KB/512KB), MS42 (32KB/512KB)
- ECU HW/SW Identification and VIN interrogation
- Complete Calibration Table Editor: 989 built-in tables across BMS46, MS43, MS42
- Delta diffing against verified factory stock calibration dumps
- Real-time Diagnostic Trouble Code (DTC) reading and clearing
- Multi-platform checksum verification (CRC-16 Modbus, CRC-16 ARC, ADD-32)
- Engine telemetry monitor and CSV datalogger

LICENSED (REQUIRES LIFETIME ACTIVATION KEY):
- High-Speed Partial Calibration Flash Writing (Bosch BMS46 only)
- Real-time 2D & 3D Live Map Operating Point Tracer with knock retard tracking


5. HOW TO ACTIVATE YOUR LICENSE
------------------------------------------------------------------------
1. Launch Ronin_Suite.exe on your computer.
2. Click "ENTER LICENSE KEY" in the top header.
3. Click "Copy ID" to copy your unique Machine ID (format: RONIN-XXXX-YYYY-ZZZZ).
4. Visit https://flasher.roninip.co.za, choose your tier, and paste your Machine ID.
5. Complete payment via secure Yoco checkout.
6. Your 16-character key (RONIN-XXXX-YYYY-ZZZZ-WWWW) will be displayed on screen
   and emailed to you from info@roninip.co.za.
7. Paste the key into Ronin Suite and click "ACTIVATE LICENSE".
   (Licensing is 100% offline once activated; no internet connection required at track/dyno).


6. PRE-READ & PRE-FLASH SAFETY CHECKLIST
------------------------------------------------------------------------
[ ] 1. Regulated automotive battery charger/maintainer connected (>12.5V confirmed).
[ ] 2. Ignition switched to Position II (Engine OFF, dashboard warning lights ON).
[ ] 3. All auxiliary accessories switched OFF (headlights, heater fan, wipers, radio).
[ ] 4. Laptop plugged into mains power; sleep mode and screensaver disabled.
[ ] 5. All other diagnostic programs closed (INPA, Tool32, EDIABAS, ISTA).
[ ] 6. FTDI latency timer confirmed at 1ms in Device Manager.


7. LEGAL & ENGINEERING DISCLAIMER
------------------------------------------------------------------------
Ronin Suite is engineered exclusively for off-highway motorsport, dynamometer
re-calibration, and automotive research. The operator assumes full responsibility
for compliance with local clean air and vehicle regulations.

Support: info@roninip.co.za
Website: https://flasher.roninip.co.za
========================================================================
