First Steps with FS20 configuration

  • Platform information:
    • Hardware: Intel i5, 8GB,1TB
    • OS: Windows 10
    • Java Runtime Environment: unknown, but its from 2017
    • openHAB version: 2.2

Hey guys,
I’ve been reading a lot in your community but I’am really confused about the configuration now.

Current state: Some FS20 components and Somfy RTS Window shutters and Warema EWFS in the wintergarden.

Future plans if the first steps work fine: Homematic in some other rooms, MAX! for the heating radiators.

So I’ve set up openHAB2.2 on Windows. This is working fine (icloud binding, astro binding, weather binding). Now I’m about to order a nanoCUL 868 to start controlling the FS20 components. As far as I know the FS20 binding is for OH1 (1.10.0) so the configuration has to be done by hand. I’ve created the fs20.cfg with the following content:


and used SmartHome Designer for creating FS20.things with:


and for fs20.items

Switch  Garden2 "Garten2 Schalter"  { fs20="C04B10" }
Switch  Garden3 "Garten3 Schalter"  { fs20="C04B11" }
Switch  Garden4 "Garten4 Schalter"  { fs20="C04B20" }
Switch  Garden5 "Garten5 Schalter"  { fs20="C04B11" }
Switch  Garden6 "Garten6 Schalter"  { fs20="C04B12" }
Switch  Garden7 "Garten7 Schalter"  { fs20="C04B22" }

So the HEX-Code is just a placeholder.

Am I right after ordering the nanoCUL 868 I just plug it to the USB of the Windows 10 Computer and install a driver to use it with OH?
I think this:
is for unix systems. How do i get the path for windows? Do I need a fs20.cfg in /conf/services oder just a fs20.things in /conf/things?

Would be nice if you can give me some advise and I can start beeing part of the OH-Community. Iam just a student and it would be mad if i spend the money for the nanoCUL (even if its just 35€) and it does not work. :slight_smile:

Best regards,

nanoCUL and FS20 / FHT is a frustrating combination.
It does not work… Something is different to a original Busware CUL.
With a Busware CUL my setup works as it should.
With my nanoCUL (working perfect with FHEM!) it doesnt.
Only if it deinstall install reconfig all with no sytem and logic the bindings
it starts working until next reboot. Then the mess starts again.
If it starts it is working reliable!
So save money and buy for working config a Busware CUL
The firmware of my nanoCUL is 1.67. The Busware is 1.67 too…
I have tried many combinations of Binding Versions for Cul transport serial fht fs20 (1.10, 1.11 and snapshot Version 1.12)
I have no problem with the access of the USB port. I have a symlink in rules defined. So it is sure that OpenHab get access to the correct port
The setup that doesnt work generates no error in any log file and log debug in karafe shows no errors

Windows will list the device as COM device. Have a look at the device manager to find the corresponding number


Put the fs20.cfg file only here: /services
You will find that path if you connect the OpenHab Server via SMB over network
SMB should be installed and enabled already out of the box

So, today my original! Busware CUL V3 was delivered.
I’ve pluged it to the USB Port and was trying to install the driver delivered with DFU-Programmer and Windows 10 said the best driver is already installed.

Then I converted my FS20 Housecode and added the livingroom, the content of my fs20.items:

Switch  Kueche "Kueche Schalter"  { fs20="2D780F" }

and the Code in my fs20.cfg in conf/services


I’ve deleted the fs20.things.

Now I’ve configured a Switch in HabPanel with the “Kueche Schalter”. If I touch it on my phone the CUL does one or two extra blinks of the green led.

So it doesn’t work, do you can see my failure?
Best regards,

What does the log say?

Do you mean the openhab.log?
It says the following:

2018-02-23 13:50:05.783 [INFO ] [er.internal.HomeBuilderDashboardTile] - Started Home Builder at /homebuilder
2018-02-23 13:50:07.265 [INFO ] [.dashboard.internal.DashboardService] - Started dashboard at
2018-02-23 13:50:07.266 [INFO ] [.dashboard.internal.DashboardService] - Started dashboard at
2018-02-23 13:50:11.231 [INFO ] [el.core.internal.ModelRepositoryImpl] - Loading model 'fs20.items'
2018-02-23 13:50:12.581 [INFO ] [thome.model.lsp.internal.ModelServer] - Started Language Server Protocol (LSP) service on port 5007
2018-02-23 13:50:13.655 [INFO ] [basic.internal.servlet.WebAppServlet] - Started Basic UI at /basicui/app
2018-02-23 13:50:13.702 [INFO ] [arthome.ui.paper.internal.PaperUIApp] - Started Paper UI at /paperui
2018-02-23 13:50:13.834 [INFO ] [panel.internal.HABPanelDashboardTile] - Started HABPanel at /habpanel
2018-02-23 13:50:13.979 [WARN ] [io.transport.cul.CULLifecycleManager] - CUL config is NULL, doing nothing

The events log:

2018-02-23 13:40:40.868 [ome.event.ItemCommandEvent] - Item 'Wohnzimmer' received command ON
2018-02-23 13:40:40.873 [vent.ItemStateChangedEvent] - Wohnzimmer changed from NULL to ON
2018-02-23 13:40:43.184 [ome.event.ItemCommandEvent] - Item 'Wohnzimmer' received command OFF
2018-02-23 13:40:43.187 [vent.ItemStateChangedEvent] - Wohnzimmer changed from ON to OFF
2018-02-23 13:40:44.973 [ome.event.ItemCommandEvent] - Item 'Wohnzimmer' received command ON
2018-02-23 13:40:44.974 [vent.ItemStateChangedEvent] - Wohnzimmer changed from OFF to ON
2018-02-23 13:40:47.552 [ome.event.ItemCommandEvent] - Item 'Wohnzimmer' received command OFF
2018-02-23 13:40:47.553 [vent.ItemStateChangedEvent] - Wohnzimmer changed from ON to OFF
2018-02-23 13:40:50.567 [ome.event.ItemCommandEvent] - Item 'Wohnzimmer' received command ON
2018-02-23 13:40:50.571 [vent.ItemStateChangedEvent] - Wohnzimmer changed from OFF to ON
2018-02-23 13:42:44.645 [ome.event.ItemCommandEvent] - Item 'Wohnzimmer' received command OFF
2018-02-23 13:42:44.647 [vent.ItemStateChangedEvent] - Wohnzimmer changed from ON to OFF
2018-02-23 13:43:09.159 [ome.event.ItemCommandEvent] - Item 'Wohnzimmer' received command ON
2018-02-23 13:43:09.161 [vent.ItemStateChangedEvent] - Wohnzimmer changed from OFF to ON
2018-02-23 13:43:10.216 [ome.event.ItemCommandEvent] - Item 'Wohnzimmer' received command OFF
2018-02-23 13:43:10.216 [vent.ItemStateChangedEvent] - Wohnzimmer changed from ON to OFF
2018-02-23 13:43:11.326 [ome.event.ItemCommandEvent] - Item 'Wohnzimmer' received command ON
2018-02-23 13:43:11.328 [vent.ItemStateChangedEvent] - Wohnzimmer changed from OFF to ON
2018-02-23 13:43:13.511 [ome.event.ItemCommandEvent] - Item 'Wohnzimmer' received command OFF
2018-02-23 13:43:13.512 [vent.ItemStateChangedEvent] - Wohnzimmer changed from ON to OFF

Do I need a sitemap? I’ve did not created one.



Did you install the Binding?
Did you restart openHAB?

A sitemap to test would not hurt.
Also make sure no other program is accessing the COM port. Maybe by restarting the computer.

If installed Fs20 binding and restarted openhab serveral times.

I will restart the Computer now. Maybe there is a false driver installed? But windows 10 gave me notification: CUL 868 is installing.

For OpenHab 2 the syntax in .cfg files changed:
fs20:device=serial:COM4 is for OpenHab 1.x
for OpenHab 2 use in fs20.cfg

items seems correct so far. I dont use HabPanel. Try to use a sitemap:


sitemap default label=“My first sitemap”
Switch item=Kueche

Did you have activated “Include Legacy 1.x Bindings” in Configuration/System (Paper UI)?
For my understandig it should do without that, but it doesnt if i dont use this option.

u both are genius.
I was going downstairs for testing and switched the lamp switch. But I was in the living room and forgot that I’ve configured the Kitchen. I just heared a “click”. Then I’ve went to the kitchen and it is working!

I’ve made a clean install earlier this morning and forgot to active 1.x bindings.


I’m really thankfull. This is amazing.

For general testing of the CUL. Use a terminal program
Type: V Enter
You should see the Firmware Version of the CUL
Type: X61 + Enter (Uppercase X!!) Communicate verbose Details
Press a button on your FS20 Remote. Now you must become a message.
If that works Type: X21 Enter -> normal modus

What terminal program for windows? Is it possible to read the lokal master for Livingroom (the part after the housecode)?

Congrats. Your welcome
Yes, take a lool at:
and that

You can try this terminal program

Okay but I don’t get what I have to type in Terminal for sending a Code and Receiving a Code if I press the remote in the living room.

Edit: Sending a Command does work. Now I just need the option to read a Fs20 remote control.

Okay got it. Just X05 and it is listening and shows the HEX of the remotes.

So there ist just a little Problem. I Have a 4x Switch in the garden, the HEX is A3E802. This works but in reverse. If I switch on it turns off, if I switch off it turns on. Also the received command is
FA3E80200 for on
A3E80201 for off
at the FS20S8 remote control.

but it should be 00 for off and 01 for on, otherwise on HABPanel it shows On but it is Off.
Do you have some advise?

Edit: And an additional question. I’m using a 2x Switch for the garage. The command is FD9955512 because it is a toggle. How can I use this toggle in Openhab. If I use a switch it doesn’t work.

Little Correction. I’m using 1x Switch with Timerfunction for the garage.

The Codes are FA3E81112 and FA3E81012. The channels on the remote are doubled. So one is for on and off. How can I use it in OpenHAB? Is there anything else then Switch as Item? Maybe Toggle?

Also there is this problem above for the garden. in Basic UI I can map ON=OFF and OFF=ON but how to use this mapping in HABPanel?