SuperH 接口指南

作者:

Paul Mundt

内存管理

SH-4

存储队列 API

void sq_flush_range(unsigned long start, unsigned int len)

刷新（预取）特定的 SQ 范围

参数

unsigned long start

开始刷新的存储队列地址

unsigned int len

要刷新的长度

描述

以线性方式从 start 到 start + len 刷新存储队列缓存。

unsigned long sq_remap(unsigned long phys, unsigned int size, const char *name, pgprot_t prot)

通过存储队列映射物理地址

参数

unsigned long phys

映射的物理地址。

unsigned int size

映射的长度。

const char *name

调用映射的用户。

pgprot_t prot

保护位。

描述

将物理地址 phys 通过下一个可用的、长度为 size 的存储队列地址进行重新映射。name 会在引导时以及通过 sysfs 接口被记录。

void sq_unmap(unsigned long vaddr)

取消映射存储队列分配

参数

unsigned long vaddr

预分配的存储队列映射。

描述

取消映射先前由 sq_remap() 创建的存储队列分配 map。同时释放先前插入内核页表的 pte 并丢弃 UTLB 转换。

机器特定接口

mach-dreamcast

int aica_rtc_gettimeofday(struct device *dev, struct rtc_time *tm)

从 AICA RTC 获取时间

参数

struct device *dev

RTC 设备（被忽略）

struct rtc_time *tm

指向生成的 RTC 时间结构的指针

描述

获取当前的 RTC 秒计数器并将其调整为 Unix 纪元。

int aica_rtc_settimeofday(struct device *dev, struct rtc_time *tm)

将 AICA RTC 设置为当前时间

参数

struct device *dev

RTC 设备（被忽略）

struct rtc_time *tm

指向新 RTC 时间结构的指针

描述

将给定的 tv 调整为 AICA 纪元并设置 RTC 秒计数器。

mach-x3proto

int ilsel_enable(ilsel_source_t set)

启用一个 ILSEL 集。

参数

ilsel_source_t set

ILSEL 源（见 include/asm-sh/ilsel.h 中的 enum in ilsel_source_t）。

描述

在最高可用中断级别上启用给定的非别名 ILSEL 源（<= ILSEL_KEY）。调用者应注意按中断级别降序排列调用点。别名 FPGA 和外部板卡 IRQ 需要使用 ilsel_enable_fixed()。

返回值是一个 IRQ 号，稍后可以通过 ilsel_disable() 注销。

int ilsel_enable_fixed(ilsel_source_t set, unsigned int level)

在固定中断级别上启用一个 ILSEL 集

参数

ilsel_source_t set

ILSEL 源（见 include/asm-sh/ilsel.h 中的 enum in ilsel_source_t）。

unsigned int level

中断级别 (1 - 15)

描述

在固定中断级别启用给定的 ILSEL 源。这对于级别保留以及仅存在于特殊 ILSEL# 上的别名源都是必需的。

返回一个 IRQ 号（同 ilsel_enable()）。

void ilsel_disable(unsigned int irq)

禁用一个 ILSEL 集

参数

unsigned int irq

ILSEL 集值的位位置（来自启用例程的返回值）

描述

禁用先前启用的 ILSEL 集。

总线

Maple

int maple_driver_register(struct maple_driver *drv)

注册一个 maple 驱动程序

参数

struct maple_driver *drv

要注册的 maple 驱动程序。

描述

注册传入的 drv，同时更新总线类型。具有匹配功能 ID 的设备将被自动探测。

void maple_driver_unregister(struct maple_driver *drv)

注销一个 maple 驱动程序。

参数

struct maple_driver *drv

要注销的 maple 驱动程序。

描述

在 maple_driver_register() 之后进行清理。将在任何模块驱动程序的退出路径中被调用。

void maple_getcond_callback(struct maple_device *dev, void (*callback)(struct mapleq *mq), unsigned long interval, unsigned long function)

设置处理 MAPLE_COMMAND_GETCOND

参数

struct maple_device *dev

响应的设备

void (*callback) (struct mapleq *mq)

处理程序回调

unsigned long interval

回调间的时间间隔（以 jiffies 为单位）

unsigned long function

设备的功能代码

int maple_add_packet(struct maple_device *mdev, u32 function, u32 command, size_t length, void *data)

向 maple 总线队列添加单个指令

参数

struct maple_device *mdev

maple 设备

u32 function

正在查询的设备上的功能

u32 command

要添加的 maple 命令

size_t length

命令字符串的长度（以 32 位字为单位）

void *data

命令字符串的其余部分