plic.h

Go to the documentation of this file.

 
#pragma once
 
#include <cpu_io.h>
 
#include <array>
#include <cstddef>
#include <cstdint>
#include <tuple>
 
#include "interrupt_base.h"
 
class Plic {
 public:
  using InterruptDelegate = InterruptBase::InterruptDelegate;
 
  static constexpr size_t kInterruptMaxCount = 16;
 
  [[nodiscard]] auto Which() const -> uint32_t;
 
  auto Done(uint32_t source_id) const -> void;
 
  auto Set(uint32_t hart_id, uint32_t source_id, uint32_t priority,
           bool enable) const -> void;
 
  [[nodiscard]] auto Get(uint32_t hart_id, uint32_t source_id) const
      -> std::tuple<uint32_t, bool, bool>;
 
  auto RegisterInterruptFunc(uint8_t cause, InterruptDelegate func) -> void;
 
  auto Do(uint64_t cause, cpu_io::TrapContext* context) -> void;
 
 
  explicit Plic(uint64_t dev_addr, size_t ndev, size_t context_count);
 
  Plic() = default;
  Plic(const Plic&) = default;
  Plic(Plic&&) = default;
  auto operator=(const Plic&) -> Plic& = default;
  auto operator=(Plic&&) -> Plic& = default;
  ~Plic() = default;
 
 private:
  static constexpr uint64_t kSourcePriorityOffset = 0x000000;
  static constexpr uint64_t kPendingBitsOffset = 0x001000;
  static constexpr uint64_t kEnableBitsOffset = 0x002000;
  static constexpr uint64_t kContextOffset = 0x200000;
 
  // 每个 context 的大小和偏移
  static constexpr uint64_t kContextSize = 0x1000;
  static constexpr uint64_t kPriorityThresholdOffset = 0x0;
  static constexpr uint64_t kClaimCompleteOffset = 0x4;
 
  // Enable bits 每个 context 的大小 (最多支持 1024 个中断源)
  static constexpr uint64_t kEnableSize = 0x80;
 
  static std::array<InterruptDelegate, kInterruptMaxCount> interrupt_handlers_;
 
  uint64_t base_addr_{0};
  size_t ndev_{0};
  size_t context_count_{0};
 
  [[nodiscard]] __always_inline auto GetContextId(uint32_t hart_id,
                                                  uint32_t mode = 1) const
      -> uint32_t {
    return hart_id * 2 + mode;
  }
 
  [[nodiscard]] auto GetEnableBit(uint32_t context_id, uint32_t source_id) const
      -> bool;
 
  auto SetEnableBit(uint32_t context_id, uint32_t source_id, bool value) const
      -> void;
 
  [[nodiscard]] auto SourcePriority(uint32_t source_id) const -> uint32_t&;
 
  [[nodiscard]] auto GetPendingBit(uint32_t source_id) const -> bool;
 
  auto SetPendingBit(uint32_t source_id, bool value) const -> void;
 
  [[nodiscard]] auto PriorityThreshold(uint32_t context_id) const -> uint32_t&;
 
  [[nodiscard]] auto ClaimComplete(uint32_t context_id) const -> uint32_t&;
};