Main Page   Namespace List   Class Hierarchy   Alphabetical List   Compound List   File List   Namespace Members   Compound Members   File Members  

procrwil.cpp File Reference

#include "rwil.h"
#include "procrwil.h"
#include "X10Device.h"
#include "X10Recv.h"
#include <stdio.h>

Go to the source code of this file.

Functions

void rwil_callback (const list< Message > &messages)
rwil_handle rwil_init ()
 Initialize the Real World Interface Library. More...

rwil_device rwil_create (rwil_handle rwilhandle, char house, int num)
 Create a device in the RWIL with the specified attributes. More...

void rwil_destroy (rwil_device handle)
 Destroy a device from the RWIL with the specified handle. More...

void rwil_on (rwil_device handle, time_t when)
 Turn a device on to full power. More...

void rwil_off (rwil_device handle, time_t when)
 Turn a device off. More...

void rwil_setbright (rwil_device handle, int brightness, time_t when)
 Set the brightness of a device. More...

void rwil_interpolatebright (rwil_device handle, int startbrightness, int endbrightness, time_t startwhen, time_t endwhen, int steps)
 Interpolate brightness between two values over a time interval. More...

int rwil_getbright (rwil_device handle)
 Get the brightness of a device now. More...

int rwil_ison (rwil_device handle)
 Determine whether the device is on now. More...

void rwil_success_callback (rwil_success_callback_t callback)
 Set the success callback. More...

void rwil_failure_callback (rwil_failure_callback_t callback)
 Set the failure callback. More...

void rwil_set_x10_listener (rwil_x10_listener_t callback)
 Set the X10 listener. More...

void rwil_shutdown (rwil_handle rwilhandle)
 Shutdown the RWIL. More...


Variables

rwil_success_callback_t success_call = NULL
rwil_failure_callback_t failure_call = NULL
rwil_x10_listener_t listener_call = NULL

Function Documentation

void rwil_callback (  const list< Message > &    messages )  [static]
 

Definition at line 145 of file procrwil.cpp.

References rwil_device::dev_handle, failure_call, rwil_device::handle, listener_call, rwil::StringToInt(), and success_call.

Referenced by rwil_init(). 

00146 {
00147   list<Message>::const_iterator iter;
00148 
00149   iter = messages.begin();
00150   rwil_device dev;
00151   while(iter != messages.end())
00152     {
00153       std::string str = iter->GetParam("rwilhandle");
00154       if(str=="")
00155         {
00156           if(iter->GetDevice().compare("rwil_x10_listener") == 0)
00157           { // got a listener message
00158             if(listener_call != 0)
00159             {
00160               listener_call(iter->GetParam("house")[0], StringToInt(iter->GetParam("number")), iter->GetCommand().c_str());
00161             }
00162           }
00163           iter++;
00164           continue;
00165         }
00166       dev.handle = (void *)StringToInt(str);
00167       dev.dev_handle = StringToInt(iter->GetDevice());
00168       str = iter->GetParam("message");
00169       if(str == "success")
00170         {
00171           if(success_call)
00172             {
00173               success_call(dev);
00174             }
00175         }
00176       else
00177         {
00178           if(failure_call)
00179             {
00180               failure_call(dev, str.c_str());
00181             }
00182         }
00183       iter++;
00184     }
00185 }

rwil_device rwil_create (  rwil_handle    rwilhandle,
char    house,
int    num
) 
 

Create a device in the RWIL with the specified attributes.

Parameters:
rwilhandle  The value returned from rwil_init()
house  The letter of the house address, a-p or A-P
num  The unit number address 1-16
Returns:
A handle to the device.

Definition at line 26 of file procrwil.cpp.

References rwil_device::dev_handle, rwil_device::handle, and rwil_handle. 

00027 {
00028   char buf[20];
00029   int val;
00030   RWIL *rwil = (RWIL*)rwilhandle;
00031   rwil_device device;
00032   val = (house << 16) + num;
00033   sprintf(buf, "%d", val);
00034   X10Device *dev = new X10Device(buf, rwil->output, house, num);
00035   rwil->AddDevice(dev);
00036   device.handle = rwilhandle;
00037   device.dev_handle = val;
00038   return device;
00039 }

void rwil_destroy (  rwil_device    handle ) 
 

Destroy a device from the RWIL with the specified handle.

Parameters:
handle  Device to destroy.

Definition at line 42 of file procrwil.cpp.

References rwil_device::dev_handle, and rwil_device::handle. 

00043 {
00044   RWIL *rwil = (RWIL*)handle.handle;
00045   char buf[20];
00046   sprintf(buf, "%d", handle.dev_handle);
00047   rwil->RemoveDevice(buf);
00048 }

void rwil_failure_callback (  rwil_failure_callback_t    callback ) 
 

Set the failure callback.

Set the global failure callback.

Parameters:
callback  A function pointer to the callback function.

Definition at line 126 of file procrwil.cpp.

References failure_call, and rwil_failure_callback_t. 

00127 {
00128   failure_call = callback;
00129 }

int rwil_getbright (  rwil_device    handle ) 
 

Get the brightness of a device now.

Get the current brightness of a device.

Parameters:
handle  The device to check the brightness of.

Definition at line 98 of file procrwil.cpp.

References rwil_device::dev_handle, rwil_device::handle, and rwil::StringToInt(). 

00099 {
00100   RWIL *rwil = (RWIL*)handle.handle;
00101   char buf[20];
00102   sprintf(buf, "%d", handle.dev_handle);
00103 
00104   X10Device* dev = (X10Device *)rwil->GetDevice(buf);
00105   return StringToInt(dev->GetStatus());
00106 }

rwil_handle rwil_init (    ) 
 

Initialize the Real World Interface Library.

Call this before any other functions.

Definition at line 14 of file procrwil.cpp.

References rwil_callback(), and rwil_handle.

Referenced by main(). 

00015 {
00016   RWIL *ptr = new RWIL;
00017   rwil_handle handle;
00018   ptr->Start();
00019   ptr->AddDevice(new X10Recv("rwil_x10_listener", ptr->output));
00020   handle = ptr;
00021   ptr->output.SetAddCallback(rwil_callback);
00022   return handle;
00023 }

void rwil_interpolatebright (  rwil_device    handle,
int    startbrightness,
int    endbrightness,
time_t    startwhen,
time_t    endwhen,
int    steps
) 
 

Interpolate brightness between two values over a time interval.

Callback is only called at completion or failure of last event.

Parameters:
handle  Device to set brightness of.
startbrightness  The starting brightness value
endbrightness  The ending brightness value
startwhen  The time to start inerpolating from startbrightness to endbrightness
endwhen  The time for the command to finish
steps  The number of steps to take in the interpolations.

Definition at line 75 of file procrwil.cpp.

References rwil_device::dev_handle, rwil_device::handle, and rwil::IntToString(). 

00076 {
00077   RWIL *rwil = (RWIL*)handle.handle;
00078   char buf[20];
00079 
00080   time_t timedif = endwhen - startwhen;
00081   int brightdif = endbrightness - startbrightness;
00082 
00083   sprintf(buf, "%d", handle.dev_handle);
00084 
00085   int count = 0;
00086   for(count = 0; count < steps; count++)
00087   {
00088     Message msg(buf, "dim", startwhen + timedif * count / steps);
00089     msg.SetParam("percent", IntToString(startbrightness + brightdif * count / steps));
00090 
00091     //Ensure that the callback is only called by the last change in brightness
00092     if((count + 1)== steps)msg.SetParam("rwilhandle", IntToString((int)rwil));
00093     rwil->input.Add(msg);
00094   }
00095 }

int rwil_ison (  rwil_device    handle ) 
 

Determine whether the device is on now.

Parameters:
handle  The device to check the status of.

Definition at line 109 of file procrwil.cpp.

References rwil_getbright(). 

00110 {
00111   if(rwil_getbright(handle)) return 1;
00112   return 0;
00113 }

void rwil_off (  rwil_device    handle,
time_t    when
) 
 

Turn a device off.

Parameters:
handle  Device to turn off.
when  When to turn device off.

Definition at line 56 of file procrwil.cpp.

References rwil_setbright(). 

00057 {
00058   rwil_setbright(handle, 0, when);
00059 }

void rwil_on (  rwil_device    handle,
time_t    when
) 
 

Turn a device on to full power.

Parameters:
handle  Device to turn on.
when  When to turn on.

Definition at line 51 of file procrwil.cpp.

References rwil_setbright(). 

00052 {
00053   rwil_setbright(handle, 100, when);
00054 }

void rwil_set_x10_listener (  rwil_x10_listener_t    callback ) 
 

Set the X10 listener.

Use this function to activate and set up the x10 listener. If you pass a null value as a listener then the function will deactivate listening.

See also:
rwil_x10_listener_t
Parameters:
callback  Function called when the x10 listener hears a complete command.

Definition at line 131 of file procrwil.cpp.

References listener_call, and rwil_x10_listener_t. 

00132 {
00133   listener_call = callback;
00134 }

void rwil_setbright (  rwil_device    handle,
int    brightness,
time_t    when
) 
 

Set the brightness of a device.

Parameters:
handle  Device to set brightness on.
brightness  Level to set brightness to. @when When to set brightness

Definition at line 62 of file procrwil.cpp.

References rwil_device::dev_handle, rwil_device::handle, and rwil::IntToString(). 

00063 {
00064   RWIL *rwil = (RWIL*)handle.handle;
00065   char buf[20];
00066   sprintf(buf, "%d", handle.dev_handle);
00067 
00068   Message msg(buf, "dim", when);
00069   msg.SetParam("percent", IntToString(brightness));
00070   msg.SetParam("rwilhandle", IntToString((int)rwil));
00071   rwil->input.Add(msg);
00072 }

void rwil_shutdown (  rwil_handle    rwilhandle ) 
 

Shutdown the RWIL.

This function shuts down the rwil system, and waits for the shutdown to complete. This could take several seconds.

Parameters:
rwilhandle  Handle to the RWIL system as returned by rwil_init()

Definition at line 137 of file procrwil.cpp.

References rwil_handle. 

00138 {
00139   RWIL *rwil = (RWIL*)rwilhandle;
00140   rwil->Kill();
00141   rwil->Join();
00142   delete rwil;
00143 }

void rwil_success_callback (  rwil_success_callback_t    callback ) 
 

Set the success callback.

Set the global success callback.

Parameters:
callback  A function pointer to the callback function.

Definition at line 120 of file procrwil.cpp.

References rwil_success_callback_t, and success_call. 

00121 {
00122   success_call = callback;
00123 }

Variable Documentation

rwil_failure_callback_t failure_call = NULL [static]
 

Definition at line 115 of file procrwil.cpp.

Referenced by rwil_callback(), and rwil_failure_callback().

rwil_x10_listener_t listener_call = NULL [static]
 

Definition at line 116 of file procrwil.cpp.

Referenced by rwil_callback(), and rwil_set_x10_listener().

rwil_success_callback_t success_call = NULL [static]
 

Definition at line 114 of file procrwil.cpp.

Referenced by rwil_callback(), and rwil_success_callback().

Generated on Tue Apr 9 13:53:08 2002 for RWIL - Real World Interface Library by doxygen1.2.12 written by Dimitri van Heesch, © 1997-2001