Mit diesem Skript können individuelle Tastenaktionen erstellt werden.
Mit "pushTime:" kann man Aktionen für lange Tastendrücke und mit "multiPush:" Aktionen für mehrere Tastendrücke erstellt werden.
Man kann/muss den Aktionen eigene Namen geben, für "openWindow" könnte das in etwa so aussehen openWindow: {pushTime: 7, shellyCall: ['Switch.Toggle', {id: 0}]},.
Es können sowohl pushTime- als auch multiPush-Aktionen kombiniert werden, sowie mehrere benutzerdefinierte Aktionen parallel erstellt werden, bis zu 40 Aktionen in einem Skript.
Beispiel: pushTime: 15, pushTime: 5, pushTime: 10. Abhängig von der Dauer des Tastendrucks 15, 10 oder 5 Sekunden wird der entsprechende "shellyCall:" ausgeführt.
Alle Aktionen beziehen sich auf den unter "cid" definierten Input/Button. Wer custom Button-Aktionen für mehrere lokale Inputs/Tasten erstellen will, kann das Script einfach mehrmals in verschiedenen Script Slots ausführen.
Der "shellyCall:" Parameter benötigt ein Array [ ], in das man alles so eintragen kann, wie man es von einem Shelly.call() gewohnt ist.
Shelly.call(), Callback Funktionen und userData werden ebenfalls unterstützt.
Ich hoffe, ihr habt viel Spaß damit.
Wenn ihr nen Fehler entdeckt oder einfach nur euer Feedback teilen möchtet , könnt ihr mir das jederzeit hier im Thread mitteilen.
Update: 27.10.2023
- Callback Beispiele hinzugefügt.
- Debug Output neu formatiert.
- Dekats Toolbox auf v1.7-Alpha angehoben.
- Blink Funktion in die Toolbox eingebaut.
MitBlink(BlinkCount,BlinkDelay,Call);kann man nun in Callbacks sehr einfach ein Bestätigungs-Blinken einbauen, alsoBlink(5,0.1,['Switch.Toggle',{id:0}]);würde 5 mal schnell Blinken.
Code
//Exampel Callbacks
function DoStuff(){ //Callback and Blink, use Exampel
Call('Switch.Set',{id:0,on:false},function(){
Blink(5,0.1,['Switch.Toggle',{id:0}]); //Paramaeter--> Blink(BlinkCount,BlinkDelay,Call)
});
}
function Somethink(){ //Special Callback Exampel
print('Hello Shelly World!');
}
//Config
let cid = 0; //Local input id
let btnMap = { //parameter-> pushTime:-> push duration, multiPush:-> push count, shellyCall=Shelly.call()=[Method,parameter,CallBack,userData]
custom1: {pushTime: 15, shellyCall: ['Switch.Set',{id:0,on:false}] },
openWindow: {pushTime: 7, shellyCall: ['Switch.Toggle',{id:0}] },
rotateWindow: {pushTime: 10, shellyCall: ['HTTP.GET',{url:"http://192.168.0.10/relay/0?turn=off"}] },
someStuff: {pushTime: 5, shellyCall: ['HTTP.GET',{url:"http://192.168.0.10/relay/0?turn=toggle"}] },
anythink: {multiPush: 1, shellyCall: ['Switch.Set',{id:0,on:true}, DoStuff] },
possible: {multiPush: 2, shellyCall: ['Switch.Set',{id:0,on:false, toggle_after: 2}] },
possible2: {multiPush: 5, shellyCall: [null,null, Somethink] },
turn_off_Google: {multiPush: 6, shellyCall: ['HTTP.GET',{url:"http://admin:exampelpw@192.0.0.10/relay/2?turn=off&timer=5"}]},
turnOn_Alexa: {multiPush: 4, shellyCall: ['HTTP.GET',{url:"http://192.168.0.41/relay/1?turn='on'"}, null, 'Log writing, anyThink'] },
}; //You can name entries inside the btnMap whatever you want, name Restriction: without Space!, unique entries only!, maximum--> 40 entries!
//Advanced config
let multiPush_delay = 0.6; //Duration betwinn short multi pushes in Seconds
let shortPush_Timeframe = 0.6; //Timeframe betwinn btn_down and btn_up in Seconds
let debug = false; //Create debug output
function CustomBtn(d){
let result = Efilter(d,{filterValue:['btn_down','btn_up']});
if(!result || d.component !== 'input:'+cid) return; //Exit if usless event
try{
if(result.btn_down){ oldTS_down = d.now; //Saving push start time
if(tH1){Timer.clear(tH1); tH1=0;} //Reset multiPush Timer
let diffT = d.now-oldTS_up; //Duration betwinn short push
if(diffT >= multiPush_delay) pushCounter = 0; //Reset push counter
}
if(result.btn_up){ oldTS_up = d.now; //Saving push stop time
let diffT = d.now-oldTS_down; //Push duration
if(!oldTS_down) return; //Exit if no oldTS_down
if(diffT < shortPush_Timeframe) pushCounter++; //Increase Push counter
if(diffT >= shortPush_Timeframe) pushCounter = 0; //Reset Push counter
if(debug) print('Debug: Btn pushed for ',diffT,' Seconds, push count: ',pushCounter||'not_a_short_Push');
try{Object.keys(btnMap).forEach(Read_btnMap);}catch(e){print('Error: Read_btnMap(),',e);} //Parse to Array
if(tList.length > 0){ //Push duration logic
try{tList = Sort(tList);}catch(e){print('Error: Sort(tList),',e);} //sorting pushTime, high --> low
for(let btn of tList){ //Compare real Push Duration with btnMap pushTime
if(diffT > btn[0]){
if(debug) print('Debug: found match pushTime, >',btn[0]);
Call(btn[1][0],btn[1][1],btn[1][2],btn[1][3],debug);
break;
}
}
tList = []; //Clear Push duration list
}
if(mList.length > 0 && pushCounter){ //Push counter logic
try{mList = Sort(mList,-1);}catch(e){print('Error: Sort(mList),',e);} //sorting multiPush, high --> low
for(let btn of mList){ //Compare Push counter with btnMap multiPush
if(btn[0] && pushCounter === btn[0]){
if(!tH1) tH1 = Timer.set(1000*multiPush_delay,false,function(){tH1=0; Check_multiPush(btn);})
break;
}
}
mList = []; //Clear Push counter list
}
}
}catch(e){print('Error: CustomBtn(),',e);}
}
function Read_btnMap(btn){ //Read btnMap and parse to Array
let t=btnMap[btn].pushTime, m=btnMap[btn].multiPush, c=btnMap[btn].shellyCall;
if((!m && !t) || !c){print('Error: btnMap, missing Parameter: ',m || t,',',c); return;}
if(t && c) tList.push([t,c]);
if(m && c) mList.push([m,c]);
}
function Sort(arr, inv) { //Sorting array, high-->low or inv=-1 low-->high
let sA = [];
while (arr.length > 0) { //array loop
let maxI = 0; //start at index 0
for (let i = 1; i < arr.length; i++) { //search for max Value
if (inv && arr[i][0] < arr[maxI][0]) maxI = i;
if (!inv && arr[i][0] > arr[maxI][0]) maxI = i;
}
sA.push(arr.splice(maxI, 1)[0]); //add new max Value
}
return sA;
}
function Check_multiPush(btn){
if(debug) print('Debug: found match multiPush, =',btn[0]);
Call(btn[1][0],btn[1][1],btn[1][2],btn[1][3],debug);
}
function Main(){ //Main Code
SwitchM(cid,'detached','button',debug); //Change Realy/input mode
Shelly.addEventHandler(CustomBtn); //Add EventHandler with Asyn CallBack CustomBtn()
}
// Dekats Toolbox, a universal Toolbox for Shelly scripts
function Str(d){ //Upgrade JSON.stringify
if(d === null || d === undefined)return null;
if(typeof d === 'string')return d;
return JSON.stringify(d);}
function Efilter(d,p,deBug) { //Event Filter, d=eventdata, p={debug:true, noInfo:true, inData:true, filterKey:[], filterValue:[]}->optional_parameter
try{
fR = {};
if (p.noInfo) {fR = d; d = {}; d.info = fR; fR = {};} if (p.inData && d.info.data) { d.info = d.info.data; delete d.info.data; }
if (p.filterKey) for (f of p.filterKey) for (k in d.info) if (f === k) fR[k] = d.info[k];
if (p.filterValue) for (f of p.filterValue) for (v of d.info) if (Str(v) && f === v) fR[Str(v)] = v;
if (deBug) print('\nDebug: EventData-> ', d, '\n\nDebug: Result-> ', fR, '\n');
if (Str(fR) === '{}') {return null;} return fR;}catch(e){print('Error: Efilter(), ',e);}}
function Blink(bc,dl,c,st){//Call Blink funktion, bc=blinkCount, dl=blinkDelay, c=call->as_arry->[methode,parameter], st=startCount
try{
if(tH8) Timer.clear(tH8); tH8= 0; if(!Str(st)) st= 0;
if(st < bc*2){st++;}else{st=0; return;}
if(!tH8) tH8 = Timer.set(1000*dl,false,function(){Call(c[0],c[1],function(){tH8=0; Blink(bc,dl,c,st);},c[3],c[4]);});
}catch(e){print('Error: Blink(), ',e);}}
function SwitchM(cID,rM,iT,deBug){ //Change rM->RelayMode, iT->InputMode, cID=0->Relay_ID and/or Input_ID,
try{ //More Info, rM='detached'->detached/flip/momentary/follow,iT='switch'->button/switch
let r = 0;
if(Config('switch',cID).initial_state === 'match_input') Call('Switch.SetConfig',{id:cID,config:{initial_state:'restore_last'}});
if(rM && Config('switch',cID).in_mode !== rM){Call('Switch.SetConfig',{id:cID,config:{in_mode: rM}});if(!r){r='';} r+='rM, ';}
if(iT && Config('input',cID).type !== iT){Call('Input.SetConfig',{id:cID,config:{type: iT}});if(!r){r='';} r+='iT, ';}
if(deBug){r='Debug: tryed to change-> '+(r||'nothing,')+' Oldconfig: rM-> '+Config('switch',cID).in_mode+', iT-> '+Config('input',cID).type; print(r);}
return r;}catch(e){print('Error: SwitchM(), ',e);}}
function ErrorChk(r,e,m,d){ //Shelly.call Error Check
try{
aC--; if(aC<0) aC=0;
if(d.CB && d.uD) d.CB(r,d.uD); if(d.CB && !d.uD) d.CB(r);
if(!d.CB && d.uD) print('Debug: ',d.uD);
if(e === -104) print('Info: no connection, maybe wrong URL, for local Shelly use local Method-> ["Switch.Toggle",{id:0}]');
if(e) throw new Error(Str(m));
if(Str(r) && Str(r.code) && r.code !== 200) throw new Error(Str(r));
}catch(e){print('Error: ErrorChk(), call Answer: ',e);}}
function Call(m,p,CB,uD,deBug){ //Upgrade Shelly.call
try{
let d={};
if(deBug) print('Debug: calling:',m,p); if(typeof CB === 'function') d.CB = CB; if(Str(uD)) d.uD = uD;
if(m === null && p === null){CB(uD); return;}
if(aC < callLimit){aC++; Shelly.call(m,p,ErrorChk,d); return 0;}else{print('Status: Call(), to many Calls in use, drop Call:',m,p);}
}catch(e){print('Error: Call(), ',e); return 1;}}
function Setup(){ //Wating 2sek, to avoid a Shelly FW Bug
if(Main !== undefined && !tH9){tH9 = Timer.set(2000,false,function(){tH9 = null; print('Status: started Script _[', scriptN,']_');
if(callLimit > 5){callLimit=5;} try{Main();}catch(e){print('Error: Main(), ',e); Setup();};});}}
var tH8= 0, tH9= 0, callLimit= 5, aC= 0, callList=[], //Toolbox global variable
var Status= Shelly.getComponentStatus, Config= Shelly.getComponentConfig; //Renamed native function
var info= Shelly.getDeviceInfo(), scriptID= Shelly.getCurrentScriptId(), scriptN= Config('script',scriptID).name; //Pseudo const, variabel
//Toolbox v1.7-Alpha, Shelly FW >1.2!
let tH1=0, oldTS_down=0, oldTS_up=0, pushCounter=0, mList=[], tList= []; //Global variabel
Setup();Das Skript fällt unter die, Apache License Version 2.0, January 2004, siehe Link für mehr Infos: https://github.com/ALLTERCO/shell…ob/main/LICENSE
Vorschau:
. Ist das in der Api seitens Shelly implementiert?