GPhoto2-Port

GPPortPrivateLibrary

typedef struct _GPPortPrivateLibrary GPPortPrivateLibrary;

GPPortPrivateCore

typedef struct _GPPortPrivateCore GPPortPrivateCore;

This structure contains private data.

GPPortSettingsSerial

typedef struct {
	char port[128];		/** The portname (/dev/ttyX)*/
	int speed;		/** The baudrate of the device. */
	int bits;		/** How many bits data. */
	GPPortSerialParity parity;	/** parity data, see GP_PORT_SERIAL_PARITY_ 
				  defines */
	int stopbits;		/** How many stop bits are used. */
} GPPortSettingsSerial;

GPPortSettingsUSB

typedef struct {
	int inep, outep, intep;
	int config;
	int interface;
	int altsetting;

	/* must be last to avoid binary incompatibility.
	 * luckily we just need to make sure this struct does not 
	 * get larger than _GPPortSettingsSerial. */
	char port[64];
} GPPortSettingsUSB;

union GPPortSettings

union GPPortSettings {
	GPPortSettingsSerial serial;
	GPPortSettingsUSB usb;
	GPPortSettingsDisk disk;
};

GPPort

typedef struct {
	/* For your convenience */
	GPPortType type;

        GPPortSettings settings;
        GPPortSettings settings_pending;

        int timeout; /* in milliseconds */

	GPPortPrivateLibrary *pl;
	GPPortPrivateCore    *pc;
} GPPort;

gp_port_new ()

int         gp_port_new                     (GPPort **port);

Allocates the memory for a new GPPort. After you called this function, you probably want to call gp_port_set_info in order to make the newly created port functional.

gp_port_free ()

int         gp_port_free                    (GPPort *port);

Closes the port and frees the memory.

gp_port_set_info ()

int         gp_port_set_info                (GPPort *port,
                                             GPPortInfo info);

Makes a port functional. After calling this function, you can access the port using for example gp_port_open.

gp_port_get_info ()

int         gp_port_get_info                (GPPort *port,
                                             GPPortInfo *info);

Retreives info about the port.

gp_port_open ()

int         gp_port_open                    (GPPort *port);

Opens a port which should have been created with gp_port_new and configured with gp_port_set_info and gp_port_set_settings

gp_port_close ()

int         gp_port_close                   (GPPort *port);

Closes a port temporarily. It can afterwards be reopened using gp_port_open.

gp_port_read ()

int         gp_port_read                    (GPPort *port,
                                             char *data,
                                             int size);

Reads a specified number of bytes from the port into the supplied buffer.

gp_port_write ()

int         gp_port_write                   (GPPort *port,
                                             const char *data,
                                             int size);

Writes a specified amount of data to a port.

gp_port_get_settings ()

int         gp_port_get_settings            (GPPort *port,
                                             GPPortSettings *settings);

Retreives the current settings of a port.

gp_port_set_settings ()

int         gp_port_set_settings            (GPPort *port,
                                             GPPortSettings settings);

Adjusts the settings of a port. You should always call gp_port_get_settings, adjust the values depending on the type of the port, and then call gp_port_set_settings.

gp_port_get_timeout ()

int         gp_port_get_timeout             (GPPort *port,
                                             int *timeout);

Retreives the current timeout of the port.

gp_port_set_timeout ()

int         gp_port_set_timeout             (GPPort *port,
                                             int timeout);

Sets the timeout of a port. gp_port_read will wait timeout milliseconds for data. If no data will be received in that period, GP_ERROR_TIMEOUT will be returned.

gp_port_get_pin ()

int         gp_port_get_pin                 (GPPort *port,
                                             GPPin pin,
                                             GPLevel *level);

gp_port_set_pin ()

int         gp_port_set_pin                 (GPPort *port,
                                             GPPin pin,
                                             GPLevel level);

gp_port_set_error ()

int         gp_port_set_error               (GPPort *port,
                                             const char *format);

Sets an error message that can later be retrieved using gp_port_get_error.