Libsmr: Difference between revisions

From Rsewiki
No edit summary
No edit summary
 
(One intermediate revision by the same user not shown)
Line 19: Line 19:
</pre>
</pre>


[[struct smr]] *[smr_connect](char *hostname, int port);
[[struct smr]] *[[smr_connect]](char *hostname, int port);


void [smr_disconnect]([struct smr] *robot);
void [[smr_disconnect]]([[struct smr]] *robot);


int [smr_read]([struct smr] *robot);
int [[smr_read]]([[struct smr]] *robot);


int [smr_write]([struct smr] *robot);
int [[smr_write]]([[struct smr]] *robot);


Each function, and the smr struct datatype, is described on its own page.
Each function, and the smr struct datatype, is described on its own page.

Latest revision as of 13:23, 29 September 2008

LibSmr is the C programming library that enables C programs to communicate with the SMR sensor daemon, [smrd].

The library provides two types of functions: smr specific and low level.

Smr specific functions

The library provides four C functions: smr_connect(), smr_disconnect(), smr_read() and smr_write(). These are modelled after similarly named functions familiar to C programmers, used for other kinds of input/output.

Central to all use of the smr specific functions if a struct smr datatype. A pointer to such a struct is returned by smr_connect(), and this pointer is used in all subsequent calls to smr_read() and smr_write(), and must finally be provided to smr_close().

To use the library, a header file must be included. The following summary shows the function type declarations:

#include <smr.h>

struct smr *smr_connect(char *hostname, int port);

void smr_disconnect(struct smr *robot);

int smr_read(struct smr *robot);

int smr_write(struct smr *robot);

Each function, and the smr struct datatype, is described on its own page.


Low level functions

The low level functions are not currently documented.