SuperH 接口指南

作者:

Paul Mundt

• 设备树引导
• 向 LinuxSH 添加新板
• 关于内核中寄存器组使用的注意事项
• sh 架构上的特性状态

内存管理

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 Epoch。

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

将 AICA RTC 设置为当前时间

参数

struct device *dev

RTC 设备（忽略）

struct rtc_time *tm

指向新 RTC 时间结构的指针

描述

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

mach-x3proto

int ilsel_enable(ilsel_source_t set)

启用一个 ILSEL 集。

参数

ilsel_source_t set

ILSEL 源（请参阅 include/asm-sh/ilsel.h 中的 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 中的 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

命令字符串的其余部分