//============================================================================== #ifndef _H_connexionclientapi#define _H_connexionclientapi #include <stdbool.h>#include "ConnexionClient.h" //==============================================================================#ifdef __cplusplusextern "C" {#endif//==============================================================================// Callback procedure types typedef void	(*ConnexionAddedHandlerProc)		(unsigned int productID);typedef void	(*ConnexionRemovedHandlerProc)		(unsigned int productID);typedef void	(*ConnexionMessageHandlerProc)		(unsigned int productID, unsigned int messageType, void *messageArgument); // NOTE for ConnexionMessageHandlerProc:// when messageType == kConnexionMsgDeviceState, messageArgument points to ConnexionDeviceState with size kConnexionDeviceStateSize// when messageType == kConnexionMsgPrefsChanged, messageArgument points to the target application signature with size sizeof(uint32_t) //==============================================================================// Public APIs to be called once when the application starts up or shuts down int16_t			SetConnexionHandlers				(ConnexionMessageHandlerProc messageHandler, ConnexionAddedHandlerProc addedHandler, ConnexionRemovedHandlerProc removedHandler, bool useSeparateThread);void			CleanupConnexionHandlers			(void); // Obsolete API replaced by SetConnexionHandlers, will be removed in the future int16_t			InstallConnexionHandlers			(ConnexionMessageHandlerProc messageHandler, ConnexionAddedHandlerProc addedHandler, ConnexionRemovedHandlerProc removedHandler); //==============================================================================// Public APIs to be called whenever the app wants to start/stop receiving data// the mask parameter (client capabilities mask) specifies which controls must be forwarded to the client// buttonMask (previously part of the client capabilities mask) specifies which buttons must be forwarded to the client uint16_t		RegisterConnexionClient				(uint32_t signature, uint8_t *name, uint16_t mode, uint32_t mask);void			SetConnexionClientMask				(uint16_t clientID, uint32_t mask);void			SetConnexionClientButtonMask		(uint16_t clientID, uint32_t buttonMask);void			UnregisterConnexionClient			(uint16_t clientID); //==============================================================================// Public API to send control commands to the driver and retrieve a result value// Note: the new ConnexionClientControl variant is strictly required for// kConnexionCtlSetSwitches and kConnexionCtlClearSwitches but also works for// all other Control calls. The old variant remains for backwards compatibility. int16_t			ConnexionControl					(uint32_t message, int32_t param, int32_t *result);int16_t			ConnexionClientControl				(uint16_t clientID, uint32_t message, int32_t param, int32_t *result); //==============================================================================// Public API to fetch the current device preferences for either the first connected device or a specific device type (kDevID_Xxx) int16_t			ConnexionGetCurrentDevicePrefs		(uint32_t deviceID, ConnexionDevicePrefs *prefs); //==============================================================================// Public API to set all button labels in the iOS/Android "virtual device" apps int16_t			ConnexionSetButtonLabels			(uint8_t *labels, uint16_t size); // Labels data is a series of 32 variable-length null-terminated UTF8-encoded strings.// The sequence of strings follows the SpacePilot Pro button numbering.// Empty strings revert the button label to its default value.// As an example, this data would set the label for button Top to "Top" and// revert all other button labels to their default values:// //	0x00,						// empty string for Menu//	0x00,						// empty string for Fit//	0x54, 0x6F, 0x70, 0x00,		// utf-8 encoded "Top" string for Top//	0x00,						// empty string for Left//	0x00, 0x00, 0x00, 0x00,		// empty strings for Right, Front, etc...//	0x00, 0x00, 0x00, 0x00,//	0x00, 0x00, 0x00, 0x00,//	0x00, 0x00, 0x00, 0x00,//	0x00, 0x00, 0x00, 0x00,//	0x00, 0x00, 0x00, 0x00,//	0x00, 0x00, 0x00, 0x00//==============================================================================#ifdef __cplusplus}#endif//============================================================================== #endif	// _H_connexionclientapi //==============================================================================