kapi: add basic device subsystem

1 files changed, 46 insertions, 0 deletions

diff --git a/kapi/include/kapi/devices.hpp b/kapi/include/kapi/devices.hpp
new file mode 100644
index 0000000..60a39bd
--- /dev/null
+++ b/kapi/include/kapi/devices.hpp
@@ -0,0 +1,46 @@
+#ifndef TEACHOS_KAPI_DEVICES_HPP
+#define TEACHOS_KAPI_DEVICES_HPP
+
+#include "kapi/devices/bus.hpp"     // IWYU pragma: export
+#include "kapi/devices/device.hpp"  // IWYU pragma: export
+
+#include <cstddef>
+
+namespace kapi::devices
+{
+
+  //! @addtogroup kernel-defined
+  //! @{
+
+  //! Initialize the kernel's device management subsystem.
+  auto init() -> void;
+
+  //! Get the virtual system root bus.
+  //!
+  //! @warning This function will panic if the root bus has not been initialized.
+  //!
+  //! @return a reference to the root bus.
+  auto get_root_bus() -> bus &;
+
+  //! Ask the kernel to allocate a new major number.
+  //!
+  //! @return a new, unused major number.
+  auto allocate_major_number() -> std::size_t;
+
+  //! Register a new device with the kernel's device manager.
+  //!
+  //! @param device The device to register.
+  //! @return true if the device was registered successfully, false otherwise.
+  auto register_device(device & device) -> bool;
+
+  //! Unregister a device from the kernel's device manager.
+  //!
+  //! @param device The device to unregister.
+  //! @return true if the device was unregistered successfully, false otherwise.
+  auto unregister_device(device & device) -> bool;
+
+  //! @}
+
+}  // namespace kapi::devices
+
+#endif
\ No newline at end of file