Complete Feature Parity for dmaker.fan.p18

[adamlove86]

Feature Request: Complete Feature Parity for dmaker.fan.p18

Summary

The Xiaomi Smart Fan 2 (dmaker.fan.p18) has several advanced features available in the Mi Home app that are not currently exposed by the Xiaomi Miot Auto integration. Based on user testing, only basic controls are currently auto-exposed.

Current Integration Status

✅ Currently Exposed (from user's device screenshot):

• Alarm
• Fan (basic on/off)
• Horizontal Angle (preset angles only)
• Info
• Oscillation
• Physical Control Locked
• Power Off Delay Time

❌ Missing Advanced Features (NOT auto-exposed):

1. Incremental Speed Adjustment (1-100 precision) - NOT exposed as percentage control
2. Direct/Natural Breeze Mode Toggle - NOT exposed as preset_mode select
3. Nudge Left/Right (Motor Control) - NOT exposed as button entities

Device Information

• Model: dmaker.fan.p18
• Firmware: 2.1.3@esp8266
• MIoT Type: urn:miot-spec-v2:device:fan:0000A005:dmaker-p18:1
• Integration: Xiaomi Miot Auto (HACS)

Missing Features - Technical Details

1. Incremental Speed Adjustment (1-100)

Property Details:

• siid: 2 (Fan service)
• piid: 10 (Speed Level property)
• Format: uint8
• Access: read, write, notify
• Range: 1-100
• ⚠️ CRITICAL: Only works in "Direct Breeze" mode

Current Behavior: Integration does NOT expose this as a percentage control or number entity.

Proposed Solution: Expose as a number entity with range 1-100, or integrate into existing fan percentage control.

2. Direct/Natural Breeze Mode Toggle

Action Details:

• siid: 4 (DM service)
• aiid: 1 (toggle-mode action)
• Effect: Toggles between "Natural Breeze" (auto-vary speed) and "Direct Breeze" (manual control)

Current Behavior: Integration does NOT expose this as a select entity or button.

Proposed Solution: Add as a select entity for mode switching (Natural Wind / Straight Wind).

3. Motor Control (Nudge Left/Right)

Property Details:

• siid: 2 (Fan service)
• piid: 9 (Motor Control property)
• Format: uint8
• Access: write
• Values: 0=NO, 1=LEFT, 2=RIGHT

Current Behavior: Integration does NOT expose these as button entities.

Proposed Solution: Auto-create button entities for incremental fan positioning.

MIoT Specification

All properties are documented in the official MIoT spec:

{
  "iid": 9,
  "type": "urn:miot-spec-v2:property:motor-control:00000038:dmaker-p18:1",
  "description": "Motor Control",
  "format": "uint8",
  "access": ["write"],
  "value-list": [
    {"value": 0, "description": "NO"},
    {"value": 1, "description": "LEFT"},
    {"value": 2, "description": "RIGHT"}
  ]
},
{
  "iid": 10,
  "type": "urn:miot-spec-v2:property:speed-level:00000023:dmaker-p18:1",
  "description": "Speed Level",
  "format": "uint8",
  "access": ["read", "write", "notify"],
  "value-range": [1, 100, 1]
}

Existing Device Customizations

In device_customizes.py, the wildcard rule already includes:

'*.fan.*': {
    'button_actions': 'turn_left,turn_right',
    ...
}

This suggests native support was intended for motor control buttons, but is not working for p18.

Tested Workaround Implementation

Until native support is added, users can implement these via scripts:

# Motor Control (Nudge)
fan_nudge_left:
  alias: Fan Nudge Left
  icon: mdi:arrow-left-bold
  sequence:
    - service: xiaomi_miot.set_miot_property
      data:
        entity_id: fan.dmaker_p18_9145_fan
        siid: 2
        piid: 9
        value: 1

fan_nudge_right:
  alias: Fan Nudge Right
  icon: mdi:arrow-right-bold
  sequence:
    - service: xiaomi_miot.set_miot_property
      data:
        entity_id: fan.dmaker_p18_9145_fan
        siid: 2
        piid: 9
        value: 2

# Mode Toggle
fan_toggle_breeze_mode:
  alias: Fan Toggle Breeze Mode
  icon: mdi:wind-power
  sequence:
    - service: xiaomi_miot.call_action
      data:
        entity_id: fan.dmaker_p18_9145_fan
        siid: 4
        aiid: 1
        params: []

# Precise Speed Control
fan_set_speed:
  alias: Fan Set Custom Speed
  icon: mdi:speedometer
  fields:
    speed:
      description: Speed level (1-100)
      example: 50
      selector:
        number:
          min: 1
          max: 100
          step: 1
  sequence:
    - service: xiaomi_miot.set_miot_property
      data:
        entity_id: fan.dmaker_p18_9145_fan
        siid: 2
        piid: 10
        value: "{{ speed }}"

Testing Results

• Device: dmaker.fan.p18, firmware 2.1.3@esp8266
• Integration: Xiaomi Miot Auto (HACS)
• Method: Direct property writes via xiaomi_miot.set_miot_property
• Results:
  • ✅ Motor control (nudge left/right) - Physical movement confirmed
  • ✅ Mode toggle - Successfully switches between Natural/Direct modes
  • ✅ Speed control (1-100) - Works in Direct mode only
• Logs: No errors, all commands execute cleanly

Proposed Implementation

Priority 1: Speed Control Entity

• Add number entity for precise speed control (1-100)
• Or enhance existing fan entity to support full percentage range
• Document mode dependency (Direct Breeze only)

Priority 2: Mode Toggle Entity

• Add select entity for Natural/Direct Breeze modes
• Options: "Natural Wind" and "Straight Wind"
• Update existing fan entity to reflect current mode

Priority 3: Motor Control Buttons

• Auto-create button.{device}_turn_left and button.{device}_turn_right
• Use siid:2, piid:9 with values 1 and 2
• Icons: mdi:arrow-left-bold and mdi:arrow-right-bold

Benefits

Implementing these features would:

• ✅ Complete feature parity with Mi Home app
• ✅ Eliminate manual scripting requirements
• ✅ Enable advanced automations (positioning, precise speed control)
• ✅ Improve user experience with intuitive controls
• ✅ Align with integration patterns for other fan models

Related Models

These enhancements would likely benefit other DMaker fans:

• dmaker.fan.p45 (already has some button_actions support)
• Other DMaker smart fans with similar capabilities

User Impact

Currently, users must:

1. Create custom scripts for basic functionality available in Mi Home
2. Use workarounds for features that should be native
3. Miss out on advanced automation possibilities

With native support:

1. All features accessible via standard HA UI
2. Dashboard integration without custom scripting
3. Full automation and scene support

---

References:

• Integration: https://github.com/al-one/hass-xiaomi-miot
• MIoT Spec: https://home.miot-spec.com/spec/dmaker.fan.p18
• python-miio: https://python-miio.readthedocs.io/

Thank you for maintaining this excellent integration! The p18 has great potential - these features would unlock its full capabilities for Home Assistant users. 🎉