Help Needed: Implementing FYTA API Integration for Remote Control

Chimera · February 25, 2025, 6:24pm

Hi everyone,

I’m trying to implement the FYTA API integration for the Unfolded Circle remote control and would appreciate some guidance on how to get started.

I’ve been looking at the Home Assistant FYTA integration implementation to understand how they handle the API communication and data structures. However, I’m not quite sure how to translate this into a working integration for the remote control.

Some specific questions:

What would be the best approach to structure the integration?
How should we handle the API authentication and data polling?
Are there any specific patterns or practices I should follow for the remote control integration?

Has anyone here worked with the FYTA API before or built similar integrations for the remote control? Any tips or pointers would be greatly appreciated!

Thanks in advance for your help!

Chimera · February 25, 2025, 6:24pm

FYI the FYTA Home Assistent GitHub code: https://github.com/home-assistant/core/tree/dev/homeassistant/components/fyta

kennymc.c · February 25, 2025, 7:19pm

There is plenty information on Github from UC on how the integration api works and how to write an integration driver for the remote: GitHub - unfoldedcircle/core-api: API specifications for Remote Two by Unfolded Circle

github.com

unfoldedcircle/core-api/blob/main/doc/integration-driver/write-integration-driver.md

## How to write an integration driver

The Integration-API allows to develop external integration drivers in any programming language capable of running
a WebSockets server. Custom integration drivers require Node.js or a statically linked binary.

- `External integration driver`: a driver running on an external device, reachable by the Remote. 
- `Custom integration driver`: a driver running on the Remote in a restricted, sandboxed environment.

ℹ️ Beta release 1.9.0 allows to install custom integration drivers on the Remote.   
This is a developer preview feature to test integrations. See [Driver installation on the Remote](driver-installation.md)
for more information.

ℹ️ See [NodeJS API wrapper](https://github.com/unfoldedcircle/integration-node-library) for a quick start in JavaScript,
or the [Python API wrapper](https://github.com/unfoldedcircle/integration-python-library) if using Python.

When writing a driver from scratch without using a wrapper library:

1. Choose your programming language.
2. Choose a WebSockets server library or framework for your language.
3. Choose a JSON framework for your language.

This file has been truncated. show original

UC also has a list of existing integration with links to their GitHub repositories: Supported devices