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