Libsmr: Difference between revisions

From Rsewiki
No edit summary
No edit summary
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);

Revision as of 13:20, 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.