refactor: make pci device driver loading passive, pci bus scanner will not load them...

[lunaix-os.git] / lunaix-os / includes / lunaix / device.h

diff --git a/lunaix-os/includes/lunaix/device.h b/lunaix-os/includes/lunaix/device.h
index af21cb35d0062f1dbbe12f674c05819a14b4e9e3..f65082126313c81202e0b587d7ae869849c73d01 100644 (file)
--- a/lunaix-os/includes/lunaix/device.h
+++ b/lunaix-os/includes/lunaix/device.h
@@ -8,51 +8,79 @@
 #include <lunaix/ds/hstr.h>
 #include <lunaix/ds/ldga.h>
 #include <lunaix/ds/llist.h>
 #include <lunaix/ds/hstr.h>
 #include <lunaix/ds/ldga.h>
 #include <lunaix/ds/llist.h>

-#include <lunaix/ds/semaphore.h>
+#include <lunaix/ds/mutex.h>

 #include <lunaix/types.h>
 
 #include <lunaix/types.h>
 

+#include <usr/lunaix/device.h>
+

 /**
 /**

- * @brief Export a device definition
+ * @brief Export a device definition (i.e., device driver metadata)

  *
  */
 #define EXPORT_DEVICE(id, devdef, load_order)                                  \
     export_ldga_el(devdefs, id, ptr_t, devdef);                                \
     export_ldga_el_sfx(devdefs, id##_ldorder, ptr_t, devdef, load_order);
 
  *
  */
 #define EXPORT_DEVICE(id, devdef, load_order)                                  \
     export_ldga_el(devdefs, id, ptr_t, devdef);                                \
     export_ldga_el_sfx(devdefs, id##_ldorder, ptr_t, devdef, load_order);
 

+/**
+ * @brief Mark the device definition can be loaded on demand, all other loading
+ * options are extended from this
+ */

 #define load_on_demand ld_ondemand
 
 /**
 #define load_on_demand ld_ondemand
 
 /**

- * @brief Mark the device definition should be loaded automatically as earlier
- * as possible in the kernel bootstrapping stage (before initialization of file
- * systems). Load here if your driver is standalone and require no other than
- * basic memory allocation services
+ * @brief Mark the device definition to be loaded as system configuration
+ * device. These kind of devices are defined to be the devices that talk to the
+ * system firmware to do config, or collecting crucial information about the
+ * system. For instances, ACPI, SoC components, and other **interconnection**
+ * buese (not USB!). Such device driver must only rely on basic memory
+ * management service, and must not try accessing subsystems other than the mm
+ * unit, for example, timer, interrupt, file-system, must not assumed exist.

  *
  */
  *
  */

-#define load_earlystage ld_early
+#define load_sysconf ld_sysconf
+
+/**
+ * @brief Mark the device definition should be loaded as time device, for
+ * example a real time clock device. Such device will be loaded and managed by
+ * clock subsystem
+ */
+#define load_timedev ld_timedev

 
 /**
 
 /**

- * @brief Mark the device definition should be loaded automatically after timer
- * is ready. Load here if your driver require a basic timing service
+ * @brief Mark the device definition should be loaded automatically during the
+ * bootstrapping stage. Most of the driver do load there.

  *
  */
  *
  */

-#define load_timerstage ld_aftertimer
+#define load_onboot ld_kboot

 
 /**
  * @brief Mark the device definition should be loaded automatically in
 
 /**
  * @brief Mark the device definition should be loaded automatically in

- * the post boostrapping stage (i.e., the start up of proc0). Load here if your
- * driver involves async mechanism
+ * the post boostrapping stage (i.e., the start up of proc0), where most of
+ * kernel sub-system are became ready to use. Do your load there if your driver
+ * depends on such condition

  *
  */
  *
  */

-#define load_poststage ld_post
+#define load_postboot ld_post
+
+#define __foreach_exported_device_of(stage, index, pos)                        \
+    ldga_foreach(dev_##stage, struct device_def*, index, pos)
+#define foreach_exported_device_of(stage, index, pos)                          \
+    __foreach_exported_device_of(stage, index, pos)

 
 /**
  * @brief Declare a device class
  *
  */
 
 /**
  * @brief Declare a device class
  *
  */

-#define DEVCLASS(devif, devfn, devkind, devvar)                                \
+#define DEVCLASS(devif, devfn, dev)                                            \
+    (struct devclass)                                                          \
+    {                                                                          \
+        .fn_grp = DEV_FNGRP(devif, devfn), .device = (dev), .variant = 0       \
+    }
+
+#define DEVCLASSV(devif, devfn, dev, devvar)                                   \

     (struct devclass)                                                          \
     {                                                                          \
     (struct devclass)                                                          \
     {                                                                          \

-        .meta = DEV_META(devif, devfn), .device = (devkind),                   \
+        .fn_grp = DEV_FNGRP(devif, devfn), .device = (dev),                    \

         .variant = (devvar)                                                    \
     }
 
         .variant = (devvar)                                                    \
     }
 


@@ -65,24 +93,19 @@
 #define DEV_IFCAT 0x2 // a device category (as device groupping)
 #define DEV_IFSYS 0x3 // a system device
 
 #define DEV_IFCAT 0x2 // a device category (as device groupping)
 #define DEV_IFSYS 0x3 // a system device
 

-struct devclass
-{
-    u32_t meta;
-    u32_t device;
-    u32_t variant;
-    u32_t hash;
-};
-

 struct device
 {
     u32_t magic;
     struct llist_header siblings;
     struct llist_header children;
     struct device* parent;
 struct device
 {
     u32_t magic;
     struct llist_header siblings;
     struct llist_header children;
     struct device* parent;

+    mutex_t lock;
+

     // TODO investigate event polling
 
     struct hstr name;
     // TODO investigate event polling
 
     struct hstr name;

-    struct devclass* class;
+    struct devident ident;
+

     u32_t dev_uid;
     int dev_type;
     char name_val[DEVICE_NAME_SIZE];
     u32_t dev_uid;
     int dev_type;
     char name_val[DEVICE_NAME_SIZE];


@@ -111,15 +134,26 @@ struct device_def
 
     struct devclass class;
 
 
     struct devclass class;
 

+    /**
+     * @brief Called when the driver is required to initialize itself.
+     *
+     */

     int (*init)(struct device_def*);
     int (*init)(struct device_def*);

-    int (*init_for)(struct device_def*, struct device*);
-};

 
 

-static inline u32_t devclass_hash(struct devclass class)
-{
-    return (((class.device & 0xffff) << 16) | (class.variant & 0xffff)) ^
-           ~class.meta;
-}
+    /**
+     * @brief Called when the driver is required to bind with a device. This is
+     * the case for a real-hardware-oriented driver
+     *
+     */
+    int (*bind)(struct device_def*, struct device*);
+
+    /**
+     * @brief Called when a driver is requested to detach from the device and
+     * free up all it's resources
+     *
+     */
+    int (*free)(struct device_def*, void* instance);
+};

 
 static inline u32_t
 device_id_from_class(struct devclass* class)
 
 static inline u32_t
 device_id_from_class(struct devclass* class)


@@ -128,53 +162,43 @@ device_id_from_class(struct devclass* class)
 }
 
 void
 }
 
 void

-device_register_all();
+device_scan_drivers();

 
 void
 
 void

-device_prepare(struct device* dev, struct devclass* class);
+device_setname_vargs(struct device* dev, char* fmt, va_list args);

 
 void
 device_setname(struct device* dev, char* fmt, ...);
 
 void
 
 void
 device_setname(struct device* dev, char* fmt, ...);
 
 void

-device_setname(struct device* dev, char* fmt, ...);
+device_register(struct device* dev, struct devclass* class, char* fmt, ...);

 
 

-struct device*
-device_add_vargs(struct device* parent,
-                 void* underlay,
-                 char* name_fmt,
-                 u32_t type,
-                 struct devclass* class,
-                 va_list args);
+void
+device_create(struct device* dev,
+              struct device* parent,
+              u32_t type,
+              void* underlay);

 
 struct device*
 
 struct device*

-device_add(struct device* parent,
-           struct devclass* class,
-           void* underlay,
-           u32_t type,
-           char* name_fmt,
-           ...);
+device_alloc(struct device* parent, u32_t type, void* underlay);

 
 

-struct device*
-device_addsys(struct device* parent,
-              struct devclass* class,
-              void* underlay,
-              char* name_fmt,
-              ...);
+static inline struct device*
+device_allocsys(struct device* parent, void* underlay)
+{
+    return device_alloc(parent, DEV_IFSYS, underlay);
+}

 
 

-struct device*
-device_addseq(struct device* parent,
-              struct devclass* class,
-              void* underlay,
-              char* name_fmt,
-              ...);
+static inline struct device*
+device_allocseq(struct device* parent, void* underlay)
+{
+    return device_alloc(parent, DEV_IFSEQ, underlay);
+}

 
 

-struct device*
-device_addvol(struct device* parent,
-              struct devclass* class,
-              void* underlay,
-              char* name_fmt,
-              ...);
+static inline struct device*
+device_allocvol(struct device* parent, void* underlay)
+{
+    return device_alloc(parent, DEV_IFVOL, underlay);
+}

 
 struct device*
 device_addcat(struct device* parent, char* name_fmt, ...);
 
 struct device*
 device_addcat(struct device* parent, char* name_fmt, ...);


@@ -195,29 +219,49 @@ struct device*
 device_getbyoffset(struct device* root_dev, int pos);
 
 struct device*
 device_getbyoffset(struct device* root_dev, int pos);
 
 struct device*

-device_create_byclass(struct devclass* class,
-                      u32_t type,
-                      char* name,
-                      int* err_code);
+device_cast(void* obj);

 
 struct hbucket*
 device_definitions_byif(int if_type);
 
 struct device_def*
 
 struct hbucket*
 device_definitions_byif(int if_type);
 
 struct device_def*

-devdef_byclass(struct devclass* class);
+devdef_byident(struct devident* class);
+
+void
+device_populate_info(struct device* dev, struct dev_info* devinfo);

 
 void
 
 void

-device_register_all();
+device_scan_drivers();

 
 /*------ Load hooks ------*/
 
 void
 
 /*------ Load hooks ------*/
 
 void

-device_earlystage();
+device_onbooot_load();

 
 void
 
 void

-device_poststage();
+device_postboot_load();

 
 void
 
 void

-device_timerstage();
+device_sysconf_load();
+
+static inline void
+device_lock(struct device* dev)
+{
+    mutex_lock(&dev->lock);
+}
+
+static inline void
+device_unlock(struct device* dev)
+{
+    mutex_unlock(&dev->lock);
+}
+
+static inline int
+device_locked(struct device* dev)
+{
+    return mutex_on_hold(&dev->lock);
+}
+
+#define devprintf_expand(devident) (devident)->fn_grp, (devident)->unique

 
 #endif /* __LUNAIX_DEVICE_H */
 
 #endif /* __LUNAIX_DEVICE_H */