vrpn  07.33
Virtual Reality Peripheral Network
vrpn_Saitek_Controller_Raw Class Referenceabstract

#include <vrpn_Saitek_Controller_Raw.h>

Inheritance diagram for vrpn_Saitek_Controller_Raw:
Collaboration diagram for vrpn_Saitek_Controller_Raw:

Public Member Functions

 vrpn_Saitek_Controller_Raw (vrpn_HidAcceptor *filter, const char *name, vrpn_Connection *c=0)
 
virtual ~vrpn_Saitek_Controller_Raw (void)
 
virtual void mainloop (void)=0
 Called once through each main loop iteration to handle updates. Remote object mainloop() should call client_mainloop() and then call d_connection->mainloop(). Server object mainloop() should service the device and then call server_mainloop(), but should not normally call d_connection->mainloop(). More...
 
- Public Member Functions inherited from vrpn_BaseClass
 vrpn_BaseClass (const char *name, vrpn_Connection *c=NULL)
 Names the device and assigns or opens connection, calls registration methods. More...
 
virtual ~vrpn_BaseClass ()
 
- Public Member Functions inherited from vrpn_BaseClassUnique
 vrpn_BaseClassUnique ()
 
virtual ~vrpn_BaseClassUnique ()
 Unregister all of the message handlers that were to be autodeleted. More...
 
vrpn_ConnectionconnectionPtr ()
 Returns a pointer to the connection this object is using. More...
 

Protected Member Functions

void init_hid (void)
 
void on_data_received (size_t bytes, vrpn_uint8 *buffer)
 Derived class reimplements this callback. More...
 
virtual void decodePacket (size_t bytes, vrpn_uint8 *buffer)=0
 
int register_types (void)
 Register the types of messages this device sends/receives. Return 0 on success, -1 on fail. More...
 
- Protected Member Functions inherited from vrpn_BaseClass
virtual int init (void)
 Initialize things that the constructor can't. Returns 0 on success, -1 on failure. More...
 
virtual int register_senders (void)
 Register the sender for this device (by default, the name of the device). Return 0 on success, -1 on fail. More...
 
- Protected Member Functions inherited from vrpn_BaseClassUnique
int register_autodeleted_handler (vrpn_int32 type, vrpn_MESSAGEHANDLER handler, void *userdata, vrpn_int32 sender=vrpn_ANY_SENDER)
 Registers a handler with the connection, and remembers to delete at destruction. More...
 
int send_text_message (const char *msg, struct timeval timestamp, vrpn_TEXT_SEVERITY type=vrpn_TEXT_NORMAL, vrpn_uint32 level=0)
 Sends a NULL-terminated text message from the device d_sender_id. More...
 
SendTextMessageBoundCall send_text_message (vrpn_TEXT_SEVERITY type=vrpn_TEXT_NORMAL)
 Returns an object you can stream into to send a text message from the device like send_text_message(vrpn_TEXT_WARNING) << "Value of i is: " << i; This use requires including vrpn_SendTextMessageStreamProxy.h. More...
 
void server_mainloop (void)
 Handles functions that all servers should provide in their mainloop() (ping/pong, for example) Should be called by all servers in their mainloop() More...
 
void client_mainloop (void)
 Handles functions that all clients should provide in their mainloop() (warning of no server, for example) Should be called by all clients in their mainloop() More...
 
- Protected Member Functions inherited from vrpn_HidInterface
void send_data (size_t bytes, const vrpn_uint8 *buffer)
 Call this to send data to the device. More...
 
void send_feature_report (size_t bytes, const vrpn_uint8 *buffer)
 Call this to send a feature report to the device - first byte must be Report ID (or 0x0 for devices without numbered reports) More...
 
int get_feature_report (size_t bytes, vrpn_uint8 *buffer)
 Call this to get a feature report from the device - first byte must be Report ID (or 0x0 for devices without numbered reports) More...
 
 vrpn_HidInterface (vrpn_HidAcceptor *acceptor)
 
virtual ~vrpn_HidInterface ()
 
virtual bool connected () const
 Returns true iff the last device I/O succeeded. More...
 
virtual void update ()
 Polls the device buffers and causes on_data_received callbacks if appropriate You NEED to call this frequently to ensure the OS doesn't drop data. More...
 
virtual bool reconnect ()
 Tries to reconnect to an acceptable device. Call this if you suspect a hotplug event has occurred. More...
 
vrpn_uint16 vendor () const
 Returns USB vendor ID of connected device. More...
 
vrpn_uint16 product () const
 Returns USB product ID of connected device. More...
 
int interface_number () const
 Returns the USB interface number of connected device. More...
 

Static Protected Member Functions

static int VRPN_CALLBACK on_connect (void *thisPtr, vrpn_HANDLERPARAM p)
 
static int VRPN_CALLBACK on_last_disconnect (void *thisPtr, vrpn_HANDLERPARAM p)
 
- Static Protected Member Functions inherited from vrpn_BaseClassUnique
static int encode_text_message_to_buffer (char *buf, vrpn_TEXT_SEVERITY severity, vrpn_uint32 level, const char *msg)
 Encodes the body of the text message into a buffer, preparing for sending. More...
 
static int decode_text_message_from_buffer (char *msg, vrpn_TEXT_SEVERITY *severity, vrpn_uint32 *level, const char *buf)
 Decodes the body of the text message from a buffer from the connection. More...
 

Protected Attributes

struct timeval _timestamp
 
vrpn_HidAcceptor_filter
 
- Protected Attributes inherited from vrpn_BaseClassUnique
vrpn_Connectiond_connection
 Connection that this object talks to. More...
 
char * d_servicename
 Name of this device, not including the connection part. More...
 
vrpn_int32 d_sender_id
 Sender ID registered with the connection. More...
 
vrpn_int32 d_text_message_id
 ID for text messages. More...
 
vrpn_int32 d_ping_message_id
 Ask the server if they are there. More...
 
vrpn_int32 d_pong_message_id
 Server telling that it is there. More...
 
- Protected Attributes inherited from vrpn_HidInterface
vrpn_HidAcceptor_acceptor
 This is the HidAcceptor we use when reconnecting. More...
 
bool _working
 
vrpn_uint16 _vendor
 
vrpn_uint16 _product
 
int _interface
 

Additional Inherited Members

- Public Attributes inherited from vrpn_BaseClassUnique
bool shutup
 
vrpn_MESSAGEHANDLER handler
 
vrpn_int32 sender
 
vrpn_int32 type
 
void * userdata
 

Detailed Description

Definition at line 25 of file vrpn_Saitek_Controller_Raw.h.

Constructor & Destructor Documentation

◆ vrpn_Saitek_Controller_Raw()

vrpn_Saitek_Controller_Raw::vrpn_Saitek_Controller_Raw ( vrpn_HidAcceptor filter,
const char *  name,
vrpn_Connection c = 0 
)

Definition at line 80 of file vrpn_Saitek_Controller_Raw.C.

References init_hid().

Here is the call graph for this function:

◆ ~vrpn_Saitek_Controller_Raw()

vrpn_Saitek_Controller_Raw::~vrpn_Saitek_Controller_Raw ( void  )
virtual

Definition at line 86 of file vrpn_Saitek_Controller_Raw.C.

References _filter.

Member Function Documentation

◆ decodePacket()

virtual void vrpn_Saitek_Controller_Raw::decodePacket ( size_t  bytes,
vrpn_uint8 *  buffer 
)
protectedpure virtual

Implemented in vrpn_Saitek_ST290_Pro.

Referenced by on_data_received().

◆ init_hid()

void vrpn_Saitek_Controller_Raw::init_hid ( void  )
protected

◆ mainloop()

virtual void vrpn_Saitek_Controller_Raw::mainloop ( void  )
pure virtual

Called once through each main loop iteration to handle updates. Remote object mainloop() should call client_mainloop() and then call d_connection->mainloop(). Server object mainloop() should service the device and then call server_mainloop(), but should not normally call d_connection->mainloop().

Implements vrpn_BaseClass.

Implemented in vrpn_Saitek_ST290_Pro.

◆ on_connect()

int vrpn_Saitek_Controller_Raw::on_connect ( void *  thisPtr,
vrpn_HANDLERPARAM  p 
)
staticprotected

Definition at line 109 of file vrpn_Saitek_Controller_Raw.C.

Referenced by init_hid().

◆ on_data_received()

void vrpn_Saitek_Controller_Raw::on_data_received ( size_t  bytes,
vrpn_uint8 *  buffer 
)
protectedvirtual

Derived class reimplements this callback.

It is called whenever a read returns some data.

WARNING! The data returned by this function differs when the device sends multiple report types and when it only has one. When it can have more than one, the report type is sent as the first byte. When it only has one, the report type is NOT included. This is the behavior of the HIDAPI library we are using. It is surprising to me, but that's how it behaves.

Implements vrpn_HidInterface.

Definition at line 98 of file vrpn_Saitek_Controller_Raw.C.

References decodePacket().

Here is the call graph for this function:

◆ on_last_disconnect()

int vrpn_Saitek_Controller_Raw::on_last_disconnect ( void *  thisPtr,
vrpn_HANDLERPARAM  p 
)
staticprotected

Definition at line 103 of file vrpn_Saitek_Controller_Raw.C.

Referenced by init_hid().

◆ register_types()

int vrpn_Saitek_Controller_Raw::register_types ( void  )
inlineprotectedvirtual

Register the types of messages this device sends/receives. Return 0 on success, -1 on fail.

Implements vrpn_BaseClass.

Definition at line 44 of file vrpn_Saitek_Controller_Raw.h.

Member Data Documentation

◆ _filter

vrpn_HidAcceptor* vrpn_Saitek_Controller_Raw::_filter
protected

Definition at line 41 of file vrpn_Saitek_Controller_Raw.h.

Referenced by ~vrpn_Saitek_Controller_Raw().

◆ _timestamp

struct timeval vrpn_Saitek_Controller_Raw::_timestamp
protected

The documentation for this class was generated from the following files: