#pragma once
#include "common.h"
+#include "mraa.h"
+#include "mraa_adv_func.h"
+#include "iio.h"
+
+// Bionic does not implement pthread cancellation API
+#ifndef __BIONIC__
+#define HAVE_PTHREAD_CANCEL
+#endif
// general status failures for internal functions
#define MRAA_PLATFORM_NO_INIT -3
void *isr_args; /**< args return when interupt service request triggered */
pthread_t thread_id; /**< the isr handler thread id */
int isr_value_fp; /**< the isr file pointer on the value */
+#ifndef HAVE_PTHREAD_CANCEL
+ int isr_control_pipe[2]; /**< a pipe used to interrupt the isr from polling the value fd*/
+#endif
+ mraa_boolean_t isr_thread_terminating; /**< is the isr thread being terminated? */
mraa_boolean_t owner; /**< If this context originally exported the pin */
- mraa_boolean_t mmap;
- void *reg;
- unsigned int reg_sz;
- unsigned int reg_bit_pos;
+ mraa_result_t (*mmap_write) (mraa_gpio_context dev, int value);
+ int (*mmap_read) (mraa_gpio_context dev);
+ mraa_adv_func_t* advance_func; /**< override function table */
/*@}*/
};
*/
struct _i2c {
/*@{*/
- int hz; /**< frequency of communication */
+ int busnum; /**< the bus number of the /dev/i2c-* device */
int fh; /**< the file handle to the /dev/i2c-* device */
int addr; /**< the address of the i2c slave */
+ unsigned long funcs; /**< /dev/i2c-* device capabilities as per https://www.kernel.org/doc/Documentation/i2c/functionality */
+ void *handle; /**< generic handle for non-standard drivers that don't use file descriptors */
+ mraa_adv_func_t* advance_func; /**< override function table */
+ /*@}*/
+};
+
+/**
+ * A structure representing the SPI device
+ */
+struct _spi {
+ /*@{*/
+ int devfd; /**< File descriptor to SPI Device */
+ uint32_t mode; /**< Spi mode see spidev.h */
+ int clock; /**< clock to run transactions at */
+ mraa_boolean_t lsb; /**< least significant bit mode */
+ unsigned int bpw; /**< Bits per word */
+ mraa_adv_func_t* advance_func; /**< override function table */
/*@}*/
};
int pin; /**< the pin number, as known to the os. */
int chipid; /**< the chip id, which the pwm resides */
int duty_fp; /**< File pointer to duty file */
+ int period; /**< Cache the period to speed up setting duty */
mraa_boolean_t owner; /**< Owner of pwm context*/
+ mraa_adv_func_t* advance_func; /**< override function table */
/*@}*/
};
* A structure representing a Analog Input Channel
*/
struct _aio {
+ /*@{*/
unsigned int channel; /**< the channel as on board and ADC module */
int adc_in_fp; /**< File Pointer to raw sysfs */
int value_bit; /**< 10 bits by default. Can be increased if board */
+ mraa_adv_func_t* advance_func; /**< override function table */
+ /*@}*/
};
/**
struct _uart {
/*@{*/
int index; /**< the uart index, as known to the os. */
+ const char* path; /**< the uart device path. */
+ int fd; /**< file descriptor for device. */
+ mraa_adv_func_t* advance_func; /**< override function table */
/*@}*/
};
+
+/**
+ * A structure representing an IIO device
+ */
+struct _iio {
+ int num; /**< IIO device number */
+ char* name; /**< IIO device name */
+ int fp; /**< IIO device in /dev */
+ int fp_event; /**< event file descriptor for IIO device */
+ void (* isr)(char* data); /**< the interupt service request */
+ void *isr_args; /**< args return when interupt service request triggered */
+ void (* isr_event)(struct iio_event_data* data, void* args); /**< the event interupt service request */
+ int chan_num;
+ pthread_t thread_id; /**< the isr handler thread id */
+ mraa_iio_channel* channels;
+ int event_num;
+ mraa_iio_event* events;
+ int datasize;
+};
+
+/**
+ * A bitfield representing the capabilities of a pin.
+ */
+typedef struct {
+ /*@{*/
+ mraa_boolean_t valid:1; /**< Is the pin valid at all */
+ mraa_boolean_t gpio:1; /**< Is the pin gpio capable */
+ mraa_boolean_t pwm:1; /**< Is the pin pwm capable */
+ mraa_boolean_t fast_gpio:1; /**< Is the pin fast gpio capable */
+ mraa_boolean_t spi:1; /**< Is the pin spi capable */
+ mraa_boolean_t i2c:1; /**< Is the pin i2c capable */
+ mraa_boolean_t aio:1; /**< Is the pin analog input capable */
+ mraa_boolean_t uart:1; /**< Is the pin uart capable */
+ /*@}*/
+} mraa_pincapabilities_t;
+
+/**
+ * A Structure representing a multiplexer and the required value
+ */
+typedef struct {
+ /*@{*/
+ unsigned int pin; /**< Raw GPIO pin id */
+ unsigned int value; /**< Raw GPIO value */
+ /*@}*/
+} mraa_mux_t;
+
+typedef struct {
+ mraa_boolean_t complex_pin:1;
+ mraa_boolean_t output_en:1;
+ mraa_boolean_t output_en_high:1;
+ mraa_boolean_t pullup_en:1;
+ mraa_boolean_t pullup_en_hiz:1;
+} mraa_pin_cap_complex_t;
+
+typedef struct {
+ /*@{*/
+ unsigned int pinmap; /**< sysfs pin */
+ unsigned int parent_id; /** parent chip id */
+ unsigned int mux_total; /** Numfer of muxes needed for operation of pin */
+ mraa_mux_t mux[6]; /** Array holding information about mux */
+ unsigned int output_enable; /** Output Enable GPIO, for level shifting */
+ unsigned int pullup_enable; /** Pull-Up enable GPIO, inputs */
+ mraa_pin_cap_complex_t complex_cap;
+ /*@}*/
+} mraa_pin_t;
+
+typedef struct {
+ /*@{*/
+ char mem_dev[32]; /**< Memory device to use /dev/uio0 etc */
+ unsigned int mem_sz; /** Size of memory to map */
+ unsigned int bit_pos; /** Position of value bit */
+ mraa_pin_t gpio; /** GPio context containing none mmap info */
+ /*@}*/
+} mraa_mmap_pin_t;
+
+/**
+ * A Structure representing a physical Pin.
+ */
+typedef struct {
+ /*@{*/
+ char name[MRAA_PIN_NAME_SIZE]; /**< Pin's real world name */
+ mraa_pincapabilities_t capabilites; /**< Pin Capabiliites */
+ mraa_pin_t gpio; /**< GPIO structure */
+ mraa_pin_t pwm; /**< PWM structure */
+ mraa_pin_t aio; /**< Anaglog Pin */
+ mraa_mmap_pin_t mmap; /**< GPIO through memory */
+ mraa_pin_t i2c; /**< i2c bus/pin */
+ mraa_pin_t spi; /**< spi bus/pin */
+ mraa_pin_t uart; /**< uart module/pin */
+ /*@}*/
+} mraa_pininfo_t;
+
+/**
+ * A Structure representing the physical properties of a i2c bus.
+ */
+typedef struct {
+ /*@{*/
+ unsigned int bus_id; /**< ID as exposed in the system */
+ unsigned int scl; /**< i2c SCL */
+ unsigned int sda; /**< i2c SDA */
+ // mraa_drv_api_t drv_type; /**< Driver type */
+ /*@}*/
+} mraa_i2c_bus_t;
+
+/**
+ * A Structure representing the physical properties of a spi bus.
+ */
+typedef struct {
+ /*@{*/
+ unsigned int bus_id; /**< The Bus ID as exposed to the system. */
+ unsigned int slave_s; /**< Slave select */
+ mraa_boolean_t three_wire; /**< Is the bus only a three wire system */
+ unsigned int sclk; /**< Serial Clock */
+ unsigned int mosi; /**< Master Out, Slave In. */
+ unsigned int miso; /**< Master In, Slave Out. */
+ unsigned int cs; /**< Chip Select, used when the board is a spi slave */
+ /*@}*/
+} mraa_spi_bus_t;
+
+/**
+ * A Structure representing a uart device.
+ */
+typedef struct {
+ /*@{*/
+ unsigned int index; /**< ID as exposed in the system */
+ int rx; /**< uart rx */
+ int tx; /**< uart tx */
+ const char* device_path; /**< To store "/dev/ttyS1" for example */
+ /*@}*/
+} mraa_uart_dev_t;
+
+/**
+ * A Structure representing a platform/board.
+ */
+
+typedef struct _board_t {
+ /*@{*/
+ unsigned int phy_pin_count; /**< The Total IO pins on board */
+ unsigned int gpio_count; /**< GPIO Count */
+ unsigned int aio_count; /**< Analog side Count */
+ unsigned int i2c_bus_count; /**< Usable i2c Count */
+ mraa_i2c_bus_t i2c_bus[12]; /**< Array of i2c */
+ unsigned int def_i2c_bus; /**< Position in array of default i2c bus */
+ unsigned int spi_bus_count; /**< Usable spi Count */
+ mraa_spi_bus_t spi_bus[12]; /**< Array of spi */
+ unsigned int def_spi_bus; /**< Position in array of defult spi bus */
+ unsigned int adc_raw; /**< ADC raw bit value */
+ unsigned int adc_supported; /**< ADC supported bit value */
+ unsigned int def_uart_dev; /**< Position in array of defult uart */
+ unsigned int uart_dev_count; /**< Usable spi Count */
+ mraa_uart_dev_t uart_dev[6]; /**< Array of UARTs */
+ mraa_boolean_t no_bus_mux; /**< i2c/spi/adc/pwm/uart bus muxing setup not required */
+ int pwm_default_period; /**< The default PWM period is US */
+ int pwm_max_period; /**< Maximum period in us */
+ int pwm_min_period; /**< Minimum period in us */
+ mraa_platform_t platform_type; /**< Platform type */
+ const char* platform_name; /**< Platform Name pointer */
+ mraa_pininfo_t* pins; /**< Pointer to pin array */
+ mraa_adv_func_t* adv_func; /**< Pointer to advanced function disptach table */
+ struct _board_t* sub_platform; /**< Pointer to sub platform */
+ /*@}*/
+} mraa_board_t;
+
+typedef struct {
+ struct _iio* iio_devices; /**< Pointer to IIO devices */
+ uint8_t iio_device_count; /**< IIO device count */
+} mraa_iio_info_t;