Alex Kurz' WAP Scripts for HomeSeer (V1.01)



These scripts will create all necessary files to run a WAP server to control and monitor your HS devices

(in conjunction with MS IIS 5 or greater). The functionality is based on flexibly created ASP pages, so

it should run on every HTTP server that is able to run ASP.



- You need only one HS event. All security related information (username and password) is stored in an

external config file.



The script is definitely not error free, so please write me a mail if you miss something or if

you find a bug.



Let's get started...



Contents:

Part 1: Prerequisites

Part 2: Installation

Part 3: Usage

Part 4: Known Issues

Part 5: History

Part 6: Credits





Part 1: Prerequisites



You will need a properly configured HS environment and an IIS 5 or greater that is configured to display

WAP pages. Information about setting up the IIS are to be found on Adam Stevens'

http://www.habitron.com.

Also you need to set the acces rights for the HomeSeer ActiveX. Information about how to set this up are

to be found on Adam Stevens' http://www.habitron.com as well.

Of course a permanent internet conection would be fine. You can use the scripts with a dial-up

connection as well, but it doesn't make too much sense (just like the built-in HS Web Server).



Part 2: Installation



In the .zip file you can find the following files



1. ak_wap_status.txt - the script

2. ak_wap_create.txt - creates the pages for the location selection

3. auth.txt - security information

4. house.wbmp - example logo

5. index.asp - example start page of your WAP server. You may want to change it to your own needs.

6. auth.asp - ASP containing the login-functions

7. functions.asp - the ActiveX functions

8. ak_wap_readme.txt - this file



- Copy ak_wap_status.txt and ak_wap_create.txt to the <drive>:\program files\homeseer\scripts\ directory.



- Copy the auth.txt to any directory you want (not into the wwwroot directory, of course. You certanly

don't want someone to be able to download your security data) and change it to your needs.



- Copy the files index.asp, auth.asp, functions.asp and the house.wbmp into your wwwroot directory.



- Set the path variables in ak_wap_create.txt and ak_wap.status.txt (SecFile and WWWRootPath) according

to your system setup.



- Create an HS event called "WAP Status". Set up the event like this:

Trigger:

   Type: Device Status Change

   The Device: Any Device

   Changed to the X10 status of: Any Status

Scripts/Speech:

   Run the following scripts in order....: ak_wap_status.txt



- Create an HS event called "WAP Create". Set up the event like this:

Trigger:

   Type: Manual only

Scripts/Speech:

   Run the following scripts in order....: ak_wap_create.txt



Run the "WAP Create" event once (you should run it every time you add or remove a group/location from

your HS Setup).



That's it! You can use an online WAP emulator to have a first look at your pages. I know that some of

these emulators don't support ASP pages properly (Yahoo! for example), but I found at least two which

work fine:



Gelon WapAlizer: http://www.gelon.net

Wapsilon: http://www.wapsilon.com



Of course my WAP phone (Nokia 6210) work fine with the pages as well. Any feedback about other phones

would be highly appreciated.



If you want to have a look at my site, point any of these emulators (or your cell phone, of course) to

http://mrgadget.dyndns.org or visit my HTTP homepage at http://control.doesntexist.com







Part 4: Known Issues



WAP doesn't support any strong security functions yet. Since the user/password informations are

submitted via the internet without encrypytion, you should change your username and password on a

regular basis. I can definitely take no resposibility if your settings are traced and misused in any

way.



Dimming may not be accurate at every time. Since the hs.ExecX10 function doesn't support direct dim, I

was forced to calculate the dim command from the metrics given by HS.



Part 5: History



Fixed/Changed in V 1.01:



- fixed error in ak_wap_create.txt. Now all locations will be created in admin and guest mode (hopefully).



Part 6: Credits



These scripts would not have been possible without Adam Stevens' excellent WAP How-To

(http://www.habitron.com). He goes a slightly different way than I do in terms of interacting with HS,

but all my knowledge about WAP is based on his site.



cu



Alex Kurz

http://control.doesntexist.com