документацију

МКТТ области примене

МКТТ је интернет протокол са централним брокером порука. Са овим брокером порука, учесници се могу претплатити на одређене "теме" и слати поруке о темама. цФос Цхаргинг Манагер може да слуша поруке о одређеним темама и стога се може контролисати преко МКТТ-а. Такође може да преноси статус уређаја којима управља. цФос Повер Браин Валлбок се такође може контролисати преко МКТТ-а и преносити његов статус. Ово је корисно када се повезујете на систем кућне аутоматизације, за индустријску контролу (М2М) и за праћење и снимање. Све теме почињу са cfos_mqtt. Ако желите да повежете неколико цФос МКТТ уређаја са МКТТ брокером, тема може опционо да почне са cfos_mqtt_<Seriennummer>/, подесив у конфигурацији. У конфигурацији такође можете одредити УРЛ за стандардног МКТТ брокера. УРЛ-ови могу опционо да почињу са mqtt:// и mqtts://. Са mqtts:// цФос Цхаргинг Манагер или цФос Повер Браин Валлбок успоставља ТЛС везу. Користе се стандардни портови 1883 за нешифроване везе и 8883 за ТЛС везе. Међутим, такође можете да наведете порт у УРЛ-у. Можете унети корисничко име и лозинку у уобичајеној УРЛ нотацији, нпр mqtt://user:password@192.168.2.111. Ако наведете МКТТ брокера у конфигурацији цФос Цхаргинг Манагер-а, можете или навести појединачног брокера или једноставно написати mqtt. Тада се користи подразумевани брокер сачуван у конфигурацији.

цФос Цхаргинг Манагер подржава и МКТТ 3.1.1 и МКТТ 5. Ако УРЛ започнете са мктт3:// или мктт5:// (мкттс3:// и мкттс5:// за шифровану везу), ви одређујете верзију протокола. Подразумевано је МКТТ 3.1.1. Са МКТТ 5, цФос Цхаргинг Манагер покушава да се врати на МКТТ 3.1.1 ако постоји одговарајућа порука о грешци. Ово функционише са старијим брокерима Москуитто, али не нужно и са другим брокерима.

Напомена: Пошто је за подешавање МКТТ-а потребна администраторска лозинка, менаџер наплате обрађује податке у складу са тим. Дакле, намерно се шаљу подаци којима се може приступити само са администраторском лозинком.

Напомена о МКТТ брокерима: Захваљујући Стефану Г. (#диебестенусердервелт) били смо у могућности да тестирамо против МКТТ брокера уграђеног у иоБрокер. Овај брокер МКТТ 3.1.1 (од фебруара 2023.) се не понаша у складу са стандардом у неколико аспеката: покушаји повезивања се тихо прекидају без поруке о грешци, корисно оптерећење понекад недостаје у ПУБЛИСХ пакетима, ПУБЛИСХ пакети се очигледно шаљу два пута (да ли се то може урадити са искљученим подешавањем?). Стога овај брокер није погодан за контролу АПИ-ја Цхаргинг Манагер-а, пошто се АПИ захтеви могу извршити више пута. Иако смо заинтересовани да наша МКТТ имплементација буде компатибилна са што је могуће више брокера, тренутно препоручујемо да користите Москуитто за иоБрокер.

Интеграција бројила и зидних кутија помоћу уређаја типа "ХТТП Инпут".

Уместо да снабдевају ове уређаје преко ХТТП-а (погледајте ХТТП АПИ -> ХТТП бројачи и зидне кутије), ови уређаји такође могу да слушају МКТТ. Унесите mqtt или УРЛ брокера МКТТ као адресу уређаја. Одговарајући мерач или валлбок затим слуша тему cfos_mqtt/set/<Geräte-ID>, на пример за мерач са ИД-ом уређаја М1 до cfos_mqtt/set/M1. ХТТП бројач уноса тада очекује ЈСОН стринг као поруку, као што је описано у ХТТП АПИ-ју под „ХТТП бројачи и зидне кутије“. Ваш МКТТ извор стога мора испоручити податке у овом формату. Можете интегрисати уређаје које цФос Цхаргинг Манагер не подржава тако што ћете добити податке из другог извора (нпр. систем кућне аутоматизације) и затим их увести у Цхаргинг Манагер.
Напомена: Ако су изворни подаци у формату другачијем од онога што ХТТП бројач очекује, можете креирати и прилагођени бројач. За МКТТ ово је описано у наставку.

Пример:
Направили сте ХТТП улазни бројач и он има М3 као ИД уређаја. Као адресу навели сте адресу Москуитто Брокера, нпр. мктт://. Ако унесете следећу команду у командну линију на рачунару на којем ради Москуитто:
mosquitto_pub -h localhost -t cfos_mqtt/set/M3 -m '{ "model": "TestModell", "import_wh": 12345, "export_wh": 23456, "voltage": [231, 232, 233], "current": [10001, 10002, 10003] }'
бројач тада треба да садржи горе наведене вредности.

Пренесите статус уређаја Цхаргинг Манагер

У конфигурацији Цхаргинг Манагер-а, можете навести УРЛ МКТТ брокера (или мктт за стандардног брокера), под којим Менаџер наплате затим објављује статус свих уређаја под темом cfos_mqtt/get/dev_info. То преноси у формату познатом из ХТТП гет_дев_инфо. Ово вам даје све вредности уређаја онако како су видљиве у корисничком интерфејсу, на пример, перформансе мерача или статус зидних кутија. Ако желите да се претплатите само на појединачне уређаје, можете да деактивирате поље за потврду „Објави информације о МКТТ“ и уместо тога означите опцију „Објави информације о МКТТ“ у подешавањима за појединачне уређаје под „Приказ“. Одговарајући ЈСОН стринг за одговарајући уређај се затим објављује под темом цфос_мктт/гет/<ИД уређаја>. Такође можете да се претплатите на све глобалне вредности под темом cfos_mqtt/get/params, пошто се оне излазе у формату познатом као ХТТП гет_дев_инфо под "парамс".

Контролишите цФос Цхаргинг Манагер АПИ преко МКТТ-а

У конфигурацији цФос Цхаргинг Манагер-а можете навести УРЛ МКТТ брокера (или мктт за стандардног брокера) под „Брокер за приступ АПИ-ју преко МКТТ-а“. Ако ова вредност није празна, цФос Цхаргинг Манагер се пријављује на све теме које почињу са цфос_мктт/апи/ . Затим тумачи поруке под таквом темом као да је назив теме ХТТП УРЛ који се завршава са /цнф? покреће и прослеђује ХТТП АПИ-ју. Управљач наплатом затим објављује ХТТП АПИ одговор као ЈСОН под темом цфос_мктт/апи_рес. Имате скоро цео ХТТП АПИ под својом контролом преко МКТТ-а. Изузеци су АПИ позиви који враћају дугачке ЈСОН одговоре. Пример: cfos_mqtt/api/cmd=set_cm_vars&name=x&val=1 користи АПИ функцију сет_цм_вар да постави променљиву Цхаргинг Манагер к на 1. Постоји порука под cfos_mqtt/api/cmd=enter_rfid&rfid=5678&dev_id=E1 Унесите РФИД 5678 за Валлбок са ИД-ом уређаја Е1 (погледајте и наше проширене РФИД функције).
Податке који се преносе путем ХТТП ПОСТ-а можете ставити у поруку испод теме.

Пример: Периодично мењање максималне укупне струје која је доступна менаџеру пуњења:
Унесите свог брокера под општим подешавањима Цхаргинг Манагер-а под „Брокер за приступ АПИ-ју преко МКТТ-а“ (или једноставно мктт ако ће се користити подразумевани брокер сачуван под „Конфигурација“). Затим објавите на тему користећи МКТТ
цфос_мктт/апи/цмд=сет_парамс
ЈСОН објекат са следећим садржајем:
{"мак_тотал_цур_прц": п}
где је п проценат унапред подешене максималне укупне струје коју треба узети.
Напомена: Неки од ХТТП АПИ позива доводе до тога да Менаџер за пуњење чува конфигурацију. Ако их користите пречесто, блиц (у цФос Повер Браин или цФос Валлбок Боостер) или СД картица у Распберри-у ће се истрошити. АПИ позив "сет_парамс" са појединачним параметром "мак_тотал_цур_прц" стога не води до чувања параметара.

Контролишите зидне кутије преко МКТТ-а

Ако цФос Цхаргинг Манагер није у режиму „Управљање оптерећењем“, већ у режиму „Обсерве“, можете користити МКТТ да сами контролишете све зидне кутије. Ово се посебно односи на цФос Повер Браин Валлбок уређаје који раде као славе у режиму „Обсерватион“. Да бисте то урадили, морате да означите опцију „Активирај контролу зидне кутије“ у подешавањима Цхаргинг Манагер-а под МКТТ. Затим цФос Цхаргинг Манагер слуша МКТТ тему cfos_mqtt/ctl и очекује поруке са ЈСОН објектом. Овај објекат има под-објекте са ИД-ом уређаја као именом као својства. Под-објекти изгледају овако: {"цур": ц, "ена": б, "вке": б}, где је ц струја пуњења у мА, а свако б може бити тачно или нетачно. "ена": фалсе деактивира пуњење на валлбок-у, "вке": труе покушава да пошаље команду за "аутоматско буђење" на валлбок (тренутно је могуће само са цФос Повер Браин валлбок-овима). Такође можете изоставити "цур", "ена" и "вке" и обављати само одређене контролне функције. Пример:
{"E1":
{cur: 8000, ena: true, wke: true},
"E2":
{cur: 10000}}

Поставља струју пуњења зидне кутије са ИД уређаја на 8А, активира пуњење и покушава да пробуди аутомобил. Штавише, струја пуњења за Валлбок Е2 је подешена на 10А.

Пошаљите евиденцију и евиденцију трансакција преко МКТТ-а

Можете да наведете УРЛ МКТТ брокера за пренос уноса дневника у системски дневник под „Конфигурација“. Затим цФос Цхаргинг Манагер објављује све уносе дневника под темом cfos_mqtt/log. Ово вам омогућава да даљински процените евиденцију да бисте надгледали Цхаргинг Манагер. Такође можете навести УРЛ МКТТ брокера за уносе у евиденцији трансакција под „Конфигурација“. Затим се све трансакције учитавања шаљу под темом cfos_mqtt/ta_log. Ово омогућава даљинско процену података о обрачуну трансакција наплате и прављење резервних копија трансакција наплате на другом систему. Трансакција пуњења почиње када је конектор за пуњење прикључен и завршава се када је искључен.

Прилагођени бројачи са МКТТ

Можете креирати прилагођене бројаче користећи ртипе=2 за МКТТ. Ови бројачи су дефинисани слично ХТТП бројачима (ртипе = 1). Међутим, адресе овде нису ХТТП УРЛ-ови, већ МКТТ теме. Пример:
"power_w": {
"address": "/test_topic3",
"type": "float",
"query": "power_w"
}

Овде се кориснички дефинисани бројач пријављује на тему /тест_топиц3 и очекује ЈСОН објекат са својством "повер_в", односно {"повер_в": 1234}. Различите променљиве бројача могу имати различите теме и биће ажуриране чим се порука објави у оквиру одговарајуће теме.