chip.h

浏览该文件的文档.

 
#ifndef __xwcd_ds_soc_chip_h__
#define __xwcd_ds_soc_chip_h__
 
#include <xwcd/ds/standard.h>
#include <xwcd/ds/device.h>
 
#if defined(XWCDCFG_ds_SOC_EIRQ_ROISRT) && (1 == XWCDCFG_ds_SOC_EIRQ_ROISRT)
#  define __xwds_soc_eirq_tbl_qualifier const
#else
#  define __xwds_soc_eirq_tbl_qualifier
#endif
 
#if defined(XWCDCFG_ds_SOC_DMA_ROCBT) && (1 == XWCDCFG_ds_SOC_DMA_ROCBT)
#  define __xwds_soc_dma_tbl_qualifier const
#else
#  define __xwds_soc_dma_tbl_qualifier
#endif
 
struct xwds_soc;
struct xwds_dma_cfg;
 
struct xwds_soc_driver {
        struct xwds_driver base; 
        xwer_t (* get_reset_reason)(struct xwds_soc * /*soc*/,
                                    xwu64_t * /*reason*/); 
#if defined(XWCDCFG_ds_SOC_CLK) && (1 == XWCDCFG_ds_SOC_CLK)
        xwer_t (* clk_req)(struct xwds_soc * /*soc*/,
                           xwid_t /*id*/); 
        xwer_t (* clk_rls)(struct xwds_soc * /*soc*/,
                           xwid_t /*id*/); 
        xwer_t (* clk_getfqcy)(struct xwds_soc * /*soc*/,
                               xwid_t /*id*/,
                               xwu32_t * /*buf*/,
                               xwsz_t * /*num*/); 
#endif
 
#if defined(XWCDCFG_ds_SOC_PWR) && (1 == XWCDCFG_ds_SOC_PWR)
        xwer_t (* pwr_req)(struct xwds_soc * /*soc*/,
                           xwid_t /*id*/); 
        xwer_t (* pwr_rls)(struct xwds_soc * /*soc*/,
                           xwid_t /*id*/); 
        xwer_t (* pwr_getvltg)(struct xwds_soc * /*soc*/,
                               xwid_t /*id*/,
                               xwu32_t * /*buf*/,
                               xwsz_t * /*num*/); 
#endif
 
#if defined(XWCDCFG_ds_SOC_GPIO) && (1 == XWCDCFG_ds_SOC_GPIO)
        xwer_t (* gpio_req)(struct xwds_soc * /*soc*/,
                            xwid_t /*port*/,
                            xwsq_t /*pinmask*/); 
        xwer_t (* gpio_rls)(struct xwds_soc * /*soc*/,
                            xwid_t /*port*/,
                            xwid_t /*pinmask*/); 
        xwer_t (* gpio_cfg)(struct xwds_soc * /*soc*/,
                            xwid_t /*port*/,
                            xwsq_t /*pinmask*/,
                            void * /*cfg*/); 
        xwer_t (* gpio_output)(struct xwds_soc *,
                               xwid_t /*port*/,
                               xwsq_t /*pinmask*/,
                               xwsq_t /*out*/); 
        xwer_t (* gpio_set)(struct xwds_soc * /*soc*/,
                            xwid_t /*port*/,
                            xwsq_t /*pinmask*/); 
        xwer_t (* gpio_reset)(struct xwds_soc * /*soc*/,
                              xwid_t /*port*/,
                              xwsq_t /*pinmask*/); 
        xwer_t (* gpio_toggle)(struct xwds_soc * /*soc*/,
                               xwid_t /*port*/,
                               xwsq_t /*pinmask*/); 
        xwer_t (* gpio_input)(struct xwds_soc * /*soc*/,
                              xwid_t /*port*/,
                              xwsq_t /*pinmask*/,
                              xwsq_t * /*inbuf*/); 
#endif
 
#if defined(XWCDCFG_ds_SOC_EIRQ) && (1 == XWCDCFG_ds_SOC_EIRQ)
        xwer_t (* eirq_req)(struct xwds_soc * /*soc*/,
                            xwid_t /*port*/, xwsq_t /*pinmask*/,
                            xwid_t /*eiid*/, xwsq_t /*eiflag*/); 
        xwer_t (* eirq_rls)(struct xwds_soc * /*soc*/,
                            xwid_t /*port*/, xwsq_t /*pinmask*/,
                            xwid_t /*eiid*/); 
#endif
 
#if defined(XWCDCFG_ds_SOC_DMA) && (1 == XWCDCFG_ds_SOC_DMA)
        xwer_t (* dma_req)(struct xwds_soc * /*soc*/,
                           xwid_t /*ch*/); 
        xwer_t (* dma_rls)(struct xwds_soc * /*soc*/,
                           xwid_t /*ch*/); 
        xwer_t (* dma_cfg)(struct xwds_soc * /*soc*/,
                           xwid_t /*ch*/,
                           void * /*cfg*/); 
        xwer_t (* dma_enable)(struct xwds_soc * /*soc*/,
                              xwid_t /*ch*/); 
        xwer_t (* dma_disable)(struct xwds_soc * /*soc*/,
                               xwid_t /*ch*/); 
        xwer_t (* dma_start)(struct xwds_soc * /*soc*/,
                             xwid_t /*ch*/); 
        xwer_t (* dma_stop)(struct xwds_soc * /*soc*/,
                            xwid_t /*ch*/); 
#endif
};
 
typedef void * xwds_eirq_arg_t;
 
typedef void (* xwds_eirq_f)(struct xwds_soc *, xwid_t, xwds_eirq_arg_t);
 
typedef void * xwds_dma_cbarg_t;
 
typedef void (* xwds_dma_f)(struct xwds_soc * /* soc */,
                            xwid_t /* ch */,
                            xwu32_t /* rc */,
                            xwds_dma_cbarg_t /* arg */);
 
struct xwds_soc {
        struct xwds_device dev; 
        /* attributes */
        const void * xwccfg; 
#if (defined(XWCDCFG_ds_SOC_GPIO) && (1 == XWCDCFG_ds_SOC_GPIO))
        struct {
                void * cfg; 
                atomic_xwsq_t * pins; 
                xwsz_t port_num; 
                xwsz_t pin_num; 
        } gpio; 
#endif
#if (defined(XWCDCFG_ds_SOC_CLK) && (1 == XWCDCFG_ds_SOC_CLK))
        struct {
                xwsz_t num; 
        } clk; 
#endif
#if (defined(XWCDCFG_ds_SOC_PWR) && (1 == XWCDCFG_ds_SOC_PWR))
        struct {
                xwsz_t num; 
        } pwr; 
#endif
#if (defined(XWCDCFG_ds_SOC_EIRQ) && (1 == XWCDCFG_ds_SOC_EIRQ))
        struct {
                __xwds_soc_eirq_tbl_qualifier xwds_eirq_f * isrs; 
                __xwds_soc_eirq_tbl_qualifier xwds_eirq_arg_t * isrargs; 
                xwsz_t num; 
        } eirq; 
#endif
#if (defined(XWCDCFG_ds_SOC_DMA) && (1 == XWCDCFG_ds_SOC_DMA))
        struct {
                xwsz_t ch_num; 
                void * ccfg; 
                atomic_xwbmp_t * chstatus; 
                __xwds_soc_dma_tbl_qualifier xwds_dma_f * chcbs; 
                __xwds_soc_dma_tbl_qualifier xwds_dma_cbarg_t * chcbargs; 
        } dma; 
#endif
};
 
void xwds_soc_construct(struct xwds_soc * soc);
 
void xwds_soc_destruct(struct xwds_soc * soc);
 
xwer_t xwds_soc_grab(struct xwds_soc * soc);
 
xwer_t xwds_soc_put(struct xwds_soc * soc);
 
xwer_t xwds_soc_get_reset_reason(struct xwds_soc * soc, xwu64_t * reason);
 
#endif /* xwcd/ds/soc/chip.h */