📘 RosCard Quick Start Guide - Get Your Astrion Remote Running in 10 Minutes

Astrion Astrion - Knowledge Base & Tutorials
, , , ,
1

Astrion Remote HA100

Home Assistant User Manual
Version 1.0.0

Smart Control Terminal for Home Assistant Ecosystem

Nov, 2025

Copyright & Disclaimer

© 2025 Sanytron Technology. All rights reserved.
This document contains proprietary information of Sanytron Technology. No part of this publication may be reproduced or transmitted in any form without prior written permission. Product specifications are subject to change without notice. Home Assistant is a trademark of the Home Assistant project. All other trademarks are the property of their respective owners.

Contents

1. Welcome to Astrion: Your Home Assistant Command Center 4

2. Getting Started: Setup & Launcher Tour 4

ü Unbox & Charge: Place the remote on its magnetic charging dock to ensure a full battery. 5

ü Power On: Press and hold the power button until the screen activates. 5

ü Connect to Wi-Fi: Follow the on-screen prompts to connect to your local Wi-Fi network. 6

ü Log in to Home Assistant: You will be guided to log in; the process is detailed in Section 4. 6

3. Mastering the Basics: Customization & Updates 8

4. Home Assistant Integration Deep Dive. 10

ü HACS > Custom Repositories. 11

ü In the new window: 11

ü Refresh HACS (typically by pressing F5). 13

ü Search & Download RosCard. 13

ü Edit Dashboard. 15

ü Add Card > Custom: RosCard. 15

ü Bind entities. 15

ü Create Long-Lived Access Token in HA: 17

ü Create QR Code with URL + token: 18

ü Remote > Settings > HA Login > Scan QR：.. 18

5. Tips for a Smooth Experience. 19

6. Appendix & Support 19

7. Frequently Asked Questions (FAQ) 20

Astrion Remote HA100 for Home Assistant

User Manual - Version 1.0.0

1. Welcome to Astrion: Your Home Assistant Command Center

The Astrion Remote HA100 is not just another remote; it’s a dedicated hardware terminal designed from the ground up for the Home Assistant (HA) ecosystem. It provides a seamless, responsive, and tactile interface to control your entire smart home.

1.1 Core Concept: Terminal, Not an Accessory
Think of Astrion as a specialized keyboard and monitor for your HA server. It uses the official Home Assistant WebSocket API to send commands and receive real-time state updates. It is a controller for HA, not a device managed within HA.

1.2 How It Works: A Seamless Connection

  • Instant-On Launcher: The custom Astrion interface starts automatically.

  • Persistent Link: A dedicated app maintains a secure, real-time WebSocket connection to your HA instance.

  • Optimized Interface: Your RosCard views load instantly for fast control.

  • Dual Control: Use the responsive touchscreen or programmable physical keys.

1.3 The Astrion Difference

Type

Example

Role in the Ecosystem

Bluetooth Remote

Pairs with a TV

Controlled Device

Smartphone with HA App

Controls HA via Wi-Fi

General-Purpose Terminal

Astrion Remote HA100

Controls HA via WebSocket API

Dedicated Control Terminal

After initial setup, the Astrion Launcher automatically connects to your Home Assistant and loads your designated views (e.g., RosCard profiles). Physical shortcut keys can be rebound to trigger any HA service, scene, or navigation. For developers, the remote interacts solely through standard HA APIs, requiring no custom integration. Feature updates are delivered seamlessly via OTA (Over-The-Air) updates.

2. Getting Started: Setup & Launcher Tour

2.1 First-Time Setup in 4 Steps

ü Unbox & Charge: Place the remote on its magnetic charging dock to ensure a full battery.

Figure 1 — First‑time setup / power‑on sequence

ü Power On: Press and hold the power button until the screen activates.

Figure 2 — First‑time setup / power‑on sequence

ü Connect to Wi-Fi: Follow the on-screen prompts to connect to your local Wi-Fi network.

Figure 3 — Launcher home and settings

ü Log in to Home Assistant: You will be guided to log in; the process is detailed in Section 4.

Figure 4 — Launcher home and settings

2.2 Astrion Launcher Overview

The Launcher is your mission control, designed for single-purpose, efficient HA control.

· Home Screen: Your primary HA dashboard and view switcher.

Figure 5 — Launcher home and settings

· Settings: Configure shortcuts, Wi-Fi, and the HA connection.

· System Tray: Quick access to brightness, sleep, and power options.

Figure 6 — Launcher home and settings

3. Mastering the Basics: Customization & Updates

3.1 Key Mapping & Shortcut Configuration

Transform the physical buttons into one-touch smart home controls.

Configuration Path:
Settings → Shortcut → [Select Key] → [Choose Action] → [Bind Entity/Service/Scene]

:light_bulb: Pro Tip: You can assign different actions for short press and long press on most keys, effectively doubling your shortcuts.

Figure 7 — Shortcut mapping and key configuration

· Choose action (e.g., “Light Dash” “Curtain Dash” etc.)

Note: You can find the same icons on the remote keypad. Once set up here, you can control it with the remote.

Figure 8 — Shortcut mapping and key configuration

· Bonding service/scene

3.2 OTA (Over-The-Air) Firmware Upgrades

Your Astrion Remote improves over time with feature additions and enhancements.

  • Checking for Updates: Navigate to Settings > About > Software Version.

  • Notification: A red dot will appear next to the version number if an update is available.

  • Installation: Ensure the remote is on Wi-Fi and has sufficient charge. Updates download and install automatically.

4. Home Assistant Integration Deep Dive

4.1 Prerequisite: Install HACS

This integration requires the Home Assistant Community Store (HACS). Please install HACS on your server before proceeding.

Figure 9 — HACS configuration and RosCard repository setup

4.2 Installing RosCard via HACS

RosCard is the custom card optimized for the Astrion Remote’s display and interaction model.

Steps:

  1. Open HACS → menu (⋮) → Custom Repositories
  2. Add
    GitHub - yyqclhy/RosCard: RosCard is a collection of advanced UI cards designed for seamless integration between Home Assistant and the Astrion ecosystem. · GitHub
    Category: Dashboard
  3. Refresh HACS (e.g., press F5), search for RosCard
  4. Download and restart if prompted

ü HACS > Custom Repositories

Figure 10 — HACS configuration and RosCard repository setup

ü In the new window:

· Add repo: https://github.com/yyqclhy/RosCard

· Category：Dashboard.

Figure 11 — HACS configuration and RosCard repository setup

Figure 12 — HACS configuration and RosCard repository setup

ü Refresh HACS (typically by pressing F5).

Figure 13 — HACS configuration and RosCard repository setup

ü Search & Download RosCard.

Figure 14 — HACS configuration and RosCard repository setup

Figure 15 — HACS configuration and RosCard repository setup

Figure 16 — HACS configuration and RosCard repository setup

4.3 Creating RosCard Control Views

Dashboard → Edit → Add Card → Custom: RosCard → Bind entities.
Examples:
• Light Control: Add light entities; enable Display Independently for full‑screen view on remote
• Media Player: Android TV → remote entity; Apple TV → media_player + remote

ü Edit Dashboard

Figure 17 — RosCard view creation and entity binding

ü Add Card > Custom: RosCard

Figure 18 — RosCard view creation and entity binding

ü Bind entities

  • Example:
    Light Card

    • Add light entities.

    • Enable Display Independently to make this card appear as a dedicated, full-screen view on the Astrion Remote.

Figure 19 — RosCard view creation and entity binding

Media Card

o Android TV: select remote entity

o Apple TV: select media_player + remote

Figure 19 — RosCard view creation and entity binding

4.4 Connecting to Your Home Assistant Account

A. Generate a Long-Lived Access Token in HA

In HA: Profile → Long‑Lived Access Tokens → Create → Copy.

B. Log In via QR Code (Recommended)

Create a QR containing HA URL + token. On remote: Settings → Home Assistant → Login → Scan QR.
If discovery fails, enter HA URL manually (e.g., http://192.168.1.133:8123).

Steps:

ü Create Long-Lived Access Token in HA:

  • In Home Assistant, click on your profile in the bottom-left corner.

  • Scroll down to Security and click Long-Lived Access Tokens.

  • Click Create Token, give it a name (e.g., “Astrion Remote”), and copy the generated token.

Figure 20 — QR login, token input, and server URL discovery

Figure 21 — QR login, token input, and server URL discovery

ü Create QR Code with URL + token:

ü Remote > Settings > HA Login > Scan QR：

On the Astrion Remote, ensure it’s on the same Wi-Fi network as your HA server.

Figure 22 — QR login, token input, and server URL discovery

Figure 22 — QR login, token input, and server URL discovery

  • If the automatic discovery fails, you will be prompted to enter your HA instance’s internal URL manually (e.g., http://192.168.1.133:8123).

5. Tips for a Smooth Experience

  • Network is Key: The remote and HA server must be on the same local subnet for auto-discovery to work.

  • Data Efficiency: Only RosCard configuration data is cached on the remote. All your automations, secrets, and core logic remain secure on your HA server.

  • Stay Updated: Periodically check Settings > About > Software Version for OTA updates.

6. Appendix & Support

Support Resources:

7. Frequently Asked Questions (FAQ)

Q1: Why doesn’t the Astrion Remote appear in my Home Assistant integrations?
A: Correct! It is a control terminal, not a device to be integrated. It communicates via the official HA API, just like the mobile app.

Q2: The remote can’t find my HA server automatically. What’s wrong?
A: This is almost always a network issue. Ensure both devices are on the same Wi-Fi network and subnet. If problems persist, manually enter your HA server’s local IP address in the login screen.

Q3: I added a new RosCard view in HA, but it’s not showing up on the remote.
A: You need to refresh the views on the remote. Pull down from the top of the home screen and tap the Refresh button.

Q4: Can I use the remote outside my home network?
A: It is possible if your Home Assistant instance is securely exposed to the internet (e.g., via Nabu Casa or a VPN), but performance and setup are best on the local network.

Q5: My remote feels sluggish. What can I do?
A: Try these steps in order: 1) Refresh your views. 2) Restart the remote. 3) Check for and install any OTA Updates. 4) Ensure your Wi-Fi signal is strong.

Q6: I changed my HA password/long-lived token. How do I re-login?
A: Go to Settings > Home Assistant > Log Out. Then, go through the login process again with your new credentials.

Q7: How do I perform a factory reset?
A: Navigate to Settings > System > Factory Reset. Warning: This will erase all settings, shortcuts, and the HA connection.

RMKs: More detail beginner setup, guide & tutorial for Astrion remote can be found in Sanytron’s online forum.

URL

https://forum.sanytron.com/c/astrion-remote/astrion-knowledge-base-tutorials/19

Independent Review: Astrion Remote for Home Assistant by Cameron Gray (Video)
📌 FAQ - Frequently Asked Questions (Read First!)