Files
eskin-finger-sdk/include/eskin_ffi.h
lenn 96f1e7db1e feat: add EskinDeviceFunc FFI bindings and update Python/README
- Add FFI wrappers for all EskinDeviceFunc trait methods:
  eskin_read_hdw_version, eskin_read_matrix_row/col,
  eskin_read_device_config1/2, eskin_write_device_config1/2,
  eskin_write_matrix_row/col
- Extract sdk_error_to_code() helper for SdkError -> SdkErrorCode conversion
- Update C header (include/eskin_ffi.h) with new function declarations
- Update Python FFI bindings (example/python/eskin_ffi.py) with new methods
- Update README with Python usage instructions and full FFI interface table
2026-05-07 10:00:04 +08:00

120 lines
2.3 KiB
C++

#ifndef ESkin_FFI_H
#define ESkin_FFI_H
#include <cstdint>
#include <stdint.h>
#include <stdbool.h>
#ifdef __cplusplus
extern "C" {
#endif
typedef void* EskinDeviceHandle;
typedef struct {
uint16_t major;
uint16_t minor;
uint16_t patch;
} EskinSdkVersion;
typedef enum {
ESkinSuccess = 0,
ESkinInvalidPointer = 1,
ESkinDeviceNotFound = 2,
ESkinDeviceAlreadyOpen = 3,
ESkinNotInitialized = 4,
ESkinAlreadyStreaming = 5,
ESkinNotStreaming = 6,
ESkinConfigError = 7,
ESkinIoError = 8,
ESkinTimeout = 9,
ESkinChannelClosed = 10,
ESkinInternalError = 11,
ESkinBufferOverflow = 12,
ESkinInvalidParameter = 13,
ESkinCrcError = 14,
ESkinFrameError = 15,
ESkinProtocolError = 16,
ESkinDeviceError = 17,
} EskinSdkErrorCode;
EskinSdkVersion eskin_version(void);
EskinDeviceHandle eskin_open(const char* path, const void* config);
EskinSdkErrorCode eskin_close(EskinDeviceHandle handle);
EskinSdkErrorCode eskin_read_register(
EskinDeviceHandle handle,
uint32_t addr,
uint16_t length,
uint8_t* buf,
uint32_t buf_len,
uint32_t* actual_len
);
EskinSdkErrorCode eskin_write_register(
EskinDeviceHandle handle,
uint32_t addr,
const uint8_t* data,
uint16_t data_len,
uint16_t* return_count
);
// Device function interfaces (EskinDeviceFunc)
EskinSdkErrorCode eskin_read_hdw_version(
EskinDeviceHandle handle,
char* buf,
uint32_t buf_len,
uint32_t* actual_len
);
EskinSdkErrorCode eskin_read_matrix_row(
EskinDeviceHandle handle,
uint8_t* out
);
EskinSdkErrorCode eskin_read_matrix_col(
EskinDeviceHandle handle,
uint8_t* out
);
EskinSdkErrorCode eskin_read_device_config1(
EskinDeviceHandle handle,
uint8_t* out
);
EskinSdkErrorCode eskin_read_device_config2(
EskinDeviceHandle handle,
uint8_t* out
);
EskinSdkErrorCode eskin_write_device_config1(
EskinDeviceHandle handle,
bool enable,
uint16_t* return_count
);
EskinSdkErrorCode eskin_write_device_config2(
EskinDeviceHandle handle,
bool enable,
uint16_t* return_count
);
EskinSdkErrorCode eskin_write_matrix_row(
EskinDeviceHandle handle,
uint8_t row,
uint16_t* return_count
);
EskinSdkErrorCode eskin_write_matrix_col(
EskinDeviceHandle handle,
uint8_t col,
uint16_t* return_count
);
#ifdef __cplusplus
}
#endif
#endif