mirror of
https://github.com/subsurface/subsurface.git
synced 2025-02-01 00:43:24 +00:00
fa250906c9
This just adds the basic structures and the accessor functions needed to manage a table of fingerprint data. The table is indexed by the hash of the model name and binary serial number as created by libdivcecomputer. This way the data is accessible when libdivecomputer fist accesses a dive computer (which is the point in time when we need to use the fingerprint. The table also contains the corresponding device id and dive id so we can verify that the current dive table still contains that dive. Signed-off-by: Dirk Hohndel <dirk@hohndel.org>
91 lines
3.6 KiB
C++
91 lines
3.6 KiB
C++
// SPDX-License-Identifier: GPL-2.0
|
|
#ifndef DEVICE_H
|
|
#define DEVICE_H
|
|
|
|
#include <stdint.h>
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
struct divecomputer;
|
|
struct device;
|
|
struct device_table;
|
|
struct dive_table;
|
|
|
|
// global device table
|
|
extern struct device_table device_table;
|
|
extern struct fingerprint_table fingerprint_table;
|
|
|
|
extern int create_device_node(struct device_table *table, const char *model, const char *serial, const char *nickname);
|
|
extern int nr_devices(const struct device_table *table);
|
|
extern const struct device *get_device(const struct device_table *table, int i);
|
|
extern struct device *get_device_mutable(struct device_table *table, int i);
|
|
extern void clear_device_table(struct device_table *table);
|
|
const char *get_dc_nickname(const struct divecomputer *dc);
|
|
extern bool device_used_by_selected_dive(const struct device *dev);
|
|
|
|
extern const struct device *get_device_for_dc(const struct device_table *table, const struct divecomputer *dc);
|
|
extern int get_or_add_device_for_dc(struct device_table *table, const struct divecomputer *dc);
|
|
extern bool device_exists(const struct device_table *table, const struct device *dev);
|
|
extern int add_to_device_table(struct device_table *table, const struct device *dev); // returns index
|
|
extern int remove_device(struct device_table *table, const struct device *dev); // returns index or -1 if not found
|
|
extern void remove_from_device_table(struct device_table *table, int idx);
|
|
|
|
// struct device accessors for C-code. The returned strings are not stable!
|
|
const char *device_get_model(const struct device *dev);
|
|
const char *device_get_serial(const struct device *dev);
|
|
const char *device_get_nickname(const struct device *dev);
|
|
|
|
// for C code that needs to alloc/free a device table. (Let's try to get rid of those)
|
|
extern struct device_table *alloc_device_table();
|
|
extern void free_device_table(struct device_table *devices);
|
|
|
|
// create fingerprint entry - raw data remains owned by caller
|
|
extern void create_fingerprint_node(struct fingerprint_table *table, uint32_t model, uint32_t serial,
|
|
const unsigned char *raw_data, unsigned int fsize, uint32_t fdeviceid, uint32_t fdiveid);
|
|
// look up the fingerprint for model/serial - returns the number of bytes in the fingerprint; memory owned by the table
|
|
extern unsigned int get_fingerprint_data(const struct fingerprint_table *table, uint32_t model, uint32_t serial, const unsigned char **fp_out);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
// Functions and global variables that are only available to C++ code
|
|
#ifdef __cplusplus
|
|
|
|
#include <string>
|
|
#include <vector>
|
|
struct device {
|
|
bool operator==(const device &a) const; // TODO: remove, once devices are integrated in the undo system
|
|
bool operator<(const device &a) const;
|
|
void showchanges(const std::string &n) const;
|
|
std::string model;
|
|
std::string serialNumber;
|
|
std::string nickName;
|
|
uint32_t deviceId; // Always the string hash of the serialNumber
|
|
};
|
|
|
|
struct fingerprint_record {
|
|
bool operator<(const fingerprint_record &a) const;
|
|
uint32_t model; // model and libdivecomputer serial number to
|
|
uint32_t serial; // look up the fingerprint
|
|
unsigned char *raw_data; // fingerprint data as provided by libdivecomputer
|
|
unsigned int fsize; // size of raw fingerprint data
|
|
unsigned int fdeviceid; // corresponding deviceid
|
|
unsigned int fdiveid; // corresponding diveid
|
|
};
|
|
|
|
struct device_table {
|
|
// Keep the dive computers in a vector sorted by (model, serial)
|
|
std::vector<device> devices;
|
|
};
|
|
|
|
struct fingerprint_table {
|
|
// Keep the fingerprint records in a vector sorted by (model, serial) - these are uint32_t here
|
|
std::vector<fingerprint_record> fingerprints;
|
|
};
|
|
|
|
#endif
|
|
|
|
#endif // DEVICE_H
|