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

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

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

New to Astrion Remote? This guide will help you set up RosCard and get your remote working with Home Assistant quickly.

What is RosCard?

RosCard is a custom Lovelace card system for Home Assistant that enables full integration with your Astrion Remote. It’s installed via HACS and provides 9 different card types for controlling your smart home.

:clipboard: Prerequisites

  • Home Assistant instance (local or cloud accessible)
  • Astrion Remote HA100 device
  • HACS (Home Assistant Community Store) installed

Step 1: Install RosCard via HACS

  1. Open Home Assistant → HACS
  2. Click Frontend → Explore & Download Cards
  3. Search for “RosCard”
  4. Click Download → Install
  5. Clear your browser cache (important!)

:light_bulb: RosCard Repository: https://github.com/yyqclhy/RosCard

Step 2: Configure Home Assistant User

Option A: Dedicated User (Recommended)

  1. Go to Settings → People → Add Person
  2. Create a new user (e.g., “Astrion Remote”)
  3. Assign a password
  4. Set permissions to Admin (required for full functionality)

Option B: Use Existing Admin User

You can use your existing admin account, but dedicated users are better for security and troubleshooting.

Step 3: Generate Long-Lived Access Token

  1. Click your user profile (bottom left)
  2. Scroll to Long-Lived Access Tokens
  3. Click Create Token
  4. Name it (e.g., “Astrion Remote”)
  5. Copy the token immediately — you won’t see it again!

Step 4: Connect Astrion Remote to Home Assistant

Method 1: QR Code (Easiest)

  1. On Astrion Remote, go to Settings → Add Device
  2. Scan the QR code shown in Home Assistant:
    • Go to Profile → Security → QR Code
  3. Enter your Home Assistant URL when prompted
  4. Connection complete!

Method 2: Manual Configuration

  1. On Astrion Remote: Settings → Add Device → Manual
  2. Enter:
    • URL: Your HA URL (e.g., https://your-domain.duckdns.org:8123)
    • Token: Paste your Long-Lived Access Token
    • Name: Give it a recognizable name
  3. Click Connect

Step 5: Add RosCard to Your Dashboard

  1. In Home Assistant, go to your Dashboard
  2. Click Edit (pencil icon)
  3. Click Add Card
  4. Search for “RosCard”
  5. Select the card type you want:

Available Card Types:

Card Purpose
AC(ROS) Climate Control Card
Cover(ROS) Cover Control Card
Fan(ROS) Fan Control Card
Light(ROS) Light Control Card
Media Player(ROS) Media Player Control Card
Scene(ROS) Scene & Script Card
Statistics(ROS) Monitor Card for Light、Switch、Climate
Switch(ROS) Switch Control Card
TV(ROS) TV Card
Weather(ROS) Weather Control Card
  1. Configure the card with your entities
  2. Click Save

:wrench: Configuration 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

:red_question_mark: Troubleshooting

“Connection Failed”

  • Check your HA URL (must be accessible from remote)
  • Verify token is correct (no extra spaces)
  • Ensure SSL certificate is valid (if using HTTPS)

“Card Not Loading”

  • Clear browser cache completely
  • Check HACS installation (RosCard should appear in Resources)
  • Try hard refresh: Ctrl+Shift+R (or Cmd+Shift+R on Mac)

“No Entities Showing”

  • Verify user has admin permissions
  • Check entity IDs are correct
  • Make sure entities exist in HA

:books: Next Steps

  • Explore all 9 RosCard types
  • Customize button mappings for your workflow
  • Join our community forum for tips and tricks
  • Check out advanced configuration guides

:sos_button: Need Help?

Welcome to the Astrion community! :tada:

This content was written by AI.

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