208807180a
The serial ops used a legacy calling convention that passed in just the pointer to the userdata pointer (ie the first argument to the functions was "void **userdata"). That's actually very inconvenient, because the custom IO data can not only contain other interesting information that was filled in by the custom IO provider, it also made it harder to chain these things together, as exemplified by the core to emulate serial over the packet interface in the subsurface bluetooth code. This also adds the 'dc_context_t' field that is passed to the packet routine open. That can allow the open routine to override the 'custom_io' details of the context at open time (to allow nested custom_io operation). Note that callers of the open function need to be aware that the 'custom_io' can be changed by the act of opening a custom_io, and the value shouldn't be cached in some local variable. Finally, this adds a new user-supplied opaque pointer dc_user_device_t *user_device; to the custom_io descriptor. The 'user_device' data is filled in when registering the custom_io with data that the custom IO open() routines can use. This is different from the existing 'userdata' in that the 'user_device' is filled in before dc_open_device() is called (and "open" can then use it to limit what kinds of devices it looks for, for example). In contrast, the existing 'userdata' field is filled in by the "xyz_open()" routines, and contains the data necessary for the IO itself. The SSRF_CUSTOM_IO define is updated to v2 to indicate the new interfaces. Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
67 lines
1.9 KiB
C
67 lines
1.9 KiB
C
/*
|
|
* libdivecomputer
|
|
*
|
|
* Copyright (C) 2012 Jef Driesen
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Lesser General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2.1 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Lesser General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Lesser General Public
|
|
* License along with this library; if not, write to the Free Software
|
|
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
|
|
* MA 02110-1301 USA
|
|
*/
|
|
|
|
#ifndef DC_CONTEXT_H
|
|
#define DC_CONTEXT_H
|
|
|
|
#include "common.h"
|
|
#include "custom_io.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif /* __cplusplus */
|
|
|
|
typedef struct dc_context_t dc_context_t;
|
|
|
|
/* Opaque libdivecomputer *user* data structure */
|
|
typedef struct dc_user_device_t dc_user_device_t;
|
|
|
|
typedef enum dc_loglevel_t {
|
|
DC_LOGLEVEL_NONE,
|
|
DC_LOGLEVEL_ERROR,
|
|
DC_LOGLEVEL_WARNING,
|
|
DC_LOGLEVEL_INFO,
|
|
DC_LOGLEVEL_DEBUG,
|
|
DC_LOGLEVEL_ALL
|
|
} dc_loglevel_t;
|
|
|
|
typedef void (*dc_logfunc_t) (dc_context_t *context, dc_loglevel_t loglevel, const char *file, unsigned int line, const char *function, const char *message, void *userdata);
|
|
|
|
dc_status_t
|
|
dc_context_new (dc_context_t **context);
|
|
|
|
dc_status_t
|
|
dc_context_free (dc_context_t *context);
|
|
|
|
dc_status_t
|
|
dc_context_set_custom_io (dc_context_t *context, dc_custom_io_t *custom_io, dc_user_device_t *);
|
|
|
|
dc_status_t
|
|
dc_context_set_loglevel (dc_context_t *context, dc_loglevel_t loglevel);
|
|
|
|
dc_status_t
|
|
dc_context_set_logfunc (dc_context_t *context, dc_logfunc_t logfunc, void *userdata);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif /* __cplusplus */
|
|
#endif /* DC_CONTEXT_H */
|