IFB Washer Hardware Profiles & Wash Guide (ifb-washer-models)

[!NOTE] Regional Scope: This database tracks IFB smart washing machines and washer-dryers sold in the Indian Market (Wi-Fi enabled and front/top load models).

A unified hardware capability database, model lookup engine, and wash guide reference for IFB smart washing machines and washer-dryers. Covers 247 commercial models, 23 factory user manuals, 349 wash programs, and 263 capability gating rules, providing verified hardware operational limits for Home Assistant integrations and custom cards.

Table of Contents

• Installation
• Model Capability Database & Lookup Engine
  • Python Backend Usage
  • Offline Bundled Data
• The Four Hardware Archetypes
• Hardware Capability Gating Rules
• Database Summary
• Credits & License

Installation

Install the Python package via pip:

pip install ifb-washer-models

Model Capability Database & Lookup Engine

Python Backend Usage

Query model metadata, detent mappings, and program capability limits using the normalized lookup engine:

from ifb_washer_models import WasherModelLookup

lookup = WasherModelLookup()

# 1. Resolve commercial model names (handles spaces, hyphens, and casing automatically)
model = lookup.get_model_info("Executive Plus ZXS WD 8.5/6.5")

print(f"Series:      {model.series}")
print(f"Capacity:    {model.capacity_kg} kg")
print(f"Max Spin:    {model.spin_max_rpm} RPM")
print(f"Manual Code: {model.manual_code}")
print(f"Archetype:   {model.archetype}")

# 2. Get physical rotary selector switch detent mappings (1..14)
dial_map = lookup.get_dial_programs(model.manual_code)
print("Physical Detents:", dial_map)
# => {1: 'Wash + Dry 2Hr', 2: 'Wash + Dry 4Hr', 4: 'Refresh', 6: 'CradleWash®', 12: 'Cotton', ...}

# 3. Query program capability gating (temperatures, spin speeds, drying modes, modifiers)
caps = lookup.get_program_capabilities(model.manual_code, "CradleWash®")

print("Allowed Temps: ", caps.allowed_temps)     # ('Cold', '30°C', '40°C')
print("Allowed Spins: ", caps.allowed_spins)     # ('No Spin', '400 RPM', '600 RPM')
print("Supports Dry:  ", caps.supports_dry)      # True
print("Dry Modes:     ", caps.allowed_dry_modes) # ('No Dry', 'Gentle Dry', '30 Minutes', '1 Hour')
print("Supports Steam:", caps.supports_steam)    # False

Offline Bundled Data

The package embeds all database tables in JSON format (models.json, manuals.json, program_gating.json, programs.json, archetypes.json) under ifb_washer_models/data/. Applications can import or read these files directly with zero external network calls.

The Four Hardware Archetypes

IFB manufactures its smart Wi-Fi appliances across 4 distinct physical control archetypes:

Hardware Capability Gating Rules

The database enforces physical MCU limits derived from official factory manuals to prevent sending incompatible command combinations:

Database Summary

• Commercial Models: 247 models across Executive, Senator, Elena, Serenade, and Top Load series.
• Factory User Manuals: 23 audited manual families.
• Wash Cycles: 349 individual program entries.
• Gating Rules: 263 cycle-to-modifier constraint records.
• Primary Data Sources: Official IFB factory user manuals, firmware MCU frame dumps, and empirical local GainSpan telemetry captures.

Credits & License

Project Contributors & AI Attribution

• Lead Architecture & Hardware Validation: @selvakk2k — physical appliance reverse engineering, manual audits, and hardware validation.
• Code Implementation & Engineering: Antigravity (Google DeepMind) — database schema design, normalized lookup engine, automated tests, and export pipelines.
• Pre-Release Code Review & Auditing: Claude (Anthropic) — data referential integrity audits and capability rule verification.

Licensed under the MIT License. See the LICENSE file for details.