nomos Documentation Release 1.1.73 October 03, 2016 Contents 1 Introduction 2 2 Basic Configuration, Licensing and Control4 2.1 Basic Configuration......................................5 2.2 Licensing............................................ 16 2.3 Controlling the nomos - Service................................ 21 2.4 Scripting Client Tool...................................... 30 3 The nomos Command Set 53 3.1 Terminology / Types...................................... 53 3.2 Syntax (Structure of the Protocol)............................... 55 3.3 Answering Sequence...................................... 57 3.4 Formatting Options, Parsing Options, Status Port....................... 58 3.5 Command Classes....................................... 69 3.6 Standard Command Set.................................... 70 3.7 Dynamic Classes........................................ 103 3.8 Keyboard Layout (special keys)................................ 111 4 Expanded Functions (AddOn’s) 112 4.1 CommandServer Extension.................................. 114 4.2 GIRA Homserver KO-Gateway, KNXnet/IP Support..................... 132 4.3 Event Server.......................................... 147 4.4 Airport Support (Airfoil).................................... 152 4.5 eyeTV - Streaming Support.................................. 153 4.6 Apple Remote Support..................................... 155 4.7 Sonos Streaming Player Support................................ 163 4.8 Z-Wave Support........................................ 167 4.9 Philips HUE Support...................................... 174 4.10 mremote Support (commandFusion iViewer support)..................... 176 5 Miscellaneous 187 5.1 Working with System Variables................................ 187 5.2 Mini- Webserver........................................ 191 5.3 Timer Support......................................... 198 i 5.4 Counter Support........................................ 202 5.5 Logic.............................................. 204 5.6 OSD Keyboard......................................... 207 5.7 System Recognition in the Network - ZeroConf........................ 208 5.8 VPN Access.......................................... 211 6 TABLE of key codes SYSTEM EVENTS 213 7 Workarounds, Previews 215 7.1 DVD Copy Window...................................... 215 7.2 iTunes Remote......................................... 216 7.3 Use of the Squeezebox as IR receiver for controlling nomos................. 218 7.4 Useful Shortcuts and Keyboard Commands.......................... 220 7.5 Special Characters (Mac/Win/VM-Ware)........................... 221 8 nomos Cloud API 222 8.1 API Doku General....................................... 222 8.2 API Befehlssatz........................................ 228 9 Legal Advisory 230 10 Version History 231 11 Attachments (templates) 232 11.1 {commandserver}.csv..................................... 232 11.2 {buttons}.csv (Mac only)................................... 234 11.3 webserver.csv.......................................... 235 11.4 sysvars.csv........................................... 237 11.5 timer.csv............................................ 238 11.6 baos.csv............................................ 240 11.7 hs.csv.............................................. 241 11.8 knx.csv............................................. 242 11.9 remote.csv........................................... 244 11.10 xbmc.csv............................................ 245 11.11 sonos.csv............................................ 246 11.12 mremote.csv.......................................... 247 11.13 logic.csv............................................ 248 11.14 zwave.csv............................................ 250 11.15 xpl.csv............................................. 251 ii nomos Documentation, Release 1.1.73 Welcome to the online documentation of the nomos IoT engine The nomos IoT engine, with its TCP-/UDP-Server (Daemon) processing in the background, places at your disposal a way of controlling devices through a network. The software is based on C Code for Linux Systems. A special protocol defined for this application makes possible the execution of a broad range of actions on these systems and their connected devices as well as their comprehensive control through simple LAN or WLAN connections. The nomos protocol serves to unify here the command sets of all the connected devices. nomos system is also distributed under various OEM names. Please be aware that some of the illustrations may not depict the current state of the software and may therefore deviate slightly. Contents 1 CHAPTER 1 Introduction We would like to introduce you to the nomos universal automation-software engine capable of controlling devices, regardless of their communication protocols, standards or proprietary software. The innovative nomos IoT software engine acts as the “Swiss army knife” of automation by elevating soft- ware and hardware to a single communication layer, creating a seamless automation system that can collect, control and feed from any platform. Meeting the Demand of the Rapidly Growing Automation Market The nomos software is made to adapt easily to new ‘standards’ and is extraordinarily light, weighing in with only 613 KB. Unlike the commonly available point-to-point control solutions, nomos is designed to elevate all software, web-services, building automation systems and multimedia components to just one communication level, delivering the full scope of a centralized controller, including logics, scripts and events. In an OEM environment, this IoT software engine can be deployed on virtually all platforms, including low-power devices, or even embedded in a chipset. A consumer-electronics manufacturer then gains the option of creating interoperability among his own prod- ucts while also taking control over third-party applications. The nomos IoT software engine unlocks potential for a boundless array of real-world uses. It can also adapt to and learn any individual consumer’s behavior. In a typical “morning routine” scenario, for example, the system knows the user’s personal wake-up pref- erence, timed by wearable technology. It simply activates macros accordingly, switching the Philips HUE scene to ‘energize.’ Then the Sonos automatically initiates a playlist called “Morning Classic”, set at 37% volume level. The Nespresso machine starts brewing the coffee as the TV, also muted, of course, turns on CNN by default. Detecting the last person to leave the house, the nomos system automatically shuts down appliances. In the car, nomos picks up the Spotify playlist, displays the status of the home in a real-time 3D map environment and shows you the way to the nearest electric-vehicle charging station. Upon leaving the office, nomos sends your ETA with a push-notification to family members or provides details on available parking at your desired destination. – Just one of the many versatile examples, please visit www.nomos-system.com for more IoT use cases. About nomos system 2 nomos Documentation, Release 1.1.73 Founded by home automation veterans as an R&D software lab in 2010, nomos system AG is the leader in innovative building automation, with currently over 2,000 licensed projects and 500 active system integrators in the nomos forum. Using its own software engine, nomos system has completed numerous upscale residential and commercial projects in Europe, the United States and Asia. Suitable for any application from residential to automotive, aviation or marine, nomos system AG supplies OEM partners in the field of automation around the globe. To learn more, please visit http://www.nomos-system.com 3 CHAPTER 2 Basic Configuration, Licensing and Control Available for the basic configuration (network configuration) of the nomos system are appropriate data entry templates. When using Mac systems, you will find that entries mask after the software installation in the system control. When using Linux versions, you obtain the templates for data entries through the Webpanel. Be aware here that the Linux systems have to be licensed before the Webserver will permit a Configuration. The Mac version offers some additional configuration possibilities, such as adjustability of the project path. 4 nomos Documentation, Release 1.1.73 2.1 Basic Configuration 2.1.1 Installation Mac OSX The preinstalled nomos Linux versions are delivered on corresponding hardware platforms. The Apple OS X version has to be installed by you. You start this Apple OSX installation from nomos with a double-click on the nomos packet: This step then guides you through the installation: Click on „Continue“. Read carefully the licensing agreement that appears and then click again on „Continue“. Confirm the query that follows, when you agree to the terms of the license, by clicking on „Agree“. The installation program then shows you that nomos is being installed on the system’s partition. An installation on another partition is prevented by the system. Confirm this with a click on „Continue“. In the window that now appears, please click on „Update“ in order to proceed with the installation. Operator Rights are required for installation of nomos. Please enter the required data: 2.1. Basic Configuration 5 nomos Documentation, Release 1.1.73 Confirm your data entries with „OK“. nomos is now installed. Confirm the completion of the installation with a click on „Close“. Congratulations! nomos is now installed on your system. Please note that the installation of nomos is always referenced to the user. Multiple installations