homebridge-loxone-ws Websocket based Loxone plugin_系统开发案例-程序员客栈

homebridge-loxone-ws

WebsocketbasedLoxonepluginforhomebridge

ThisisaLoxonepluginforHomebridgeThepluginwillautomaticallyretrieveandcommunicatewithalltheseitemsfromyourLoxonesetup:

Lights(Switches,DimmersandColorleds)OtherSwitchesPushbuttonsWindowblindsTemperaturesensors(othertypescanbeaddedeasily)

TheonlyconfigurationneededisthecredentialstoyourLoxoneminiserver.

BenefitsRealtimeandveryfast2-wayupdatesbyusingthewebsocketconnectionOne-touchdeploymentthroughautomaticimportofLoxonecontrolsPrerequisites

HomebridgeFollowalltheinstallationstepsthere.

Installation

Installthepluginthroughnpmordownloadthefilesfromhere.

$sudonpminstall-ghomebridge-loxone-ws

Orupdatetolatestversionwhenalreadyinstalled:

$sudonpmupdate-ghomebridge-loxone-ws

Note:thepluginrequiresextranodemodules,buttheseshouldbeautomaticallyinstalled:

node-lox-ws-apirequestHomebridgeconfig.json

AddtheplatformsectiontoyourHomebridgeconfig.json(usuallyin~/.homebridge):

{"bridge":{"name":"Homebridge","username":"CA:AA:12:34:56:78","port":51826,"pin":"012-34-567"},"description":"Yourconfigfile.","platforms":[{"platform":"LoxoneWs","name":"Loxone","host":"192.168.1.2","port":"12345","username":"homebridge","password":"somepassword"}]}

Replacefields

hostbytheIPofyourloxoneminiserverportbytheportofyourminiserver(use80ifnospecialport)usernamebytheLoxoneusernamepasswordbytheLoxonepassword

IstronglysuggesttocreateadedicateLoxoneuserthroughLoxoneConfig(eghomebridge).Likethisyoucanrestrictaccesstosensitiveitemsorfilteroutunneededcontrols.

Optionalconfigurationfieldsintheplatformsection

rooms

Tospecifyanarrayofinterestedroomstofilteron.Ifemptyornotgiven,allelementsareused.Eg:specifying"rooms":["Kitchen","Bedroom"]willlimityourbridgetoonlyelementsfromthose2rooms.

moodSwitches

CanuseLoxonemoodswhicharepartofLightControllerV2elements.(Inordertousethis,you'llneedtoconvertany'old'LightControllersblocks.)

Has3possiblevalues

none:doesnotincludemoods.Thisisthedefaultincasenotgiven.all:includemoodsasactionableitemonly:onlyincludemoodsandfilteroutanyotherelementAssumptions

TocreatethecorrectaccessorytypefromLoxoneitems,someattributeparsingisrequired.(EgaLoxoneSwitchcanbeaSwitchoraLightBulb,andInfoOnlyAnalogtypecanbeatemperaturesensorbutalsoanythingelse.)ThisiscoveredinthecheckCustomAttrsfunctioninItemFactory.Adaptittoyourneeds.Currentlytheseassumptionsaremade:

temperaturesensornamesstartwith'Temperat'lightswitchesareinaLoxonecategoryusingthelightbulbicon

ThecontrolswillbenamedlikeyounamedtheminLoxone.RenamethemthroughtheiOSHomeapptomakeitmoreintuitiveforusingwithSiri.EgLIGHT_KITCHENcanberenamedto'mainlight'andaddedtoroomKitchen.ThenyoucanaskSirito'turnonthemainlightinthekitchen'.

Limitations

roomsTheHomebridge/HAPprotocoldoescurrentlynotallowattachingtheLoxoneroomstotheaccessories.ThatisamanualactiontobedoneonceusingtheIOSHomeapp(ortheEveappwhichismuchmoreuser-friendly).

Specialnote:organizingintoroomscanbedonefromEve,butrenamingtheitemsshould(unfortunately)bedonefromtheIOSHomeapp.NamechangesinEvearenotreflectedinHomeandthusnotknownbySiri.

100itemsHomeKithasalimitof100accessoriesperbridge.IfyouhavealargeLoxonesetup,trytofilterunneededitemsouteitherthroughadedicatedLoxoneusergrouporinthecheckCustomAttrsfunction.

pushbuttonsSinceHomekithasnopushbuttonconcept,IimplementedpushbuttonsasswitchesinHomekit.TellingSiritoputthemOnwillsendapulsetothepushbutton.InHomekit,theywillappeartobeOnforasecond.

Advanced

TheEventtypeisforeseenforyourconvenience,butnotcurrentlyused.Itcanbeusedforpushbuttonswhenyou'reonlyinterestedinreadingfromHomekitandnotcontrollingit.Thatcouldbeusefulforsettingtriggers,egaPushbuttoneventwhichcausesaHomekitscenetobecomeactive.

Problemsolving

IfyourhavetroublesgettingthestatesonyouriOSdevice,tryremovingthefilesinyour'persists'folder(usuallyin~/.homebridge/persist)andrestartinghomebridge.

License

ThepluginisreleasedunderMITlicense,whichmeansyoucandowhateveryouwantwithitaslongasyougivecredit.

Credits

AttributiongoestowardsTommasoMarchionni.ThestructureofthiscodeisbasedonhisopenHABplugin.

TheoriginalHomeKitAPIworkwasdonebyKhaosTianinhisHAP-NodeJSproject.

ThehomebridgecomponentonwhichthispluginisbuiltwascreatedbyNickFarina.

I'vemadeuseoftheNodeJSLoxonewebsocketAPIcreatedbyLadislavDokulil

Thankstoallcontributors!

homebridge-loxone-ws Websocket based Loxone plugin

作品详情

重点城市程序员兼职推荐

重点岗位程序员兼职推荐