Manufacturer:Fibaro
Model Number(s):Home Center 3 Series
Control Platform:RTI
Integration Designer Version:11
Driver Developer:Intrinsic Dev, Part of Intrinsic Group Limited
Document Revision Date:20th November 2023

> Overview

This driver allows an RTI system to communicate with Fibaro Home Center 3 for full control and feedback of up to 64 lighting devices.

> Supported features

The Driver splits the connected devices into 4 categories:

Relay

Dimmer

RGB

Shutter

Commands:

Relay, Dimmer, RGB -

On

Off

Dimmer, RGB – (above plus: )

Brightness

RGB – (above plus: )

Hue

Saturation

Value

WarmWhite

HSV Preset

Shutter -

Open

Close

Stop

Variables:

Relay, Dimmer, RGB -

Name [STRING]

Power State [BOOLEAN]

Dimmer, RGB – (above plus: )

Brightness (min=0, max=100) [INTEGER]

RGB – (above plus: )

[INTEGERS]

Hue (min=0, max=360)

Saturation (min=0, max=100)

Value (min=0, max=100)

Red (min=0, max=255)

Green (min=0, max=255)

Blue (min=0, max=255)

Warm White (min=0, max=255)

Shutter –

Name [STRING]

State [STRING]

Level (min=0, max=100) [INTEGER]

Events:

Relay, Dimmer, RGB -

Power State Changed

Dimmer, RGB – (above plus: )

Brightness Changed

RGB – (above plus: )

Colour Changed

Shutter –

Level Changed

Open

Closed

> ButtonTags

Commands:

Relay [1-16] On

Relay [1-16] Off

Dimmer [1-16] On

Dimmer [1-16] Off

Dimmer [1-16] Set Brightness

RGB [1-16] On

RGB [1-16] Off

RGB [1-16] Set Brightness

RGB [1-16] Set Hue

RGB [1-16] Set Saturation

RGB [1-16] Set Value

RGB [1-16] Set WarmWhite

RGB [1-16] HSV Preset

Shutter [1-16] Open

Shutter [1-16] Close

Shutter [1-16] Stop

Variables:

Relay [1-16] Name

Relay [1-16] State

Dimmer [1-16] Name

Dimmer [1-16] State

Dimmer [1-16] Brightness

RGB [1-16] Name

RGB [1-16] State

RGB [1-16] Brightness

RGB [1-16] Hue

RGB [1-16] Saturation

RGB [1-16] Value

RGB [1-16] Red

RGB [1-16] Green

RGB [1-16] Blue

RGB [1-16] WarmWhite

Shutter [1-16] Name

Shutter [1-16] State

Shutter [1-16] Level

Any feature not specifically noted as supported should be assumed to be unsupported.

> Driver support

This driver is fully supported via our online ticketing system. If you require assistance with this driver please submit a support request at www.intrinsicdev.com/support.

> Continued dealer support

Intrinsic Dev offer free licence keys for showrooms and dealers’ own homes. To obtain your free licence keys simply drop us a support ticket. All of our drivers/modules are fully supported by our online ticketing system.

> Disclaimer

Intrinsic Dev’s drivers are created to the highest standard developed with industry leading practices.

By installing this driver, you agree to our full Terms and Conditions, a copy of which can be found at the end of this document.

> Driver licence

This driver requires a licence to function. Pricing and licences can be obtained by visiting https://www.intrinsicdev.com/. Licences are issued on a per controller basis. You only need a single licence for multiple installations on the same controller.

This driver is powered by the Intrinsic(Athena) cloud and will auto detect if you have purchased a license for your systems MAC address.

If you have not already purchased a license it will show an error. Please navigate to www.intrinsicdev.com to rectify and within a few minutes of order completion the driver will update and activate. You do not need to enter any information manually or make changes to the driver.

> Driver configuration

Ensure you have downloaded the latest version of the driver from: https://www.intrinsicdev.com/

> Device setup

Add and set up devices as described in the Fibaro web interface. The Fibaro system should be fully functional and tested before attempting integration into an RTI system.

A static IP address is required. Please use your router to set a reserved DHCP address for the Fibaro Home Center.

> Configuration Process

1. Download the latest version of the driver from www.intrinsicdev.com

2. Place the .rtidriver file in your designated custom driver directory. This can be identified in Apex by clicking Options > Set Directories.

3. Import the driver into your project.

4. In Driver Properties:

a) Connection - Enter IP Address of Home Center.

- Enter Username and Password. Default set as ‘admin’ for both fields.

b) Management Port – Set a port number for the Driver Web interface to show devices on network via server hosted on the RTI processor.

c) Import Device Names from Fibaro – Toggle On to allow driver to use device names set in Fibaro Dashboard / App or Off if you wish to set new custom names in your Integration Designer project.

5. Send the configuration to the processor.

6. Open a web browser and enter the IP Address of your RTI processor followed by a colon and the Management Port number, e.g. 192.168.10.101:9130. Allow a few minutes (depending on number of devices) for the driver to start and to process all Fibaro lighting devices on the network. Keep refreshing the web page until all expected devices are visible and allocated to their device type table.

7. Driver Properties - Number of Devices:

Using the driver web management page as a guide, use the dropdowns to select how many devices there are for each device type. Device input fields will populate below.

Number of Devices can be set to 0 to hide from project completely if not in use.

8. Copy the ID from the Management Port web page and paste into the corresponding ID field.

a) If Import Device Names from Fibaro has NOT been enabled, use the name fields below the ID input fields to enter a device name. These names will be displayed via the Name text variable and used throughout the Integration Designer project.

9. You can now move onto setting up your UI.

The attached FibaroHC3-Example.apex file contains a fully configured UI (Virtual Panel) for 2 Relay Devices, 1 Dimmer Device, 1 RGB Device and 1 Shutter Device.

3 Images for the Hue, Saturation and Value sliders have also been included:

HUE360Colours.jpg

Saturaion.jpg

Value.jpg

Debug – Install the XP Diagnostics driver. Enter processor IP Address into browser. Set “Driver – FibaroHC3” to High and Save Level.

> Command Behaviors:

Temporary Level Storage -

At Start up, all levels / sliders for Dimmer and RGB will be at 0 (unless device is on) until either a Power On command or a Set Level command is sent.

If Power On is sent, the levels will be set and stored after the next poll (every 15 seconds).

If Power Off is then sent, the current level set will persist and not return to 0. This allows the user to see what level the device will turn on at upon the next firing of Power On.

Alternatively, If a Set Level command is sent the new level will be stored until the next change.

If the device is turned off via another source (other than this RTI driver), brightness levels will be reset to ‘0’ after the next poll has completed (every 15 seconds) and stored levels will be reset until set again upon the next command sent via this driver.

General -

If Brightness on any applicable device type is set to 0, device will turn Off.

Shutter [1-16] State will display “Opening” and “Closing” after a Open or Close command is sent until next poll is complete – max 15 Seconds.

RGB Devices - WarmWhite, Brightness, Hue, Saturation, Value and Red, Green, Blue variables are connected, so expect to see adjustments to the levels of these colour variables after the completion of the next poll if changes to one or more of them have been made in quick succession.

Red, Green and Blue variables are for display only, their levels cannot be controlled directly, only HSV control. ‘255’ may be displayed instead of ‘0’.

Saturation and Value cannot be set to 0. If accidentally set, driver will correct to ‘1’.

Value produces same effect as Brightness for RGB devices.

Fibaro resets brightness and shutter level from ‘100’ to ‘99’. Not noticeable via a slider, but noticeable if displaying level integer as text. - If 100 is sent, after next poll completes, level will change to ‘99’.

If Import Device Names from Fibaro is true – if device names are changed via Fibaro Dashboard / App, device name variables across driver will update after following poll (15 seconds).

Device Names pulled from Fibaro cannot be used across Integration Designer programming as identifiers. Devices will be identified via Type and number e.g. ‘Relay 1’.

If Custom names are required to aid programming set-up in a big project but you wish to use same names from Fibaro, disable Import Names and copy and paste names from Web Management page into Device Names input fields.

> Integration Designer11

There are multiple ways to map the features from this driver to a Controller, we recommend using the Tag Browser technique.

> Tag Browser

Tag Browser shows all tags - commands and variables provided by the driver under Source. Using the Filter, the tags can be organised by Macro, Variable and Text and then dragged to a button, automatically assigning the function or variable. Only Tags for Devices added via Driver Properties – Number of Devices will appear.

The Green highlight and tick will show depending on the page that is currently selected. For this image example the page selected is Fibaro – Circuits.

This list also includes custom tags that have been manually created inside this Integration Designer project for Colour Presets – “Coral”, “Crimson” etc.. and for Sliders.

> Tag Field

Another technique is to use the Tag input field. Create and select a button, enter the custom Tag into the Tag input field located at the bottom of the Integration Designer window and the command will be mapped. Tags listed at top of this document.

Text Variables can NOT be mapped this way.

See section > Manual Text Variable Mapping

> Macro List

Another technique is to add a macro via the Macro List, drag Command across from Macro Steps to the Tag Editor area, click <select a device> and select FibaroHC3, you can now select the functions provided via the driver.

e.g.

“Command – FibaroHC3 – [01] RGB 1 \ Off”.

Finally, enter the name of the Macro you created into the Tag input field to map a command to a selected button.

> Manual Text Variable Mapping:

To manually map a text variable provided by the driver –

Create a button

Right click – Edit Text...

Select the Insert Control Variable icon.

Select FibaroHC3 – The number of devices listed depends on Number of Devices set in Driver Properties.

Select desired Text variable

Placeholder sample text has been programmed to text and integer variables to help with UI design layout.

Boolean variables can be used as text. After adding the variable select the blue ‘{var}’ within the Edit Button Text window, here you could change True / False to be On / Off.

> Manual Toggle:

To achieve the dynamic UI design of toggling ON / OFF buttons:

Add the 2 buttons. Assign them both with their driver command.

For the “Off” button assign the Power State variable to Visible.

Right click the “Off” button – Button Properties – select Reversed. A quick solution to visually distinguish the buttons from each other.

Stack the “Off” button on top of “On”.

After pressing “On”, the state will change so “Off” will appear in its place (on top) acting as a toggle.

> Using Slider

Commands that can take a range of integer values (from a min to max) can be mapped to sliders. By default, the tags of the commands have been programmed to enable quick mapping to buttons (to act as a preset button) and not for slider mapping, therefore manual programming for creating a Slider is required.

Add the slider to the UI. Corners can be dragged to change it from horizontal to vertical.

Create a new Tag for the Slider, e.g. “RGB 1 Set WarmWhite SLIDER”.

In Tag Editor assign an Integer variable to Value. Check Minimum and Maximum under Graph Scale are correct, they have been programmed to match the variables’ min and max.

If Slider is behaving unexpectedly, un-select automatic and add the exact number of steps between min and max. (See [INTEGER] info section for each device min and max values).

Assign the Command. After clicking the 3 dots the Driver Command window appears.

Click the button to the right of ‘Not Set’ – Click FibaroHC3 and select the device and then command. Optionally, you can use the checkbox Sustain – recommended level Minimum 1000ms.

Note – You do NOT need to assign the Command as a Macro command in Tag Editor on the Slider element.

> Using HSV Preset

After adding a button to the panel, enter the Tag “RGB [1-16] HSV Preset”.

The 3 integer input values are (from left to right) Hue (0-360), Saturation (0-100), Value (0-100).

Only 1 instance of this Tag is available for mapping per device, [1-16], which could be used as a ‘Favourite’ button.

If you require more uses of the HSV Preset command, additional Tags must be created with the following manual programming:

Add a button to the panel,

Enter a new Tag. For example, we have used colour names.

Enter values for the 3 integer inputs. Hue (0-360), Saturation (0-100), Value (0-100).

Upon clicking the ‘+’ icon to the right of ‘command’ you will see labels for the 3 integer inputs.

> Troubleshooting

Check IDs entered in Driver Properties match IDs displayed in Management Port web page.

If devices are removed from the network or new are added, re-send the driver to the processor and follow configuration steps again.> Terms and Conditions

This page gives you all the information you need to know about Intrinsic Dev and the legal Terms and Conditions through which we sell the software listed on our website to you. These Terms apply to any contract of sale for products that exists between us and you.

Please read these Terms and Conditions carefully, if you do not agree with something written within them do not use our website or install our software. Before completing your purchase you will be asked to confirm you have read and understood these Terms, unfortunately if you refuse our Terms you will be unable to complete a transaction on our website.

We recommend you print a copy of our Terms and Conditions or save them to your computer so you can refer to them in the future as necessary.

We reserve the right to change these Terms and Conditions and recommend you read through them each time you use our site to ensure you understand how they apply to you.

These Terms, and any contract that exists between us, are in the English language only.

1. About Us

1.1 Intrinsic Dev is a trading name of Intrinsic Group Limited. Our registered office address is 9 Dicconson Terrace, Lytham, Lytham St Annes, FY8 5JY. Our trading address for all non-financial correspondence is The Maltings, Allendale, NE47 9EE.

1.2 Intrinsic Group Limited is registered in England and Wales under company number 09659256.

1.3 Contacting us:

1.3.1 To discuss a contract with us in accordance with your legal rights please simply contact us with your query. You can contact us by email at info@intrinsicdev.co.uk

1.3.2 To contact us for any other reason please submit a helpdesk ticket online as this is the quickest way to get in touch. Alternatively you can email info@intrinsicdev.co.uk but please note tech support cannot be contacted in any way other than the online helpdesk. You can also use the form on the Contact Us page.

1.3.3 If we need to contact you in regards to the contract that exists between us we will do so using the information you provided when placing the order, usually by phone or email.

1.4 Intrinsic Group Limited is a member of CEDIA. CEDIA is the international trade association and central touch point for over 3,700 member companies worldwide who design, manufacture, and install technology for the home.

2. Our Products

2.1 We make every effort to ensure we provide you with accurate information on our software. If you believe we have misrepresented the functionality of a driver or module please contact us as set out in section 1.3.

2.2 Images on our website are for illustrative purposes only. Our drivers are only available as instant downloads and not available in any hard format.

2.3 Our software is licensed to you, not sold to you. All of our software is available to download free of charge but will require licensing to function. All products that are offered for sale on this website are licenses for the automation controller specified at the time of purchase.

2.3.1 Obtaining a license key from Intrinsic Dev grants you a non-exclusive, non-transferable, limited and revocable license to install and use the specified software on a device owned or managed by you or your organization. The number of license installations may not exceed the total number of licenses you purchased for the software.

2.3.2 This license applies only to the applicable driver/module purchased and any updates that supplement the original driver/module.

2.3.3 Intrinsic Dev's software is licensed, not sold, to you and Intrinsic Dev retains ownership of all copies even after installation on your device.

2.3.4 This license is valid only for the specific system identified at the time the license was purchased and cannot be resold or transferred by you on to any other system. Under exceptional circumstances Intrinsic Group Ltd may grant authorization to transfer an existing license to a new system but maintains the right to charge an administrative fee for this service as well as the right to refuse authorization at Intrinsic Group Limited's sole discretion.

2.3.5 Intrinsic Group Limited may transfer its rights and obligations, or sub-contract or sub-license to another legal entity, provided your consumer rights are not prejudiced.

2.4 All software written by Intrinsic Dev remains the property of Intrinsic Group Limited. This software is the intellectual property of Intrinsic Group Limited, and is protected by law, including English and International copyright laws.

2.5 You may not decrypt, reverse engineer, modify, translate, disassemble or decompile any of Intrinsic Dev's drivers/modules in whole or in part. Any modifications will immediately terminate all licenses held and full compensation for any and all infringements will be sought.

2.6 Intrinsic Dev reserve the right to withdraw a module/driver from sale at any time and for any reason, including, for example, if the equipment for which the driver/module is written is discontinued or substantially modified.

2.7 Intrinsic Dev carry out extensive BETA testing on all our software. Software that remains in BETA will not be offered for sale on this website. Our BETA testing scheme is covered by separate Terms, but in signing up to this scheme you consent to also abide by these Terms and Conditions. All BETA software remains the property of Intrinsic Dev and is covered by confidentiality agreements. This software must not be abused in any way as per section 2.5 and all discussions and findings during the testing phase are to remain confidential. Intrinsic Group Limited reserve the right to revoke BETA testing privileges at any time.

3. Use of our website

3.1 Your use of our site is governed by these Terms and our Privacy Policy. Please ensure you read these documents fully so you are aware of all Terms that apply to you.

3.2 You must be over 18 to purchase from this website.

3.3 You are responsible for ensuring that your account details and passwords remain confidential when using our website and agree to accept responsibility for all activities that occur under your account and password.

3.4 Please ensure you provide us with details that are complete and correct when setting up your account or placing an order. We cannot be held responsible for any delays or losses suffered due to incorrect information being supplied.

3.5 We will endeavor to provide you with uninterrupted, error free access to our website, however due to the nature of the internet this cannot always be guaranteed. On rare occasions your access may be restricted or interrupted to allow updates, upgrades or repairs; we will endeavor to carry out such tasks in the shortest time possible.

4. Our Contract with you

4.1 All Intrinsic Dev drivers/modules are designed to be used by qualified system integrators for the relevant control platform. When obtaining a license to use our software (whether free or purchased) you are confirming your status as above. We regret we only sell B2B and cannot license our software to end consumers. If you are the owner of a system and you believe you require our software please contact your system integrator to obtain a license and carry out the applicable integration work on your behalf.

4.2 Our drivers/modules are all available for instant download free of charge, you do not need an account with Intrinsic Dev to download a driver. The majority of our drivers require license keys to activate, you do need an account to obtain a license key. To obtain a license key (whether for a free or chargeable driver) simply add the relevant driver(s) to your basket and follow the checkout procedure online. Please check you have provided us with all the correct information before completing the transaction. Please note we do not accept purchases or provide license keys by phone or email.

4.3 When you place an order to purchase a license key from Intrinsic Dev you will be sent a confirmation email to confirm we have received your order. Please check through this email and notify us if anything is incorrect.

4.4 A contract between you and Intrinsic Dev exists only once you have received your license key, usually contained within the confirmation email.

4.5 Intrinsic Group Limited will deem this contract null and void in the event a license is used in any way that can be deemed harmful, including, but not limited to attempts to decrypt, reverse engineer, modify, translate, disassemble or decompile a driver/module, or the use of a license on a system not specified for at the time of purchase.

5. Payment

5.1 We accept all major credit or debit cards excluding American Express. Payment is taken immediately by our online payment provider Stripe. Stripe offers a secure payment gateway for online credit and debit card processing. All card numbers processed by Stripe are encrypted on disk with AES-256. Decryption keys are stored on separate machines. Stripe's infrastructure for storing, decrypting, and transmitting card numbers runs in separate hosting infrastructure, and doesn't share any credentials with Stripe's primary services.

5.2 Do not email your card details. We accept no responsibility if you provide us with your details in this way.

5.3 Card fraud is illegal and will always lead to prosecution. Every transaction taken is subject to fraud checks performed by Stripe; if we believe the risk of fraud is present on a transaction we reserve the right to cancel the order with immediate effect and without correspondence.

5.5 The Intrinsic Dev website is fully PCI Compliant. Stripe has been audited by a PCI-certified auditor and is certified to PCI Service Provider Level 1. This is the most stringent level of certification available in the payments industry. To accomplish this, Stripe make use of best-in-class security tools and practices to maintain a high level of security.

6. Delivery

6.1 There are no delivery charges for any of the products listed for sale on this website. All software is available to download instantly, free of charge. All license keys are automatically emailed upon receipt of applicable payment.

6.2 Our drivers/modules are not available in any hard format

6.3 License keys are emailed to the address given during the checkout process. Please check you spam folder if you have not received your license and allow up to 12 hours before contacting us regarding a missing license key.

6.4 We recommend reading the integration notes for each driver before attempting installation.

7. Refunds and Warranty

7.1 We do not offer refunds on our licensing. If you have made a mistake during your purchase or have another legitimate reason for requiring a refund please contact us as set out above in 1.3. Refunds may be offered within 7 working days in some circumstances, but please note no refunds will be considered if the driver/module has already been installed onto the relevant control platform.

7.2 Whilst every care is taken to ensure the thorough testing of our drivers, you should always carry out your own tests before first use. You agree not to hold Intrinsic Group Limited or any related party, liable for any issues or loss arising from the installation of our drivers/modules.

7.3 Our software is provided "as is" and "as available", without express or implied warranty or condition of any kind to the maximum extent permitted by law. We disclaim any warranty that our drivers/modules will meet your requirements or will be constantly available, uninterrupted, timely, secure, or error-free; the results obtained from the use of our drivers/modules will be effective, accurate, or reliable; the quality of the software will meet your expectations; or any errors or defects in the software will be corrected.

7.4 Intrinsic Group Limited specifically disclaim all liability for any actions resulting from your use of our software. You use our software at your own discretion and risk, and you are solely responsible for any damage to computer systems/control platforms, loss of data or loss of profits that results from the use of our software.

7.5 Our software is written and tested on the most recent version of 3rd Party platforms available at the time of release. Intrinsic Group Limited make no assurances of stability of any untested updates that may be released subsequently as all 3rd Party developments are beyond our control. Where an updated driver becomes available this can be downloaded from our website or from within your purchase history. Whilst we make every effort to keep all drivers/modules up to date we disclaim any obligation to do so.

8. Pricing

8.1 We make every effort to maintain the prices shown on our Website, however we reserve the right to discontinue drivers or to amend prices when necessary.

8.2 All prices exclude VAT (where applicable)

8.3 Our pricing originates in £ sterling, we make use of live currency exchange rates to automatically calculate pricing for alternative currencies. The rate used is beyond our control.

9. Support

9.1 We offer comprehensive support for our drivers/modules via an online ticket system. All support queries must be submitted through this ticket system. Any attempt to by-pass this system or to misrepresent priority levels will result in delays.

9.2 Intrinsic Dev offer paid for Remote Support packages for support that falls outside of standard driver queries, including, but not limited to, driver installation, wider system integration/programming and system design.

9.3 All drivers/modules written by Intrinsic Group Limited that require the purchase of a license key are fully supported for as long as they are listed on the Intrinsic Dev site.

9.4 We reserve the right to withdraw licensing and remove download links for a driver/module, thereby discontinuing on-going support at any time and for any reason. This includes, for example, if the equipment for which the driver/module is written is discontinued or substantially modified. The remainder of your rights and obligations pursuant to this license will not be affected should support be discontinued.

10. Other Terms

10.1 This contract is between you and us, no other person has the right to enforce these Terms.

10.2 Each of the paragraphs in these Terms operate separately. If any court or relevant authority deems any of them are unenforceable the remaining paragraphs remain in force and in effect.

10.3 The name Intrinsic Dev and Intrinsic Group, and associated logos are protected under UK copyright laws. The contents of this website, including (but not limited to) downloadable content, imagery and text may not be copied, reproduced, replicated, sold, downloaded or distributed by any means to third parties without the express consent of Intrinsic Group Limited.

10.4 The content of Intrinsic Dev and its Third Party associates are protected by copyright and database laws. You may not extract or use any content (in part or entirety) of the website without express written consent of the owners.

10.5 You must not use this website in any way that causes damage or impairment to the site or company of Intrinsic Group Limited or any other persons. Unlawful and fraudulent activity will be prosecuted.

10.6 The content contained on this website is for information purposes only. Intrinsic Dev (whether written on the website, through the helpdesk, via email or verbally) are not providing any recommendations or endorsements to any Third Party solutions, software or products. The material on this website does not constitute advice and you should not use the information on the website whilst making any decisions.

10.7 We accept no responsibility for the content of websites that are linked to Intrinsic Dev and do not necessarily endorse the material contained within these external websites. These links are provided for convenience only.

11. Contact Details

Intrinsic Dev, The Maltings, Allendale, NE47 9EE, UNITED KINGDOM

Email: info@intrinsicdev.co.uk

VAT Registration Number: 298 2167 63

Intrinsic Dev is a trading name of Intrinsic Group Limited.

Company Reg Number: 09659256