Ns16550aDriver Class Reference

NS16550A UART 驱动 More...

#include <ns16550a_driver.hpp>

Collaboration diagram for Ns16550aDriver:

Public Types
using	Ns16550aType = ns16550a::Ns16550a

Public Member Functions
auto	Probe (DeviceNode &node) -> Expected< void >
	初始化 NS16550A UART。
auto	Remove (DeviceNode &node) -> Expected< void >
	卸载驱动
auto	GetDevice () -> Ns16550aType *
	获取 NS16550A 设备实例
构造/析构函数
	Ns16550aDriver ()=default
	Ns16550aDriver (const Ns16550aDriver &)=delete
	Ns16550aDriver (Ns16550aDriver &&)=default
auto	operator= (const Ns16550aDriver &) -> Ns16550aDriver &=delete
auto	operator= (Ns16550aDriver &&) -> Ns16550aDriver &=default
	~Ns16550aDriver ()=default

Static Public Member Functions
static auto	GetEntry () -> const DriverEntry &
	返回用于注册的 DriverEntry
static auto	MatchStatic (DeviceNode &node) -> bool
	硬件检测：MMIO 区域大小是否足够 NS16550A？

Private Attributes
Ns16550aType	uart_ {}

Static Private Attributes
static constexpr MatchEntry	kMatchTable []

Detailed Description

NS16550A UART 驱动

Copyright

Copyright The SimpleKernel Contributors

提供 NS16550A UART 设备的驱动程序实现，包括设备检测、初始化和访问接口。

Definition at line 20 of file ns16550a_driver.hpp.

Member Typedef Documentation

Ns16550aType

using Ns16550aDriver::Ns16550aType = ns16550a::Ns16550a

Definition at line 22 of file ns16550a_driver.hpp.

Constructor & Destructor Documentation

Ns16550aDriver() [1/3]

Ns16550aDriver::Ns16550aDriver ( )

default

Here is the caller graph for this function:

Ns16550aDriver() [2/3]

Ns16550aDriver::Ns16550aDriver ( const Ns16550aDriver &  )

delete

Ns16550aDriver() [3/3]

Ns16550aDriver::Ns16550aDriver ( Ns16550aDriver &&  )

default

~Ns16550aDriver()

Ns16550aDriver::~Ns16550aDriver ( )

default

Member Function Documentation

GetDevice()

auto Ns16550aDriver::GetDevice ( ) -> Ns16550aType*

inline

获取 NS16550A 设备实例

Returns

设备实例指针

Definition at line 96 of file ns16550a_driver.hpp.

{ return &uart_; }

GetEntry()

static auto Ns16550aDriver::GetEntry ( ) -> const DriverEntry&

inlinestatic

返回用于注册的 DriverEntry

Note

使用 Ns16550aDriverSingleton::instance() 访问单例。

Returns

DriverEntry 常量引用

Definition at line 30 of file ns16550a_driver.hpp.

                                                             {
    static const DriverEntry entry{
        .name = "ns16550a",
        .match_table = etl::span<const MatchEntry>(kMatchTable),
        .match = etl::delegate<bool(
            DeviceNode&)>::create<&Ns16550aDriver::MatchStatic>(),
        .probe = etl::delegate<Expected<void>(DeviceNode&)>::create<
            Ns16550aDriver, &Ns16550aDriver::Probe>(
            etl::singleton<Ns16550aDriver>::instance()),
        .remove = etl::delegate<Expected<void>(DeviceNode&)>::create<
            Ns16550aDriver, &Ns16550aDriver::Remove>(
            etl::singleton<Ns16550aDriver>::instance()),
    };
    return entry;
  }

Here is the call graph for this function:

MatchStatic()

static auto Ns16550aDriver::MatchStatic ( DeviceNode &  node ) -> bool

inlinestatic

硬件检测：MMIO 区域大小是否足够 NS16550A？

NS16550A 没有可读的 magic 寄存器，仅验证 MMIO 资源。

Returns

true 如果 mmio_base 非零且 mmio_size 足够

Definition at line 53 of file ns16550a_driver.hpp.

              {
    static constexpr size_t kMinRegisterSpace = 8;
    return node.mmio_base != 0 && node.mmio_size >= kMinRegisterSpace;
  }

operator=() [1/2]

auto Ns16550aDriver::operator= ( const Ns16550aDriver &  ) -> Ns16550aDriver &=delete

delete

operator=() [2/2]

auto Ns16550aDriver::operator= ( Ns16550aDriver &&  ) -> Ns16550aDriver &=default

default

Probe()

auto Ns16550aDriver::Probe ( DeviceNode &  node ) -> Expected<void>

inline

初始化 NS16550A UART。

Precondition

node.mmio_base != 0

Postcondition

uart_ 有效；node.type == DeviceType::kChar

Definition at line 65 of file ns16550a_driver.hpp.

                                                               {
    auto ctx = mmio_helper::Prepare(node, 0x100);
    if (!ctx) {
      return std::unexpected(ctx.error());
    }
 
    auto result = Ns16550aType::Create(ctx->base);
    if (!result) {
      return std::unexpected(Error(result.error().code));
    }
 
    uart_ = std::move(*result);
    node.type = DeviceType::kChar;
    klog::Info("Ns16550aDriver: UART at {:#x} bound", node.mmio_base);
    return {};
  }

Here is the call graph for this function:

Here is the caller graph for this function:

Remove()

auto Ns16550aDriver::Remove ( DeviceNode &  node ) -> Expected<void>

inline

卸载驱动

Parameters

node

设备节点

Returns

Expected<void> 成功返回空值

Definition at line 87 of file ns16550a_driver.hpp.

                        {
    return {};
  }

Here is the caller graph for this function:

Member Data Documentation

kMatchTable

constexpr MatchEntry Ns16550aDriver::kMatchTable[]

staticconstexprprivate

Initial value:

= {
      {BusType::kPlatform, "ns16550a"},
      {BusType::kPlatform, "ns16550"},
  }

Definition at line 109 of file ns16550a_driver.hpp.

                                              {
      {BusType::kPlatform, "ns16550a"},
      {BusType::kPlatform, "ns16550"},
  };

uart_

Ns16550aType Ns16550aDriver::uart_ {}

private

Definition at line 114 of file ns16550a_driver.hpp.

{};

---

The documentation for this class was generated from the following file:

• /workspaces/SimpleKernel/src/device/ns16550a/ns16550a_driver.hpp