📘 RosCard for Home Assistant

Charles · December 22, 2025, 7:52am

RosCard for Home Assistant

Complete Technical Documentation (v2.0.0)

Product: Astrion Remote HA100
Last Updated: December 5, 2025
Maintained by: Sanytron Technology

About This Document

This post is the official technical reference for RosCard, the custom Home Assistant card system designed for Astrion Remote.

RosCard acts as the communication bridge between Astrion hardware and Home Assistant, enabling:

Real-time control
Optimized UI rendering
Physical button integration
Secure local communication

This document is intended for advanced users, integrators, and developers.

Copyright & Disclaimer

© 2025 Sanytron Technology. All rights reserved.
This document contains proprietary information. Specifications may change without notice.

Home Assistant is a trademark of the Home Assistant project
All other trademarks belong to their respective owners

Introduction to RosCard

1.1 What is RosCard?

RosCard is a custom Home Assistant card package built specifically for the Astrion Remote HA100.

Without RosCard:

Astrion cannot communicate with Home Assistant
No entity control or status sync is possible

RosCard translates HA states and services into a UI optimized for Astrion’s 3.1" touchscreen and physical buttons.

1.2 Key Principles

API-Based Communication (HA WebSocket API)
Real-Time State Synchronization
Secure Token-Based Authentication
Astrion-Optimized UI Rendering
Physical Button Mapping Support

1.3 System Requirements

Component	Minimum	Recommended
Home Assistant	Core 2023.1+	2024.1+
HACS	1.30.0+	Latest
Network	Local Wi-Fi	5GHz
Astrion Remote	FW 1.0+	FW 1.2+

System Architecture

2.1 Communication Flow

Astrion Remote  ⇄  WebSocket API  ⇄  Home Assistant + RosCard

Astrion handles UI & hardware input
RosCard handles HA communication & data formatting
HA remains the single source of truth

2.2 Data Flow Example

Astrion requests entity state
RosCard queries HA WebSocket
HA returns entity data
RosCard optimizes data for display
Astrion renders UI

2.3 Security Model

Feature	Implementation
Authentication	Long-lived HA tokens
Data Storage	No HA data stored on remote
Network	Local WebSocket
Token Control	Revocable via HA
Encryption	HTTPS / Secure WS

Installation Guide

3.1 Prerequisites

Home Assistant running
HACS installed
Astrion on same network
Network discovery enabled

3.2 Installation Steps (HACS)

Step 1 – Add Repository

HACS → Integrations → Custom Repositories
URL: https://github.com/yyqclhy/RosCard
Category: Dashboard

Step 2 – Install RosCard

Search "RosCard" → Download → Restart HA

Step 3 – Create Access Token

Profile → Security → Long-lived Tokens
Name: Astrion Remote

Step 4 – Generate QR Code

http://HA_IP:8123?token=YOUR_TOKEN

Configuration & Setup

4.1 Astrion Remote Connection

Settings → Home Assistant → Scan QR Code
Manual setup supported if needed

4.2 Creating RosCard Views

Edit Dashboard → Add Card
Select Custom: RosCard
Enable Independent Display for full-screen use

4.3 Physical Button Mapping

Path:
Remote Settings → Shortcut Configuration

Supported actions:

Light / Climate control
Media playback
Scene activation
Custom HA service calls

Card Types & Features

Climate Card

Temperature presets
Mode selection
Fan & swing control
Real-time feedback

Light Card

Brightness (0–100%)
Color temp / RGB
Group & scene support

Media Card

Android TV / Apple TV
Playback & navigation
Custom key mapping

Supported Card Summary

Card	Purpose
Climate	AC & heating
Light	Dimming & color
Switch	Power control
Cover	Curtains & blinds
Scene	Automation
Media	AV control
Weather	Forecast
Host	System actions

API Integration

6.1 WebSocket API

RosCard uses HA’s official WebSocket API for:

State subscriptions
Event handling
Service execution

6.2 Performance Optimization

Lazy loading
Delta updates
Data compression
Cached UI assets
Batched requests

6.3 Service Call Mapping

RosCard converts Astrion actions into standard HA service calls
(e.g. light.toggle, climate.set_temperature).

Troubleshooting

Common Issues

Issue	Cause	Solution
No connection	Network	Re-scan QR
No response	Entity mapping	Rebind
Slow UI	Network	Use 5GHz
Device missing	Discovery	Restart HA

Reset Options

Soft Reset: Restart remote
Hard Reset: Factory reset
RosCard Reset: Reinstall via HACS

Advanced Features

Custom Icons

Path:
/local/community/RosCard/icon_img/

Formats:

PNG (recommended)
SVG
JPG

Templates & Automations

RosCard supports:

HA templates
Button-triggered automations
Multi-user dashboards
Per-user access tokens

FAQ (Short Version)

Why RosCard? → Required communication layer
Multiple remotes? → Yes, one token per device
Remote lost? → Revoke token
Remote-only use? → Works as Lovelace cards too

1:zero: Support & Resources

Official

Community

GitHub: RosCard Repository
Facebook: Astrion Remote Users

Document Version History

Version	Date	Notes
1.0.0	Nov 2025	Initial
1.1.0	Dec 2025	Troubleshooting
2.0.0	Dec 2025	Full documentation

Downloads

Always refer to this forum post or the official portal for the latest updates.

peteS-UK · December 26, 2025, 3:37pm

Can you add some details on HA Templates and Button-triggered automations please.

Charles · December 29, 2025, 8:28am

Hi @peteS-UK, great question.

HA Templates

RosCard supports Home Assistant templates, because templates are evaluated by HA itself.
Astrion simply displays and controls the resulting entities.

Common uses:

Conditional entities
Time-based behavior
State-dependent controls

Button-triggered automations

Physical buttons on Astrion can trigger:

Scenes
Scripts
Automations
Custom HA service calls

Typical flow:
Astrion button → HA event/service → HA automation logic