引言
之前我们写过OR的裸机程序,写过基于OR的linux设备驱动程序,也反汇编过OR的机器码。
本小节,我们将通过一个简单的实验,对OR的汇编(指令集)做一个简单的梳理和测试。
1,基本思想
要想了解OR的指令集,其实只要查查OpenRISC architecture manual就可以了,但是不是最好的熟悉方式,也没有必要将其所有指令集记下来。我认为,通过一个实际的工程或者例子,从中了解OR的指令集是比较好的一种方式。
那么,通过什么例子呢?
一般RISC的指令集包括,运算指令,分支指令,和访存指令,三类。所以我们这个实验最好能用到这三类指令,碰巧,我最近在测试DDR控制器,所以我们下面将通过一个读写内存的例子来熟悉OR的指令集。
2,实验步骤
2.1实验准备
在开始编码之前,我们首先需要考虑如下几个问题:
a,如何对汇编源程序(.S文件)进行编译,生成机器码。
b,如何加载机器码使OR的指令总线能读到。
c,如何查看机器码的执行过程和结果。
根据前面,我们积累下来的经验,可知,利用bootrom进行RTL仿真,可以很好的解决上面三个问题。并且都是自动化的。
2.2 实验步骤
在了解并解决了上面几个问题之后,剩下的就是具体的操作了。
a,修改soc-design/orpsocv2/sw/bootrom目录下的board.h
#ifndef _BOARD_H_
#define _BOARD_H_
//#define IN_CLK 50000000 // Hz
#define IN_CLK 66666667 // Hz
#define PRELOAD_RAM
#define BOOTROM_MEM_TEST
//
// ROM bootloader
//
// Uncomment the appropriate bootloader define. This will effect the bootrom.S
// file, which is compiled and converted into Verilog for inclusion at
// synthesis time. See bootloader/bootloader.S for details on each option.
#ifndef PRELOAD_RAM
#define BOOTROM_SPI_FLASH
//#define BOOTROM_GOTO_RESET
//#define BOOTROM_LOOP_AT_ZERO
//#define BOOTROM_LOOP_IN_ROM
#else
#ifdef BOOTROM_MEM_TEST
#define BOOTROM_MEM_TEST1
#else
#define BOOTROM_GOTO_RESET
#endif
#endif
// Address bootloader should start from in FLASH
// Last 256KB of 2MB flash - offset 0x1c0000 (2MB-256KB)
#define BOOTROM_ADDR_BYTE2 0x1c
#define BOOTROM_ADDR_BYTE1 0x00
#define BOOTROM_ADDR_BYTE0 0x00
// Causes SPI bootloader to loop if SPI didn't give correct size of image
#define SPI_RETRY_IF_INSANE_SIZEWORD
//
// Defines for each core (memory map base, OR1200 interrupt line number, etc.)
//
#define SDRAM_BASE 0x0
#define GPIO_0_BASE 0x91000000
#define UART0_BASE 0x90000000
#define UART0_IRQ 2
#define UART0_BAUD_RATE 115200
#define SPI0_BASE 0xb0000000
#define SPI0_IRQ 6
#define I2C_0_BASE 0xa0000000
#define I2C_0_IRQ 10
#define I2C_1_BASE 0xa1000000
#define I2C_1_IRQ 11
#define ETH0_BASE 0x92000000
#define ETH0_IRQ 4
#define ETH_MACADDR0 0x00
#define ETH_MACADDR1 0x12
#define ETH_MACADDR2 0x34
#define ETH_MACADDR3 0x56
#define ETH_MACADDR4 0x78
#define ETH_MACADDR5 0x9a
//
// OR1200 tick timer period define
//
#define TICKS_PER_SEC 100
//
// CFI flash controller base
//
#define CFI_CTRL_BASE 0xf0000000
//
// UART driver configuration
//
#define UART_NUM_CORES 1
#define UART_BASE_ADDRESSES_CSV UART0_BASE
#define UART_BAUD_RATES_CSV UART0_BAUD_RATE
//
// i2c_master_slave core driver configuration
//
#define I2C_MASTER_SLAVE_NUM_CORES 2
#define I2C_MASTER_SLAVE_BASE_ADDRESSES_CSV \
I2C_0_BASE, I2C_1_BASE
#endif
b,修改soc-design/orpsocv2/sw/bootrom目录下的bootrom.S
这个文件,是需要我们自己手动编写OR的汇编了。
需要注意的有几点。
首先,如何让仿真自动退出:使用“l.nop 1”这条指令,具体原因可参考or1200_monitor.v文件中的相关内容。
其次,如何判断读写内存的成功与失败,分别使用“l.nop 4”和“l.nop 3”。
最后,这些汇编,都很容易理解,唯一需要注意的是OR支持延迟槽。
下面是具体代码清单:
//
///
/// bootrom Rill 2014-04-28
///
/// Assembly programs to be embedded inside system to aid boot
///
///
//
// Defines for which bootrom app to use are in board.h - TODO: use the
// processed orspoc-defines.v file for this define. It makes more sense
// as this software ends up as gates.
#include "board.h"
#ifdef BOOTROM_MEM_TEST1
#define RAM_LOAD_BASE 0x100000
#define RESET_ADDR 0x100
#define RAM_LOAD_VALUE 0x5555
#define RAM_LOAD_SIZE 0xc
boot_init:
l.movhi r0, 0 /*0*/
l.movhi r1, RAM_LOAD_BASE /*1*/
mem_write:
l.movhi r6, 0 /*2*/ /* counter*/
l.ori r7, r0, RAM_LOAD_SIZE /*3*/
//l.movhi r7, RAM_LOAD_SIZE
l.movhi r8, 0 /*4*/ /* load addr index*/
write:
l.ori r3,r0, RAM_LOAD_VALUE /*5*/ /* Read a byte into r3 */
l.add r8, r1, r6 /*6*/ /* Calculate store address */
l.sw 0(r8), r3 /*7*/ /* Write byte to memory */
l.addi r6, r6, 4 /*8*/ /* Increment counter */
l.sfeq r6, r7 /*9*/ /* Check if we've finished loading the words */
l.bnf write /*10*/ /* Continue copying if not last word */
l.nop /*11*/
mem_read:
l.movhi r6, 0
l.ori r7, r0, RAM_LOAD_SIZE
l.movhi r8, 0
read:
l.add r8, r1, r6
l.lwz r3, 0(r8)
l.j check
l.nop
read2:
l.addi r6, r6, 4
l.sfeq r6, r7
l.bnf read
l.nop
l.j success
l.nop
check:
l.ori r5,r0, RAM_LOAD_VALUE
l.sfeq r3, r5
l.bnf error
l.nop
l.j read2
l.nop
error:
l.nop 3
l.j error
l.nop 1
success:
l.nop 4
l.j success
l.nop 1
#endif
c,创建C语言裸机测试目录和程序
由于我们想利用ORPSoC现成的测试环境,所以我们还需要编写一个假的,只是为了满足原有的测试环境的目录和文件。
在soc-design/orpsocv2/board/xilinx/ml501/sw/tests目录下创建目录和文件:
mkdir mem
cd mem
touch mem.c
cp ../../Makefile .
编辑mem.c:
/*
* Rill
* april/28/2014
*/
int main()
{
while(1);//we run instructions in bootrom ONLY.
return 0;
}
由于我们只运行bootrom.S中的指令,所以mem.c里面写什么语句不重要。
d,测试与验证
完成编码之后,我们就可以运行我们刚才写的汇编程序了,方法我们之前已经介绍过多次了,这里重复如下:
在 soc-design/orpsocv2/board/xilinx/ml501/sim/run目录下执行如下:
make rtl-test TEST=mem VCD=1
很快,我们就可以仿真结束,然后,我们就可以查看仿真日志文件和仿真波形。
从中可以看出,对内存的读写都是正确的。
or1200_monitor输出的日志文件:mem-general.log
58598000.0 ps: l.nop 4 putc (U)
58718000.0 ps: l.nop exit (00005555)
vcd波形文件:
3,小结
对于cpu来说,对所有外设(uart,i2c,vga......)的控制都可以通过load/store来完成,和读写内存的实质是完全相同的,所以,通过上面的汇编,我们只要改变一下读写地址修改成对应外设的地址,我们就可以实现对该设备的控制了。
当然,编写出优秀的汇编程序也不是一件太容易的事情,这就需要详细阅读OR的架构手册,掌握GPR和SPR的使用方法。甚至,我们还要查看or32-elf-asm来了解更准确的OR的指令集。