# External integrations: access to a serial USB key (RFPlayer, Téléinfo, Zigbee...)

**URL:** <https://community.gladysassistant.com/t/integrations-externes-acces-a-une-cle-usb-serie-rfplayer-teleinfo-zigbee/11418>\
**Category:** Demande de fonctionnalités\
**Tags:** integration-externe\
**Created:** [October 25, 2026, 5:48pm UTC](https://community.gladysassistant.com/t/integrations-externes-acces-a-une-cle-usb-serie-rfplayer-teleinfo-zigbee/11418 "2026-10-25T17:48:44Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![prohand](https://gladys-assistant-community.b-cdn.net/user_avatar/community.gladysassistant.com/prohand/32/15713_2.png) [@prohand](https://community.gladysassistant.com/u/prohand)\
**Post date:** [October 25, 2026, 5:48pm UTC](https://community.gladysassistant.com/t/integrations-externes-acces-a-une-cle-usb-serie-rfplayer-teleinfo-zigbee/11418/1 "2026-10-25T17:48:44Z")

</div>

Hello everyone,

Following the closure of [GitHub issue #18](https://github.com/GladysAssistant/integration-store/issues/18) (« let’s discuss this on the forum »), I propose the feature here.

## The Need

External integrations run in an isolated container that does **not have access to USB serial ports**.

Today, the manifest allows requesting only these hardware classes: `coral-usb`, `coral-pcie`, `gpu`, `video`. And only for sub-containers (`containers[]`), not for the main integration container.

Result: impossible to directly read a serial USB key.

## Affected Integrations

I have developed two integrations that need this:

- [Téléinfo: Your Linky meter in Gladys with the LiXee TIC module](https://community.gladysassistant.com/t/integration-teleinfo-votre-compteur-linky-dans-gladys-avec-le-module-lixee-tic/11025)
- [RFPlayer (RFP1000, 433/868 MHz)](https://community.gladysassistant.com/t/integration-rfplayer/11061)

But the need is broader: Zigbee, Z-Wave, EnOcean keys, modems, etc.

## Current Solution (Not Ideal)

Going through **ser2net** (or socat) on the host machine, which exposes the serial port as TCP.

The problems:

- You have to install and configure ser2net manually via SSH → not suitable for Gladys users.
- It **opens an unauthenticated network port** on the local network.
- Another brick to maintain that can fail.

## What I Propose

Adding a **`serial`** class, which follows exactly the same rules as existing classes:

1. **Requested** in the manifest: `"devices": ["serial"]`, also for the main container.
2. **Authorized by the user** in the interface (switch during installation, removable at any time).
3. **Mounted only if present** on the machine.

A few additional ideas:

- **The user chooses the key** from a list of detected serial ports (only one device is mounted, not all `/dev`).
- Use the **stable path** `/dev/serial/by-id/...` so it still works after a reboot or USB port change.
- **Optional filter** in the manifest (USB vendor/product ID or a label) to only offer compatible keys.
- **Never a free `/dev` path** in the manifest, like for other classes.

## Open Questions

- What to do if **two integrations** (or a native integration like Zigbee2mqtt) want the same key?
- How to handle the key **unplugged and then replugged** on the fly?
- One serial port per integration, or multiple?

## Related GitHub Issues

- Gladys Core (device mounting): [External integrations: allow access to a USB serial device · Issue #3194 · GladysAssistant/Gladys · GitHub](https://github.com/GladysAssistant/Gladys/issues/3194)
- Integration store (manifest schema): [External integrations: allow access to a USB serial device · Issue #18 · GladysAssistant/integration-store · GitHub](https://github.com/GladysAssistant/integration-store/issues/18)
- JS SDK: [External integrations: allow access to a USB serial device · Issue #39 · GladysAssistant/integration-sdk-js · GitHub](https://github.com/GladysAssistant/integration-sdk-js/issues/39)

As soon as the class exists, I will update my two integrations to remove ser2net.

What do you think? If you’re interested, don’t hesitate to **vote** for this topic 🙂
