Astrion ROS Card Configuration Guide
This guide explains how to configure ROS Cards for the Astrion Smart Remote in Home Assistant.
ROS Cards allow Astrion to display and control devices such as lights, climate systems, covers, media players, and more.
How ROS Cards Work
Astrion does not create devices directly.
Instead, it reads the Home Assistant dashboard configuration and displays supported ROS cards on the remote screen.
Basic workflow:
Add a ROS Card to your Home Assistant dashboard
Assign Home Assistant entities to the card
Save the configuration
Astrion syncs and displays the card automatically
Available ROS Card Types
| Card | Purpose |
|---|---|
| AC (ROS) | Climate Control Card |
| Cover (ROS) | Curtain / Blind Control |
| Fan (ROS) | Fan Control |
| Light (ROS) | Light Control |
| Media Player (ROS) | Media Player Control |
| Scene (ROS) | Scene & Script Control |
| Statistics (ROS) | Device Status Monitoring |
| Switch (ROS) | Switch Control |
| TV (ROS) | TV Control |
| Weather (ROS) | Weather Information |
Basic Card Setup
Step 1 — Open Home Assistant Dashboard
Go to:
Home Assistant → Dashboard
Click:
Edit Dashboard
Step 2 — Add a ROS Card
Click:
Add Card
Select one of the ROS cards.
Example:
Light (ROS)
Step 3 — Add Entities
Assign the Home Assistant entity you want to control.
Example:
light.living_room
Step 4 — Save
Click:
Save
The Astrion remote will automatically sync the configuration.
Configuration Example
Light Control Card
The Light Card allows Astrion to control one or multiple lights.
Example:
type: custom:aiks-light-card
entities:
- entity_id: light.lu_tai_deng
uuid: 20d80393-3d1d-4618-8d27-542973799be3
independent_display: false
alias: Desk CSD
- entity_id: light.diao_guang_2
uuid: 3d43a7c3-1957-4bcf-a34c-911aac62189d
independent_display: false
alias: ""
Parameters:
| Parameter | Description |
|---|---|
| entity_id | Home Assistant light entity |
| uuid | Unique ID used by Astrion |
| independent_display | Controls independent display mode |
| alias | Custom name shown on the remote |
Switch Control Card
Used for controlling smart switches or relays.
Example:
type: custom:aiks-switch-card
entities:
- entity_id: switch.ipano_relay_1_2
uuid: 9a19a877-9772-4d04-8672-9589862dfbf6
alias: ""
- entity_id: switch.ipano_relay_2_2
uuid: a63535bb-756a-48a7-bf19-b295ef6970dc
alias: ""
Astrion can toggle switches directly from the remote.
Media Player Card
Controls audio devices, TVs, and media players.
Example:
type: custom:aiks-media-player-card
entities:
- entity_id: media_player.speakerss190_2872_2
uuid: 226fb064-f366-43b6-a487-e81f8c336cef
independent_display: true
alias: ""
remoteId: ""
Typical controls include:
-
Play / Pause
-
Volume
-
Source selection
Climate Control Card
Controls air conditioners or thermostats.
Example:
type: custom:aiks-climate-card
entities:
- entity_id: climate.ban_gong_shi_kong_diao
uuid: 8fd848c5-78a1-41dc-bbf7-43b965bfe463
independent_display: true
alias: ""
Astrion supports:
-
Temperature adjustment
-
HVAC mode selection
-
Fan speed control
Scene Control Card
Used to trigger scenes or scripts in Home Assistant.
Example:
type: custom:aiks-scene-card
entities:
- entity_id: scene.go_home
uuid: 21ef9622-8e69-4736-aa1e-b505868a6a00
mode: immediate
alias: ""
Common uses include:
-
Movie mode
-
Good night
-
Leaving home automation
Weather Card
Displays weather information on Astrion.
Example:
type: custom:aiks-weather-card
entities:
- entity_id: weather.shenzhen
uuid: b06a892e-82f4-4e04-bb0b-6b5fee8421d0
alias: ""
Statistics Monitor Card
This card monitors the status of smart devices in the home.
Example:
type: custom:aiks-switch-monitor-card
uuid: a58ddbb5-84a4-424e-b712-81f4cac69c4b
monitor_name: home
device_types:
light: true
switch: true
climate: true
TV Control Card
Allows Astrion to function as a full TV remote.
Example:
type: custom:aiks-tv-card
uuid: 4930e7ed-df20-4bb3-bcc2-6f5c0e9180a5
tv_type: android_tv
tv_name: Xiaomi TV
media_play_entity: media_player.szxiaomitv
Example button mapping:
entities:
- key: POWER
type: remote
entity_id: remote.android_tv_192_168_2_121
value: POWER
Supported commands include:
-
Power
-
Volume
-
Navigation
-
Channel control
-
Numeric input
Important Notes
• All entities must exist in Home Assistant.
• Each entity must have a unique UUID.
• After saving the configuration, Astrion will sync automatically.
• Incorrect entity IDs will cause the card to fail.
Example Card Use Cases
Living Room Control
Cards used:
-
Light (ROS)
-
Media Player (ROS)
-
Scene (ROS)
Example layout:
Living Room
├─ Light Control
├─ TV Control
├─ Movie Scene
Bedroom Control
Cards used:
-
Light (ROS)
-
Climate (AC ROS)
-
Cover (ROS)
Example layout:
Bedroom
├─ Bedside Lights
├─ Air Conditioner
├─ Curtains
Statistics Card Example
The Statistics (ROS) card can monitor device status such as:
-
temperature
-
humidity
-
light brightness
-
switch status
Example uses:
-
room monitoring
-
energy tracking
-
climate overview
Common Mistakes
Card Not Showing on Astrion
Possible causes:
• entity does not exist
• wrong YAML format
• card not saved in dashboard
• Astrion not synced yet
Entity Not Responding
Check:
• entity is available in Home Assistant
• correct entity_id used
• user permissions allow control
Tips for Best Experience
Use alias names to display friendly device names
Group cards by room
Use Scene cards for common automation actions
Avoid adding too many entities to one card
Recommended Setup Structure
A good beginner layout:
Home
├─ Living Room
│ ├─ Light
│ ├─ TV
│ ├─ Scene
│
├─ Bedroom
│ ├─ Light
│ ├─ Climate
│ ├─ Curtains
│
├─ Kitchen
│ ├─ Light
│ ├─ Switch
This keeps the Astrion interface clean and easy to use.
Need Help?
If you run into issues, please include the following when asking for help:
• Home Assistant version
• Astrion firmware version
• YAML configuration
• screenshots of the problem
Community discussions and support are available in the Astrion Remote section of the forum.