Modules/UDI/include/udi_meta_mgmt.h

   1 /**
   2  * \file udi_meta_mgmt.h
   3  */
   4 #ifndef _UDI_META_MGMT_H_
   5 #define _UDI_META_MGMT_H_
   6
   7 typedef struct udi_mgmt_ops_s   udi_mgmt_ops_t;
   8 typedef struct udi_mgmt_cb_s    udi_mgmt_cb_t;
   9 typedef struct udi_usage_cb_s   udi_usage_cb_t;
  10 typedef struct udi_filter_element_s     udi_filter_element_t;
  11 typedef struct udi_enumerate_cb_s       udi_enumerate_cb_t;
  12
  13 /**
  14  * \name Specify Usage
  15  * \{
  16  */
  17 typedef void udi_usage_ind_op_t(udi_usage_cb_t *cb, udi_ubit8_t resource_level);
  18 /* Values for resource_level */
  19 #define UDI_RESOURCES_CRITICAL     1
  20 #define UDI_RESOURCES_LOW          2
  21 #define UDI_RESOURCES_NORMAL       3
  22 #define UDI_RESOURCES_PLENTIFUL    4
  23 /* Proxy */
  24 extern udi_usage_ind_op_t       udi_static_usage;
  25 /**
  26  * \}
  27  */
  28
  29 typedef void udi_usage_res_op_t(udi_usage_cb_t *cb);
  30
  31 /**
  32  * \name Enumerate this driver
  33  * \{
  34  */
  35 typedef void udi_enumerate_req_op_t(udi_enumerate_cb_t *cb, udi_ubit8_t enumeration_level);
  36 /* Values for enumeration_level */
  37 #define UDI_ENUMERATE_START           1
  38 #define UDI_ENUMERATE_START_RESCAN    2
  39 #define UDI_ENUMERATE_NEXT            3
  40 #define UDI_ENUMERATE_NEW             4
  41 #define UDI_ENUMERATE_DIRECTED        5
  42 #define UDI_ENUMERATE_RELEASE         6
  43 /* Proxy */
  44 extern udi_enumerate_req_op_t   udi_enumerate_no_children;
  45 /**
  46  * \}
  47  */
  48
  49 /**
  50  * \name Enumeration Acknowlagement
  51  * \{
  52  */
  53 typedef void udi_enumerate_ack_op_t(udi_enumerate_cb_t *cb, udi_ubit8_t enumeration_result, udi_index_t ops_idx);
  54 /* Values for enumeration_result */
  55 #define UDI_ENUMERATE_OK             0
  56 #define UDI_ENUMERATE_LEAF           1
  57 #define UDI_ENUMERATE_DONE           2
  58 #define UDI_ENUMERATE_RESCAN         3
  59 #define UDI_ENUMERATE_REMOVED        4
  60 #define UDI_ENUMERATE_REMOVED_SELF   5
  61 #define UDI_ENUMERATE_RELEASED       6
  62 #define UDI_ENUMERATE_FAILED         255
  63 /**
  64  * \}
  65  */
  66
  67 /**
  68  * \name
  69  * \{
  70  */
  71 typedef void udi_devmgmt_req_op_t(udi_mgmt_cb_t *cb, udi_ubit8_t mgmt_op, udi_ubit8_t parent_ID);
  72 /* Values for mgmt_op */
  73 #define UDI_DMGMT_PREPARE_TO_SUSPEND 1
  74 #define UDI_DMGMT_SUSPEND            2
  75 #define UDI_DMGMT_SHUTDOWN           3
  76 #define UDI_DMGMT_PARENT_SUSPENDED   4
  77 #define UDI_DMGMT_RESUME             5
  78 #define UDI_DMGMT_UNBIND             6
  79
  80 typedef void udi_devmgmt_ack_op_t(udi_mgmt_cb_t *cb, udi_ubit8_t flags, udi_status_t status);
  81 /* Values for flags */
  82 #define UDI_DMGMT_NONTRANSPARENT          (1U<<0)
  83 /* Meta-Specific Status Codes */
  84 #define UDI_DMGMT_STAT_ROUTING_CHANGE     (UDI_STAT_META_SPECIFIC|1)
  85 /**
  86  * \}
  87  */
  88 typedef void udi_final_cleanup_req_op_t(udi_mgmt_cb_t *cb);
  89 typedef void udi_final_cleanup_ack_op_t(udi_mgmt_cb_t *cb);
  90
  91
  92
  93
  94
  95 struct udi_mgmt_ops_s
  96 {
  97         udi_usage_ind_op_t      *usage_ind_op;
  98         udi_enumerate_req_op_t  *enumerate_req_op;
  99         udi_devmgmt_req_op_t    *devmgmt_req_op;
 100         udi_final_cleanup_req_op_t      *final_cleanup_req_op;
 101 };
 102
 103 struct udi_mgmt_cb_s
 104 {
 105         udi_cb_t        gcb;
 106 };
 107
 108 struct udi_usage_cb_s
 109 {
 110         udi_cb_t        gcb;
 111         udi_trevent_t   trace_mask;
 112         udi_index_t     meta_idx;
 113 };
 114
 115
 116 struct udi_filter_element_s
 117 {
 118      char       attr_name[UDI_MAX_ATTR_NAMELEN];
 119      udi_ubit8_t        attr_min[UDI_MAX_ATTR_SIZE];
 120      udi_ubit8_t        attr_min_len;
 121      udi_ubit8_t        attr_max[UDI_MAX_ATTR_SIZE];
 122      udi_ubit8_t        attr_max_len;
 123      udi_instance_attr_type_t   attr_type;
 124      udi_ubit32_t       attr_stride;
 125 };
 126 struct udi_enumerate_cb_s
 127 {
 128      udi_cb_t   gcb;
 129      udi_ubit32_t       child_ID;
 130      void       *child_data;
 131      udi_instance_attr_list_t   *attr_list;
 132      udi_ubit8_t        attr_valid_length;
 133      const udi_filter_element_t *filter_list;
 134      udi_ubit8_t        filter_list_length;
 135      udi_ubit8_t        parent_ID;
 136 };
 137 /* Special parent_ID filter values */
 138 #define UDI_ANY_PARENT_ID       0
 139
 140 #endif