Catalog of features supported in MQTT

Hi everyone! :slightly_smiling_face:

I’m still looking for someone to take the lead on this!

No technical skills required, you just need to speak French and be willing to help. :smiley:

To make the work easier, I exported the list of the 193 features currently in Gladys: :link: Existing list of features

The goal is to create one row for each feature in the new catalog, with:

:white_check_mark: A clear name
:white_check_mark: A precise description
:white_check_mark: A consistent category

:link: New catalog to fill out

All of this will be used to feed this page:

A big thank you to everyone who can help out on this! :slightly_smiling_face:

Hi @pierre-gilles , so since I hadn’t understood anything about this topic (see my posts above), I’m happy to take the lead :rofl:
I’ll take care this weekend of completing the table with what you’ve already exported and I’ll remove what I added since it’s 1:1 and not an improvement for now.

1 Like

@pierre-gilles
table filled in with my comments :

  • green: what I changed to something that made more sense to me
  • orange: what needs to be checked because I have doubts or even no idea for some
  • an extra column for units but I don’t think I filled everything in
  • nothing is sorted alphabetically
  • some terms/functions don’t make any sense to me at all (relays? cube?)
  • for teleinformation, I was lazy and used a formula to do
1 Like

So cool, thanks for taking the topic! :+1:

The cube is the Xiaomi cube:

https://www.domadoo.fr/fr/bons-plans/4668-aqara-controleur-intelligent-magic-cube-zigbee-mfkzq01lm-0192784000045.html

For the relay, given the context, it’s a switch that you install in your electrical meter to control a specific circuit (hot water tank, etc…)

A few questions on my side

  • Why did you put all the TV-related categories in « Device »? Why not « Television »?
  • Why « Audio » and not « Music »?
  • The « Generic » category — I think we could find a better name?
  • The « Information » category likewise, couldn’t we group « Generic » and « Information »?

Hi @pierre-gilles,
I’ll see what sentence I can find to put for the cube but I must admit I’m a bit puzzled about what to put… And can we « remove » things from that list like the cube for example because apart from saying that this type represents the mode of a cube… personally I wouldn’t understand (and I already don’t understand :frowning: )

It’s always the same with me, I have trouble seeing only the pure specific :frowning:
And as I filled out the table, you can put all those commands for a television, but also for a VCR (watch out, Old School mode activated), an internet box, a Blu-Ray player, an A/V receiver, etc.
And all those commands are common so I tried « Device », but that might not be the right name and we can revert to « Television ».

Well, a bit like the previous point but for sound. You can have music but also a podcast, a radio, an audiobook, etc.

At first I went with « Mathematics » because it was for Surface, Volume, etc.
And then I thought we’d end up with a big bunch of categories, which I don’t find great right now.
So « Generic » is the closest, the name isn’t necessarily the best.

Yes, I think we can merge.

For Audio and Device, I don’t know if you prefer that we compact them or make more detailed categories: Television, Internet box, A/V receiver, DVD player, etc.
My idea is still to rationalize but I don’t know what that implies in the programming part later if there is grouping.

Or « Audiovisual device »? It’s the ‹ standard › term to refer to a television, a Blu-ray player, the player of a set-top box,…

1 Like

I like it, and at that point we can put Music back instead of Audio to better differentiate. I’ll modify the file.

I feel like you’re falling into a classic development trap: wanting to generalize too much.

If we follow your reasoning, @mutmut, we risk ending up with a category « Object » or « Thing » that would encompass everything and anything :laughing: (I’m exaggerating)

The goal is for the user to clearly understand what each category corresponds to.

Yes, the physical device may be an internet box or a Blu-Ray player, but in the end, the use remains the same: watching television.

Whether I watch TV via an Apple TV, a Bouygues box, or the TNT, it’s still… television!

Hard to find a clearer category than « Television » to describe this usage :smiley:

The point isn’t to have a perfect, absolute classification, but simply an intuitive and clear organization for the user :wink:

From a programming point of view, we can do whatever we want, there are no limits :wink:

that’s not wrong :sweat_smile:
We’ll use more specific titles then.

1 Like

Hi @mutmut :slight_smile:

I wanted to know where you were at on this?

Hi @pierre-gilles
I’ve just done another pass on the terms, I think it’s fine.
I left a column with the old section names; you’ll need to delete it if everything looks good to you.
Some descriptions need to be validated and as soon as that’s done we can remove the orange/red color.

I tested creating features in mqtt to see examples, and for Image, you need a min and a max to save… for an image there I didn’t understand but I’m still not sure I understand how some features work :confused:

Anyway, you can check and validate if it’s OK.

1 Like

Thanks @mutmut for your awesome work! :blush: It’s really great!

I’ve completed all the yellow/red lines and made a few corrections.

As for the categories, that’s well thought out! Some points seem a bit too generic to me, but we’ll see how that works in real situations.

It’s up to me now — I’ll keep you posted as soon as I get to it!

4 Likes

I have a small remark about line 190 for the « bed activity » of the vibration sensor.
I see that you restored the original description but I didn’t understand at all what a bed has to do with it and DeepL returned this to me:
![image|690x

No, it’s indeed used by a Xiaomi sensor that reports « bed_activity »:
Xiaomi DJT11LM

so chez moi j’ai un Aqara DJT11LM et nulle part ça parle de bed_activity et j’imagine que les 2 sont identiques :thinking:
J’ai effectivement trouvé ce bed_activity par ici mais je n’ai rien du tout dans mes Exposes sous Z2M.

J’ai trouvé une doc de 2016 qui dit :

1.Security Mode.
Monitor the door and window switch status.
2.Knock Mode.
Control other smart devices via wireless connection.
3.Bed Mode.
Monitor the person’s bed activity, to help determine user’s quality of sleep.

On a bien le bed mais aucune idée de comment faire fonctionner/basculer ce module dans un mode ou un autre, peut-être avec un hub Xiaomi ou Aqara.
En tout cas on ne trouve plus cette info dans le manuel actuel du capteur.

Finalement, toujours utile ?

Maybe not, indeed, and even less so in the MQTT view, you’re right :slight_smile:

Hello, is this still relevant? I recently integrated a hot water tank and I must admit it was really tedious to create (especially via the phone) all the features with dropdown lists: name, MQTT path, etc. :sweat_smile:
If there’s one thing to review in terms of UI/UX, it would be this, I’d say. :sweat_smile:
Thanks in advance for your feedback

It’s still planned in my medium-term roadmap :slightly_smiling_face:

I’ll keep you informed as soon as development starts on that front!

2 Likes