docs: remove phase references and future roadmap items

- Remove development phases from documentation
- Remove gRPC optional dependency
- Clean up TBD placeholders with actual values
- Update hardware documentation with EMC2305 specs
- Simplify architecture diagrams

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: moffa90

CLAUDE.md

@@ -14,8 +14,6 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 **Target Platform:** Multiplatform Linux (Banana Pi, Raspberry Pi, generic Linux systems with I2C support)
 
-**Current Phase:** Phase 1 - Core Driver Development (Completed with critical fixes)
-
 ## Development Commands
 
 ### Driver Testing
@@ -46,9 +44,6 @@ i2cdetect -y [bus_number]
 # Install in development mode
 pip3 install -e .
 
-# Install with gRPC support
-pip3 install -e ".[grpc]"
-
 # Install development dependencies
 pip3 install -e ".[dev]"
 ```
@@ -59,16 +54,13 @@ pip3 install -e ".[dev]"
 
 ```
 ┌─────────────────────────────────────────┐
-│   High-Level API (TBD)                  │  <- API Layer (gRPC/REST)
-│   - Fan control service                 │
-│   - Monitoring endpoints                │
+│   Application Code                      │
 └──────────────┬──────────────────────────┘
                │
 ┌──────────────▼──────────────────────────┐
 │   Fan Controller Driver                 │  <- Hardware Abstraction
 │   - Speed control                       │
 │   - RPM monitoring                      │
-│   - Temperature sensing                 │
 │   - Configuration management            │
 └──────────────┬──────────────────────────┘
                │
@@ -126,7 +118,7 @@ pip3 install -e ".[dev]"
 ### Hardware Limitations
 - **I2C bus speed**: Typically 100 kHz or 400 kHz (check device requirements)
 - **No hot-plug**: Devices must be present at initialization
-- **Chip-specific limitations**: [TBD - Add specific chip constraints]
+- **Chip-specific limitations**: See EMC2305 datasheet for detailed constraints
 
 ### I2C Bus Sharing
 - **Multiple services may use the same I2C bus** - always use I2C locking
@@ -263,10 +255,6 @@ scp /tmp/ventus-deploy.tar.gz user@target:/tmp/
 ssh user@target "cd /opt && tar xzf /tmp/ventus-deploy.tar.gz && pip3 install -r requirements.txt"
 ```
 
-### Systemd Service (TBD)
-
-Will be added in Phase 2 for automatic startup and monitoring.
-
 ## Known Issues and Gotchas
 
 ### I2C Permissions
@@ -289,26 +277,6 @@ sudo chmod 1777 /var/lock
 ### Bus Speed Configuration
 Some devices require specific I2C bus speeds. Configure via device tree or kernel module parameters.
 
-## Development Phases
-
-### Phase 1: Core Driver (Current)
-- ✅ Project structure and templates
-- 🔄 I2C communication layer
-- 🔄 Fan controller driver implementation
-- 🔄 Basic examples and tests
-
-### Phase 2: Advanced Features (Planned)
-- gRPC API (optional)
-- Automatic fan curves (temperature-based)
-- PID controller implementation
-- Systemd service integration
-
-### Phase 3: Tools & Monitoring (Planned)
-- CLI client
-- Web dashboard
-- Real-time monitoring
-- Logging and diagnostics
-
 ## Code Style Standards
 
 ### Python Standards
@@ -349,12 +317,6 @@ Some devices require specific I2C bus speeds. Configure via device tree or kerne
 - Handle sensor errors
 - Provide calibration options if needed
 
-## Reference Projects
-
-This project follows patterns established in:
-- **bananapi-i2c-led-board (luminex)** - I2C driver architecture, gRPC API patterns
-- **go-cyacd** - Professional code structure, documentation standards
-
 ## Quick Reference
 
 ### Essential Commands

PRODUCTION_READINESS.md

@@ -5,7 +5,7 @@
 
 ## Executive Summary
 
-The EMC2305 driver library is now production-ready for use as a driver/library component. All critical gaps have been addressed, making it suitable for integration into applications that will provide higher-level features like gRPC APIs, web dashboards, etc.
+The EMC2305 driver library is now production-ready for use as a driver/library component. All critical gaps have been addressed, making it suitable for integration into applications.
 
 ## Completed Improvements
 
@@ -157,8 +157,6 @@ from emc2305 import (
 ### For Internal Use ✅
 The library is **immediately ready** for:
 - Integration into applications
-- Building gRPC/REST APIs on top
-- Creating monitoring dashboards
 - Developing fan control services
 - Testing and validation
 
@@ -172,21 +170,6 @@ The library is **ready** for public release with:
 
 ---
 
-## What's NOT Included (By Design)
-
-These are **application-layer features** and are intentionally excluded from the driver library:
-
-❌ gRPC/REST API server
-❌ Web dashboard
-❌ CLI client application
-❌ Systemd service integration
-❌ Automatic temperature-based fan curves
-❌ Monitoring/alerting system
-
-**Rationale:** These belong in applications that use the library, not in the driver itself.
-
----
-
 ## Installation
 
 ### From Source (Development)
@@ -203,9 +186,6 @@ pip install -e ".[config]"
 
 # Development tools
 pip install -e ".[dev]"
-
-# gRPC support (if building API server)
-pip install -e ".[grpc]"
 ```
 
 ---
@@ -264,24 +244,6 @@ PYTHONPATH=. python3 examples/python/test_fsc_mode.py
 
 ---
 
-## Next Steps for Application Development
-
-Now that the driver library is production-ready, applications can be built on top of it:
-
-### Phase 2: Application Layer (Recommended)
-1. **gRPC API Server** - Remote control and monitoring
-2. **REST API** - HTTP-based interface
-3. **CLI Client** - Command-line control tool
-4. **Configuration Service** - Centralized config management
-
-### Phase 3: Advanced Features (Optional)
-5. **Web Dashboard** - Real-time monitoring UI
-6. **Automatic Fan Curves** - Temperature-based control
-7. **Systemd Integration** - Service management
-8. **Logging & Monitoring** - Telemetry and diagnostics
-
----
-
 ## Production Checklist
 
 - [x] Core driver functionality complete
@@ -333,4 +295,4 @@ The library provides a solid foundation for building fan control applications, m
 - CI/CD pipeline integration
 - Third-party consumption
 
-**Recommended:** Proceed with building application-layer features (gRPC/REST APIs, dashboards, etc.) on top of this solid driver foundation.
+**Available on PyPI:** `pip install microchip-emc2305`

docs/development/README.md

@@ -19,9 +19,8 @@ This directory contains development notes, implementation decisions, and technic
 - Performance measurements
 - Compatibility testing
 
-## Development Phases
+## Completed Features
 
-### Phase 1: Core Driver ✅ (Completed)
 - [x] Project structure and templates
 - [x] I2C communication layer with validation
 - [x] Fan controller driver implementation
@@ -30,17 +29,6 @@ This directory contains development notes, implementation decisions, and technic
 - [x] Configuration lock race condition fix
 - [x] Magic numbers replaced with named constants
 
-### Phase 2: Advanced Features (Planned)
-- [ ] gRPC API
-- [ ] Automatic fan curves
-- [ ] PID controller
-- [ ] Systemd service
-
-### Phase 3: Tools & Integration (Planned)
-- [ ] CLI client
-- [ ] Web dashboard
-- [ ] Monitoring and logging
-
 ## Technical Decisions
 
 Document key technical decisions here as the project evolves:

docs/hardware/README.md

@@ -23,20 +23,20 @@ Place the following documentation here:
 
 ## Hardware Specifications
 
-**Fan Controller IC**: [TBD - Add chip model]
+**Fan Controller IC**: Microchip EMC2305 (5-channel PWM fan controller)
 
-**I2C Addresses**: [TBD - List device addresses]
+**I2C Addresses**: Configurable via ADDR_SEL pin (0x4C, 0x4D, 0x5C, 0x5D, 0x5E, 0x5F)
 
 **Supported Features**:
-- [ ] Fan speed control (PWM/DC)
-- [ ] RPM monitoring (tachometer)
-- [ ] Temperature sensing
-- [ ] Fault detection
+- [x] Fan speed control (PWM)
+- [x] RPM monitoring (tachometer)
+- [x] Fault detection (stall, spin failure, drive failure)
+- [x] Closed-loop RPM control (FSC mode with hardware PID)
 
 **Electrical Specifications**:
-- Operating voltage: [TBD]
-- I2C bus speed: [TBD]
-- Fan power ratings: [TBD]
+- Operating voltage: 3.3V (VDD)
+- I2C bus speed: 100 kHz / 400 kHz
+- Fan power: 5V or 12V (separate rail)
 
 ## Quick Reference
 
@@ -46,14 +46,9 @@ Place the following documentation here:
 # Scan I2C bus 0
 i2cdetect -y 0
 
-# Expected output should show devices at:
-# [TBD - List expected addresses]
+# Expected output should show EMC2305 at configured address (e.g., 0x4D)
 ```
 
-### Pin Connections
-
-[TBD - Add pinout diagram or table]
-
 ## Notes
 
-Add any hardware-specific notes, quirks, or important considerations here.
+See the EMC2305 datasheet in this directory for complete hardware specifications.

pyproject.toml

@@ -40,11 +40,6 @@ dev = [
     "mypy>=1.5",
     "ruff>=0.1.0",
 ]
-grpc = [
-    "grpcio>=1.60.0",
-    "grpcio-tools>=1.60.0",
-    "protobuf>=4.25.0",
-]
 
 [project.urls]
 Homepage = "https://github.com/moffa90/python-emc2305"
@@ -53,7 +48,7 @@ Repository = "https://github.com/moffa90/python-emc2305"
 "Bug Tracker" = "https://github.com/moffa90/python-emc2305/issues"
 
 [tool.setuptools]
-packages = ["emc2305", "emc2305.driver", "emc2305.proto", "emc2305.server"]
+packages = ["emc2305", "emc2305.driver"]
 
 [tool.setuptools.package-data]
 emc2305 = ["py.typed"]

tests/README.md

@@ -136,12 +136,6 @@ i2cdetect -y 0
 - RPM monitoring
 - Fault detection
 
-### ⏳ Future Tests (Planned)
-- Mock hardware tests (for CI/CD)
-- Performance benchmarks
-- Stress tests
-- Multi-device scenarios
-
 ## Writing Tests
 
 ### Test Structure