# FBSmartHome

A small collection of one usefull FritzBox SmartHome tool and one example script. Still in development and highly experimental. 

If you have any issues or questions regarding this tool and script just get in contact with me.

## fb-login-test.sh

A simple script to test the user name and passwort set in file `~/.fbsh.config`. If the login was successfull an XML file with connected SmartHome devices will be printed out. 

The config file for both script and client use the same syntax.

	#
	# PARAMETERNAME=VALUE  no space allowed except for the value.
	#                      but not between parametername, = and value.
	#
	#
	FBSH_USER=testuser
	FBSH_PASS=anypassword
	FBSH_SIDFILE=/home/username/.fbsh.sid
	FBSH_HOSTNAME=http://192.168.0.1


## fbsh-cli FritzBox SmartHome Console Client

I wrote the fbsh-cli tool to get a small easy low ressourced interface for the Fritzbox Smart Home devices. It should be able to get it running on most of the SoC devices which are out there.

### Preparation

You need the libxml2 and openssl devel pakages for compilation. In addition you will need to download, compile and install the [libUDPTCPNetwork](https://steffen.gulpe.de/gitea/steffen/libUDPTCPNetwork) library which includes some helper functions i use. 
If you have a debian based distribution you can install them with:

	apt install libxml2-dev libssl-dev
	git clone https://steffen.gulpe.de/gitea/steffen/libUDPTCPNetwork.git
	cd libUDPTCPNetwork
	make
	sudo make install

## Compilation

No comment here. Just download, compile and run the tool.

	git clone https://steffen.gulpe.de/gitea/steffen/FBSmartHome.git
	cd FBSmartHome
	make
	./fbsh-cli

### Configuration File

To set some default settings and create the configuration file, just run the command.

`./fbsh-cli -host http://192.168.0.1 -user SOMEUSER -pass SOMEPASSWORD saveconfig`

The default configuration will be saved under `$HOME/.fbsh.config`. In addition the client will save a SID file `.fbsh.sid` which contains the last known SID (session ID). This file will also be located inside the home directory.

Both script and the client will use the same config file.

### Test the Login
Test the connection with `./fbsh-cli connect`. The successfull conntion will look like:

    user@desktop ~/FBSmartHome $ ./fbsh-cli connect
    SID:989346018a2dca53
    user@desktop ~/FBSmartHome $  

### Supported Commands
+ saveconfig
+ connect
+ list
+ gethkr
+ listhkr
+ switch
+ color
+ level
+ help


### Currently Not Working
+ HTTPS is yet not supported
+ sending commands to switches and lights

# Sample Output

	steffen@pc1 ~/Dokumente/Programmierung/FBSmartHome $ ./fbsh-cli listhkr
	01234 0001234 name:Heizung 1 temp:19.5 cur:19.5 set:21.0
	01234 0001235 name:Heizung 2 temp:19.0 cur:19.0 set:19.0
	01234 0001236 name:Heizung 3 temp:21.5 cur:21.5 set:22.0
    steffen@pc1 ~/Dokumente/Programmierung/FBSmartHome $

![Screenshot1](https://steffen.gulpe.de/progs/fbsh-cli_gethkr.png)