RosCard Fan Card Guide
Configure the RosCard Fan Card to control ceiling fans, air circulators, and exhaust fans directly from your Astrion Remote. Supports speed control, oscillation mode, and real-time status feedback.
Overview
The RosCard Fan Card provides a dedicated interface for controlling fan entities from your Astrion Remote. It supports a wide range of fan types — including ceiling fans, pedestal fans, air circulators, and exhaust fans — with speed control, oscillation toggle, and real-time status feedback.
The Fan Card works with any Home Assistant fan entity, offering a clean,
intuitive interface for managing airflow and comfort in any room.
💡 Tip: Enable Independent Display for any Fan Card you want to appear as a full-screen, dedicated view on your Astrion Remote — perfect for bedroom or living room fan control.
Features
On / Off Control
Toggle the fan on and off with a single tap
Speed Control
Adjust fan speed levels — Low, Medium, High, and Auto
Oscillation Mode
Toggle oscillation or swing mode (if supported by the fan)
Real-Time Status
Visual indicators show current speed and on/off state
Independent Display
Full-screen dedicated view on your Astrion Remote
Step-by-Step Configuration
1 Open Dashboard Editor
In Home Assistant, navigate to the dashboard you want to use for your Astrion Remote. Click Edit Dashboard in the top-right corner.
2 Add Fan Card
Click Add Card and search for "Fan (ROS)" or "custom:aiks-fan-card". Select it to add the card to your dashboard.
3 Configure Fan Entity
Add your fan entity to the card. The Fan Card works with any Home Assistant
fan entity.
Example Configuration:
4 Enable Independent Display
For any card you want to appear as a full-screen view on your Astrion Remote, enable Independent Display.
5 Save and Refresh
Click Save to apply your configuration. On your Astrion Remote, pull down from the top of the home screen and tap Refresh to load the new card.
⚠️ Important: Oscillation controls are only available if your fan entity
supports the oscillating attribute in Home Assistant. Not all fans support
oscillation — check your device's capabilities in Developer Tools.
YAML Reference
Full Parameter List
Parameter Details
- entity_id — The Home Assistant entity ID for the fan (e.g.,
fan.living_room_fan). - uuid — A unique identifier for the card. Generated automatically when you add the card.
- independent_display — When
true, the card appears as a full-screen dedicated view on the remote. - alias — A custom display name shown on the remote instead of the entity ID.
Supported Fan Types
- Ceiling Fans: Standard ceiling fans with speed control
- Pedestal Fans: Floor-standing fans with oscillation
- Air Circulators: Smart air movement devices
- Exhaust Fans: Bathroom and kitchen ventilation
- Tower Fans: Slim tower fans with speed and mode control
- Smart Fans: WiFi-enabled fans with Home Assistant integration
Supported Features
- On/Off: Toggle the fan on and off
- Speed: Set fan speed level (Low, Medium, High, Auto)
- Oscillation: Toggle oscillation or swing (if supported)
- Direction: Reverse fan direction (if supported)
💡 Tip: The Fan Card automatically adapts its interface based on the capabilities of your fan entity. If your fan supports oscillation, the card will show an oscillation toggle. If it supports direction, it will show a direction switch.
Example Use Cases
Living Room — Speed Control
Control your living room ceiling fan speed from the Astrion Remote. Adjust from Low to High with a single tap.
Bedroom — Oscillation Control
Control both speed and oscillation for your bedroom fan. Toggle oscillation to distribute air evenly across the room.
Kitchen — Exhaust Fan
Turn on the kitchen exhaust fan while cooking, with speed control for adjusting airflow.
Popular Fan Integrations
The RosCard Fan Card works with any Home Assistant fan entity. Here are some popular integrations that work well:
- Zigbee/Z-Wave: Smart ceiling fans and plug-in fans
- HomeKit: Fans exposed via HomeKit Controller integration
- Tuya/Smart Life: WiFi-enabled fans (requires LocalTuya or Tuya integration)
- ESPHome: Custom-built fans with ESP8266/ESP32
- MQTT: Generic MQTT fan entities
- Bond: RF-controlled ceiling fans (requires Bond integration)
📌 Note: Each integration has its own setup requirements. Most integrations can be installed via HACS or the built-in Home Assistant integrations menu.
Troubleshooting
Fan Card Not Showing on Astrion Remote
- Refresh the remote: Pull down from the top of the home screen and tap Refresh.
- Verify entity exists: Make sure the fan entity is available in Home Assistant.
- Check YAML format: Ensure your configuration uses the correct syntax and indentation.
- Update RosCard: If you're running an older version, update RosCard via HACS.
Fan Not Responding
- Check entity status: Verify the fan is available and not unavailable in Home Assistant.
- Test in Home Assistant: Try controlling the fan directly from the Home Assistant UI to rule out connection issues.
- Verify entity type: Ensure the entity is a valid
fanentity. - Check permissions: Make sure the Astrion Remote token has permission to control the fan.
Oscillation Control Not Showing
- Ensure your fan entity supports the
oscillatingattribute. - Check the entity's supported features in Home Assistant Developer Tools.
- Some fan integrations (e.g., basic exhaust fans) may not support oscillation.
Speed Controls Not Working
- Verify the fan entity supports speed control (not all fans do).
- Some fans only support on/off (toggle) and not speed adjustment.
- Check the device's capabilities in Home Assistant Developer Tools.
🔧 Note: After updating RosCard to a new version, you may need to resave all your Fan Cards to refresh the binding. This is a known requirement for version updates.
Related resources
Need help with Fan Card?
Our support team and community are here to assist you.