Intewell TTOS SHELL 参考手册说明书

密级：
受控状态：
发放号：
Intewell TTOS SHELL参考手册
（V1.0）
拟制：
审核：
批准：
科东（广州）软件科技有限公司
年月日
修订历史记录
目录
1范围 (1)
1.1标识 (1)
1.2系统概述 (1)
1.3文档概述 (2)
2引用文档 (2)
3shell连接 (3)
3.1通过telnet连接至shell (3)
3.2通过串口连接至shell (3)
4shell命令 (4)
4.1任务 (4)
4.2设备管理 (9)
4.3网络 (10)
4.4文件系统 (13)
4.5内存 (16)
4.6misc (18)
4.7时间 (21)
4.8调度 (22)
4.9ethercat (22)
1 范围
1.1 标识
软件名称：Intewell虚拟化操作系统
软件简称：Intewell
软件版本：1.0
1.2 系统概述
Intewell是一款硬实时操作系统，为应用程序运行提供资源管理和任务调度能力。

Intewell运行环境如图1所示：
图1 Intewell运行环境
(1) 虚拟机应用开发采用交叉开发环境，集成开发环境Intewell Developer运行于宿主机操作
系统windows 7/10之上，是科东（广州）软件科技自主可控的产品。

用于项目的创建、编
辑、编译和调试。

(2) Intewell运行于目标机（龙芯2k、x86或arm），微内核和各虚拟机分别生成不同的映像。

虚拟机运行于用户态，微内核运行于核心态。

基本服务、系统服务和运行时环境在虚拟机内。

(3) Intewell在硬件资源允许情况下，最多可支持63个虚拟机。

虚拟机间时空隔离、中断故障
隔离。

1.3 文档概述
本文档描述Intewell提供的shell命令帮助手册，主要包括命令描述、示例等，其目的在于指导开发人员如何使用shell命令。

2 引用文档
本章节所列文件中的条款通过本文档的引用而成为本文档的条款。

凡是注日期的引用文件，其随后所有的修改单(不包括勘误的内容)或修订版均不适用于本文档。

凡是不注日期的引用文件，其最新版本适用于本文档。

《Intewell TTOS软件参考手册》科东（广州）软件科技有限公司。

3 shell连接
3.1 通过telnet连接至shell
使用支持telnet的工具连接。

3.2 通过串口连接至shell
3.2.1 配置如下:
Step1：应用项目宏配置
TTOS项目右击->属性->C/C++构建->设置->GCC C Compiler->预处理器
CONFIG_CONSOLE_STDIN=CONFIG_DEVICE_COMX_NAME。

CONFIG_CONSOLE_STDOUT=CONFIG_DEVICE_COMX_NAME。

Step2：应用项目组件配置
专家模式下设置组件配置->SHELL->串口为TRUE。

Step3：硬件资源归宿配置
配置串口：
硬件资源归宿配置->实时运行环境->I/O外设->实时串行端口->COMX。

多TTOS构型应将SHELL串口分配到具体的虚拟机。

Hypervison项目->虚拟机配置->
虚拟机->I/O外设->新建实时串行串口->新建串行串口。

串口模型选择Pass-Through。

配置完成，需重新构建项目。

4 shell命令
4.1 任务
4.1.1 top - CPU使用率
命令格式：top
描述：动态显示任务ID、任务当前优先级、CPU使用率、任务运行时间、任务运行tick数和任务名称。

示例：top
4.1.2 cpuuse - CPU使用率
命令u格式：cpuuse
描述：显示任务ID、任务当前优先级、CPU使用率、任务运行时间、任务运行tick数和任务名称。

示例：cpuuse
4.1.3 stackuse - 栈信息
命令格式：stackuse [id [id .. ]]
描述：打印任务栈使用情况，包括任务ID、名称、栈顶、栈底、当前栈针位置、栈可用栈大小和已使用栈大小等信息。

示例：stackuse
4.1.4 task - 任务信息
命令格式：task [id [id ...]]
描述：显示任务信息，主要包括任务ID、当前任务优先级、任务状态、任务入口函数、任务等待信息、任务tick数和任务名称。

示例：task
ID：任务id号
PRIOR:任务优先级，数字越大，优先级越高
AFF-CPU：cpu亲和属性，ANY表示非绑定任务，即该任务可动态运行在任意核上；其他值，如0，表示绑定在0核，1，表示绑定在1核上，以此类推。

RUN-CPU：None表示当前任务未运行，其他值表示cpu id，即任务正在该cpu上运行
STATE:W-等待态S-挂起态R-就绪态U-运行态F-第一次运行态D-休眠态
ENTRY:任务入口地址
TICKS：任务执行的总时间，单位为tick
NAME：任务名
TOTAL：任务总数
4.1.5 ts -挂起任务
命令格式：ts [id [id ...]]
描述：挂起任务。

示例：ts id
4.1.6 tr -恢复任务
命令格式：tr [id [id ...]]
描述：恢复任务。

示例：tr id
4.1.7 td -停止任务
命令格式：td [id [id ...]]
描述：停止任务。

示例：td id
4.1.8 tp -任务等待对象信息
命令格式：tp [id [id ...]]
描述：任务等待对象信息、任务ID和等待对象名称。

示例：tpid
4.1.9 tc -任务上下文
命令格式：tc [id [id ...]]
描述：显示任务上下文。

示例：tc不指定id时，默认显示所有任务上下文信息。

4.1.10 msg -消息队列信息
命令格式：msg [id [id ... ]]
描述：显示消息队列信息，包括消息ID、消息队列名、消息队列最大长度、最大消息个数和等待被接收的消息数量等。

示例：msg不指定id时，默认显示所有消息队列信息。

4.1.11 sem - 信号量信息
命令格式：sem [id [id ... ]]
描述：显示信号量信息，包括信号量ID、信号量类型、当前计数值、天花板优先级、信号量拥有者，等待信号量的任务、信号量名称。

示例：sem id
4.1.12 timer - 定时器信息
命令格式：timer [id [id ..]]
描述：定时器相关信息，包括定时器ID、定时器名称、定时器触发时间间隔、定时器处理函数、定时器触发次数和定时器状态。

示例：timer
4.2 设备管理
4.2.1 devls -列出设备
命令格式：devls
描述：打印系统设备，设备名称、设备类型和设备驱动号。

示例：devls
4.2.2 fdinfo–查询设备描述符打开的设备名称
命令格式：fdinfo
描述：查询设备描述符打开的设备名称，fd描述符为系统内部分配，其中0-2固定被标准输入输出占有，现不支持socket描述符查询。

示例：fdinfo
4.3 网络
4.3.1 netstats - 网络数据信息
命令格式：netstats [-a [-m ... ]]
描述：显示各种类型的网络信息。

该命令有以下参数可用：
-a 打印所有统计信息
-m打印MBUF统计
-p 打印IP统计
-c打印ICMP统计
-u打印UDP统计
-t 打印TCP统计
-s 打印socket信息
示例：netstats -a打印所有统计信息
4.3.2 arp - ARP表
命令格式：arp
描述：显示ARP表项相关信息，IP地址、MAC地址。

示例：arp
4.3.3 ifconfig-显示或修改网卡数据
命令格式：ifconfig [interface]
ifconfig
显示系统所络接口信息
ifconfig interface
显示指定网络接口信息
ifconfig interface ip x.x.x.x
配置网络IP地址
ifconfig interface mask x.x.x.x
配置网络掩码
ifconfig interface gateway x.x.x.x
配置网关
ifconfig interface IP
配置网络IP地址
ifconfig interface netmask IP
配置网络掩码、IP地址
ifconfig interface netmask IP GateWay
配置网络掩码、IP地址、网关
描述：用于显示系统中网络接口信息和配置网络。

显包括IP、MAC地址、子网掩码和网关、最大传输单位、传输速度、发送接收错误、发送接收帧、发送接收字节数据。

示例：ifconfig显示系统所络接口信息。

4.3.4 ping -网络测速
命令格式：ping ipaddr
描述：测试网络连通性。

示例：ping xxx.xxx.xxx.xxx
4.3.5 route -路由设置
命令格式：route [add|del] default [interface]
route
显示系统所有路由信息
route del default
删除默认路由规则
route add default [interface]
设置默认路由规则
描述：用于显示系统中路由信息和配置默认网卡。

示例：route
4.4 文件系统
注意：由于现在mips平台上还未对文件系统服务化，当前只支持一个分区使用文件系统，shell 文件系统相关的命令也仅支持一个分区使用。

4.4.1 cat -显示文件内容
命令格式：cat file1 [file2 .. fileN]
描述：打印文件内容。

示例：cat file
4.4.2 pwd -显示工作目录
命令格式：pwd
描述：打印工作目录。

示例：pwd
4.4.3 touch -创建文件
命令格式：touch file1 [file2 .. fileN]
描述：创建文件。

示例：touch file
4.4.4 cd -更改目录
命令格式：cd path
描述：更改当前工作目录。

示例：cd path
4.4.5 cp -拷贝文件
格式：cp source target
描述：拷贝文件，支持相对目录。

示例：cp source target
4.4.6 mv -移动文件
命令格式：mv source target
描述：移动文件或目录。

示例：mv source target
4.4.7 ls-显示文件信息
命令格式：ls [dir]
描述：列出目录中的文件。

该命令有以下参数可用：
-l 列出文件，并展示详细信息
-a列出所有文件
示例：ls
4.4.8 mkdir -创建目录
命令格式：mkdir dir [dir1 .. dirN]
描述：创建目录。

示例：mkdir dir [dir1 .. dirN]
4.4.9 rmdir - 删除目录
命令格式：rmdir dir
描述：删除目录。

示例：rmdir dir
4.4.10 rm -删除文件
命令格式：rm file [file1 ... fileN]
描述：删除文件，支持删除目录。

该命令有以下参数可用：
-r删除目录
-f强制删除文件
示例：rm file
4.4.11 mkfs-格式化分区
命令格式：mkfsfstype dev
描述：格式化分区。

该命令有以下参数可用：
fstype文件系统类型
dev设备路径名
注意事项：格式化完成后请重启机器生效，目前只支持fatfs的格式化。

示例：mkfs fatfs /dev/sata
4.5 内存
4.5.1 heap -堆信息
命令格式：heap
描述：获取堆信息，包括总的内存区大小、正在使用中的内存、正在使用中的内存块的个数、总的空闲内、总的空闲内存块数、当前空闲内存块中的最大内等信息，默认显示用户堆。

该命令有以下参数可用：
-s 显示分区系统堆
示例：heap
4.5.2 sysheap -系统堆信息
命令格式：sysheap
描述：系统堆总空间大小和剩余可用空间大小。

示例：sysheap
4.5.3 d -显示内存
命令格式：d addr [len] [width]
描述：按宽度（字节、）显示内存。

注意事项：字节宽度只支持1、2、4。

示例：d addr
4.5.4 shminfo-显示共享内存信息
命令格式：shminfo
描述：显示共享内存信息。

示例：shminfo
4.5.5 m–修改内存
命令格式：mwidthaddr value
描述：按宽度（字节、）修改内存。

注意事项：字节宽度只支持1、2、4。

示例：m 1addr value
4.6 misc
4.6.1 help -帮助命令
命令格式：help
描述：显示shell命令帮助信息。

示例：help
4.6.1 clear–清屏
命令格式：clear
描述：清除shell客户端界面。

示例：clear
清屏前
清屏后
4.6.2 quit - 退出Shell
命令：quit
描述：退出Shell。

注意事项：执行命令，需要输入N/n取消退出，输入Y/y表示确认退出。

示例：quit
4.6.3 version-显示版本
命令格式：version
描述：打印操作系统版本信息。

示例：version
4.6.4 errno–打印系统错误号
命令格式：errno
描述：打印系统错误号。

示例：errno
4.6.5 redirect– shell重定向开关
命令格式：redirect
描述：打开或关闭shell重定向。

该命令有以下参数可用：
on 打开shell重定向
off 关闭shell重定向示例：redirect on/off
4.6.6 deadlock–死锁检测
命令格式：deadlock
描述：检测系统中任务之间是否存在死锁。

示例：deadlock
4.6.7 sysinfo -列出系统信息
命令格式：sysinfo
描述：打印系统cpu名称、数量，内核资源使用情况，文件系统使用情况。

示例：sysinfo
4.7 时间
4.7.1 tick-运行tick数
命令格式：tick
描述：打印系统tick数、分区运行tick数和分区IDLE任务的tick数。

示例：tick
4.7.2 date-显示日历时间
命令格式：date
描述：当前日历时间。

示例：date
4.7.3 who-启动时间
命令格式：who
描述：打印系统启动时间和日历时间。

该命令有以下参数可用：
-b打印启动时间
-r打印系统运行时间
示例：who
4.8 调度
4.8.1 vm -分区信息
命令格式：vm
描述：显示所有分区信息，包括分区状态、优先级、运行的CPUID、调度策略、时间片和分区名。

示例：vm
4.8.2 tts -调度表信息
命令格式：tts
描述：时间调度表信息，主帧信息、分区窗口。

示例：tts
4.9 ethercat
4.9.1 alias-设置从站地址别名
命令格式：ethercat alias [OPTIONS] <ALIAS>
描述：设置从站地址别名
该命令有以下参数可用：
--alias –a 匹配从站别名
--position –p 从站的绝对地址
--force –f 获取所有从站
示例：ethercat alias -a 0 0
4.9.2 config-获取总线配置
命令格式：ethercat config [OPTIONS]
描述：获取总线配置
该命令有以下参数可用：
--alias –a 匹配从站别名
--position –p 从站的绝对地址
--version –v 显示详细信息
示例：ethercat config -v
4.9.3 cstruct-获取PDO信息，以C语言的格式显示
命令格式：ethercat cstruct [OPTIONS]
描述：获取PDO信息，以C语言的格式显示
该命令有以下参数可用：
--alias –a 匹配从站别名
--position –p 从站的绝对地址
示例：ethercat cstruct
4.9.4 debug-设置主站调试级别
命令格式：ethercat debug
描述：设置主站调试级别
该命令有以下参数可用：
0: 无任何调试信息
1: 输出部分调试信息
2: 输出所有的帧信息
示例：ethrecat debug 0
4.9.5 domains-获取域的信息
命令格式：ethercat domains [OPTIONS] 描述：获取域的信息
该命令有以下参数可用：
--domain –d 根据索引号，获取域
--version –v 显示域的详细信息
示例：ethercat domains
4.9.6 download-写入SDO条目
命令格式：ethercat download [OPTIONS]
描述：写入SDO条目
该命令有以下参数可用：
可选参数：
INDEX:16位无符号SDO索引
SUBINDEX:8位无符号的SDO子索引
VALUE:需要写入的值
--alias –a 匹配从站别名
--position –p 从站的绝对地址
--type –t 数据类型
示例：ethercat download –t int8 –p 0 0x6060 0 8 4.9.7 upload-读取sdo条目
命令格式：ethercat upload [OPTIONS]
描述：读取sdo条目
该命令有以下参数可用：
可选参数：
INDEX:16位无符号SDO索引
SUBINDEX:8位无符号的SDO子索引--alias –a 匹配从站别名
--position –p 从站的绝对地址
--type –t 数据类型
示例：ethercat upload –t int8 –p 0 0x6060 0
4.9.8 foe_read-通过FOE读取从站文件
命令格式：ethercat foe_read [OPTIONS]
描述：通过FOE读取从站文件
该命令有以下参数可用：
--alias –a 匹配从站别名
--position –p 从站的绝对地址
--output –file –o 读取数据后保存的文件4.9.9 foe_write-通过FOE向从站写入文件
命令格式：ethercat foe_write [OPTIONS]
描述：通过FOE向从站写入文件
该命令有以下参数可用：
--alias –a 匹配从站别名
--position –p 从站的绝对地址
--output –file –o 待写入的文件
4.9.10 graph-输出总线拓扑图
命令格式：ethercat graph [OPTIONS]
描述：输出总线拓扑图
示例：ethercat graph
4.9.11 master-显示主站信息
命令格式：ethercat master [OPTIONS] 描述：显示主站信息
该命令有以下参数可用：
--master –m 主站索引
示例：ethercat master –m 0
4.9.12 pdos-显示PDO条目和映射信息
命令格式：ethercat pdos [OPTIONS]
描述：显示PDO条目和映射信息
该命令有以下参数可用：
--alias –a 匹配从站别名
--position –p 从站的绝对地址
--skin –s skin可选择”default”和”etherlab”
示例：ethercat pdos –p 1
4.9.13 reg_read-读取从站寄存器
命令格式：ethercat reg_read [OPTIONS]
描述：读取从站寄存器
该命令有以下参数可用：
--alias –a 匹配从站别名
--position –p 从站的绝对地址
--type –t 数据类型
示例：ethercat reg_read -p 4 -t sm32 0x092c
4.9.14 reg_write-将指定的内容写入从站寄存器
命令格式：ethercat reg_write [OPTIONS]
描述：将指定的内容写入从站寄存器
该命令有以下参数可用：
--alias –a 匹配从站别名
--position –p 从站的绝对地址
--type –t 数据类型
示例：ethercat reg_write -p 2 -t int32 0x0ff0 1
4.9.15 sdos-列出SDO字典
命令格式：ethercat sdos [OPTIONS]
描述：列出SDO字典
该命令有以下参数可用：
--alias –a 匹配从站别名
--position –p 从站的绝对地址
--quiet -q 只输出PDOS，不输出PDO条目示例：ethercat sdos –p 3
4.9.16 slaves-显示从站信息
命令格式：ethercat slaves [OPTIONS]
描述：显示从站信息
该命令有以下参数可用：
--alias –a 匹配从站别名
--position –p 从站的绝对地址
--verbose -v 显示从站详细信息
示例：ethercat slaves
4.9.17 soe_read-读取从站SOE IDN
命令格式：ethercat soe_read [OPTIONS] 描述：读取从站SOE IDN
该命令有以下参数可用：
--alias –a 匹配从站别名
--position –p 从站的绝对地址
--type -t 数据类型
示例：ethercat soe_read 0 0 -p 0 -t uint32 4.9.18 states-应用层转换状态机
命令格式：ethercat states [OPTIONS]
描述：应用层转换状态机
该命令有以下参数可用：
--alias –a 匹配从站别名
--position –p 从站的绝对地址示例：ethercat states –p 0 OP
4.9.19 version-显示主站版本
命令格式：ethercat version [OPTIONS]
描述：显示主站版本
示例：ethercat version
4.9.20 xml-生成从站信息描述文件
命令格式：ethercat xml [OPTIONS]
描述：生成从站信息描述文件
该命令有以下参数可用：
--alias –a 匹配从站别名
--position –p 从站的绝对地址示例：ethercat xml –p 0。