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

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

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

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

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

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

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

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

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

Преузмите дефиниције бројача за више бројача

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

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

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

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

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

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

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

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

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

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

упд_делаи: у мс. одређује интервал у коме се уређај може очитати. Неки уређаји постају преоптерећени када се анкетирају пречесто.
произвођач: Стринг, назив произвођача. Ово је приказано у проширеним информацијама о плочици.
делаи_аццумулатед: труе = Акумулиране вредности (кВх) се траже само сваке 3 секунде или када има довољно снаге. фалсе = Ове вредности се увек питају.
уи_аддр: УРЛ, ако се разликује од адресе уређаја за позивање веб интерфејса.
резервисано: Низ са вредностима интерпретираним као 0 (корисно ако уређај подржава одређене вредности у зависности од модела).

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

Следећи корак у ЈСОН дефиницији је дефиниција променљивих које мерач користи за читање или израчунавање вредности струје, напона итд. Менаџер пуњења препознаје следеће променљиве:
типе_десигнатион, версион, фирмваре_версион, сериал: Они формирају ознаку модела као што је приказано у проширеним информацијама плочице. Они се постављају једном приликом постављања или ресетовања бројача.
Волтаге_л1..волтаге_л3, цуррент_л1..цуррент_л3, повер_в, повер_вар, повер_ва, повер_в_л1..повер_в_л3: цФос Цхаргинг Манагер покушава да израчуна потписану струју_л1..л3, повер_в и повер_ва из ових вредности за волтажу_л1..л3. Не морате да наведете све променљиве. цФос Цхаргинг Манагер покушава да израчуна вредности из постојећих варијабли.
импорт_вх, екпорт_вх: Менаџер пуњења користи ове променљиве за приказ импорт_вх и екпорт_вх. Код једносмерних бројача (нпр. претварача) увек треба да дефинишете само импорт_вх. екпорт_вх треба дефинисати само за двосмерна бројила (као што су меморијска или купљена бројила електричне енергије).

соц: Одмах доступно, стање напуњености складишта батерије је приказано овде у % у плочици.
Поред тога, можете дефинисати друге променљиве са различитим именима, које се читају са сваким ажурирањем или израчунавају помоћу формула. Ако дефинишете променљиве које користе ЦМ. старт, нпр. ЦМ._сет_прице, додељене вредности се чувају у глобалним променљивим Цхаргинг Манагер-а (погледајте доле) и могу се тражити у складу са тим.
Променљиве са *: Ако дефинишете променљиве које почињу са * , оне се приказују у корисничком интерфејсу у плочици бројача под проширеним информацијама, нпр. температура складишта батерије.

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

Објекат је назван по горе наведеној променљивој и има следећа својства:
фикед: Стринг са фиксном вредношћу. Корисно ако се, на пример, не може одредити вредност, нпр. за типе_десигнатион или напон.
екпр: Стринг, променљива се не чита већ се вреднује као формула.
тип: Ако није фиксно или експр, тип променљиве: инт16, инт32, флоат, инт64, стринг Ово је важно за Модбус да чита регистре у исправном формату. Са ЈСОН/ХТТП углавном можете користити флоат.
резолуција: флоат, прочитана вредност се множи са 'резолуцијом'. Вредности за напон морају бити у волтима, струје у милиамперима, снага у ватима, енергија у ват-сатима (Вх). Са негативном 'резолуцијом' можете инвертовати вредност ако има супротан предзнак.
једном: боол (тачно или нетачно), ако је тачно, вредност се чита само једном када се уређај иницијализује, иначе периодично.
адреса: број (Модбус) или стринг (ХТТП/ЈСОН), број Модбус регистра или ХТТП УРЛ вредности која се чита.
куери: Стринг, са ХТТП ЈСОН спецификацијом на језику упита Цхаргинг Манагер-а помоћу које проналази вредност коју треба прочитати у ЈСОН одговору.
ордер: Стринг, за Модбус редослед бајтова, или "хл" или "лх", у коме је вредност присутна. дужина: број, са Модбусом дужина низа у регистрима. За варијабле 'версион' и 'фирмваре_версион', 'ленгтх' се користи за прављење низова са тачкама од нумеричких верзија. Вредности од 2 или 4 су дозвољене за 'дужину', што онда резултира форматима верзије аб и абцд. Са 'ленгтх' 2 и типом 'инт16', Цхаргинг Манагер раздваја ниски и високи бајт тачком, са инт32 ниском и високом речју, са 'инт64' ниском и високом две речи. Са 'лентх' 4 и 'инт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.име2Елемент „наме2“ у подобјекту „наме1“
име[идк]Елемент "идк" елемента објекта "наме". "идк" може бити број, нпр. за низове или стринг
име["у2"]Елемент "у2" елемента објекта "наме", одговара "наме.у2"
наме[{"ел1": "в1", "ел2": 3}].валуеИзаберите елемент низа који задовољава услове нотације објекта и процените елемент под називом 'валуе'. Овде се, на пример, бира елемент у низу 'наме' који има елементе објекта 'ел1' са вредношћу 'в1' и 'ел2' са вредношћу 3, а затим се вредност елемента 'валуе' враћа из овог објекта .

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

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

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

У сврху тестирања, можете приказати Цхаргинг Манагер и варијабле мерача, на пример тренутне цене од Аваттар-а:


                        Приказ снимка екрана променљивих бројача

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

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

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

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

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

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