Прилагођени бројачи

Напомена: цФос Цхаргинг Манагер може да очита већину соларних претварача користећи СунСпец (тип уређаја „СунСпец Солар Инвертер / Метер“). У овом случају не морате да креирате сопствену дефиницију бројача.

цФос Цхаргинг Манагер вам омогућава да креирате сопствене дефиниције бројила како бисте подржали бројила која нису у стандардном репертоару. Тренутно постоје три типа: Модбус бројачи, ХТТП/ЈСОН бројачи и МКТТ/ЈСОН бројачи. Датотеке дефиниција за ове бројаче су веома сличне. Модбус бројила читају своје податке из одређених регистара преко Модбус-а, док ХТТП/ЈСОН бројила преузимају своје податке путем ХТТП захтева и читају ЈСОН као одговор. За МКТТ/ЈСОН мераче, цФос Цхаргинг Манагер се претплаћује на МКТТ теме и чита поруке објављене у оквиру теме као ЈСОН. цФос Цхаргинг Манагер користи мали „језик упита“ да га прочита. Овде је документација о МКТТ могућностима у цФос Цхаргинг Манагер-у.

Поред низа унапред дефинисаних варијабли као што су струја и напон, кориснички дефинисани бројила могу такође да читају непознате, кориснички дефинисане варијабле, уносе упита и излазе. Читање променљивих и подешавање излаза омогућава процену формула. Ово је моћна карактеристика у комбинацији са варијаблама Цхаргинг Манагера и глобалним излазима Цхаргинг Манагера описаним у наставку и чак омогућава одређене задатке кућне аутоматизације и контролу спољних уређаја као што је складиштење батерија. Ако ово користите за имплементацију контролних задатака, пошаљите нам повратне информације. Веома смо заинтересовани за оно што наши купци контролишу са цФос Цхаргинг Манагер-ом и то нам помаже да даље развијамо Цхаргинг Манагер у складу са потребама купаца.

Ево једноставног примера Модбус дефиниције која чита један регистар активне снаге. Можете једноставно да промените регистарски број за вашу конкретну апликацију:
Пример дефиниције за један регистар.

Ево примера дефиниције за Модбус и једне за ХТТП/ЈСОН:
Преузмите пример дефиниције за Модбус мерач
Преузмите пример дефиниције за ХТТП/ЈСОН бројач

Неколико таквих датотека је већ укључено у Цхаргинг Манагер, али можете да отпремите и избришете сопствене датотеке под „Конфигурација система“.
Овде ћете наћи велики део дефиниција бројача које пружамо:
Преузмите приложене дефиниције бројила

Ако сте креирали сопствену датотеку бројача и ово би могло бити релевантно за друге кориснике, били бисмо вам веома захвални ако бисте нам је учинили доступним. Затим их испоручујемо са будућим верзијама Цхаргинг Манагера.

Структура датотеке дефиниције:

Дефиниције бројача су ЈСОН датотеке са глобалним ЈСОН објектом који има својства и под-објекте. 'ртипе' одређује тип операције читања: 0 = Модбус, 1 = ХТТП/ЈСОН, 2 = МКТТ/ЈСОН. 'мтипе' одређује тип уређаја: 0 = Други уређај, 1 = Мерач, 2 = Инвертер, 4 = Складиштење батерије.

Можете навести бројеве у децималном или хексадецималном облику са префиксом '0к'. Коментари у једном реду који користе '//' су такође дозвољени. Препоручујемо да своје датотеке дефиниције покренете преко ЈСОН5 валидатора, нпр

Обавезно прочитајте поглавље Формуле да бисте разумели које вредности се могу користити у формулама у следећој референци.

Модбус дефиниције имају 'рту' објекат са следећим својствима:

силенце_период, у мсец: Одређује дужину паузе пре приступа Модбус РТУ тако да уређај препозна почетак поруке.
силенце_саме_славе, истина: Пауза се одржава чак и ако постоји више приступа истом уређају.
поновни покушаји: Број покушаја ако уређај не реагује.
рцв_тимеоут: у мс: Максимално време чекања док уређај не одговори, по приступу.

Ова глобална својства се примењују на Модбус ТЦП и РТУ:

модбус_реад: Број функције Модбус команде за читање, обично 3 или 4.
модбус_реад_мак_регистерс: Максималан број регистара који се могу прочитати у једном потезу.
модбус_аллов_гапс: труе = неискоришћене области регистра могу бити прочитане у операцији читања.

За Модбус ТЦП и ХТТП/ЈСОН постоји објекат 'тцп' са следећим својствима:

цоннецт_тимеоут: је мсец: Максимално време чекања за ТЦП везу.
делаи_афтер_цоннецт: у мсец: Пауза након успостављања везе пре слања прве команде.

Оба типа дефиниција (Модбус и ХТТП/ЈСОН) такође имају следећа својства:

upd_delay: у ms: Одређује интервал у којем се уређај може читати. Неки уређаји постају преоптерећени ако се пречесто испитују.
произвођач: Стринг, назив произвођача. Ово ће бити приказано у проширеним информацијама плочице.
delay_accumulated: true = Акумулиране вредности (kWh) се испитују само сваке 3 секунде или када је снага довољна. false = Ове вредности се увек испитују.
ui_addr: URL, ако се разликује од адресе уређаја, за позивање веб интерфејса.
резервисано: Низ са вредностима које се интерпретирају као 0 (корисно ако уређај подржава одређене вредности у зависности од модела).

Ако изоставите горе наведена својства, cFos Charging Manager користи подразумеване вредности које добро функционишу у већини случајева.

Следећа у JSON дефиницији је дефиниција променљивих које бројило користи за очитавање или израчунавање вредности струје, напона итд. Менаџер пуњења препознаје следеће променљиве:
ознака_типа, верзија, верзија_фирмвера, серијски број: Ови подаци чине ознаку модела, као што је приказано у проширеним информацијама плочице. Захтевају се једном приликом подешавања или ресетовања бројача.
voltage_l1..voltage_l3, current_l1..current_l3, power_w, power_var, power_va, power_w_l1..power_w_l3: cFos Charging Manager покушава да израчуна предвиђене вредности за voltage_l1..l3, current_l1..l3, power_w и power_va из ових променљивих. Не морате да наводите променљиве. cFos Charging Manager покушава да израчуна вредности из постојећих променљивих.
import_wh, export_wh: Менаџер пуњења користи ове променљиве да би назначио import_wh и export_wh. За једносмерна бројила (нпр. инверторе), увек треба дефинисати само import_wh. Export_wh треба дефинисати само за двосмерна бројила (као што су бројила за складиштење или бројила из мреже).

soc: Ако је доступно, стање напуњености батеријске јединице се приказује у % на плочици.
Поред тога, можете дефинисати додатне променљиве са различитим називима које се читају са сваким ажурирањем или израчунавају помоћу формула. Ако дефинишете променљиве које почињу са „CM.“, нпр. CM._set_price, додељене вредности се чувају у глобалним променљивим Менаџера наплате (видети доле) и могу се сходно томе испитивати.
Променљиве са *: Ако дефинишете променљиве које почињу са '*', оне ће бити приказане у корисничком интерфејсу у плочици мерача под проширеним информацијама, нпр. температура батеријског складишта.
Напомена: Само бројеви и слова аз и АЗ могу се користити као имена променљивих.

Дефиниција променљиве:

Објекат је назван по имену горе наведене променљиве и има следећа својства:
фикед: Стринг са фиксном вредношћу. Корисно ако се, на пример, не може одредити вредност, нпр. за типе_десигнатион или напон.
израз: Стринг. Променљива се не чита, већ се вреднује као формула.
типе: Ако није фиксно или експр, тип променљиве: инт16, уинт16, инт32, уинт32, флоат, инт64, стринг Ово је важно за Модбус да чита регистре у исправном формату. уинт16 и уинт32 су типови који могу прихватити само позитивне бројеве. Са ЈСОН/ХТТП обично можете користити флоат.
резолуција: флоат. Прочитана вредност се множи са 'резолуцијом'. Вредности напона морају бити у волтима, струје у милиамперима, снага у ватима, а енергија у ват-часовима (Вх). Са негативном 'резолуцијом' можете инвертовати вредност ако има супротан предзнак.
једном: боол (тачно или нетачно). Ако је тачно, вредност се чита само једном када се уређај иницијализује, у супротном периодично.
адреса: број (Модбус) или стринг (ХТТП/ЈСОН). Број Модбус регистра или ХТТП УРЛ вредности за читање.
куери: Стринг. За ХТТП ЈСОН, информације на језику упита менаџера наплате помоћу којих проналази вредност коју треба прочитати у ЈСОН одговору.
ред: Стринг. За Модбус, редослед бајтова, или "хл" или "лх", у којем је вредност доступна. дужина: број. Код Модбус-а, дужина стринга у регистрима, са променљивим 'версион' и 'фирмваре_версион' 'ленгтх' се користи за претварање нумеричких верзија у низове са тачкама. Вредности од 2 или 4 су дозвољене за 'дужину', што онда резултира форматима верзије аб и абцд. За 'дужину' 2 и откуцајте 'инт16' или 'уинт16', Менаџер пуњења раздваја ниски и високи бајт тачком, за 'инт32' или 'уинт32' ниску и високу реч, за 'инт64' ниску и високу реч. Са 'лентх' 4 и 'инт32' или 'уинт32', Цхаргинг Манагер разбија вредност на 4 бајта одвојена тачкама. За 'инт64' одговарају 4 речи.
регек: Стринг. Ако је наведен регуларни израз, одговор бројача не мора да буде у ЈСОН-у. Као резултат, процењује се или цело подударање регуларног израза или прва група. Користите само ако уређај не враћа ЈСОН. Ево листе карактеристика наших регуларних израза:
било који знак: .
именоване класе: \д \с \в \Д \С \В
анонимне класе: [а-з0-9_], [^0-9], [^\д]
групе са алтернативама: (аб|цд|еф)
неухваћене групе: (?:аб|цд)
(похлепан) једном или ништа: а?, а??
(похлепан) много или ништа: а*, а*?
(похлепан) једном или више пута: а+, а+?
почетак низа: ^
крај низа: $

Дефиниција улаза:

Цхаргинг Манагер може да затражи до 32 улазне вредности из различитих регистара или ЈСОН елемената по уређају. Својство Инпутс је ЈСОН низ. Морате дефинисати следећа својства за сваки улаз:
адреса: Адреса (Модбус регистар или УРЛ).
цоунт: Број улазних битова који се читају са овим захтевом.
куери: За ХТТП/ЈСОН, језик упита за проналажење вредности у одговору.

Са сваким ажурирањем, цФос Цхаргинг Манагер чита све улазе дефинисане на овај начин и интерно поставља битове у низ који се затим може тражити у формулама, Инпут1..ИнпутН.

Дефиниција излаза:

Цхаргинг Манагер може пребацити до 32 излаза по уређају. Излази су дефинисани у "излазима" као ЈСОН низ излазних објеката. Сви излази се пребацују на крају сваког циклуса ажурирања ако се статус одговарајућег излаза променио.
За сваки излаз морате дефинисати следећа својства у излазном објекту:
адреса: ХТТП УРЛ са опционим ХТТП методом, нпр. ГЕТ хттп//}. Да бисте подесили Модбус регистре, можете користити ХТТП АПИ цФос Цхаргинг Манагер. Менаџер наплате открива одговарајуће приступе локалном хосту и преусмерава захтев интерном руковаоцу, тако да вам није потребна ауторизација као код екстерних ХТТП АПИ приступа. Ако је УРЛ празан након свих замена, излаз није подешен. На пример, можете мењати излазе само ако постоје одређене променљиве (погледајте формуле: функција постоји()). Такође можете да наведете ${аддресс} и ${ид} у адреси. Ово је тренутна адреса уређаја и Модбус ИД као што је подешено у подешавањима. 'аддресс' и 'ид' се првенствено користе за коришћење Модбус АПИ-ја (погледајте доле).
тело: Опционо ХТТП тело за ПОСТ или ПУТ.
У УРЛ-у и телу можете да користите формуле ${екпр} које упућују на глобалне променљиве Цхаргинг Манагера или одговарајући мерач. Формула 'екпр' се процењује приликом подешавања излаза и замењује се у тексту УРЛ-а или тела. У горњем примеру, ако хттп://ввв.екампле.цом?оутпут1=1 поставља излаз, а хттп://ввв.екампле.цом?оутпут1=0 га брише, можете дефинисати променљиву 'вар1' и подесити је на 1 по жељи или поставите 0. Такође можете да упишете нумеричке вредности за контролу перформанси меморије у Модбус регистре које сте претходно ускладиштили у променљивој користећи формулу.
Ако, уместо да прослеђујете нумеричку вредност, морате да замените један текст у УРЛ-у другим у зависности од формуле, као што су Схелли ВЛАН утичнице, можете то написати овако: ${иф екпр`тект1`тект2}. "Апостроф" је позадинска ознака (АСЦИИ код 96). Ако је 'екпр' != 0, користи се текст1, у супротном текст2. За Схелли ВЛАН утичницу, УРЛ изгледа овако: хттп://<ип-аддр>/релаи/0?турн=${иф екпр`он`офф}, тј. ако је екпр != 0, Цхаргинг Манагер позива онда хттп ://<ип-аддр>/релаи/0?турн=он он, иначе хттп://<ип-аддр>/релаи/0?турн=офф.

Ако унесете релативну путању као УРЛ, Цхаргинг Манагер узима адресу конфигурисану за одговарајући уређај. Ако наведете 'лоцалхост' као домен, Менаџер за пуњење узима адресу уређаја на којем је покренут. Ако детектује приступ сопственом АПИ-ју, користи интерни руковалац уместо да изврши потпуни ХТТП приступ, тако да не морате да чувате корисничко име и лозинку у дефиницији бројача. УРЛ адреса која почиње са „*“ доводи до тога да Управитељ наплате увек обавља потпуни ХТТП приступ.

Ресетујте излазе: Поред низа "излази", можете дефинисати и низ под називом "ресетовање" структуриран као низ "излази". Ово омогућава да се излази ресетују на њихове почетне вредности када је уређај деактивиран. Ово, у комбинацији са кориснички дефинисаним варијаблама и "једном": тачно, омогућава вам да вратите уређај у почетно стање.
Повремено уписивати излазе: На неким уређајима излази се морају периодично писати, у супротном уређај враћа вредности на "стандард". На пример, Костал меморија ће се вратити на своја подразумевана правила ако меморијски контролер није био активно уписан неко време. Да бисте периодично подесили излазе, адреси можете додати префикс #ккк#, где ккк означава сваке секунде да ће се излаз поново писати, чак и ако је вредност која се уписује остала иста. На пример, ако је адреса /цнф?цмд=сет_цм_варс&наме=тест&вал=42, можете користити #30#/цнф?цмд=сет_цм_варс&наме=тест&вал=42 да бисте осигурали да се ова вредност уписује сваких 30 секунди постаје.

Дефиниција језика упита:

Тренутно се имена чланова и оператори "." могу користити у изразима за претрагу "упита". и "[]" се користе, примери:

Променљиве Глобал Цхаргинг Манагера:

Можете креирати променљиве у конфигурацији Цхаргинг Манагер-а. Можете користити фиксну вредност или формулу као вредност. На крају сваког циклуса ажурирања, менаџер пуњења може поново израчунати вредност ове променљиве. Затим их можете користити у (одређеним) параметрима Цхаргинг Манагера, правилима пуњења или за контролу излаза. Такође можете написати Е к.мембер или М к.мембер као променљиву. Овде Е к и М к су ИД уређаја зидне кутије или мерача постављених у Цхаргинг Манагер-у. 'мембер' је "прилагођена" променљива која се чува у одговарајућем уређају. Неке од варијабли могу имати посебно значење: За КЕБА "оут1" је прекидачки излаз, за АББ Б23 бројила "оут1" и "оут2" су прекидачки излази (на моделима који то подржавају). А 1 пребацује излаз, 0 га поново искључује.

Окидач: Ако имате уређаје који треба да се укључе под одређеним условима, али затим раде неко време (нпр. машина за прање веша, машина за прање судова), можете дефинисати променљиву и као „окидач“. Формула променљиве тада представља услов који поставља променљиву на 1. Након конфигурабилног времена, она се ресетује на 0. „Услов поновног покретања“ вам омогућава да више пута продужавате време док се уређај не искључи (тј. променљива се не подеси на 0), све док је услов испуњен.

Прекидачи: Такође можете приказати променљиве као прекидаче на почетној страници. Они тада могу имати вредност 0 или 1. Клик на прекидач инвертује вредност. Можете навести текст ознаке као израз / вредност прекидача. Као и код корисничких прекидача, можете навести боју дугмета помоћу ${red}, ${yellow}, ${green}, ${gray} и ${grey}. Ако назив ваше променљиве почиње са 'user_', свако може кликнути на дугме и тиме променити вредност; у супротном, само администратор може кликнути на њега.

Напомена: Само бројеви и слова аз и АЗ могу се користити као имена променљивих.

За потребе тестирања, можете приказати варијабле менаџера наплате и бројила, на пример тренутне цене од Аваттар-а:

Излази глобалног менаџера пуњења:

У конфигурацији Цхаргинг Манагер-а можете да конфигуришете глобалне излазе као што је горе описано у дефиницији мерача под 'Излази'. Они се постављају на крају сваког циклуса ажурирања ако се њихов статус променио. Ако желите да контролишете комутационе излазе у кориснички дефинисаним уређајима, препоручује се горња конвенција (погледајте Променљиве менаџера за пуњење): Поставите променљиве са именом „оут1“, „оут2“ итд. у кориснички дефинисаном бројачу и подесите излази у кориснички дефинисаном бројачу мењају излаз у зависности од вредности ове променљиве.

Глобални Модбус АПИ менаџера за пуњење:

Модбус АПИ менаџера за пуњење се користи за контролу Модбус уређаја који имају било коју Модбус РТУ или ТЦП адресу (доступну од стране Цхаргинг Манагера). Као адресу за Модбус РТУ унесите ЦОМк,бд,8,п,с, као у конфигурацији појединачних уређаја, где је к број ЦОМ порта, бд је брзина преноса, п је паритет ('Н', 'Е' или 'О'), а с је број стоп битова (1 или 2). Код Модбус ТЦП, адреса је ИП адреса уређаја у мрежи Цхаргинг Манагер укључујући број порта.
УРЛ (за ХТТП ГЕТ) Модбус АПИ-ја је:
/цнф?цмд=модбус_гет или /цнф?цмд=модбус_сет
цФос Цхаргинг Манагер подржава следеће додатне параметре упита:
аддр: Модбус РТУ или ТЦП адреса уређаја поменута горе.
фунц: Модбус број функције, нпр. за читање 3 или 4, за писање 6 или 16.
ид: ИД уређаја Модбус уређаја.
рег: Модбус регистарски број. Вредност се може навести у децималном или хексадецималном облику (са префиксом 0к).
вал: број: Вредност која се уписује у регистар. Изоставите приликом читања.
тип: 'в' 16 бита (подразумевано), д = 32 бита, ф = флоат, к = 64 бита, с = стринг.
цнт: број: Максимална дужина стринга у регистрима, за друге типове изоставити или поставити на 1.
ордер: Стринг: Редослед бајтова, или "хл" или "лх".

Напомена: Ако се ваш „Метар“ првенствено користи у контролне сврхе, можете да проверите опцију „Сакриј уређај“ у подешавањима ове плочице тако да се овај уређај не појављује на почетној страници.

Напомена: Неки бројила која се очитавају преко ХТТП захтевају корисничко име/лозинку као ауторизацију. Ово можете навести у адреси за ХТТП приступ, нпр. са http://username:password@192.168.2.111. Ако ваше корисничко име или лозинка садржи "@", морате га заменити са "%40".