Tutorials:Install and Run openAAL

Aus openAAL
Wechseln zu: Navigation, Suche



FHEM is a Perl server form house automation supporting devices and sensors from multiple manufacturers. It is used to automate tasks like switching lamps, shutters, heating, etc. In order to use it permanently, you need a server running 24H/7. This tutorial will guide you throw installing the FHEM server on a Raspberry Pi computer. The Raspberry Pi is a small and low consumption computer.


In order to setup up your server, you need the following products:
• A Microsoft Windows® computer
• A Raspberry Pi Model B
• A 4 GB minimum SD card
• The current openAAL image
• A receiver (CUL, HomeMatic Lan Interface, etc.)
Win32 Disk Imager software
• Flip software from Atmel (www.atmel.com/tools/FLIP.aspx)


CUL is a USB dongle that can capture radio signal from different sensors. You can buy one from busware. The one used in this tutorial is a 868 MHz receiver version 3. The version number is written on the CUL.
Before starting, you need to install the Flip software then go to http://culfw.svn.sourceforge.net/viewvc/culfw/trunk/culfw/Devices/CUL/ and download the appropriate version of your CUL.
Connect the CUL to your computer (if the CUL was already programmed, you need to maintain the switch pressed). When Windows prompts you to find a hardware driver, choose to search in a specific folder NOT online. Choose C:\Program Files\Atmel\Flip3.3.4\usb or wherever you downloaded Flip. If you get a message saying that driver is not signed, ignore it and go on with the installation process.
Now, launch Flip and from the Device menu, choose Select. Now choose your device. Its name appeared during the driver installation and you can find it the in Windows Device Manager. Open the Settings menu then choose Communication then USB. A window pops up, choose Open. Now choose Load HEX File from the File menu and then choose the firmware you download it previously from culfw sourceforge site. From Flip main window, check Erase, Program and Verify then click Run. If you are lucky, you will see green lights next to these three options. Your CUL is ready.
You need now to add it to fhem server. Connect the CUL to your Raspberry then from the FHEM web interface, choose Edit files from the left menu then click on fhem.cfg. Add the following sentence to the file then click Save fhem.cfg: define MyCUL CUL /dev/ttyACM0 1234

Starting and running openAAL

Insert your SD card into the computer. If you have a Windows OS, then use Win32 Disk Imager. On a Linux system you can flash the SD card with the "dd" command. Choose the downloaded openaal image then click Write in Win32DiskImager. Once it’s done, insert it into the Raspberry. Now connect your PI to your network with a LAN cable and turn it on by putting the plug of the PI into the plug socket. Wait a little until the os of the PI is booted. You have to detect, which IP has your Raspberry PI (e.g. with command ifconfig), so that you can start a SSH session with the PI or open directly your browser from a remote system to access the fhem server website or the openAAL system tool website. For a SSH connection you can use a SSH client (like PuTTY) to connect to your Raspberry. Default username is pi and its password is openaal. After the Rapberry has booted you can access the FHEM server by entering the following address in your browser: http://raspberry_host_ip:8083/.

FHEM server

For accessing the openAAL system tool you have to enter: http://raspberry_pi_host_ip:8080/systemcontrol in your browser. If you can see the following screens, you have successfully installed your openAAL system on your Raspberry PI. :)

Loginsite of the openAAL system tool

If you want to login into the system tool site to maintain your openAAL environment, you have to enter admin as username and oAAL as password.:)

After you have logged in, go to the Setting Menu in the right corner and enter the IP of your PI into the FHEM IP textfield and save your settings. Now the systemcontrol is ready for use.


You can have further information on how setting up other type of receivers or using other platforms via the following link: http://culfw.de/culfw.html
Information about using fhem via this link : http://fhem.de/HOWTO.html also accessible via your fhem web interface.