PULPino是PULP的一个子项目，PULP全称“Parallel Ultra Low Power”，是一个RISC-V项目，旨在搭建低功耗的多核嵌入式SOC。PULPino是一个单核的单片机的架构，CPU内核除了实现RISCV的I、M、C指令集之外还扩展了一些类似于DSP的指令集，使其计算性能超过了ARM Cortex M4、硅片面积更小、功耗更低。。。

PULPino的例程用cmake来管理；其中有FreeRTOS的简单移植。FreeRTOS说到底就是一个scheduler，其他东西基本上连架构都没有，啥都要自己动手。

就功能而言适用于无MMU的操作系统最强的当属nuttx，号称“Linux on microcontroller”，文件系统、网络、应用程序一应俱全，而且非常小巧，完全没有UCLinux那般臃肿。作为例子，若在stm32上要用网络，则nuttx不用特别裁剪优化得到100kB左右的bin，而UCLinux疯狂裁剪之后得到1MB左右的bin。

目前nuttx里有riscv的基本移植，但要移植到PULPino上还需要非常多的功夫。本文阐述nuttx的踩坑历程。

Nuttx的创立者名叫Gregory Nutt，命名有Linus风范。nuttx定位在从RTOS到Linux的这段广阔的中间地带：这里有着很多“高性能”的MCU，也有一些有MMU的GHz主频级别的应用处理器，甚至是SMP多核处理器。

nuttx的功能多得令人咋舌，驱动架构、VFS、可执行文件、各种文件系统、网络、shell、web服务器、图形框架等等应有尽有，而且支持非常多的架构（其中大部分是ARM的，其中又有大部分是NXP和STM32的片子），几乎实现了UCLinux的所有东西并且代码时刻在更新。nuttx工程由Bitbucket托管，如果想贡献代码的话直接给Nutt发邮件即可。。。

对于系统程序员而言需要特别留意Nuttx Porting Guide，在源码里也有Documentation/NuttxPortingGuide.html。

nuttx将SOC的移植分为三个层次：

在架构级目录下面实现的是诸如进程调度、系统调用、信号之类的与ISA息息相关的东西。

在芯片级目录下面实现的是片子的外设驱动，以及它的启动文件（需要实现启动代码和中断向量表）。值得一提的是Linux的外设驱动分散在它的drivers/目录下面，而arch/xxx/mach-xxx/目录下面又只有非常少的东西。

在板极目录下面实现的一般是外挂设备的初始化，比方说SDIO上挂了一个WiFi网卡，SPI上挂了一个flash等。这些驱动一般放在drivers/目录下面，毕竟外接设备与架构无关。

于是一目了然，要做某些层次的移植就要关注那些层次的目录。

nuttx可以有三种运行方式：

为体现模块化，nuttx的应用程序与内核分开来开发，编译时候要分别下载nuttx-xxx.tar.gz和apps-xxx.tar.gz。应用程序可以有两类：

与Linux纷繁复杂的驱动架构相比nuttx简单多了。Linux支持的设备太多太复杂了，以至于现在每一个驱动都是一个复杂的架构，比如时钟系统、电源管理等等，程序员要同时关注数个对象、数十个方法；另外它还开发出很多gdb不友好的“动态”的技巧，比方说链表、container_of云云，以至于调bug几乎只能靠打log来猜。。

小型嵌入式系统在驱动层面上往往没有那么多“动态”的东西：外设少而且几乎都是MMIO，而且并不指望同一个系统镜像能运行在不同类型的板子上，因此它不需要设备树之类的东西；该有的对象直接静态地列出就好。关于设备树的讨论可见笔者之前的博客。

值得一提的是nuttx中类的继承关系只有单继承，而且子类的第一个成员对象是父类的实例。这样做的好处是，要通过父类找子类只需要对父类指针cast一下就可以了，根本不需要container_of之类的东西。Java也只有单继承（接口不算），说明这样做也没啥不妥的。

与Linux一样，nuttx也使用kbuild来管理工程。用Kconfig脚本，make menuconfig来配置，最后正式编译之前将配置项生成include/nuttx/config.h头文件，根据各个目录下面的Make.defs来确定要编译哪些文件、要加哪些编译参数。

配置是板极的，一个板子可以有很多个配置，比方说stm32f429-discovery就有：串口shell（nsh）、USB shell（usbnsh）、图形界面（nxwm）等等配置。板极目录下面有这些子目录：

defconfig非常小，只保留必要信息，可通过遍历整个工程的Kconfig来还原.config。这个过程由tools/configure.sh来进行。比方说要还原configs/xxboard/xxconf/defconfig，则用以下命令：

生成defconfig方法如下：

PULPino指令集包括RISCV-IMC以及扩充的计算指令集，系统层面的话只需要关注RISCV的指令即可。由于nuttx里面有RISCV-IM的基本实现，而且需要汇编实现的部分很短而不需要考虑压缩指令集，因此只需要实现chip级以及board级的东西就可以了。

因为PULPino既没有MMU也没有MPU，因此内核只能以flat模式运行，整个操作系统就相当于一个程序。由低址到高址可连续地分为以下几段：

链接脚本见下文。

根据RI5CY手册，复位后CPU从0x80处开始执行，那里是一条跳转指令。如果链接脚本没有注明入口，则pulpino的工具链默认0x8C处是reset handler。

启动时，将31个寄存器清零，将bss段清零，初始化data段，然后跳转到c语言程序中（由于目前用JTAG直接下载ELF，因此data段实际上不需要初始化）。如果没什么特别的初始化的话，可以直接跳转到内核的os_start()函数。。

nuttx的中断由内核统一管理，编写的ISR需要统一向内核注册，无论芯片是否支持向量中断：

所有中断程序有统一入口：

其中struct xcptcontext每个架构都不同。riscv的在arch/risc-v/include/rv32im/irq.h：

其中XCPTCONTEXT_REGS定义为39，编制如下：

刚初始化任务时，up_initial_state()函数在struct tcb_s内设置入口地址和堆栈指针。

因为有可能某个进程正在睡眠等待某个事件，比方说串口接收中断来了，那么getchar()就可以返回了。另外显式的up_switchcontext()通过系统调用来切换任务。将syscall处理程序也注册为一个IRQ即可统一这个过程。

扁平模式下的任务切换只需换堆栈。因此整个中断处理流程如下：

严格来说syscall应该归为“异常（exception）”，而普通的外部中断归为“中断（interrupt）”。因为exceptions一般都是“同步的”，就像非法指令异常、除以零异常、精确总线异常、系统调用等，都由正常或不正常的CPU指令触发；interrupts则是“异步的”，由CPU片外的东西不时触发。更精细地说，异常发生时那条触发异常的指令没有执行完毕，而中断发生时上一条指令执行完毕而下一条指令还没开始。因此异常返回到触发异常的那条指令，而中断返回返回到那条指令的下一条指令。

可以简单将syscall注册为一个IRQ，但是它的汇编wrapper要手动将返回地址加4，跳过ecall（新riscv标准为mcall）指令，免得死循环。

非正在运行状态的任务，寄存器组信息存放在tcb_s::xcptcontext中，进入运行状态则从那里复原寄存器组。但是中断是随机发生的，汇编并不知道该任务的tcb在哪，而且保存寄存器组之前不能破坏原来的寄存器因而不能找全局变量或者调用C程序；因此寄存器组只能暂存在原来任务的堆栈上。传入的上下文指针是此时的栈顶指针。

非得把寄存器组放在tcb里而不是直接留在堆栈，笔者认为这考虑到统一管理、便于调试。放在tcb里的话C语言程序就很方便操作，而且gdb可以直接打印整个结构体。另外gdb不认中断上下文，它不放在堆栈就不会干扰gdb找call stack，也便于通用的探针程序去操作。

PULPino没有实现RISCV内核的定时器，而是实现了两个简易的32位计数器作为外设。定时器的寄存器如下：

一个定时器有两个中断：

操作很简单：

这是arch级别的配置。

推荐使用ETH定制的riscv32-unknown-elf-gcc。需要注意的是要checkout到老commit，因为新版PULPino指令集有所更改。用RISCV原生工具生成I、M、C指令集也可以运行，只是不能用PULPino的扩展了。

同时在nuttx源码中更改工具链。首先在arch/risc-v/src/rv32im/Kconfig中添加一个config选项：

随后在arch/risc-v/src/rv32im/Toolchain.defs中添加编译参数：

ARCHCPUFLAGS中的-m32 -march=IMXpulpv2选项将使用PULPino扩展的指令集，-mrvc将使用RISCV-C压缩指令集。MAXOPTIMIZATION是gcc的通用优化选项，-Os是对size的优化。加了这些参数之后生成代码体积可以与ARM Thumb2指令集相媲美。。

这是board级别的配置。工作目录在configs/pulpino/scripts/：

我们pulpino挂了一块挺大的DDR内存。参照内存映射（见上文）写链接脚本，简化如下：

关键就是暴露一些变量，例如data段的开始和结束_sdata、_edata，bss段的开始和结束_sbss、_ebss，以供reset handler初始化它们。

PULPino有一个兼容16750的串口。PC机上的8250、16550、16750之类的串口一脉相承，软件基本上兼容，只是后续的型号速度更快、FIFO更深等等。对于常用的115200波特率而言，可以直接使用nuttx的16550驱动。为此只需要配置好寄存器基地址，并实现uart_getreg()和uart_putreg()即可。

另外还要选择串口作为终端：

随后配置nsh library：

最后使能nsh：

编译通过后就可以在串口上操作shell了。