452 lines
13 KiB
C++
452 lines
13 KiB
C++
/**
|
|
* @defgroup core telldus-core
|
|
* Telldus Core is the base module used to interface a Telldus TellStick.
|
|
* @{
|
|
*/
|
|
|
|
#include "telldus-core.h"
|
|
#include "common.h"
|
|
#include <stdlib.h>
|
|
|
|
|
|
/**
|
|
* @def TELLSTICK_TURNON
|
|
* Device-flag for devices supporting the tdTurnOn() call.
|
|
*
|
|
* @def TELLSTICK_TURNOFF
|
|
* Device-flag for devices supporting the tdTurnOff() call.
|
|
*
|
|
* @def TELLSTICK_BELL
|
|
* Device-flag for devices supporting the tdBell() call.
|
|
*
|
|
* @def TELLSTICK_TOGGLE
|
|
* This method is currently unimplemented.
|
|
*
|
|
* @def TELLSTICK_DIM
|
|
* Device-flag for devices supporting the tdDim() call.
|
|
*
|
|
* @def TELLSTICK_LEARN
|
|
* Device-flag for devices supporting the tdLearn() call.
|
|
*
|
|
* @def TELLSTICK_TYPE_DEVICE
|
|
* Device type of a single device.
|
|
*
|
|
* @def TELLSTICK_TYPE_GROUP
|
|
* Device type of a device which contains other devices.
|
|
*
|
|
* @def TELLSTICK_SUCCESS
|
|
* Error code. Returned when the command succeeded.
|
|
*
|
|
* @def TELLSTICK_ERROR_NOT_FOUND
|
|
* Error code. Returned if a TellStick was not found on the system.
|
|
*
|
|
* @def TELLSTICK_ERROR_PERMISSION_DENIED
|
|
* Error code. Returned if the user doesn't have privileges to open
|
|
* the TellStick device.
|
|
*
|
|
* @def TELLSTICK_ERROR_DEVICE_NOT_FOUND
|
|
* Error code. The supplied device id was not found.
|
|
*
|
|
* @def TELLSTICK_ERROR_METHOD_NOT_SUPPORTED
|
|
* Error code. The requested method is not supported by the device.
|
|
* This should be avoided by a call to tdMethods().
|
|
*
|
|
* @def TELLSTICK_ERROR_COMMUNICATION
|
|
* Error code. An error occurred when communicating with TellStick.
|
|
*
|
|
* @def TELLSTICK_ERROR_CONNECTING_SERVICE
|
|
* Error code. The client library could not connect to the service.
|
|
* Maybe it is not running?
|
|
*
|
|
* @def TELLSTICK_ERROR_UNKNOWN_RESPONSE
|
|
* Error code. The client library received a response from the service
|
|
* it did not understand.
|
|
*
|
|
* @def TELLSTICK_ERROR_UNKNOWN
|
|
* Error code. An unkown error has occurred.
|
|
*/
|
|
|
|
#define MAX_LOADSTRING 100
|
|
|
|
void WINAPI tdInit(void) {
|
|
}
|
|
|
|
int WINAPI tdRegisterDeviceEvent( TDDeviceEvent eventFunction, void *context ) {
|
|
return 0;
|
|
}
|
|
|
|
int WINAPI tdRegisterRawDeviceEvent( TDRawDeviceEvent eventFunction, void *context ) {
|
|
return 0;
|
|
}
|
|
|
|
int WINAPI tdRegisterDeviceChangeEvent( TDDeviceChangeEvent eventFunction, void *context) {
|
|
return 0;
|
|
}
|
|
|
|
int WINAPI tdUnregisterCallback( int callbackId ) {
|
|
return TELLSTICK_SUCCESS;
|
|
}
|
|
|
|
|
|
/**
|
|
* Close the library and clean up the cache it uses.
|
|
* This should be called when the library is not supposed to be used anymore
|
|
**/
|
|
void WINAPI tdClose(void) {
|
|
}
|
|
|
|
/**
|
|
* This method releases resources allocated by telldus-core.
|
|
* It should be called on the returned value from all functions return <tt>char *</tt>
|
|
**/
|
|
void WINAPI tdReleaseString(char *string) {
|
|
#ifdef _WINDOWS
|
|
SysFreeString((BSTR)string);
|
|
#else
|
|
free(string);
|
|
#endif
|
|
}
|
|
|
|
|
|
/**
|
|
* Turns a device on.
|
|
* Make sure the device supports this by calling tdMethods() before any
|
|
* call to this function.
|
|
* @param intDeviceId The device id to turn on.
|
|
**/
|
|
int WINAPI tdTurnOn(int intDeviceId){
|
|
return TELLSTICK_ERROR_UNKNOWN;
|
|
}
|
|
|
|
/**
|
|
* Turns a device off.
|
|
* Make sure the device supports this by calling tdMethods() before any
|
|
* call to this function.
|
|
* @param intDeviceId The device id to turn off.
|
|
*/
|
|
int WINAPI tdTurnOff(int intDeviceId){
|
|
return TELLSTICK_ERROR_UNKNOWN;
|
|
}
|
|
|
|
/**
|
|
* Sends bell command to devices supporting this.
|
|
* Make sure the device supports this by calling tdMethods() before any
|
|
* call to this function.
|
|
* @param intDeviceId The device id to send bell to
|
|
*/
|
|
int WINAPI tdBell(int intDeviceId){
|
|
return TELLSTICK_ERROR_UNKNOWN;
|
|
}
|
|
|
|
/**
|
|
* Dims a device.
|
|
* Make sure the device supports this by calling tdMethods() before any
|
|
* call to this function.
|
|
* @param intDeviceId The device id to dim
|
|
* @param level The level the device should dim to. This value should be 0-255
|
|
*/
|
|
int WINAPI tdDim(int intDeviceId, unsigned char level){
|
|
return TELLSTICK_ERROR_UNKNOWN;
|
|
}
|
|
|
|
/**
|
|
* Sends a special learn command to some devices that need a special learn-command
|
|
* to be used from TellStick
|
|
* Make sure the device supports this by calling tdMethods() before any
|
|
* call to this function.
|
|
* @param intDeviceId The device id to learn.
|
|
*/
|
|
int WINAPI tdLearn(int intDeviceId) {
|
|
return TELLSTICK_ERROR_UNKNOWN;
|
|
}
|
|
|
|
/**
|
|
* Returns the last sent command to a specific device
|
|
* @param intDeviceId The device id to query
|
|
* @param methodsSupported The methods supported by the client. See tdMethods() for more information.
|
|
* @returns the last sent command as integer, example TELLSTICK_TURNON or TELLSTICK_TURNOFF
|
|
*/
|
|
int WINAPI tdLastSentCommand( int intDeviceId, int methodsSupported ) {
|
|
return TELLSTICK_TURNOFF;
|
|
}
|
|
|
|
/**
|
|
* If the last sent command it TELLSTICK_DIM this returns the dimmed value.
|
|
* @param intDeviceId The device id to query
|
|
* @returns the the value as a human readable string, example "128" for 50%
|
|
*/
|
|
char * WINAPI tdLastSentValue( int intDeviceId ) {
|
|
return wrapStdString("255");
|
|
}
|
|
|
|
|
|
/**
|
|
* This function returns the number of devices configured
|
|
* @returns an integer of the total number of devices configured
|
|
*/
|
|
int WINAPI tdGetNumberOfDevices(void){
|
|
DWORD dwMode;
|
|
bool fSuccess = false;
|
|
|
|
//Convert our std::string to std::wstring since we build agains win32 with unicode support
|
|
//std::string strName = "\\\\.\\pipe\\" + server;
|
|
std::wstring name(L"\\\\.\\pipe\\TelldusClient");
|
|
HANDLE hPipe = CreateFile(
|
|
(const wchar_t *)name.c_str(), // pipe name
|
|
GENERIC_READ | // read and write access
|
|
GENERIC_WRITE,
|
|
0, // no sharing
|
|
NULL, // default security attributes
|
|
OPEN_EXISTING, // opens existing pipe
|
|
FILE_FLAG_OVERLAPPED, // default attributes
|
|
NULL); // no template file
|
|
|
|
if (hPipe == INVALID_HANDLE_VALUE) {
|
|
return 2;
|
|
}
|
|
|
|
dwMode = PIPE_READMODE_MESSAGE;
|
|
fSuccess = SetNamedPipeHandleState(
|
|
hPipe, // pipe handle
|
|
&dwMode, // new pipe mode
|
|
NULL, // don't set maximum bytes
|
|
NULL); // don't set maximum time
|
|
|
|
if (!fSuccess) {
|
|
return 3;
|
|
}
|
|
|
|
OVERLAPPED oOverlap;
|
|
DWORD bytesWritten = 0;
|
|
|
|
oOverlap.hEvent = CreateEvent(NULL, TRUE, TRUE, NULL);
|
|
std::string msg = "tdGetNumberOfDevices";
|
|
WriteFile(hPipe, msg.data(), (DWORD)msg.length(), &bytesWritten, &oOverlap);
|
|
|
|
/*result = WaitForSingleObject(oOverlap.hEvent, 10000);
|
|
if (result == WAIT_TIMEOUT) {
|
|
CloseHandle(oOverlap.hEvent);
|
|
return;
|
|
}
|
|
|
|
fSuccess = GetOverlappedResult(d->hPipe, &oOverlap, &bytesWritten, false);
|
|
CloseHandle(oOverlap.hEvent);
|
|
if (!fSuccess) {
|
|
return;
|
|
}
|
|
*/
|
|
return 1;
|
|
}
|
|
|
|
/**
|
|
* This function returns the unique id of a device with a specific index.
|
|
* To get all the id numbers you should loop over all the devices:
|
|
* \code
|
|
* int intNumberOfDevices = tdGetNumberOfDevices();
|
|
* for (int i = 0; i < intNumberOfDevices; i++) {
|
|
* int id = tdGetDeviceId( i );
|
|
* // id now contains the id number of the device with index of i
|
|
* }
|
|
* \endcode
|
|
* @param intDeviceIndex The device index to query. The index starts from 0.
|
|
* @returns the unique id for the device or -1 if the device is not found.
|
|
*/
|
|
int WINAPI tdGetDeviceId(int intDeviceIndex){
|
|
return 1;
|
|
}
|
|
|
|
/**
|
|
* Returns which type the device is. The device could be either
|
|
* TELLSTICK_TYPE_DEVICE or TELLSTICK_TYPE_GROUP
|
|
*/
|
|
int WINAPI tdGetDeviceType(int intDeviceId) {
|
|
return TELLSTICK_TYPE_DEVICE;
|
|
}
|
|
|
|
/**
|
|
* Query a device for it's name.
|
|
* @param intDeviceId The unique id of the device to query
|
|
* @returns The name of the device or an empty string if the device is not found.
|
|
*/
|
|
char * WINAPI tdGetName(int intDeviceId){
|
|
std::string strReturn = "Hardcoded device";
|
|
return wrapStdString(strReturn);
|
|
}
|
|
|
|
/**
|
|
* Sets a new name for a device. The devices are global for all application, changing
|
|
* this will change the name for other applications aswell.
|
|
* @param intDeviceId The device id to change the name for
|
|
* @param strNewName The new name for the devices
|
|
* @returns \c true on success, \c false otherwise.
|
|
*/
|
|
bool WINAPI tdSetName(int intDeviceId, const char* strNewName){
|
|
bool blnSuccess = false;
|
|
return blnSuccess;
|
|
}
|
|
|
|
/**
|
|
* @returns the protocol used by a specific device.
|
|
* @param intDeviceId The device id to query.
|
|
*/
|
|
char* WINAPI tdGetProtocol(int intDeviceId){
|
|
std::string strReturn = "";
|
|
return wrapStdString(strReturn);
|
|
}
|
|
|
|
/**
|
|
* This changes the current protocol used by a device. After changing the protocol,
|
|
* setting new parameters is required.
|
|
* @param intDeviceId The device to change.
|
|
* @param strProtocol The new protocol to use.
|
|
* @returns \c true on success, \c false otherwise.
|
|
* @sa tdSetModel()
|
|
* @sa tdSetDeviceParameter()
|
|
*/
|
|
bool WINAPI tdSetProtocol(int intDeviceId, const char* strProtocol){
|
|
bool blnSuccess = false;
|
|
return blnSuccess;
|
|
}
|
|
|
|
/**
|
|
* @returns the model for a device. Not all protocols uses this.
|
|
* @param intDeviceId The device to query.
|
|
*/
|
|
char* WINAPI tdGetModel(int intDeviceId){
|
|
std::string strReturn = "";
|
|
return wrapStdString(strReturn);
|
|
}
|
|
|
|
/**
|
|
* Sets a new model for a device. Which model to set depends on the
|
|
* current protocol.
|
|
* @param intDeviceId The device to change
|
|
* @param strModel The new model
|
|
* @returns \c true on success, \c false otherwise.
|
|
*/
|
|
bool WINAPI tdSetModel(int intDeviceId, const char *strModel){
|
|
bool blnSuccess = false;
|
|
return blnSuccess;
|
|
}
|
|
|
|
/**
|
|
* Sets a new protocol specific parameter. Please see the documentation of the protocols
|
|
* before setting any parameter.
|
|
* @param intDeviceId The device to change.
|
|
* @param strName The parameter to change.
|
|
* @param strValue The new value for the parameter.
|
|
* @returns \c true on success, \c false otherwise.
|
|
*/
|
|
bool WINAPI tdSetDeviceParameter(int intDeviceId, const char *strName, const char *strValue){
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* @returns any protocol specific parameter specified by \c strName
|
|
* @param intDeviceId The device to query.
|
|
* @param strName The name of the parameter to query.
|
|
* @param defaultValue A defaultValue to return if the current parameter hasn't previously been set.
|
|
*/
|
|
char * WINAPI tdGetDeviceParameter(int intDeviceId, const char *strName, const char *defaultValue){
|
|
std::string strReturn = "";
|
|
return wrapStdString(strReturn);
|
|
}
|
|
|
|
/**
|
|
* Add a new device to the global database of devices. This function must be called first before
|
|
* any call to tdSetName(), tdSetProtocol() and similar functions.
|
|
* @returns the new device id for the newly created device. If the creation fails it returnes a
|
|
* negative value.
|
|
*/
|
|
int WINAPI tdAddDevice(){
|
|
int intNewDeviceId = -1;
|
|
return intNewDeviceId;
|
|
}
|
|
|
|
/**
|
|
* Removes a device.
|
|
* @returns \c true on success, \c false otherwise.
|
|
*/
|
|
bool WINAPI tdRemoveDevice(int intDeviceId){
|
|
bool blnSuccess = false;
|
|
return blnSuccess;
|
|
}
|
|
|
|
/**
|
|
* Query a device for which methods it supports. By supplying the methods you support
|
|
* the library could remap the methods a device support for better fit the application.
|
|
* Example of querying a device supporting TELLSTICK_BELL:
|
|
* \code
|
|
* int methods = tdMethods(id, TELLSTICK_TURNON | TELLSTICK_TURNOFF | TELLSTICK_BELL);
|
|
* //methods is now TELLSTICK_BELL
|
|
* int methods = tdMethods(idm TELLSTICK_TURNON | TELLSTICK_TURNOFF);
|
|
* //methods is now TELLSTICK_TURNON because the client application doesn't support TELLSTICK_BELL
|
|
* \endcode
|
|
* @param id The device id to query
|
|
* @param methodsSupported The methods the client application supports
|
|
* @returns The method-flags OR'ed into an integer.
|
|
* @sa TELLSTICK_TURNON
|
|
* @sa TELLSTICK_TURNOFF
|
|
* @sa TELLSTICK_BELL
|
|
* @sa TELLSTICK_TOGGLE
|
|
* @sa TELLSTICK_DIM
|
|
*/
|
|
int WINAPI tdMethods(int id, int methodsSupported){
|
|
|
|
return TELLSTICK_TURNON;
|
|
}
|
|
|
|
/**
|
|
* Get a human readable string from an error code returned
|
|
* from a function in telldus-core.
|
|
* @param intErrorNo The error code to translate.
|
|
* @returns a string ready to show to the user.
|
|
* @sa TELLSTICK_SUCCESS
|
|
* @sa TELLSTICK_ERROR_NOT_FOUND
|
|
* @sa TELLSTICK_ERROR_PERMISSION_DENIED
|
|
* @sa TELLSTICK_ERROR_DEVICE_NOT_FOUND
|
|
* @sa TELLSTICK_ERROR_METHOD_NOT_SUPPORTED
|
|
* @sa TELLSTICK_ERROR_UNKNOWN
|
|
*/
|
|
char * WINAPI tdGetErrorString(int intErrorNo) {
|
|
const int numResponses = 8;
|
|
const char *responses[numResponses] = {
|
|
"Success",
|
|
"TellStick not found",
|
|
"Permission denied",
|
|
"Device not found",
|
|
"The method you tried to use is not supported by the device",
|
|
"An error occurred while communicating with TellStick",
|
|
"Could not connect to the Telldus Service",
|
|
"Received an unknown response"
|
|
};
|
|
std::string strReturn;
|
|
intErrorNo = abs(intErrorNo); //We don't use negative values here.
|
|
if (intErrorNo >= numResponses) {
|
|
strReturn = "Unknown error";
|
|
} else {
|
|
// Copy the error string to strReturn
|
|
strReturn = responses[intErrorNo];
|
|
}
|
|
return wrapStdString(strReturn);
|
|
}
|
|
|
|
/**
|
|
* Send a raw command to TellStick. Please read the TellStick protocol
|
|
* definition on how the command should be constructed.
|
|
* @param command The command for TellStick in its native format
|
|
* @returns TELLSTICK_SUCCESS on success or one of the errorcodes on failure
|
|
*/
|
|
int WINAPI tdSendRawCommand(const char *command, int reserved) {
|
|
return TELLSTICK_ERROR_UNKNOWN;
|
|
}
|
|
|
|
|
|
void WINAPI tdConnectTellStickController(int vid, int pid, const char *serial) {
|
|
}
|
|
|
|
void WINAPI tdDisconnectTellStickController(int vid, int pid, const char *serial) {
|
|
}
|
|
|
|
|
|
/*\@}*/
|