Magnocomp magDomus MGD2 Series User manual

.












User Guide

Version, 1.31, Feb.2012
www.magnocomp.com
This User Guide applies to the complete family line of magDomus from magnocomp, including the models:
●MGD2xxx
●MGD300x
●MGD301x

At a Glance
The magnocomp’s magDomus is a light and high flexible equipment that takes care and automates
your home.
The magDomus Home Controller checks and monitors status of all your electric devices and
automatically controls every element according to your life style. If necessary, it even informs you of
what is happening in your home.
The magDomus Home Controller was design with compatibility and interoperability in mind. We
believe our costumers benefit with the freedom to choose the best home automation elements
without the typical restrictions imposed by most technological manufactures. The magDomus Home
Controller can be integrated in most standard home automation networks like X10, Z-Wave, Insteon,
KNX, DLI, ZigBee, and others. Additionally, it can join together several home automation networks,
even with different technologies, by allowing a transparent bridge of events and commands between
networks. By integrating a magDomus controller in your home you can solve all the typical
interoperability problems between different technologies.
The magDomus Home Controller interacts naturally with any device with a personal network, Intranet
or Internet connection. Every family member will be able to check the status of home environments
and to specify both precise and generic requirements to adjust the achieved comfort.
The magDomus home controller is implemented in a thin and low consuming design that allows fast
and clean installation in any targeted environment. Its form factor allows a quick an convenient
installation almost any where.

Fig. 1. Front view
Fig. 2. Rear view
The magDomus can interact with any remote configuration station in the Internet, using its standard
Ethernet port. The magDomus can monitor and control any Home Automation network through
specific adaptor devices.

Fig. 3. magDomus ecosystem

Setup
Install
The magDomus device is intended to be connected to a main power supply, to a communication
network and to one or more home automation networks.
1. Connect the device to the main power supply using the provided transformer and power cord.
Verify that the transformer is compatible in form factor and in electrical specification to the available
power mains standardized in your country. In case of incompatibility please contact your local
magnocomp supplier for a solution.
Fig. 4. Power supply transformer (example)
2. Connect the device to your local Ethernet network using the provided UTP cable with RJ-45
connectors.
Fig. 5. UTP cable with RJ45 connectors
One cable’s end should be connected to the Ethernet port of your magDomus device. The other end
can be connect to any RJ-45 socket from your local network or to an available port in any active

network equipment, like a router or a switch.
The connection to a network is recommended but not strictly required in order to configure and to
operate your equipment. Your device can be configured and operated through a locally attached
computer keyboard.
The connection to the Internet is not required to the basic operation of your equipment. If you
connect your device to local or home network, isolated from the public Internet, you will be able to
access most magDomus functionalities from any locally connected device in your home. Internet
connection is required only for remote access to your device from the Internet.
3. Connect the magDomus device to your home automation network using a specific adaptor device.
Each home automation adaptor must be declared in the “Home Automation” Setup page.
4. Optionaly, you may also connect your magDomus device to a Display using a standard VGA cable
with male connector. This cable may have been included in your display purchase kit or it may be
acquired from any usual supplier. Please verify compatibility with your display when purchasing this
cable.
Fig. 6. Standard VGA cable
The connection to the display is not required to configure or operate the magDomus system. It may
be used to provide an additional interaction station, to operate the magDomus system without a
network connection or for debug proposes.

Configure
The magnocomp’s magDomus can be configured locally, with a directly attached keyboard or through
the friendlier provided Web interface.
Accessing the configuration Web interface
When connected to a network, the brand new magDomus device will try to obtain a valid IP address
from the network using DHCP (Dynamic Host Configuration Protocol). If there are no DCHP servers in
the attached network, or if the magDomus device cannot get a valid address within 60 seconds, it will
self configure its network interface with the default parameters:
Parameter
Default Value
IP Address
192.168.1.111
Net Mask
255.255.0.0
Gateway
none
You can use this default configuration parameters to implement a start-up haddock network
connecting your magDomus device directly to a computer. Use a standard network cable with RJ45
connectors and crossover connections.
If you connect your magDomus device to a network with DHCP services, you can try to find the IP
address given to your device using the management interface of your router or DHCP server.
When you know the IP address of your magDomus device you are ready to access its configuration
interface by pointing a standard Web browser to it. Just write the known IP address in the URL field of
your browser.

Device collector
The magnocomp’s device collector can help you finding your device in cases when you don't know its
IP address due to:
●You are using a local network where addresses are assign dynamically by a DHCP server (case
1), and/or
●You are trying to access from an external network to your device located in a private network
and the public address of the NAT gateway is dynamically assigned by the ISP’s DHCP server
(case 2).
Please note that if you are trying to connect from the outside to private network (case 2), even
though you already know or you can find the public address of the networks gateway, you may need a
specific permission and static route in your NAT gateway. Read section “Connecting from the
outside”.
Finding you device
Using a computer or any other Web enabled device, point your Internet browser to the devices
announcement collector in the magnocomp site:
http://www.magnocomp.com/device/find.php
This list presents collected recent announces from magnocomp's devices at your location.
The ability to announce itself to the magnocomp's devices collector is enable by default in every
device and can be disabled using the setup interface.
Only devices that share the public address with the requester are considered.
This list is only provided to Web clients located in the same private network as the considered
devices.
This information is provided only for device identification and setup and cannot be used in any other
intention.

Client Setup
Dependingonyourprevioussecuritysetting,youmayneedtoenteraadministratorpasswordto
accessthemagDomussetuppage.Thefactorydefaultadministratorcredentialsare:


User
admin
Password
admin

Bysubmittingadministratorcredentials,youshouldberedirectedtothemagDomusSetup
page:
magDomusSetup
● HomeAutomation
● Network
● AccessControl
● DateandTime
● Scheduler
● Rebootdevice
● UserManual
●magnocompWebPortal


Network Setup
To configure the network connection select the option “Network” in the configuration application.
The following network parameters can be defined:
DHCP
Use the Dynamic Host Configuration Protocol (DHCP).
Enter Yes to allow the device to request for an IP address and other
network parameters each time its starts up.
Enter No to specify a fixed IP address and the other parameters.
Name
The device name.
This name identifies the device inside the domain.

A local network should not include two magDomus devices with
the same name.
This name must start with a letter and the other characters can
include letters or numeric characters. Spaces are not allowed.
IP address
The device IP (IPv4) address. This is not required when using DHCP.
NetMask
The network mask. This is not required when using DHCP.
Gateway
The local address of the network gateway. This is the internal
address of the router or equipment that connects the internal
network to the Internet. This is not required when using DHCP.
DNS1
DNS2
Addresses for the Domain Name Servers. These are not required
when using DHCP.
After adjusting the parameters according to requirements, press the Save button to store the
network parameters or the Discard button to leave parameters unchanged.
Access Control
You can adjust the security setting using the the option “Access Control” in the magDomus Setup
page.
Fig. 7. The Access Control setup window

After adjusting the parameters according to requirements, press the Save button to store the security
parameters or the Discard button to leave parameters unchanged..
Date and Time
Each magDomus device maintains a internal clock. This clock keeps running even when the device is
switched off or unplugged from the main power.
You can adjust manually the date and time of internal clock using the the option “Date and Time” in
the configuration application. In order to allow the device to synchronize its clock from an external
source, it is preferably to use the Network Time Protocol (NTP).
Fig. 7. The Date and Time setup window
NTP requires that the specified NTP servers are reachable through the defined network. This usually
implies a permanent Internet connection.
When using NTP, it is not necessary to adjust the device clock in any circumstances.
After adjusting the parameters according to requirements, press the Save button to store the date
and time parameters or the Cancel button to leave parameters unchanged..

Home Automation
Fig. 8. The Home Automation setup window
After adjusting the parameters according to requirements, press the Save button to store the
network parameters or the Cancel button to leave parameters unchanged..
Scheduler
You can adjust the scheduler setting using the the option “Scheduler” in the magDomus Setup page.
Fig. 9. The scheduler setup window

Minute
The minute when the event will be triggered.
You can specify :
●a integer number (00-59)
●a set of comma separated integer numbers
●a ‘*’ character to indicate every minute.
Hour
The hour when the event will be triggered.
You can specify :
●a integer number (00-23)
●a set of comma separated integer numbers
●a ‘*’ character to indicate every hour.
Day
The day of month when the event will be triggered.
You can specify :
●a integer number (1-31)
●a set of comma separated integer numbers
●a ‘*’ character to indicate every day.
Month
The month when the event will be triggered.
You can specify :
●a integer number (1-12)
●a set of comma separated integer numbers
●a ‘*’ character to indicate every month.
WeekDay
The day of week when the event will be triggered.
You can specify :
●a integer number (0-7). ‘0’ means Sunday and ‘7’ means
Saturday.
●a set of comma separated integer numbers
●a ‘*’ character to indicate every day.
Command
Addresses for the Domain Name Servers. These are not required
when using DHCP.
Examples:
Turn on X10 unit H7 five minutes after midnight, every day:
5 0 * * * magdom ON XH7
Turn off Z-Wave unit 003 at 2:15pm on the first day of every month
15 14 1 * * $magdom OFF Z003
Since the magDomus scheduler is build on top of cron, you can refer to the crontab documentation for other
option and advanced use.

After adjusting the parameters according to requirements, press the Save button to store the
scheduler parameters or the Cancel button to leave parameters unchanged. If you need to enter
several rules, you must save each one before proceeding to the next.
magDomus Cloud
Your magDomus can be operated directly, or through the magDomus Control Panel hosted over the
magnocomp’s Internet cloud infra-structure (ControlCloud). Please refer to the section Client Setup
to select the desired configuration for your magDomus Client.
The magDomus Control Cloud can be accessed by following the URL:
http://www.magnocomp.com/magdomus
or by using the presented QR-Code:
Fig. 7. QR-code

Control Panel
The picture presents the screen layout for the magDomus control panel. In the left panel you can
select a home automation unit to display and control. The right panel presents the state of the
selected unit (when available) and allows its interactive control.
Fig. 8. Control Panel
The general information about the script presented in the left panel includes the parameters:
Name
The unit’s name.
This name identifies the the unit inside your home.
One magDomus controller can not include two units with the same
name.
This name must start with a letter and the other characters can
include letters or numeric characters. Spaces are not allowed.
Room
The room where the unit is located.
State
The recent state of the unit. This state can only be known for units
that report state changes and answer state queries. Some home

automation networks do not implement state queries.
Z
The Z field is usually used to store the unit height coordinate or the
floor where the unit is located.

Specs
Platform
EB6010
Software
magnocomp 3.x
Operating System
magBoxLinux
Configuration
USB flashdisk download, FTP, Embbeded Web Server
Internal Clock
Autonomous.
Sincronization using NTP (requires network connection)
Security
Password protected for both user and admin.
Remote workstation control.

Legal Information
This user guide is published by magnocomp or its local affiliated company, without any warranty.
Improvements and changes to this user guide necessitated by typographical errors, inaccuracies of
current information, or improvements to programs and/or equipment, may be made by magnocomp
at any time and without notice. Such changes will, however, be incorporated into new editions of this
user guide.
All illustrations are for illustration only and may not accurately depict the actual device or service.
All rights reserved
@ magnocomp.com SA, 2011
Publication number: 2033-5807-1108

PleasereadthefollowingImportantinformationbefore
youuseyourdevice.
Your magDomus device has the capability to download, store, forward and present additional
content, e.g. pages, images and documents. The use of such content may be restricted or prohibited
by rights of third parties, including but not limited to restriction under applicable copyright laws. You,
and not magnocomp, are entirely responsible for additional content that you download to, forward
from or present using your magDomus device. Prior to your use of any additional content, please
verify that your intended use is properly licensed or is otherwise authorized. magnocomp does not
guarantee the accuracy, integrity or quality of any additional content or any other third party content.
Under no circumstances will magnocomp be liable in any way for your improper use of additional
content or other third party content.
Registeredtrademarks
Bluetooth is a trademark or a registered trademark of Bluetooth SIG Inc. and any use of such mark is under
license.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
Wi-Fi is a trademark or a registered trademark of the Wi-Fi Alliance.
Java, JavaScript and Java-based trademarks and logos are trademarks or registered trademarks of Sun
Microsystems, Inc. in the U.S. and other countries.
Other product and company names mentioned herein may be the trademarks of their respective owners.
Open Source Software
Some software components of this product incorporate source code covered under GNU General Public License
(GPL), GNU Lesser General Public License (LGPL), OpenSSL License, BSD License and other open source licenses. To
obtain the source code covered under the open source licenses, please visit:
http://www.magnocomp.com/opensource/
Any rights not expressly granted herein are reserved.