LXR linux/include/linux/of

   1/*
   2 * OF helpers for DMA request / controller
   3 *
   4 * Based on of_gpio.h
   5 *
   6 * Copyright (C) 2012 Texas Instruments Incorporated - http://www.ti.com/
   7 *
   8 * This program is free software; you can redistribute it and/or modify
   9 * it under the terms of the GNU General Public License version 2 as
  10 * published by the Free Software Foundation.
  11 */
  12
  13#ifndef __LINUX_OF_DMA_H
  14#define __LINUX_OF_DMA_H
  15
  16#include <linux/of.h>
  17#include <linux/dmaengine.h>
  18
  19struct device_node;
  20
  21struct of_dma {
  22        struct list_head        of_dma_controllers;
  23        struct device_node      *of_node;
  24        struct dma_chan         *(*of_dma_xlate)
  25                                (struct of_phandle_args *, struct of_dma *);
  26        void                    *(*of_dma_route_allocate)
  27                                (struct of_phandle_args *, struct of_dma *);
  28        struct dma_router       *dma_router;
  29        void                    *of_dma_data;
  30};
  31
  32struct of_dma_filter_info {
  33        dma_cap_mask_t  dma_cap;
  34        dma_filter_fn   filter_fn;
  35};
  36
  37#ifdef CONFIG_DMA_OF
  38extern int of_dma_controller_register(struct device_node *np,
  39                struct dma_chan *(*of_dma_xlate)
  40                (struct of_phandle_args *, struct of_dma *),
  41                void *data);
  42extern void of_dma_controller_free(struct device_node *np);
  43
  44extern int of_dma_router_register(struct device_node *np,
  45                void *(*of_dma_route_allocate)
  46                (struct of_phandle_args *, struct of_dma *),
  47                struct dma_router *dma_router);
  48#define of_dma_router_free of_dma_controller_free
  49
  50extern struct dma_chan *of_dma_request_slave_channel(struct device_node *np,
  51                                                     const char *name);
  52extern struct dma_chan *of_dma_simple_xlate(struct of_phandle_args *dma_spec,
  53                struct of_dma *ofdma);
  54extern struct dma_chan *of_dma_xlate_by_chan_id(struct of_phandle_args *dma_spec,
  55                struct of_dma *ofdma);
  56
  57#else
  58static inline int of_dma_controller_register(struct device_node *np,
  59                struct dma_chan *(*of_dma_xlate)
  60                (struct of_phandle_args *, struct of_dma *),
  61                void *data)
  62{
  63        return -ENODEV;
  64}
  65
  66static inline void of_dma_controller_free(struct device_node *np)
  67{
  68}
  69
  70static inline int of_dma_router_register(struct device_node *np,
  71                void *(*of_dma_route_allocate)
  72                (struct of_phandle_args *, struct of_dma *),
  73                struct dma_router *dma_router)
  74{
  75        return -ENODEV;
  76}
  77
  78#define of_dma_router_free of_dma_controller_free
  79
  80static inline struct dma_chan *of_dma_request_slave_channel(struct device_node *np,
  81                                                     const char *name)
  82{
  83        return ERR_PTR(-ENODEV);
  84}
  85
  86static inline struct dma_chan *of_dma_simple_xlate(struct of_phandle_args *dma_spec,
  87                struct of_dma *ofdma)
  88{
  89        return NULL;
  90}
  91
  92#define of_dma_xlate_by_chan_id NULL
  93
  94#endif
  95
  96#endif /* __LINUX_OF_DMA_H */
  97