HomeSeer A2Z-Link Manuel utilisateur

A2Z‐Link

User Manual

Prepared by: Administrator

Date: 5/11/2015

A2ZLink

http://www.homeseer.com

The information contained in this document is subject to change without notice.

This document contains proprietary information which is protected by copyright.

All rights are reserved. No part of this document may be photocopied, reproduced,

or translated to another language without the prior written consent of HomeSeer Technologies LLC.

TableofContents

Chapter1:Welcome 

Chapter2:GettingStarted 

SystemOverview 

Installation 

ManagingZWave 

Chapter3:ASCIIControlInterface 

Control 

Status 

Chapter4:JSONControlInterface 

ControllingwithJSON 

Chapter5:Index 

Getting Started

ASCII Control

Interface

JSON Control

Interface

A2Z‐Link

Online Help

Welcome to the A2Z‐Link online help system. Browse through the help pages by clicking on the icons

below or selecting pages in the table of contents to the left. To quickly find specific product information,

enter search criteria in the search box above and click the search button.

If you're unable to find what

you're looking for in this help

system, try these alternative

resources:

Our Website

Knowledgebase

FAQ

or contact our team:

Email: [email protected]

Phone: 603‐471‐2816

See also

Welcome

ASCII Control Interface

JSON Control Interface

Home>GettingStarted>SystemOverview

System Overview

What is A2Z‐Link?

A2Z‐Link is a hardware module that allows systems to communicate with Z‐Wave devices without any knowledge of Z‐Wave technology. A Z‐Wave

system can be very complex as it comprises many command classes that are used to control specific devices. The A2Z‐Link uses simple "ASCII" or text

commands to control Z‐Wave devices and gather their status. The device supports 2‐way communication, so status may also be maintained. The unit

supports either simple text commands, or more robust JSON for communications. Either or both protocols may be used.

A2Z‐Link Features:

Can Function as either a primary or secondary controller

Supports Replication ﴾send and receive﴿

Supports multiple Z‐Wave networks using multiple units ﴾allows for installation in any size premises, including support for outbuildings﴿

Each unit supports up to 232 Z‐Wave devices

Includes diagnostics for connectivity and network healing ﴾healing is the ability to tell a device that it needs to update its neighbor table, this

is required for proper command routing in the Z‐Wave mesh network﴿

Supports associations for instant status

Supports polling for device status for nodes that do not support associations

Includes Add and Remove functions for Z‐Wave nodes

Provides detailed information for all Z‐Wave nodes, including node capabilities, firmware version, etc.

Supports firmware update class for supported devices

Includes device management web interface for full device control, testing, configuration, scene management, etc.

Includes configurable IP port number for control

Supports simple ASCII command or JSON control protocol

Provides full 2‐Wave control of devices with instant status report

Includes Z‐Wave scene support

Why HomeSeer?

HomeSeer was the first control system company to support Z‐Wave back in 2003. Today, our software is the culmination of more than a decade's

worth of Z‐Wave engineering experience. We work very hard to support new Z‐Wave command classes and products, as they are released; this is a

primary focus for us. Our Z‐Wave inclusion feature employs a robust 'interrogation' process that's designed to uncover and provide support for all

aspects of a product's feature set, including special parameter settings. This allows installers to adjust devices in many ways. Diagnostics features are

also included to provide connectivity testing and network healing functions.

Other technologies

A2Z‐Link can also be used to provide integration with these technologies:

Insteon

UPB ﴾Universal Powerline Bus﴿

X10

Philips Hue

Any other system supported by the HomeSeer control software ﴾contact HomeSeer for details﴿

2.GettingStarted

A2ZLink

See also

Installation

Managing Z‐Wave

Home>GettingStarted>Installation

Installation

Installing A2Z‐Link

The unit connects to the control system via a network connection and all communications are done over IP. Power is applied via the included micro

USB power adapter. The unit will boot up automatically when power is applied; there is no power switch.

1. Apply power and wait approximately 2 minutes. The LED on the unit will flash as the unit starts up.

2. The unit uses DHCP to obtain an IP address, to find the unit on the network, bring up a web browser on any computer that is connected to

the same network. In the URL enter: http://find.homeseer.com

3. Click the Search button. The unit should then be listed; click on the link to connect to the unit.

4. Please refer to the Z‐Wave section of this guide for information on managing Z‐Wave devices.

5. For remote connections, myHomeSeer Remote can also be used. Create an account at http://myhs.homeseer.com. All you need is the license ID

and password printed on the bottom of the unit. Once the account is created, you can log into the unit remotely at

http://myhs.homeseer.com. If myHomSeer Remote is not to be used, it can be disabled from the Network tab in Setup.

See also

System Overview

Managing Z‐Wave

Home>GettingStarted>ManagingZWave

Managing Z‐Wave

New Z‐Wave Installation Using A2Z‐Link

If a Z‐Wave network has not yet been established at the installation site, this may be done with A2Z‐Link. To add Z‐Wave devices, navigate to the

A2Z‐Link web interface, select the "PLUG‐INS" menu, then Z‐Wave, then Controller Management. Expand Z‐Wave Interfaces and select "Add/Include a

Node" from the Actions drop list. A log window will appear with a "Start" button just above it. Progress will be displayed on the screen as well as any

instructions. Click the Start button and then activate the inclusion process on the device you are adding. Typically, this is done by pressing a button

or switch paddle or by following a sequence of steps ﴾as with many door locks﴿. Consult with the manufacturer's documentation for specific steps, if

you encounter problems with this*. A message will display after the device adds successfully. Click the "Close" button to close the log window when

finished.

*Note: If the device was previously added to another network, it will not add to this network until it has been reset. To reset the device follow the

procedure above but select the "Remove/Exclude a Node" function instead of "Add/Include a Node". Once the device has been successfully

removed ﴾reset﴿, you should be able to add it successfully.

GettingStarted.3



A2ZLink

Controller Management "Actions" Menu

Adding A2Z‐Link to Existing Z‐Wave Installations

If the site already has an existing Z‐Wave network a decision will need to be made.

1. If the devices were added using a simple handheld controller, or if the devices were added using a controller that will no longer be used, you

should consider establishing a new network with the A2Z‐Link. This will allow the A2Z‐Link to function as the primary Z‐Wave controller and

you'll have many more Z‐Wave management options available going forward ﴾including replication and optimization functions﴿. To do this,

you'll need to reset ﴾remove﴿ all nodes from the existing network and then establish a new network using A2Z‐Link. Follow the procedure

outlined above.

2. If the existing controller is to remain and ﴾a﴿ you wish to keep it as a primary controller or ﴾b﴿ it cannot function as a secondary controller, then

A2Z‐Link can be added to your existing network as a secondary controller. To make the A2Z‐Link a secondary, the primary controller needs to

be put in Replication Send mode, then select "Receive Network from another Controller" from the Controller Management "Actions" menu in

the A2Z‐Link web interface. Progress information will be displayed. Note that A2Z‐Link cannot perform replication or optimization ﴾healing﴿

functions when operating as a secondary controller.

See also

System Overview

Installation

4.GettingStarted

A2ZLink

Control

Status

Home>ASCIIControlInterface

ASCII Control Interface

Articles in this section

See also

Welcome

Getting Started

JSON Control Interface

Home>ASCIIControlInterface>Control

Control

Connection

Commands are sent over a TCP connection. The connection may remain open, or it may be opened and closed as needed. The default TCP port is port

# 11000. To test, start a Telnet session on a computer connected to the same network as the A2Z‐Link and connect to port 11000. This command is

typically:

telnet ip‐address‐of‐a2zlink 11000

Then enter:

vr[ENTER]

A version # should be returned such as:

3.0.0.127

Connections need to be authorized. In Setup on the Network tab users may be set up. A user with rights Admin or Normal will have access. Guests

will not have access. The connection IP is authorized with the following command:

au,user,pass

If the user is authorized, the command returns "ok". After authorization, commands may be given from the source IP address. To de‐authorize a

connect use the command:

This will remove the source IP address from the this list of authorized IP addresses.

Controlling Devices

The A2Z‐Link abstracts Z‐Wave devices so there is no need to understand the intricacy of the Z‐Wave protocol. When devices are added, the A2Z‐Link

creates virtual devices that represent the functionality of the target device. For example. if a simple Z‐Wave lamp module is added, it will be viewed on

the Device Management web page like:

This virtual device represents the lighting control functionality of the device and shows it can be turned On,Off, and Dimmed. These devices are

controlled with their reference #. A reference # is a unique ID assigned to the device and cannot be changed. Other properties of the device may be

changed as needed, such as the location and name. The reference # is listed in the second column as can be seen above.

ASCIIControlInterface.5



A2ZLink

Devices are controllable by setting their value or label. Each device holds a collection of name/value pairs that represent the available control points.

Control points can be a single value, such as 0 for Off, or a value range such as 1‐98 for a dim level. In the web interface on the device management

page you can click on the name of a device to bring up its properties. Click on the "Status/Graphics" tab to see the available pairs. From here you can

determine how to control the device. You can also issue a command to get the pairs if your control system can deal with that.

Commands are available to retrieve the control information if your control system can support this.

Here is an example of the status pairs for a dimmable light. It can be seen that the possible control values are 0 for Off, 99 for On, 255 for on last

level, and 1‐98 for the dim level.

Commands are issued as simple text strings terminated with a carriage return and linefeed.

Commands are not case sensitive.

Parameters in [] are optional.

The following commands are available for device control:

Command Format Description Example

Control a

device by

value

cv,ref,value

Controls a device by settings its value. All devices have a

collection of name/value pairs that represent controllable parts

of the device, such as On=99 and Off=0. The value is used for

control.

Turn on a light

where the reference

# is 2356 and the

ON value is 99:

cv,2356,99

Control a

device by

label

cl,ref,label

Controls a device using the control label. All devices have a

collection of name/value pairs that represent controllable parts

of the device, such as On=99, and Off=0. The actual label is

used for control.

Turn on a light

where the reference

# is 2356 and the

ON label is On:

cl,2356,On

Retrieving control information

For advanced systems that can dynamically create a user interface, the control information can be obtained. A request may contain a single device

reference #, of, if omitted, control information for all devices is returned.

6.ASCIIControlInterface

A2ZLink

Command Format Description Example

Get control

information gc,[ref]

Returns control information for a given device, all all

devices if the reference # is omitted. The return

format is:

ref,label=value,label=value,...

If the device supports a control point that accepts a

range of values, such as dimming light, the control

pair will be returned as:

PREFIX (value)SUFFIX=FROM->TO

The PREFIX is a label that appears before the value

and the SUFFIX is a label that appears after the

value. The PREFIX and SUFFIX are listed on the

"Status/Graphics" tab in the device properties and

can be changed if needed.

Note: If a label contains a "," it will be escaped and

returned as "\,".

For example, a dimming device

with ref 3755 may have its PREFIX

set to "Dim" and its SUFFIX set to

"%", and the valid values are 1-98,

the return would be:

3755,On=99,Off=0,Dim

(value)%=1->98

See also

Status

Home>ASCIIControlInterface>Status

Status

Please read the Control section first for information on how to connect to the A2Z‐Link and how to format commands.

For more advanced control systems and control systems drivers, you may want to dynamically retrieve the available devices in the system and get their

current status. The following commands can be used to discover all devices, get their current status, and assigned name and location. The A2Z‐Link

allows for 2 location parameters to be set on each device, as well as a device name. This information can be maintained in the A2Z‐Link itself, or left

off and maintained by the controller.

Command Format Description Example

ASCIIControlInterface.7



A2ZLink