Yoga Intelligent Smart Home User manual

Installation Manual
Vers: 3.0 2015
Yoga Systems – Intelligent Smart Home

Table of Contents
Introduction............................................................................................................................................................ 3
About Yoga AS....................................................................................................................................................... 3
System Architecture............................................................................................................................................... 4
Building Level Architecture..................................................................................................................................... 6
Cabling................................................................................................................................................................... 8
Cloud Server Smart Home Gateway.............................................................................................................. 8
Smart Home Gateway YogaBus Gateway.....................................................................................................8
YogaBus Gateway Yoga controllers (incl. Yoga 1-wire Gateway)...................................................................8
Yoga 1-wire Gateway Yoga 1-wire Sensors................................................................................................... 9
Power................................................................................................................................................................ 9
Power Consumption......................................................................................................................................... 9
Doubling Power Supplies.................................................................................................................................. 9
More than one Power Supply in a System......................................................................................................10
Yoga Smart Home System Components Installation............................................................................................11
Yoga Cloud Server.......................................................................................................................................... 11
Yoga Smart Home Gateway............................................................................................................................ 11
YogaBus Gateway.......................................................................................................................................... 12
Yoga Switch.................................................................................................................................................... 13
Yoga Input/Output Controller 8ADi8Do...........................................................................................................15
Connecting Security Detectors and devices...................................................................................................18
Yoga Output Controller 0..10VDC................................................................................................................... 19
Yoga 1-WireGateway with Temperature and Temperature + Relative Humidity Sensor..................................21
........................................................................................................................................................................ 21
Yoga Counter Controller................................................................................................................................. 22
Third party product connecting with Yoga:......................................................................................................23
Internal Air Quality Sensor: CO2 + T + RH......................................................................................................23
Page 2|24

Introduction
The goal of this document is to assist installers to physically set up a Yoga Smart Home solution. In turn, the in-
stallers will also learn about Yoga Smart Home's architecture.
Yoga is an intelligent smart home platform that connects and interconnects anything you can think of: wired and
wireless security sensors, cameras, thermostats, smart plugs, lights, entertainment systems, locks and appli -
ances. Moreover, Yoga manages these items from anywhere and with any device possessing an internet con-
nection.
Yoga is location-aware. Whether you leave home for a long vacation or a brief night on the town, Yoga allows
you to manage security and utilities with one touch, giving you peace of mind and saving you money.
Yoga is a revolutionary home-operation system that redefines the term "homepage".
Yoga Smart Home plays a key role in a building in:
•Indoor air quality monitoring
•Room-based climate control heating, cooling and ventilating
•Lighting and Power Socket control
•Security System
•Video surveillance
•Access Control
•Energy metering and statistics
•Any device monitoring and controlling
Yoga Smart Home consists on following major feature groups:
•Geofencing
•Your personal home dashboard
•Automation rules (also known as automated actions)
•Actions
•Notifications
About Yoga AS
Yoga AS has developed a revolutionary cloud-based IoT platform for smart homes and smart building automa-
tion. Based in Tallinn, Estonia, we’ve been working on intelligent remote management of appliances, devices
and buildings since the mid-90s. As a technology provider, we license our solution to service providers, who in
turn offer their customers a smart home service.
Page 3|24

System Architecture
Yoga Smart Home has a 5 level system architecture:
1. Cloud server
2. Smart Home Gateway
3. I/O and other controller gateways
4. I/O controllers
5. Peripheral devices
All Smart Home Gateways from homes and other type of buildings are connecting to a scalable Yoga Smart
Home cloud server (called Magic), which takes care of real time communication, logging, video storage etc.
Yoga offers a scalable cloud service by itself or depending on the region through service providers.
Start using the service
When a customer has bought the devices, the service needs to be activated. There are basically two ways for
service activation:
•customer signs the agreement with service provider and the service is activated
•customer goes to a smart home web portal (URL provided to customer while purchasing devices), cus-
tomer activates the service and customer is charged by third party billing system à la Paypal.
When the service is activated, the user goes to a web portal and steps through a setup wizard.
Registering a Smart Home ateway to a cloud server
All Smart Home Gateways are manufactured with the same firmware (i.e. it doesn't have a service provider spe-
cific data like for example cloud server IP addresses etc). The Smart Home Gateway has to go through a regis-
tration procedure.
While going through the setup wizard steps, a user enters the Smart Home Gateway's activation code, and in
the background Magic server requests this Smart Home Gateway's ownership from Yoga's global Dispatcher
service.
Page 4|24

A brand new Smart Home Gateway goes through a registration process during first boot:
•Connects to Dispatcher service to query where it should connect for certificate signing Smart Home
Gateways do not have a signed certificates after manufacturing and therefore they need to do it by con-
necting straight to customer's signing server. Certificates are not included in Smart Home Gateway's
firmware because of security risk to avoid theft of service provider's secret key while manufacturing
process.
•Receives a SIGN server URL from Dispatcher service, and then connects to SIGN server to sign the
certificate and to get its service provider specific data - static configuration including the Magic server
URL.
•After certificates are signed, the Smart Home Gateway can now connect to Magic server to get initial
runtime configuration and start operations.
Setup wizard
In the setup wizard, a user creates his or her home configuration - enters rooms, devices, utility prices etc. In
addition, all devices' firmware versions are checked to be up-to-date and if not, they will be upgraded.
Note: Smart Home Gateway's firmware update is mandatory and the next wizard step will not start before the
Smart Home Gateway update has been successfully finished. Other devices' firmware upgrades are done in
background.
Smart Home ateway connection to cloud
A Smart Home Gateway has an option to connect to cloud servers through LAN or mobile connection.
Note that for connecting to a Dispatcher service during initial registration a Smart Home Gateway needs a LAN
connection or a SIM card with publicly listed APN - as APN cannot be dynamically requested from mobile net -
work, an unknown APN doesn't allow a Smart Home Gateway to connect to cloud services.
VPN connection
As a backup channel a VPN connection can be initiated to a Smart Home Gateway through Magic server. This
might be useful for high level troubleshooting. A Smart Home Gateway automatically initiates a VPN connection
when the connection to Magic is lost and closes it when Magic connection restores.
Video
To provide video surveillance functionality, Yoga uses a cloud-based video platform. Users can still start and
stop recording video stream manually or with automation rules through Yoga Smart Home service in a purpose
to guarantee the authorized video streaming.
Unless all start and stop and other technical commands are sent through Magic, video stream goes straight
from camera to video platform. All recordings are hold in video platform DB.
Logs
As logging the events is not a core feature of Magic server, logging is taken out from Magic and can be there-
fore customised for different customers and applications.
Log handlers are processing all events for fast and optimal information serving in user interfaces.
External Systems
There are multiple 3rd party external systems involved and integrated to Magic. Some of them are customer
specific and some of them are universal for all Yoga's customers:
•Service operator specific
◦E-mail relay server
◦SMS gateway
◦IVR platform for alarm calls
◦Local weather information system
◦Service operator's CRM system
•Common
◦Google Cloud Messaging
◦Apple Push Notification
Page 5|24

Building Level Architecture
Yoga Smart Home devices are typically connected to a building's local area network (LAN) or in case of higher
security requirements to a separate LAN.
Yoga has several types Smart Home Gateways, each of them having a different configuration and therefore a
dedicated connection schematics are provided below.
Connecting Yoga Tiny
Page 6|24

Connecting Yoga Pro1
Page 7|24

Cabling
Installers have to follow the cabling instructions exactly, otherwise it is possible that the system will not work, or
will work with data loss, or will display other strange symptoms which will make the discovery of mistakes very
complex.
All cable types are indicative and show minimum needs. In each case, if the indicated cable is not appropriate
for correct signal transfer, the installer must choose the appropriate cable type.
Cloud Server – Smart Home ateway
The Cloud Server and Smart Home Gateway are connected through a public Internet connection (WAN).
A standard 10/100/1000BASE-T Ethernet network (http://en.wikipedia.org/wiki/Ethernet), with CAT5/6 cabling
and its standard installation methods is used to connect the Smart Home Gateways.
In case of higher reliability requirements, an industrial Ethernet Switches are recommended.
The connection is fully encrypted.
Smart Home ateway – YogaBus ateway
The YogaBus Gateway connects to Smart Home Gateway through an Ethernet port connection.
The connection is fully encrypted.
YogaBus ateway – Yoga controllers (incl. Yoga 1-wire ateway)
The YogaBus Gateway connects Yoga controllers to a Smart Home Gateway. RS485 protocol is used to connect
Yoga controllers.
It is essential that the RS485 network be installed in a standard way (a description can be seen at:
http://en.wikipedia.org/wiki/RS485). A twisted pair cable is mandatory, a shielded cable advisable, and Line A
and Line B must be connected to the same twisted pair (e.g green and green/white).
NB! The required arrangement of the wires is a connected series of point-to-point (multi-dropped)
nodes, a line or bus, not a star, ring, or multiply-connected network. Ideally, the two ends of the
cable will have a termination resistor connected across the two wires. Without termination resistors, reflections
of fast driver edges can cause multiple data edges, which can cause data corruption. Termination resistors also
reduce electrical noise sensitivity due to the lower impedance, and bias resistors (see below) are required. The
value of each termination resistor should be equal to the cable impedance (typically, 120 ohms for twisted pairs).
Star and ring topologies are not allowed!
It is possible and convenient to provide a power to controllers through a YogaBus data cable. However, a sepa -
rate and wider cable should be used to avoid low power (12V) too quick voltage drop.
Device Cable type Cable colors
Yoga con-
troller
twisted pair cable, for
example:
CAT7, CAT6, CAT5
UTP, FTP (shielded)
recommended
Orange-Orange/White 12V Power
Green YogaBus A
Green/White YogaBus B
Blue-Blue/White GND
Brown-Brown/White reserved
Page 8|24

Yoga 1-wire ateway – Yoga 1-wire Sensors
The Yoga 1-wire Gateway connects Yoga 1-wire sensors with the Smart Home Gateway through YogaBus Gate-
way. Standard 1-wire cabling methods are required (http://pdfserv.maxim-ic.com/en/an/AN148.pdf). Operating a
1-Wire network beyond the limits or disregarding advice given in this document may result in unreliable network
performance.
As with any electronic component, supporting electronic systems must meet the device specifications under all
conditions of use to assure reliable operation. Therefore:
–There are countless combinations of wire types and topologies that can be used with 1-Wire devices.
Yoga Smart Home supports only the most general and typical 1-Wire network topologies: Linear and
Stubbed. In stubbed networks, special resistors must be used to avoid impedance mismatch at the
branch point. Star topology and switched networks are not allowed!
Power
Power Consumption
The system must be powered correctly for proper functioning. Please consider carefully the whole system's
power consumption and make sure that the power supplies and batteries are chosen correctly!
Battery capacity calculating apparatus according to the desired power consumption and endurance time. Good
practice will yield a minimum of 4 hours of battery life.
The overall system power consumption (A) multiplied by the employee to the desired battery (h) = battery
capacity (Ah).
If the power supply does not have enough power to feed the system, the installer must add an additional one.
Doubling Power Supplies
It is recommended to have two separate power supply groups for:
•mission critical devices (e.g security and access) and
•other devices (e.g lighting and climate).
The first power supply must be connected to a battery, although it is not necessary with the other one (or it may
have a battery with much less capacity).
Battery capacity must be chosen according to the customer's requirements or agreement.
All Yoga controllers must have been equipped with backup battery option.
Page 9|24

More than one Power Supply in a System
NB! All of the Yoga Smart Home system's 12VDC power supply grounds (GND) must be connected together!
This is necessary for RS485 line potential equalization; otherwise, traffic on the YogaBus line might be cor-
rupted. If input/output decoupling is used (see Yoga Input/Output Controller description), the decoupled part's
power supply Power and GND may not be connected together with the rest of the system.
Page 10|24
Drawing: 12VDC Power Connection

Yoga Smart Home System Components Installa-
tion
The following chapter describes the installation of Yoga components.
All peripheral device requirements and installation instructions are described in the chapter Peripheral Device
Requirements and Installation.
For detailed technical information about each component, please refer to the product sheets.
All Yoga components have to be installed following Yoga instructions; otherwise, Yoga will not be able to offer
technical support for the installer, there may be an extra charge for the technical support, and the component
warranty may be void.
Yoga Cloud Server
eneral Description
Yoga Cloud Server is set up by Yoga or service provider. An installer doesn't have to take care of it.
Yoga Smart Home ateway
eneral Description
The Yoga Smart Home Gateway is the local brain of the Yoga Smart Home system. It takes care of a local in-
stallation and transfers local information to the Yoga Cloud Server for logging and management.
The Yoga Smart Home Gateway is capable of functioning without Yoga Cloud Server connections. The Yoga
Smart Home Gateway logs locally all data and after a connection has been recovered, it transfers local logs to
the Yoga Cloud Server, which will store it in a database.
The Yoga Smart Home Gateway always initiates the connection with the Yoga Cloud Server and blocks all in-
coming connections for security reasons.
Connection Scheme
There are several types of Yoga Smart Home Gateway hardware available.
Depending on device type different connection schematics apply. The common part of connections include:
•Power (+5VDC, +12VDC)
•Ethernet network (RJ45)
Smart Home Gateways might have wireless interfaces e.g. ZigBee, Bluetooth LE.
For more detailed information please refer to data sheet.
Installation Requirements
The Yoga Smart Home Gateway, with passive cooling, doesn't have special installation requirements, as long as
the room's temperature stays within the temperature limits.
For more detailed information on temperature ranges please refer to data sheet.
Page 11|24

YogaBus ateway
eneral Description
The YogaBus Gateway connects to a Smart Home Gateway through LAN and to Yoga controllers through
RS485 interface, on which YogaBus software protocol is implemented.
The YogaBus line protocol is encrypted to ensure data transfer security.
The YogaBus Gateway connects to:
•Yoga Smart Home Gateway (Ethernet).
•YogaBus (RS485) (4-pin screw terminal)
•12VDC power (4-pin screw terminal)
Connection scheme
Drawing: YogaBus Gateway connection scheme
Page 12|24

Yoga Switch
eneral Description
The Yoga Switch has eight freely configurable touch inputs (capacitive), a 4-digit numeric display, and a temper -
ature and daylight sensor.
The Yoga Switch consists of two parts: a base controller and cover plate. The base controller is installed with
two screws (60mm distance) on a sunk electrical box.
Page 13|24
Drawing: Usage principles for Yoga Switch

LED Indicators
Name Color Description
LED9 Green Blinking: controller is being polled by YogaBus Gateway continuously. Blinking frequency
shows how frequently the controller is being polled; each blink means one polling.
OFF: controller is not being polled by the YogaBus Gateway.
NB! LED9 only blinks when the front cover is removed. As soon as the front cover is re-
placed, this LED is switched off.
LED10 Green Blinking: controller is being polled by the YogaBus Gateway continuously. Blinking frequency
shows how frequently the controller is being polled; each blink means one polling.
OFF: controller is not being polled by the YogaBus Gateway.
Page 14|24
Drawing: Yoga Switch connection scheme

Yoga Input/Output Controller 8ADi8Do
eneral Description
The Yoga Input/Output Controller is used to connect input and output devices to the Yoga system. The controller
can be used for security, access, lighting, climate and other device control.
Drawing: Yoga nput/Output Controller LED indicators
Page 15|24

Drawing: Yoga nput/Output Controller general connection scheme
Controller inputs have internal pull-up resistors, which makes it possible to connect passive contact based
equipment directly to the input's 2 pins. Internal pull-up resistors are automatically switched on if the following
devices are configured to input:
Switch, security detector, access sensor, doorbell switch, RFID tamper, exit and entry buttons, and 0..10V and
4..20mA sensors (with internal pull-up).
Pull-up resistors can be manually configured for the following devices:
Siren tamper, lock tongue sensor, and lock handle sensor.
Page 16|24

Connecting RFID Readers
The RFID reader always requires two inputs (for D0 and D1) from the Yoga Input/Output Controller. RFID reader
inputs must be connected in a predefined order and inputs. A maximum of four readers can be connected to one
controller.
The main rules in connecting card readers are:
Possible inputs to connect D0 are: 1, 3, 5 and 7
D1 must always be beside D0
Therefore, the RFID reader's inputs can be 1-2 (weigand 1), 3-4 (weigand 2), 5-6 (weigand 3), 7-8 (weigand 4).
It's not possible to connect the RFID reader to inputs 2 and 3, 4 and 5, 2 and 8 etc. Suggested installation order:
Access type Inputs order Outputs order
access with one RFID reader (opened
manually with a handle or with an exit
button from inside)
1. RFID reader #1
2. sensor
3. exit button 1. lock
2. green LED
3. buzzer
access with two RFID readers 1. RFID reader #1
2. RFID reader #2
3. door sensor
Decoupling controller from YogaBus Line
The controller (power, inputs and outputs) is decoupled from the YogaBus line by factory settings External
Power Jumpers are in the OFF position and external power must be connected.
Please note that if decoupling is needed, an external power supply must be installed and “External power +12V”
and “External Power “ must be connected.
Page 17|24
Drawing: Yoga nput/Output Controller decoupling from YogaBus line
Galvanic coupling of loose, remove the jumpers +12 and GND
If you wish to use additional EP 12V or 12V power supplies for various example 5V, 24V, and is not
recommended galvanically decoupled power lines and additional power, you can leave the umper
shortcut GND to GND lead with different power supplies

Connecting Security Detectors and devices
Technically, it is also possible to connect detectors with one or without any resistors, but in this case the security
level is seriously decreased and an installer must respond.
The installation interface has, for security detectors, predefined default normal and alarm state voltages. These
values are based on the nominal resistor values recommended by Yoga.
NB! Any resistors can be used but the installer must consider the fact that a whole line may have a maximum 15
kΩ resistance and the gap between alarm and normal states must be at least 1.5V.
Page 18|24
Drawing: Yoga nput/Output Controller: connecting security detectors with 2 resistors and without resistors

Yoga Output Controller 0..10VDC
eneral Description
The Yoga Output Controller 0..10VDC is mainly used for smooth luminary light switching, but also to control the
central HVAC and other devices.
The Yoga Output Controller 0..10VDC has eight output channels, each of which is individually controllable.
Page 19|24
Drawing: Yoga 0..10VDC Output Controller: connecting device 1..10V control and 0..10V control

LED Indicators
Name Color Description
Line Power
(+12V)
Green ON: +12V line power OK
OFF: +12V line power failure
Module OK Orange Smoothly waving between ON/OFF: controller software is up and running
All other states: controller has not started or controller has crashed
Ybus traffic Green ON or blinking: indicates that traffic is running on the YogaBus line; doesn't consider the con-
troller serial number
OFF: there's no traffic on the YogaBus line
Ybus OK Orange ON: controller recognizes the traffic on the YogaBus line
OFF: controller doesn't recognize the traffic on the YogaBus line
Blinking: controller is experiencing some errors in understanding YogaBus traffic
Module Rx Green ON or blinking: controller has received data from the YogaBus
OFF: controller has received no data from the YogaBus
Blinking: continuous data receiving
Module Tx Green ON or blinking: controller has sent data to the YogaBus
OFF: controller is not sending data to the YogaBus
Blinking: continuous data transmitting
LED1 Green ON/OFF: Smart Home Gateway and controller are not communicating (Failure)
Blinking slowly: Smart Home Gateway and controller are communicating (OK)
OUT1..OUT8 Green OFF: output OFF
ON: output ON
All other states between ON/OFF: LED follows the real % of switching
Page 20|24