⚡ Reduxi Configurator · Bruksanvisning

MQTT v3-connector

Publicera aktuella enhets- och strategidata till din egen MQTT-broker och ta emot kommandon från den.

⏱ ca 10 minuter

📍 Settings → System → Connector → MQTT v3

👤 Installatör · integratör

← Molnanslutning ☰ Innehåll i bruksanvisningen Flex-connector →

📋 I den här artikeln

Översikt
Anslut till en broker
Parametrar
Topics
Felsökning
Checklista

→ Översikt

MQTT v3-connectorn ansluter controllern som klient till en MQTT-broker som du väljer, till exempel brokern i ett fastighetsautomationssystem, ett SCADA-system eller en plattform för hemautomation. Controllern publicerar sedan aktuella värden för alla enheter och strategier, elpriserna och ett keep-alive-meddelande, och den lyssnar efter kommandon som enhetsbörvärden, strategi på/av, External EMS-scheman och nätinställningar.

Connectorn är avstängd tills du anger en Host. Den är oberoende av anslutningen till Reduxi Cloud; båda kan köras samtidigt.

⛔

Brokern kan styra anläggningen

Alla som kan publicera till controllerns kommando-topics på din broker kan ändra enhetsbörvärden, stänga av strategier, ändra nätgränserna och starta om controllern. Använd en broker med användarautentisering, ge controllern ett eget konto och tillåt skrivåtkomst till controllers/<Unit ID>/…/set och controllers/<Unit ID>/commands/… bara för betrodda klienter.

1 Anslut till en broker

Öppna sidan

Klicka på Settings, System, Connector och sedan MQTT v3 i vänstermenyn.

Ange brokern

Skriv brokerns adress i Host och dess port i Port (1883 för vanlig MQTT, oftast 8883 för TLS).

Ange inloggningen

Om brokern kräver inloggning fyller du i Username och Password.

Ställ in kryptering (valfritt)

Ställ in Use SSL på Yes för en TLS-anslutning. Ladda upp brokerns CA-certifikat i Server CA chain (PEM format) och ställ in Verify server cert på Yes. För certifikatinloggning laddar du också upp Client public certificate (PEM format) och Client private key (PEM format).

Lägg till fasta topics (valfritt)

Under Additional topics klickar du på Add och anger ett Name or path och en Payload för varje extra topic som controllern ska publicera.

Ställ in avläsningsintervallet

Ange hur ofta aktuella värden publiceras i Readout interval, i sekunder. Lämna tomt för 60 s.

Spara

Klicka på Save. Connectorn startas om med de nya inställningarna.

Kontrollera anslutningen

Klicka på uppdateringsikonen på raden Connected. En grön bock betyder att controllern är ansluten till brokern.

Sidan MQTT v3 med statusraderna Client (Unit ID), Host och Connected; kortet Mqtt connection med Host, Port 1883, Username, Password, Use SSL och Verify server cert inställt på No, tre PEM-filväljare, ett tomt kort Additional topics med en knapp Add, fältet Readout interval i sekunder samt knapparna Clear connection configuration och Save

Settings → System → Connector → MQTT v3 med statustabellen, formuläret Mqtt connection, Additional topics och Readout interval

2 Parametrar

Status

Parameter	Vad den gör	Enhet / standard
Client	MQTT-klient-ID som controllern använder. Det är controllerns Unit ID och det ingår också i varje topic: `controllers/<Unit ID>/…`. Skrivskyddad.	text
Host	Brokern som den sparade konfigurationen pekar på. Tomt = connectorn är av. Skrivskyddad.	text
Connected	Grön bock = ansluten till brokern; rött kryss = inte ansluten. Skrivskyddad.	—
Uppdateringsikon	Läser av statusen igen.	—

Mqtt connection

Parameter	Vad den gör	Enhet / standard
Host	Värdnamn eller IP-adress för brokern. Lämna tomt för att stänga av connectorn.	text · tomt = av
Port	Brokerns TCP-port.	tal · standard 1883
Username	Användarnamn på brokern. Valfritt.	text
Password	Lösenord på brokern. Används bara tillsammans med Username. Fältet visar lösenordet i klartext.	text
Use SSL	Yes öppnar anslutningen med TLS-kryptering. Om du aldrig har ställt in det slås det på automatiskt när en server-CA-kedja eller ett klientcertifikat har lagrats.	Yes / No · standard No
Verify server cert	Yes kontrollerar brokerns certifikat mot Server CA chain (eller mot controllerns inbyggda betrodda certifikatutfärdare om ingen kedja har laddats upp). No godtar vilket certifikat som helst: anslutningen är krypterad, men controllern kontrollerar inte vem den kommunicerar med. Används bara med Use SSL = Yes.	Yes / No · standard No
Server CA chain (PEM format)	Certifikat (kedja) för den certifikatutfärdare som signerade brokerns certifikat. Klicka på Choose File och välj en PEM-fil. När den är lagrad visar fältet i stället en knapp Download.	PEM-fil
Client public certificate (PEM format)	Controllerns eget klientcertifikat, för brokers som autentiserar klienter med certifikat (ömsesidig TLS). Kräver den matchande privata nyckeln.	PEM-fil
Client private key (PEM format)	Den privata nyckeln för klientcertifikatet.	PEM-fil

⚠️

Certifikat och nycklar är hemligheter

Klientens privata nyckel och brokerns lösenord ger åtkomst till din broker. Förvara filerna på ett säkert ställe, skicka dem inte med e-post och lämna inga kopior på delade datorer. Alla som har åtkomst till den här sidan i Configurator kan ladda ned de lagrade certifikaten och se lösenordet.

💡

Byta ut ett certifikat

Ett lagrat certifikat visar bara en knapp Download. För att ladda upp ett annat klickar du på Clear connection configuration och anger sedan hela anslutningen på nytt med de nya filerna.

Additional topics

Parameter	Vad den gör	Enhet / standard
Name or path	Topic som ska publiceras, relativt `controllers/<Unit ID>/`. Till exempel publiceras `site/name` som `controllers/<Unit ID>/site/name`. Rader med tomt namn hoppas över.	text
Payload	Fast text som publiceras på den topicen.	text
Add	Lägger till en tom rad.	—
Papperskorgsikon	Tar bort raden. Träder i kraft efter Save.	—

Additional topics publiceras tillsammans med controllerns metadata: varje gång connectorn ansluter till brokern och varje gång brokern skickar commands/refresh.

Sidan MQTT v3 efter ett klick på Add under Additional topics: en rad med fälten Name or path och Payload samt en papperskorgsikon

Kortet Additional topics med en tom rad: Name or path, Payload och en papperskorgsikon

Publicering och knappar

Parameter	Vad den gör	Enhet / standard
Readout interval	Hur ofta controllern publicerar avläsningen och börvärdet för varje enhet samt avläsningen, tillståndet och parametervärdena för varje strategi. Lägre värden ger färskare data men mer trafik.	s · tomt = 60 s · minst 0.25 s
Spara	Lagrar inställningarna och startar om connectorn. Registreras i Audit log som `CONNECTOR_EDIT`.	—
Clear connection configuration	Efter bekräftelsen Are you sure to clear MQTT settings? (Yes / Cancel) raderas host, port, användarnamn, lösenord, SSL-inställningarna och alla certifikat. Connectorn stängs av. Readout interval och Additional topics behålls.	—

⚠️

Rensning stoppar all MQTT-trafik

Efter Clear connection configuration publicerar controllern inte längre data och tar inte emot kommandon via MQTT. Ett system som är beroende av data, eller som skickar External EMS-scheman, slutar ta emot eller leverera dem. Du måste ange lösenordet på nytt och ladda upp certifikaten igen för att ansluta på nytt.

3 Topics

Alla topics börjar med controllers/<Unit ID>/. Controllern publicerar med QoS 0 och utan retain-flaggan, och prenumererar på kommando-topics med QoS 1. Payloads är JSON eller enkla värden; de fullständiga payload-formaten finns i artikeln "Reduxi Controller - MQTT API" i supportcentret.

Publiceras av controllern:

Topic	Innehåll	När
`identifier`	Controllerns identifiering (Unit ID, versioner, …)	Vid anslutning och vid `commands/refresh`
`settings/interval/readout`, `settings/interval/keepAlive`	Aktuella intervall i ms	Vid anslutning och vid refresh
`devices/list`, `devices/types`, `devices/<id>/info`	Konfigurerade enheter och deras typer	Vid anslutning och vid refresh
`strategies/list`, `strategies/types`, `strategies/<id>/info`, `strategies/<id>/parameters/list`, `strategies/<id>/parameters/<id>/info`	Konfigurerade strategier och deras parametrar	Vid anslutning och vid refresh
`<additional topic>`	Payload från Additional topics	Vid anslutning och vid refresh
`devices/<id>/readout`	Aktuella värden för en enhet	Varje avläsningsintervall
`devices/<id>/setpoint`	Aktuellt börvärde för en enhet	Varje avläsningsintervall
`strategies/<id>/active`, `strategies/<id>/readout`, `strategies/<id>/parameters/<id>/value`	Strategi på/av, aktuella värden, parametervärden	Varje avläsningsintervall
`prices`	Elpriser för i dag och i morgon	Vid anslutning, när priserna ändras, vid `prices/refresh`
`strategies/<id>/externalEMS/<type>`	Lagrat External EMS-schema (`battery`, `evse`, `hvac`, `pv`)	Vid `…/externalEMS/<type>/refresh`
`keepAlive`	Aktuell tid (Unix ms)	Varje keep-alive-intervall, standard 60 s

Kommandon som controllern tar emot:

Topic	Effekt
`commands/refresh`	Publicerar metadata-topics igen.
`commands/reboot`	Startar om controllern ungefär 5 s senare.
`prices/refresh`	Publicerar `prices` igen.
`settings/interval/readout/set`	Ändrar avläsningsintervallet (ms) och lagrar det.
`settings/interval/keepAlive/set`	Ändrar keep-alive-intervallet (ms) och lagrar det.
`devices/<id>/setpoint/set`	Ställer in ett börvärde för en enhet.
`strategies/<id>/parameters/<id>/value/set`	Ställer in en strategiparameter.
`strategies/<id>/active/set`	Slår på eller av en strategi.
`strategies/<id>/externalEMS/<type>/set`	Läser in ett External EMS-schema för `battery`, `evse`, `hvac` eller `pv`. Ignoreras om inte strategin har optimeringsläget External EMS.
`strategies/<id>/externalEMS/<type>/refresh`	Publicerar det lagrade External EMS-schemat.
`settings/grid/set`	Ändrar nätinställningarna (plats, säkringar, gräns för import och export), på begäran även i valda strategier.

⚠️

Kommandon skriver över lokala inställningar

settings/grid/set skriver över värdena under Settings → Grid och, om det begärs, strategiernas gränser – samma effekt som att spara sidan Grid. devices/<id>/setpoint/set skriver börvärdet direkt till enheten. Skicka inte börvärden för en enhet som även styrs av en strategi, annars skriver de två över varandra.

4 Felsökning

Symptom	Vad du ska kontrollera
Connected förblir rött	Host och Port är rätt; controllern kan nå brokern (TCP port test mot brokerns host och port); användarnamn och lösenord; vid TLS: CA-kedjan matchar brokerns certifikat, eller prova Verify server cert = No för att avgränsa problemet.
Ansluten, men inga data på brokern	Prenumerera på `controllers/#` och kontrollera värdet Client: topics använder Unit ID exakt som det visas där.
Kommandon har ingen effekt	Klienten som skickar dem har publiceringsrättigheter på brokern; topicen använder rätt enhets- eller strategi-ID (se `devices/list`, `strategies/list`).

5 Checklista

Host och Port stämmer med brokern, och Connected visar en grön bock efter en uppdatering.
På produktionsanläggningar: Use SSL = Yes, CA-kedjan är uppladdad och Verify server cert = Yes.
Data kommer in under controllers/<Unit ID>/ med det inställda Readout interval.
Skrivåtkomsten till kommando-topics är begränsad till betrodda klienter på brokern.
Certifikatfiler och lösenord förvaras säkert utanför controllern.