.. _features_usage:

5.Features Usage Guide
========================

This chapter provides a detailed introduction to the functions and usage methods of the LAFVIN AIoT Starter Kit, helping you make full use of the platform.

AI Voice Control Features
------------------------------------------

The core feature of the LAFVIN AIoT Starter Kit is controlling hardware devices through natural language. You can interact with the system in the following ways:

**Voice Wake-up Method**

1. Wake word activation:
   
   * Default wake word is "Hi ESP" or "Sophia"
   * After saying the wake word, the system will respond and wait for your commands
   * You have approximately 5 seconds to give control commands after wake-up
   * Supports continuous conversation and mid-conversation interruption

**Device Control Commands**

The LAFVIN AIoT Control Kit supports the following types of voice control:

1. **Lighting Control**: "Turn the light red" / "Enable rainbow mode"

2. **Environmental Monitoring**: "What's the current temperature and humidity?"

3. **Device Operation**: "Turn on the cooling fan" / "Move servo to 90 degrees"

4. **Scene Modes**: "Enable police car mode" / "Start rainbow chase"

**Voice Recognition Quality**

1. Pickup range: Approximately 2-3 meters effective recognition distance

2. Noise reduction: Built-in algorithms can filter environmental noise

3. Multi-language support: Chinese, English, and other language recognition

Smart Lighting System
------------------------------------------

**RGB LED Module Functions**

   .. code-block:: none

      RGB LED module  →    ESP32-S3
      GND             →    GND
      R               →    GPIO4
      G               →    GPIO5
      B               →    GPIO6

.. image:: img/connect/rgb_led.jpg

1. **Color Adjustment**:
   
   * Supports 16.77 million colors for precise color adjustment
   * Voice command: "Hi ESP, turn the LED blue"
   * Adjustable brightness: 0-100% continuous adjustment

2. **Special Effect Modes**:
   
   * Breathing light effect: Configurable color and breathing cycle
   * Rainbow mode: Automatic color cycle transitions
   * Voice command: "Hi ESP, enable breathing light mode"

.. .. video:: img/rgb_led_demo.mp4
    :width: 100%

**WS2812 Smart LED Strip**

.. code-block:: none

   WS2812strip   →    ESP32-S3
   5V            →    5V
   GND           →    GND
   DIN           →    GPIO7

.. image:: img/connect/led_strip.jpg

1. **Preset Lighting Modes**:
   
   * Police car mode: Red and blue alternating flashing effect
   * Rainbow chase: Rainbow colors flowing along the strip
   * Breathing light: Overall brightness gradient effect

2. **Custom Control**:
   
   * Overall color setting: All 8 LEDs change color simultaneously
   * Individual LED control: Precise control of each LED
   * Voice commands: "Hi ESP, enable rainbow chase on LED strip", "Hi ESP, enable police car mode on LED strip"

.. video:: img/phenomenon/police_mode.mp4
    :width: 100%

Environmental Monitoring System
------------------------------------------

**DHT11 Temperature & Humidity Sensor**

   .. code-block:: none
   
      DHT11 Sensor  →    ESP32-S3
      DATA          →    GPIO11
      VCC           →    5V
      GND           →    GND

.. image:: img/connect/dht11.jpg

1. **Real-time Monitoring Functions**:
   
   * Temperature monitoring: 0-50°C, accuracy ±2°C
   * Humidity monitoring: 20-90%RH, accuracy ±5%RH
   * Voice query: "Hi ESP, what's the current temperature and humidity?"

.. .. video:: img/dht11_demo.mp4
    :width: 100%


**Rain Sensor**

   .. code-block:: none
   
      Rain Sensor   →    ESP32-S3
      VCC           →    3.3V
      GND           →    GND
      DO            →    GPIO15

.. image:: img/connect/rain_sensor.jpg

1. **Rainfall Detection**:
   
   * Real-time raindrop sensing
   * Digital switch signal output
   * Voice query: "Hi ESP, is it raining outside?"

.. .. video:: img/rain_sensor_demo.mp4
    :width: 100%

**Soil Moisture Sensor**

   .. code-block:: none
   
      Soil Sensor   →    ESP32-S3
      VCC           →    3.3V
      GND           →    GND
      DO            →    GPIO17

.. image:: img/connect/soil_sensor.jpg

1. **Soil Status Monitoring**:
   
   * Real-time soil moisture content detection
   * Analog signal output with high precision
   * Voice query: "Hi ESP, how is the soil moisture of the plants?"

.. .. video:: img/soil_sensor_demo.mp4
    :width: 100%
   
Smart Control System
------------------------------------------

**SG90 Servo Motor Control**

   .. code-block:: none
   
      SG90 Servo    →    ESP32-S3
      Red (VCC)     →    5V
      Brown (GND)   →    GND
      Orange (Signal) →  GPIO16

.. image:: img/connect/servo.jpg

1. **Precise Angle Control**:
   
   * Control range: 0-180 degrees
   * Control precision: 1 degree
   * Voice command: "Hi ESP, move servo to 45 degrees"

2. **Motion Modes**:
   
   * Scanning mode: Automatic left-right swinging
   * Voice command: "Hi ESP, start servo scanning"

.. .. video:: img/servo_demo.mp4
    :width: 100%

**Smart Fan Control**

   .. code-block:: none
   
      Fan Module    →    ESP32-S3
      VCC           →    5V
      GND           →    GND
      IN            →    GPIO10

.. image:: img/connect/fan.jpg

1. **On/Off Control**:
   
   * Voice control: "Hi ESP, turn on the fan" / "Hi ESP, turn off the fan"
   * Status query: "Hi ESP, is the fan running?"

.. video:: img/phenomenon/fan.mp4
    :width: 100%

**2-Channel Relay Control**

   .. code-block:: none
   
      Relay Module  →    ESP32-S3
      VCC           →    5V
      GND           →    GND
      IN1           →    GPIO8
      IN2           →    GPIO9

.. image:: img/connect/relay.jpg

1. **Independent Control**:
   
   * Two relays can be controlled independently
   * Voice command: "Hi ESP, turn on relay channel 1"
   * Maximum control capacity: 10A@250VAC

2. **External Device Control**:
   
   * Control lamps, appliances, and other external devices
   * Timer on/off functionality
   * Safety isolation protection

.. video:: img/phenomenon/relays.mp4
    :width: 100%

Application Scenarios
------------------------------------------

**Smart Home** *(Ready to Use)*
* Environmental monitoring: "Hi ESP, what's the temperature?" → Real-time sensor data
* Lighting control: "Hi ESP, turn the light warm yellow" → RGB mood lighting
* Device control: "Hi ESP, turn on the fan" → Built-in relay/fan control

**Smart Agriculture** *(Monitoring Ready, Automation Requires Development)*
* Monitoring: "Hi ESP, how's the soil moisture?" → Sensor data collection
* Automation: Connect pumps/valves to relays for irrigation *(requires additional hardware & programming)*

**Creative Display** *(Ready to Use)*
* Light shows: "Hi ESP, enable police car mode" → Dynamic LED effects
* Interactive demos: "Hi ESP, start servo scanning" → Motion demonstrations

**Educational & Development Platform** *(Ready to Use + Expandable)*
* Learning: Device control principles, AI voice interaction
* Development: MCP protocol extension, custom automation logic

.. note::
   **Included**: All sensors, LED controls, servo, fan, and 2-channel relay are ready to use with voice commands.
   
   **Expandable**: Connect external devices (pumps, valves, appliances) to relays for custom automation. Programming knowledge required for advanced features.

Device Status & Control
------------------------------------------

**Voice Queries**
* "Hi ESP, what's the status of all sensors?"
* "Hi ESP, which devices are running?"
* "Hi ESP, is the system working normally?"

**Smart Features**
* Supports voice-driven status checks after the device is connected and bound
* Can be extended through firmware and backend customization for advanced automation