⚙️ Configuration Guide - OLED

Complete guide to configuring your IntelliAGS controller using the OLED display menu system.

🎛️ Button Controls

The IntelliAGS has three physical buttons on the front panel for all navigation and control:

ON
Start / Up / Increase
OFF
Stop / Down / Decrease
MENU
Menu / Select / Confirm

Status Screen Controls

Button Action Result
ON Hold ≥300ms Start Generator (if idle)
OFF Short press Stop Generator
MENU Short press Open Settings Menu (only when idle)
MENU Hold 2 seconds Enter WiFi Configuration Mode

Menu Navigation

Button In Menu When Editing Value
ON Move selection UP Increase value
OFF Move selection DOWN Decrease value
MENU Select / Enter submenu Confirm and return
💡 Tip: The menu automatically closes after 60 seconds of inactivity. Unsaved changes will be discarded.

📋 Menu Structure

The settings menu is organized into a main menu and a Glow Plug submenu:

⚠️ Important: The menu is only accessible when the generator is in IDLE state. A message will display "Menu blocked - generator not idle" if you try to enter while running.

🔧 Engine Start/Stop Settings

Setting Range Description
Max Coolant Tmp 40-150°C Engine shuts down if coolant temperature exceeds this value
Min Battery 8-14.5V Minimum battery voltage required to allow engine start
Min Fuel Level 0-100% Minimum fuel level required to allow engine start
Min Oil Press 0-115 PSI Minimum oil pressure required while engine is running
Max Oil Press 3-115 PSI Maximum oil pressure before overpressure alarm triggers
Oil Start Delay 0-3000ms Delay after engine start before checking oil pressure
Oil Start Thrsh 0-115 PSI Oil pressure threshold for detecting engine is running
Start Retry Lim 1-10 Number of start attempts before giving up
Max Crank Time 0.5-15 sec Maximum cranking duration per attempt
Min RPM 200-1800 Minimum RPM to detect engine is running
Start Cooldown 0-120 sec Wait time between crank attempts

🔥 Preheat & Block Heater Settings

Setting Range Description
Preheat Start 0-60°C Enable block heater when coolant is below this temperature
Preheat Time 0-480 min Maximum block heater run time (safety limit)
Preheat Max 0-60°C Turn off block heater when coolant reaches this temperature
Block Heat Internal / External Preheat relay type selection

🔌 Glow Plug Settings (Submenu)

Access via Glow Plug >> in the main menu:

Setting Descriptions

Setting Range Description
Mode PWM / SmartGlow PWM uses fixed time, SmartGlow exits based on resistance measurement
Hot Plug R 0-2000 mΩ Target resistance for SmartGlow exit (auto-calibrated)
Cold Plug R 0-2000 mΩ Cold resistance reference (auto-calibrated)
Plug Count 1-4 Number of glow plugs installed
Skip Temp 0-50°C Skip preglow if coolant is above this temperature
Preglow Time 0-60 sec Maximum preglow duration (failsafe for SmartGlow)
Preglow Duty 0-100% Preglow PWM duty cycle
Postglow Time 0-600 sec Crank assist postglow duration
Postglow RPM 500-2000 RPM target for postglow duty tapering
Postglow Duty 0-100% Postglow PWM duty cycle

SmartGlow Auto-Calibration

The SmartGlow feature uses a drift-window plateau detection algorithm to automatically determine optimal preglow settings:

  1. Ensure generator is IDLE and glow plugs are cold (wait 5+ minutes after any glow operation)
  2. Open Settings Menu → Navigate to Glow Plug >>
  3. Navigate to Auto Calibrate and press MENU to start
  4. Watch the live display showing Voltage, Current, Resistance (EMA smoothed), and Time
  5. System checks drift every 5 seconds - plateau detected when drift <5mΩ for 6+ consecutive seconds
  6. Values are saved automatically with safety adjustments:
    • Target resistance: 1% margin reduction from plateau
    • Preglow time: Rounded to 1 second + 5 second buffer
  7. Maximum calibration timeout: 120 seconds (saves best value if reached)
💡 Tips for Best Results:
  • Start with cold plugs (ambient temperature)
  • Ensure battery is fully charged (12.5V+)
  • Avoid calibrating in extreme temperatures (<0°C or >40°C)
  • Press OFF to cancel calibration at any time

🔧 Factory Calibration Menu (Advanced)

For advanced current sensing calibration of each output channel.

⚠️ Restricted Access: Please contact support if calibration is needed for access and instruction.

Calibration Channels

Channel Parameters Description
GLOWPLUG Offset, Gain, Max I Glow plug current sense (ACS772 ±50A sensor)
FUELCUT Offset, Gain, Max I Fuel cut solenoid current (BTS50015 switch)
FUELPUMP Offset, Gain, Max I Fuel pump current (BTS50015 switch)
STARTER Offset, Gain, Max I Starter motor current (BTS50015 switch)

Button Controls in Factory Menu

Button Function
ON Increment selected value (hold for auto-repeat)
OFF Decrement selected value (hold for auto-repeat)
MENU Cycle: Offset → Gain → Max → Next Channel → [SAVE] → [EXIT]
⚠️ Advanced Feature: This menu is intended for factory calibration or troubleshooting. Incorrect settings may affect overcurrent protection. Navigate to [SAVE] and press MENU to persist changes to EEPROM.

🌀 Automatic Fan Control

The IntelliAGS features PWM variable-speed fan control for optimal cooling:

Temperature-Based Speed

Ambient Temperature Fan Speed
≤30°C 0% (Off)
30-60°C Linear ramp (~3.3% per degree)
≥60°C 100% (Full speed)

Glow Plug Override

During preglow and glow plug operation, the fan automatically runs at minimum 50% speed to ensure adequate cooling of the glow plug circuitry, regardless of ambient temperature.

💡 Note: The fan uses 25kHz PWM frequency for quiet, motor-friendly operation (inaudible to humans).

🔋 Charger Behavior During AGS Cycle

The battery charger is automatically managed during generator start cycles:

Automatic Control

AGS State Charger Action
IDLE → CRANKING Charger disabled (prevents voltage issues during cranking)
RUNNING → COOLDOWN Charger restored to pre-crank state
Any → IDLE (Shutdown) Charger restored if it was enabled before start
💡 Note: The system remembers the charger state before cranking and restores it automatically. This prevents charger load from affecting cranking voltage.

⚡ System Options

Setting Options Description
Charger On Boot Off / On Automatically enable battery charger at system startup
Start Signal Opto / Alt D+ / Both Engine running detection source
Remote Start Disabled / Enabled Allow remote start via external input
Remote Polarity LOW / HIGH Remote start signal active polarity
SD Log Rate 0-3 Logging interval: 0=250ms, 1=500ms, 2=1000ms, 3=2000ms
Data Logging Off / On Enable data logging to storage
WiFi TX Power 8-20 dBm WiFi transmission power (higher = more range, more power)
Timezone 0-9 Timezone index for display time

Start Signal Options

Setting Detection Method When to Use
Opto Optocoupler + RPM sensor for alternator pulses Default - best for most installations with RPM sensor
Alt D+ Alternator D+ terminal signal When RPM sensor is unavailable or unreliable
Both Requires both signals to agree Maximum reliability - prevents false starts

📺 Status Display Icons

The header bar shows three status icons. Each icon and label color indicates different states:

NET (Network)

Ethernet connected
WiFi connected
WiFi connected, VPN connecting
No network connection

Label color: Cyan = MQTT/VPN connected, Yellow = WiFi only (VPN pending), Green = Network only, Gray = No connection

SD (Primary Storage - eMMC)

Note: This icon shows eMMC (internal SD-NAND) status, not the removable SD card.

Ready (idle)
Collecting data
Writing/archiving to storage
Error / eMMC fault

CHR (Charger)

Standby (AC present)
Actively charging
Charger fault
Charger off (no AC)

📊 Sensor Bar Colors

Each sensor bar on the status screen is color-coded based on the reading:

Sensor 🔴 Red 🟠 Orange 🟢 Green 🟠 Orange 🔴 Red
RPM <1600 1600-1730 1730-1870 1870-2000 >2000
OIL <15 PSI 15-30 PSI 30-95 PSI >95 PSI
TMP <100°C 100-110°C >110°C
FUEL <10% 10-25% >25%
BAT <11V 11-12V 12-14.5V 14.5-15V >15V

💾 Saving Your Settings

Menu Visual Indicators

Element Color Meaning
Selected item border White Currently highlighted
Editing item border Yellow Currently being edited
Value text Green Unchanged value
Value text Blue Modified this session
Value text Red Currently editing

Save Actions

Action Description
Save Settings Save all changes to EEPROM and exit. WiFi LED blinks 10 times to confirm.
Exit No Save Discard all changes and exit menu
<< Back Return to parent menu (in submenus)
⚠️ Remember: Changes are NOT saved until you select "Save Settings". The menu will timeout after 60 seconds, discarding unsaved changes.
← Back to Documentation