docs: update README

Author: AhmedYasserrr

README.md

@@ -43,7 +43,7 @@ Instead, test from another location, e.g.:
 
 ```sh
 cd ..
-sudo python -c "import pyectool; print(pyectool.is_on_ac())"
+sudo python -c "from pyectool import ECController; ec = ECController(); print(ec.is_on_ac())"
 ```
 
 ## VENV INSTALLATION
@@ -66,15 +66,47 @@ pip install .
 ### Test from outside the repo dir
 ```bash
 cd ..
-sudo env "PATH=$PATH" python -c "import pyectool; print(pyectool.is_on_ac())" 
+sudo env "PATH=$PATH" python -c "from pyectool import ECController; ec = ECController(); print(ec.is_on_ac())"
 ```
 
 ### Available Functions
 
-| Function                                   | Description                                                                      |
-| ------------------------------------------ | -------------------------------------------------------------------------------- |
-| `auto_fan_control()`               | Enables automatic fan control by the EC.                             |
-| `get_max_non_battery_temperature() -> float` | Returns the highest temperature (in °C) from all sensors except the battery.     |
-| `get_max_temperature() -> float`             | Returns the highest temperature (in °C) from all EC sensors including battery.   |
-| `is_on_ac() -> bool`                       | Checks whether the device is running on AC power.                                |
-| `set_fan_duty(percent: int)`               | Sets the fan duty cycle manually (0–100%).                                       |
+All functions are methods of the `ECController` class. Instantiate it like so:
+
+```python
+from pyectool import ECController
+ec = ECController()
+```
+
+Then use the methods as shown below:
+
+| Method                                                  | Description                                                               |
+| ------------------------------------------------------- | ------------------------------------------------------------------------- |
+| `ec.is_on_ac() -> bool`                                 | Returns `True` if the system is on AC power, else `False`.                |
+| `ec.get_num_fans() -> int`                              | Returns the number of fan devices detected.                               |
+| `ec.enable_fan_auto_ctrl(fan_idx: int) -> None`         | Enables automatic fan control for a specific fan.                         |
+| `ec.enable_all_fans_auto_ctrl() -> None`                | Enables automatic control for all fans.                                   |
+| `ec.set_fan_duty(percent: int, fan_idx: int) -> None`   | Sets fan duty (speed) as a percentage for a specific fan.                 |
+| `ec.set_all_fans_duty(percent: int) -> None`            | Sets the same duty percentage for all fans.                               |
+| `ec.set_fan_rpm(target_rpm: int, fan_idx: int) -> None` | Sets a specific RPM target for a specific fan.                            |
+| `ec.set_all_fans_rpm(target_rpm: int) -> None`          | Sets the same RPM target for all fans.                                    |
+| `ec.get_fan_rpm(fan_idx: int) -> int`                   | Returns current RPM of a specific fan.                                    |
+| `ec.get_all_fans_rpm() -> list[int]`                    | Returns a list of current RPM values for all fans.                        |
+| `ec.get_num_temp_sensors() -> int`                      | Returns the total number of temperature sensors detected.                 |
+| `ec.get_temp(sensor_idx: int) -> int`                   | Returns the temperature (in °C) for the given sensor index.               |
+| `ec.get_all_temps() -> list[int]`                       | Returns a list of all sensor temperatures (in °C).                        |
+| `ec.get_max_temp() -> int`                              | Returns the highest temperature across all sensors.                       |
+| `ec.get_max_non_battery_temp() -> int`                  | Returns the highest temperature excluding battery-related sensors.        |
+| `ec.get_temp_info(sensor_idx: int) -> ECTempInfo`       | Returns detailed info for a sensor, including name, type, and thresholds. |
+
+---
+
+### `ECTempInfo`
+
+Returned by `get_temp_info()`, acts like a `dict` with:
+
+* `sensor_name`: str
+* `sensor_type`: int
+* `temp`: int
+* `temp_fan_off`: int
+* `temp_fan_max`: int