Added generic device model.
authorMichael Brown <mcb30@etherboot.org>
Tue, 16 May 2006 14:10:21 +0000 (14:10 +0000)
committerMichael Brown <mcb30@etherboot.org>
Tue, 16 May 2006 14:10:21 +0000 (14:10 +0000)
src/core/device.c [new file with mode: 0644]
src/include/gpxe/device.h [new file with mode: 0644]

diff --git a/src/core/device.c b/src/core/device.c
new file mode 100644 (file)
index 0000000..e54ab29
--- /dev/null
@@ -0,0 +1,97 @@
+/*
+ * Copyright (C) 2006 Michael Brown <mbrown@fensystems.co.uk>.
+ *
+ * This program is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU General Public License as
+ * published by the Free Software Foundation; either version 2 of the
+ * License, or any later version.
+ *
+ * This program is distributed in the hope that it will be useful, but
+ * WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
+ * General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+ */
+
+#include <gpxe/list.h>
+#include <gpxe/tables.h>
+#include <gpxe/device.h>
+
+/**
+ * @file
+ *
+ * Device model
+ *
+ */
+
+static struct root_device root_devices[0] __table_start ( root_devices );
+static struct root_device root_devices_end[0] __table_end ( root_devices );
+
+/** Registered root devices */
+static LIST_HEAD ( devices );
+
+/**
+ * Register a root device
+ *
+ * @v rootdev          Root device
+ * @ret rc             Return status code
+ *
+ * Calls the root device driver's probe() method, and adds it to the
+ * list of registered root devices if successful.
+ */
+static int register_rootdev ( struct root_device *rootdev ) {
+       int rc;
+
+       DBG ( "Registering %s root bus\n", rootdev->name );
+
+       if ( ( rc = rootdev->driver->probe ( rootdev ) ) != 0 )
+               return rc;
+
+       list_add ( &rootdev->dev.siblings, &devices );
+       return 0;
+}
+
+/**
+ * Unregister a root device
+ *
+ * @v rootdev          Root device
+ */
+static void unregister_rootdev ( struct root_device *rootdev ) {
+       rootdev->driver->remove ( rootdev );
+       list_del ( &rootdev->dev.siblings );
+       DBG ( "Unregistered %s root bus\n", rootdev->name );
+}
+
+/**
+ * Probe all devices
+ *
+ * @ret rc             Return status code
+ *
+ * This initiates probing for all devices in the system.  After this
+ * call, the device hierarchy will be populated, and all hardware
+ * should be ready to use.
+ */
+int probe_devices ( void ) {
+       struct root_device *rootdev;
+
+       for ( rootdev = root_devices; rootdev < root_devices_end; rootdev++ ) {
+               register_rootdev ( rootdev );
+       }
+       return 0;
+}
+
+/**
+ * Remove all devices
+ *
+ */
+void remove_devices ( void ) {
+       struct root_device *rootdev;
+       struct root_device *tmp;
+
+       list_for_each_entry_safe ( rootdev, tmp, &devices, dev.siblings ) {
+               unregister_rootdev ( rootdev );
+       }
+}
diff --git a/src/include/gpxe/device.h b/src/include/gpxe/device.h
new file mode 100644 (file)
index 0000000..43bbf60
--- /dev/null
@@ -0,0 +1,70 @@
+#ifndef _GPXE_DEVICE_H
+#define _GPXE_DEVICE_H
+
+/**
+ * @file
+ *
+ * Device model
+ *
+ */
+
+#include <gpxe/list.h>
+#include <gpxe/tables.h>
+
+/** A hardware device */
+struct device {
+       /** Devices on the same bus */
+       struct list_head siblings;
+       /** Devices attached to this device */
+       struct list_head children;
+       /** Bus device */
+       struct device *parent;
+};
+
+/**
+ * A root device
+ *
+ * Root devices are system buses such as PCI, EISA, etc.
+ *
+ */
+struct root_device {
+       /** Name */
+       const char *name;
+       /** Device chain
+        *
+        * A root device has a NULL parent field.
+        */
+       struct device dev;
+       /** Root device driver */
+       struct root_driver *driver;
+};
+
+/** A root device driver */
+struct root_driver {
+       /**
+        * Add root device
+        *
+        * @v rootdev   Root device
+        * @ret rc      Return status code
+        *
+        * Called from probe_devices() for all root devices in the build.
+        */
+       int ( * probe ) ( struct root_device *rootdev );
+       /**
+        * Remove root device
+        *
+        * @v rootdev   Root device
+        *
+        * Called from remove_device() for all successfully-probed
+        * root devices.
+        */
+       void ( * remove ) ( struct root_device *rootdev );
+};
+
+/** Declare a root device */
+#define __root_device __table ( root_devices, 01 )
+
+extern int probe_devices ( void );
+extern void remove_devices ( void );
+
+#endif /* _GPXE_DEVICE_H */