AddVantage PPG Documentation
============================

.. image:: https://img.shields.io/badge/version-3.4.0-blue
   :alt: Version 3.4.0

.. image:: https://img.shields.io/badge/platform-SKEAZ128-green
   :alt: Platform SKEAZ128

**AddVantage PPG** (Programmable Pulse Generator) is a dual-fuel controller for diesel engines.
It injects LPG/propane as supplementary fuel based on engine parameters received via J1939 CAN bus.

Key Features
------------

- **J1939 CAN Bus Integration** - Reads engine RPM, torque, coolant temperature from ECU
- **Configurable Fuel Maps** - 16x16 RPM/torque lookup tables with interpolation
- **Differential Pressure Compensation** - Adjusts injection based on gas pressure
- **Temperature Correction** - Modifies fuel delivery based on coolant temperature
- **UART Telemetry** - Real-time monitoring at 57600 baud
- **Flash Configuration** - Persistent storage of calibration data

Hardware
--------

- **MCU**: NXP SKEAZ128MLK4 (ARM Cortex-M0+, 48MHz)
- **CAN**: MSCAN peripheral, 250kbit/s J1939
- **Outputs**: 2x PPG channels for gas injectors, solenoid drivers
- **Inputs**: 3x ADC (gas pressure, manifold pressure, tank level)

Quick Links
-----------

- :doc:`guides/getting_started` - Build and flash the firmware
- :doc:`guides/can_protocol` - J1939 PGN reference
- :doc:`guides/telemetry` - Serial output format
- :doc:`guides/testing` - Test harness usage

.. toctree::
   :maxdepth: 2
   :caption: User Guides
   :hidden:

   guides/getting_started
   guides/can_protocol
   guides/flash_layout
   guides/telemetry
   guides/testing

.. toctree::
   :maxdepth: 2
   :caption: API Reference
   :hidden:

   api/firmware
   api/tools

.. toctree::
   :maxdepth: 1
   :caption: Additional Info
   :hidden:

   known_issues
   changelog

Indices and Tables
------------------

* :ref:`genindex`
* :ref:`search`