智能命令行设计及其在SOPC系统中的应用
智能命令行设计及其在sopc系统中的应用
命令行是计算机系统中最重要的组件之一。它可以帮助开发人员更方便的控制系统。在调试过程中，可以让开发人员随时变更测试方法。
fpga的成本越来越低，fpga上的嵌入式系统（sopc）也应用得越来越广泛。但是相对其他成熟的计算机体系，sopc系统现在还没有命令行。为了更好的推广sopc应用，笔者开发了一个智能的命令行模块，可以调用系统中的任意函数，降低了开发人员的使用难度。在最小配置时，它只有大约1000行代码，占用14kb存储容量，可以放在完全由fpga片内资源构成的计算机系统中。它的结构也具有很好的扩展性，开发人员可以结合自己的需求，轻松添加命令，丰富它的特性。
命令行框架设计
1 总体设计
好的命令行要具有扩展性，开发人员能轻松添加自己的命令；也要傻瓜化，简单易于使用。
为了达到这两个目的，可采用编译器创建的数组作为命令的总索引数据结构。为每条命令创建一个变量，指定它放在一个命令行专用的段中；其中用段“shell_cmd_tab”存放用户主动创建的命令；用段“shell_cmd_tab_auto”存放系统中所有全局函数。创建变量只需调用宏shell_cmd_decl，提供命令名、命令说明和函数名即可。这样就可以实现c语言函数、变量、段、内存区域的自动映射过程。
命令的数据结构如下。
typedef struct _ncommand_t {
const char *name;
const char *descr;
shell_st_call cfunc;
} ncommand_t;
为了简化命令的创建，定义下面这个宏来创建命令。
#define shell_cmd_decl(name, usage, func) ncommand_t\ _shell_cmd_tab_##func _attribute_ ( (section( “.shell_cmd_tab”) ) )\={ name, usage, func }; // small memory version
创建命令的实例如下：shell_cmd_decl(“dump”, “shows a memory dump”, hexdump);
2 连接脚本
在连接脚本里指定段的位置是简化命令行使用流程的关键。gcc使用provide定义变量。笔者使用provide定义了各个段的起始地址和结束地址，从而可以在代码中使用段地址查询到所有命令。在编译器使用的连接脚本中添加如下行定义函数表。
.shell :
{
provide (__ram_shell_start = absolute(.));
. = align(32 / 8);
provide (__ram_shell_cmd_tab_begin = absolute(.));
*(.shell_cmd_tab .shell_cmd_tab.*)
provide (__ram_shell_cmd_tab_end = absolute(.));
provide (__ram_shell_cmd_tab_auto_begin = absolute(.));
*(.shell_cmd_tab_auto .shell_cmd_tab_auto.*)
provide (__ram_shell_cmd_tab_auto_end = absolute(.));
*(.shell .shell.*)
. = align(32 / 8);
provide (__ram_shell_end = absolute(.));
} > ddr_sdram
3 动态函数表创建
由工具自动根据系统中的全局函数创建的命令被称为自动命令。自动命令使用户可以在命令行中调用任意普通函数，即使开发人员没有声明这些函数为命令。自动命令也需要一个数组包含系统中所有全局函数的信息，这个表为动态函数表。使用一个脚本根据系统的可执行文件自动生成动态函数表。要先编译软件，生成可执行文件；再调用脚本创建动态函数表；最后再编译出包含动态函数表的可执行文件。
在脚本中先使用gnu的nm工具从可执行文件导出所有全局符号，再使用grep提取出包括函数名的行，接着使用cut删除函数名前的地址信息，使用sed将字符t替换为创建命令的宏shell_cmd_decl_auto，并在行尾添加括号。最后将所有这些信息写入一个c源代码文件，交给编译器编译，就能得到一个动态函数表。
4 自动命令参数个数
为了便于开发人员使用，自动命令最好能适应所有函数类型，假设都是unsigned int的函数类型。对于可以成功转化为unsigned int类型整数的参数，将真实的值传递给函数；对于其他参数，则将参数作为一个字符串传递给函数。
5 字符输入
命令行从标准输入设备中获取字符。命令行只接受可打印的字符和特定的控制字符。如果收到了回车或者换行字符，代表用户完成了命令输入，就解析命令。解析命令前，去掉多余的空格符（0x20），即不允许有连续的两个或多个空格符存在，命令的最后也不能有空格符。
6 参数解析
命令行模块要从用户输入的字符串中解析出命令名和参数。为命令提供与dos和linux类似的两个参数，argc和argv。argc表示参数的个数；argv是字符串指针的数组，最多10个字符串。argv[0]是第一个参数，argv[1]是第二个参数，如此类推。
7 函数解析
在代码中使用shell_cmd_decl创建了命令列表，使用工具创建了自动命令列表。这两个表实际上都是数据结构ncommand_t的数组，其中有命令名和函数地址的信息。解析函数实际上就是根据在这两个数组中依次比较函数名。如果用户输入的命令名和数组中的命令名一致，就使用对应的函数地址。
8 命令执行
得到函数地址后，就可以执行命令对应的函数。对于主动创建的命令，使用argc和argv作为参数。对于自动命令，命令行模块先尝试将原始参数转换无符号整数。如果成功，使用无符号整数作为参数；如果不成功，则将原始参数的地址作为参数，实际上是一个字符串。
命令设计
完成总体设计后，就可以逐个添加开发需要的命令了。
● 帮助命令用于显示所有命令名及其用法。
● io命令用来访问输入输出设备的寄存器，可以实现对外部设备的控制。
● 存储器命令用来显示、修改存储器的值。最基本的包括：dump命令显示指定位置的内存的值；modify命令用来修改指定内存单元的值。
● 用户在使用过程中，会使用很多命令。能够查询历史命令、循环执行历史命令将给用户带来很多方便。因此笔者实现了三条命令。history_show用来显示所有已经使用了的命令；history_del用来删除指定的历史命令；history_exec用来执行指定的历史命令。
优化处理
altera提供了简化版的输出函数alt_printf来替代printf，降低了嵌入式系统的开销，笔者在命令行中也支持这个这个函数。命令行的代码中，只调用shell_print；在头文件中，根据用户设置，shell_print使用标准的printf或者简化的alt_printf。如果使用简化的alt_printf，这个命令行占用的内存小于14kb。
在sopc系统中的应用
altera为sopc系统开发提供的集成开发环境nios ii ide附带了多个软件实例。在使用这些软件实例时，用户只需要选择模块，完全不用新编代码，非常简单。
智能命令行模块也可以作为nios ii ide的一个实例。先在“nios2eds\examples\software\”目录下为命令行创建一个子目录shell_standard，再以其他软件实例的template.xml为模板创为命令行建一个template.xml文件，然后复制命令行模块的所有文件到这个目录中。这样，用户在创建工程时，直接选中智能命令行模板，就可以使用智能命令行模块了。
市场分析：备货下旬重启，大陆厂商面板近期状况分析
美高森美和SiFive推出HiFive Unleashed扩展板 助力Linux软件和固件开发人员首次构建RISC-V PC
医疗电子概况：便携产品走俏，百家厂商争鸣
什么是直通线？直通线的做法？
中国纯电动车市场可能会在2020年出现萎缩状态
智能命令行设计及其在SOPC系统中的应用
模型在Close set和在Open set的表现是否存在一定的相关性呢
GAOJ-K能够做到与CSK整套替换的理由是什么？
RT-Thread开源作品分享 黑白棋游戏机械手臂
中国PCB产业量产能力薄弱 PCB厂商生存困境凸显
性价比最好的国产手机有那几款？
京东方在美注册专利数量位居第二
有什么性价比高的运动蓝牙耳机、最适合运动佩戴的无线耳机
黑客和人工智能都能促进网络安全的发展？
一千多的耳机和几十块钱的耳机究竟有什么区别
怎样制作实时启动的Linux USB驱动器
多项新款智能手机设计成功采用最新一代RF Fusion™ 射频前端模块
苹果成为继三星索尼之后下一个防尘防水制造商
贴片电感需要用的材料有哪些_贴片电感参数_贴片电感封装尺寸
曝光跳线和网线区别
命令行是计算机系统中最重要的组件之一。它可以帮助开发人员更方便的控制系统。在调试过程中，可以让开发人员随时变更测试方法。
fpga的成本越来越低，fpga上的嵌入式系统（sopc）也应用得越来越广泛。但是相对其他成熟的计算机体系，sopc系统现在还没有命令行。为了更好的推广sopc应用，笔者开发了一个智能的命令行模块，可以调用系统中的任意函数，降低了开发人员的使用难度。在最小配置时，它只有大约1000行代码，占用14kb存储容量，可以放在完全由fpga片内资源构成的计算机系统中。它的结构也具有很好的扩展性，开发人员可以结合自己的需求，轻松添加命令，丰富它的特性。
命令行框架设计
1 总体设计
好的命令行要具有扩展性，开发人员能轻松添加自己的命令；也要傻瓜化，简单易于使用。
为了达到这两个目的，可采用编译器创建的数组作为命令的总索引数据结构。为每条命令创建一个变量，指定它放在一个命令行专用的段中；其中用段“shell_cmd_tab”存放用户主动创建的命令；用段“shell_cmd_tab_auto”存放系统中所有全局函数。创建变量只需调用宏shell_cmd_decl，提供命令名、命令说明和函数名即可。这样就可以实现c语言函数、变量、段、内存区域的自动映射过程。
命令的数据结构如下。
typedef struct _ncommand_t {
const char *name;
const char *descr;
shell_st_call cfunc;
} ncommand_t;
为了简化命令的创建，定义下面这个宏来创建命令。
#define shell_cmd_decl(name, usage, func) ncommand_t\ _shell_cmd_tab_##func _attribute_ ( (section( “.shell_cmd_tab”) ) )\={ name, usage, func }; // small memory version
创建命令的实例如下：shell_cmd_decl(“dump”, “shows a memory dump”, hexdump);
2 连接脚本
在连接脚本里指定段的位置是简化命令行使用流程的关键。gcc使用provide定义变量。笔者使用provide定义了各个段的起始地址和结束地址，从而可以在代码中使用段地址查询到所有命令。在编译器使用的连接脚本中添加如下行定义函数表。
.shell :
{
provide (__ram_shell_start = absolute(.));
. = align(32 / 8);
provide (__ram_shell_cmd_tab_begin = absolute(.));
*(.shell_cmd_tab .shell_cmd_tab.*)
provide (__ram_shell_cmd_tab_end = absolute(.));
provide (__ram_shell_cmd_tab_auto_begin = absolute(.));
*(.shell_cmd_tab_auto .shell_cmd_tab_auto.*)
provide (__ram_shell_cmd_tab_auto_end = absolute(.));
*(.shell .shell.*)
. = align(32 / 8);
provide (__ram_shell_end = absolute(.));
} > ddr_sdram
3 动态函数表创建
由工具自动根据系统中的全局函数创建的命令被称为自动命令。自动命令使用户可以在命令行中调用任意普通函数，即使开发人员没有声明这些函数为命令。自动命令也需要一个数组包含系统中所有全局函数的信息，这个表为动态函数表。使用一个脚本根据系统的可执行文件自动生成动态函数表。要先编译软件，生成可执行文件；再调用脚本创建动态函数表；最后再编译出包含动态函数表的可执行文件。
在脚本中先使用gnu的nm工具从可执行文件导出所有全局符号，再使用grep提取出包括函数名的行，接着使用cut删除函数名前的地址信息，使用sed将字符t替换为创建命令的宏shell_cmd_decl_auto，并在行尾添加括号。最后将所有这些信息写入一个c源代码文件，交给编译器编译，就能得到一个动态函数表。
4 自动命令参数个数
为了便于开发人员使用，自动命令最好能适应所有函数类型，假设都是unsigned int的函数类型。对于可以成功转化为unsigned int类型整数的参数，将真实的值传递给函数；对于其他参数，则将参数作为一个字符串传递给函数。
5 字符输入
命令行从标准输入设备中获取字符。命令行只接受可打印的字符和特定的控制字符。如果收到了回车或者换行字符，代表用户完成了命令输入，就解析命令。解析命令前，去掉多余的空格符（0x20），即不允许有连续的两个或多个空格符存在，命令的最后也不能有空格符。
6 参数解析
命令行模块要从用户输入的字符串中解析出命令名和参数。为命令提供与dos和linux类似的两个参数，argc和argv。argc表示参数的个数；argv是字符串指针的数组，最多10个字符串。argv[0]是第一个参数，argv[1]是第二个参数，如此类推。
7 函数解析
在代码中使用shell_cmd_decl创建了命令列表，使用工具创建了自动命令列表。这两个表实际上都是数据结构ncommand_t的数组，其中有命令名和函数地址的信息。解析函数实际上就是根据在这两个数组中依次比较函数名。如果用户输入的命令名和数组中的命令名一致，就使用对应的函数地址。
8 命令执行
得到函数地址后，就可以执行命令对应的函数。对于主动创建的命令，使用argc和argv作为参数。对于自动命令，命令行模块先尝试将原始参数转换无符号整数。如果成功，使用无符号整数作为参数；如果不成功，则将原始参数的地址作为参数，实际上是一个字符串。
命令设计
完成总体设计后，就可以逐个添加开发需要的命令了。
● 帮助命令用于显示所有命令名及其用法。
● io命令用来访问输入输出设备的寄存器，可以实现对外部设备的控制。
● 存储器命令用来显示、修改存储器的值。最基本的包括：dump命令显示指定位置的内存的值；modify命令用来修改指定内存单元的值。
● 用户在使用过程中，会使用很多命令。能够查询历史命令、循环执行历史命令将给用户带来很多方便。因此笔者实现了三条命令。history_show用来显示所有已经使用了的命令；history_del用来删除指定的历史命令；history_exec用来执行指定的历史命令。
优化处理
altera提供了简化版的输出函数alt_printf来替代printf，降低了嵌入式系统的开销，笔者在命令行中也支持这个这个函数。命令行的代码中，只调用shell_print；在头文件中，根据用户设置，shell_print使用标准的printf或者简化的alt_printf。如果使用简化的alt_printf，这个命令行占用的内存小于14kb。
在sopc系统中的应用
altera为sopc系统开发提供的集成开发环境nios ii ide附带了多个软件实例。在使用这些软件实例时，用户只需要选择模块，完全不用新编代码，非常简单。
智能命令行模块也可以作为nios ii ide的一个实例。先在“nios2eds\examples\software\”目录下为命令行创建一个子目录shell_standard，再以其他软件实例的template.xml为模板创为命令行建一个template.xml文件，然后复制命令行模块的所有文件到这个目录中。这样，用户在创建工程时，直接选中智能命令行模板，就可以使用智能命令行模块了。
市场分析：备货下旬重启，大陆厂商面板近期状况分析
美高森美和SiFive推出HiFive Unleashed扩展板 助力Linux软件和固件开发人员首次构建RISC-V PC
医疗电子概况：便携产品走俏，百家厂商争鸣
什么是直通线？直通线的做法？
中国纯电动车市场可能会在2020年出现萎缩状态
智能命令行设计及其在SOPC系统中的应用
模型在Close set和在Open set的表现是否存在一定的相关性呢
GAOJ-K能够做到与CSK整套替换的理由是什么？
RT-Thread开源作品分享 黑白棋游戏机械手臂
中国PCB产业量产能力薄弱 PCB厂商生存困境凸显
性价比最好的国产手机有那几款？
京东方在美注册专利数量位居第二
有什么性价比高的运动蓝牙耳机、最适合运动佩戴的无线耳机
黑客和人工智能都能促进网络安全的发展？
一千多的耳机和几十块钱的耳机究竟有什么区别
怎样制作实时启动的Linux USB驱动器
多项新款智能手机设计成功采用最新一代RF Fusion™ 射频前端模块
苹果成为继三星索尼之后下一个防尘防水制造商
贴片电感需要用的材料有哪些_贴片电感参数_贴片电感封装尺寸
曝光跳线和网线区别