融合终端智芯操作系统使用说明书

操作系统使用说明书智芯操作系统使用说明书V4.25前言智芯操作系统平台（以下简称操作系统）为边缘计算终端量身定做的系统级平台，本系统基于Linux3.10深度定制开发，主要应用于基于国网智芯SCM701所研发的相关硬件产品。操作系统提供容器管理技术，虚拟的独立运行环境，能够通过对终端部分物理资源（CPU、内存、磁盘、网络资源等）的划分和隔离，屏蔽本容器中应用软件与其他容器或操作系统的相互影响。运行在容器中的软件，可单独快速开发、自由扩展。

目录TOC\o"1-3"\f\h\z\u5495第1章操作系统核心技术指标 126291第2章系统安装 237682.1烧录工具安装 224142.2软件介绍 4120762.3镜像烧录 4291242.3.1准备工作 4282072.4烧写 5197802.5注意事项 841502.5.1注意事项 8202882.5.2准备文件 9166862.5.3操作步骤 918997第3章系统登录 938043.1连接终端 9279393.2系统重启 1211081第4章高级指令操作 1232814.1设备管理 12244464.1.1设备信息 12246014.1.2设备告警 1564214.1.3设备温度 1740124.1.4设备版本 1744644.2网络配置 18156084.2.1本地网络 18173044.2.2无线APN配置 192604.3容器管理 23199774.3.1创建容器 23111494.3.2修改容器 2320454.3.3查看容器 2429804.3.4启动容器 2535744.3.5停止容器 2557874.3.6重启容器 26265084.3.7删除容器 2699924.4应用管理 27145484.4.1应用安装 2774574.4.2应用查询 27173704.4.3应用启动 28129944.4.4应用停止 29253434.4.5应用删除 30104604.5本地MQTT服务接入 3011069第5章创建应用程序指令 32248615.1智芯104程序 3275885.1.1交采底板程序 32199815.1.2创建智芯104程序 32188195.2104程序 33135675.2.1交采底板程序 3333585.2.2创建104程序 33226525.3创建698程序 33207085.4容器中手动启动程序 3459085.5查看APP运行日志 3414719第6章终端调试技巧 35106856.1烧写固件失败对策 35284686.2开启ssh 36179606.3删除安装容器 36198206.4进入容器指令 36196346.5复制文件到容器 3690546.6容器复制文件到宿主机 3699416.7查看APP运行日志 37141276.84G模组的调试 3725169第7章配置文件说明 3818057.1/etc/sysConf.yaml文件具体说明 38139197.2系统告警及阈值说明 39操作系统核心技术指标当前系统版本：OS_V04.025操作系统内核（kernel）：Linux3.10.108容器技术：Dockerversion18.09.6镜像文件大小：1.05G支持的通信协议：TCP/IP、HTTPS、MQTT支持的容器个数：≥5单容器多APP：支持系统软件升级：支持大支持flash：7.62GB最大支持DDR：4GB多核CPU：支持内置MQTTBroker：mosquittoversion1.4.8，mosquittoisanMQTTv3.1broker.内置SQLite数据库：版本3.11.0系统安装通过智芯提供的专用的烧录SCMSoftSuit工具将镜像烧写到硬件载体。本章以智芯公司提供的融合终端为例进行说明。烧录工具安装第一次运行程序烧录时，按以下步骤加载一次驱动：图2.1.1图2.1.2SCMSoftSuit软件属于绿色软件无需安装。在工具文件夹里找到来运行SCMSoftSuit软件，软件运行界面如图2.1.1所示。注意1：请勿与LiveSuit软件或者其它量产工具同时运行。注意2：本软件和豌豆荚，91手机助手等软件有冲突，运行本软件时请勿同时运行豌豆荚和91手机助手。图2.1.3软件介绍软件最上方区域是客户区，左键按住可以拖动窗口移动。客户区4个主功能按钮，点选不同的按钮可以切换到不同的功能页面。程序启动之后默认处于页面。软件中间是主操作区，设备进入时，切换至设备信息显示页面。状态栏用于显示软件的版本信息。点击，在弹出的如下窗口可以看到版本信息。图2.2.1客户区命令按钮，左边是帮助按钮，中间是最小化按钮，右边是关闭按钮。点击帮助按钮，显示帮助信息。点击最小化按钮，程序窗口将会最小化至系统任务栏。点击关闭按钮，程序将会关闭窗口并退出。镜像烧录准备工作（1）usb烧写电缆（mini5P数据线）,如图3.1.1所示：图2.3.1（2）短接线或其他可短接的工具（3）智能融合终端（4）烧写镜像。烧写（1）插上usb烧写电缆，需要安装驱动。我的电脑-管理-设备管理器-未识别的设备驱动，查找上图软件包路径，可以默认安装。图2.4.1（2）打开SCMSoftSuit烧写工具，检测到设备进入之后，就可以对设备进行刷机操作了。点击按钮进入刷机模块界面，如图2.4.2所示：图2.4.2点击浏览按钮在弹出的文件选择窗口中选择烧写镜像文件，如图2.4.3所示：图2.4.3在固件路径编辑框下方有勾选框，一旦勾选，并在下拉菜单中选择对应分区，烧录操作只会覆盖对应分区，不会影响其他分区。全系统烧写不建议勾选此项。操作界面如下图：图2.4.4智能融合终端需要短接，使用短接线或短接工具连接终端中的两PIN，连接如图2.4.5所示：图2.4.5同步按下复位键，如图2.4.6所示，再立马插入烧写线，松开复位键，弹出烧写信息，此时可拔掉短接线或放开短接操作，选择弹窗中的是，进行烧写。图2.4.6如果烧写工具驱动、TTU板子正常，烧写软件将进入如下状态，直至进度为100%，弹出烧写完成提示框，可拔掉烧写电缆，固件烧写完成。图2.4.7注意事项注意事项终端烧写4.21版本后，禁止烧写以前的镜像版本。如果终端成功烧写过4.21操作系统，可以不用执行“操作程序一”，直接执行“操作程序二”。如果不曾烧写过4.21，或者烧写不成功，请按照操作步骤执行。准备文件OS_V04.021.imgsafe.sh操作步骤操作程序一:step1:烧写OS_V04.021.img.烧写完成后拔掉usb线。step2:串口登入操作系统,执行shell指令:"sudommc_set_slc.sh"step3.硬件复位。操作程序二：step1:重新烧写OS_V04.021.img.烧写完成后拔掉usb线。step2:串口登入操作系统,step3:配置设备信息,以下为示例，根据现场情况修改sudoboardcfg-SN-TEST"12345678901234560123456789ABCDEF"sudoboardcfg-M"SCM701"sudodevcfg-SN"T20001SCT120201608080109"sudodevcfg-T"T20"sudodevcfg-N"000001"sudodevcfg-MF"BEIJINGSMARTCHIPMICROELECTRONICSTECHNOLOGYCOMPANYLIMITED"sudodevcfg-MD"2019-11-30"sudodevcfg-HV"HV02.01"sudodevcfg-M"SCM701"sudodevcfg-ST"normal"step4：根据现场情况决定是否需要关闭安全，如果需要，通过串口导入safe.sh到系统中，执行命令sudobashsafe.shunsafe step5.重启系统sudoreboot系统登录连接终端打开Xshell输入ssh指令:ssh18888（系统默认IP和端口号，如果不指定8888端口，默认端口是22）此处IP是智能终端的IP。（注意自己的电脑的IP设置，最好是固定IP，与智能终端保持同网段)安全系统注意事项用户名/密码：sysadm/Zxwdz@guest123默认ssh无效，如需使用需要串口登录系统开启ssh服务。开启指令为sudoservicestartssh。此方法是暂时有效，如果系统重启需要重新开启服务。使用ssh登录默认登录端口号为8888。登录名为sysadm有部分权限无法执行，可以使用sudo加相应的操作，可以达到root的权限。终端有两个网口，烧写完系统，FE1地址为1，FE2地址为1普通系统注意事项用户名/密码：root/Sgitg2019.TTU使用ssh登录默认登录端口号为22。终端有两个网口，烧写完系统，FE1地址为1，FE2地址为1如果用户使用权限不够的话，请在指令前加sudo。如执行containerstatusdb没有权限添加sudo执行，其结果如下：系统重启手动输入sudoreboot指令即可进行系统重启，也可以找到硬件复位键，进行硬件复位也可达成对系统的重启。高级指令操作设备管理设备信息命令功能：通过devctl命令可以查看设备的指定信息，包括设备款型、设备ESN号、电子标签信息（核心板信息）、系统MAC地址、厂商信息、Flash内存信息、RAM信息、硬件版本号、接口信息和设备的CPU频率。指令解析：#查看设备款型root@root:~#devctl-tdevicetype:SCM701serialtype:SCM#查看设备的ESN号root@root:~#devctl-eesn:2102351HNF10H7000001root@root:~#devctl-EBoardType=SCM701V1.0BarCode=025BHN1234567890Manufactured=2018-03-23VendorName=BEIJINGSMARTCHIPMICROELECTRONICSTECHNOLOGYCOMPANYLIMITEDIssueNumber=00Model=T20#查看设备的电子标签信息。#查看系统的MAC地址。root@root:~#devctl-MEth0MAC:00:00:7f:84:eb:01Eth1MAC:00:00:67:94:0a:06#查看厂商信息。root@root:~#devctl-vvendor:BEIJINGSMARTCHIPMICROELECTRONICSTECHNOLOGYCOMPANYLIMITED#查看设备的Flash内存信息。root@root:~#devctl-IFlashsize:4096M#查看设备的RAM信息。root@root:~#devctl-mMemorysize:1024M#查看设备的硬件版本号。root@root:~#devctl-Hhardwareversion:PCB0#查看设备的CPU频率。root@root:~#devctl-fCPU(MHz):1200#查看设备的接口信息。root@root:~#devctl-iif-nameif-typeFE0EthLTELTERS485-IRS485RS485-IIRS485RS485-III/RS232-IRS485RS485-IV/RS232-IIRS232注：LTE视模块是否存在而定,RS485-III/RS232-I根据接口设置而定。设备告警命令功能：monitorctl命令可以查看和设置设备当前的基本使用状态，包括CPU使用率、内存使用率、存储空间使用率和已产生的告警，进而判断当前设备是否发生故障或处于异常的工作状态指令解析：#查看设备的CPU使用率。root@root:~#monitorctl-cCPUusage:15%#查看设备的内存使用率。root@root:~#monitorctl-mmemoryusage:15%#查看设备的存储空间使用率。root@root:~#monitorctl-istorageusage:15%#查看设备当前已产生的告警。root@root:~#monitorctl-sresource:HighCPUUsage,alt-resource:new,event-time:2017-02-0616:15:09,perceived-severity:Warning,alarm-text:ThecurrentCPUusageishighresource:HighMemoryUsage,alt-resource:new,event-time:2017-02-0616:15:09,perceived-severity:Warning,alarm-text:Thecurrentmemoryusageishigh#设置设备的CPU使用率告警门限值为85。root@root:~#monitorctl-tcpu85threshold:setthresholdsuccess#设置设备的内存使用率告警门限值为90。root@root:~#monitorctl-tmemory95threshold:setthresholdsuccess#设置设备的存储空间使用率告警门限值为75。root@root:~#monitorctl-tstorage75threshold:setthresholdsuccess#恢复设备的CPU使用率告警门限值为默认值。root@root:~#monitorctl-rcputhreshold:restorethresholdsuccess#显示设备的CPU使用率告警门限值。root@root:~#monitorctl-dcpuCPUusagethreshold:90%#恢复设备的内存使用率告警门限值为默认值。root@root:~#monitorctl-rmemorythreshold:restorethresholdsuccess#恢复设备的存储空间使用率告警门限值为默认值。root@root:~#monitorctl-rstoragethreshold:restorethresholdsuccess设备温度命令功能：合适的温度范围是设备稳定运行的前提，设备温度过高或过低可能会造成硬件的损坏。执行此命令，可以查看设备当前的温度信息。当设备温度超过上下限阈值时，设备会产生告警，提示用户设备处于不正常工作状态。指令解析：#查看主板温度。root@root:~#temperature-tMainboard:42C设备版本命令功能：version命令用来查看设备的版本信息。执行此命令，可以查看设备当前的系统版本和内核信息进而判断设备是否需要升级。指令解析：#查看设备系统版本的详细信息。root@root:~#version-dsoftwareversion:V01.008patchversion:--#查看设备内核版本的详细信息。root@root:~#version-kkernelversion:V01.008网络配置本地网络在任意路径下执行：cd/etc/network/interfaces.d命令，及切换到修改配置网口ip的配置文件当中会看到以下图片：此处FE0为网口1的配置文件用vi指令打开此文件，如图所示：将第五行address（红色圈）后的ip改成规定的ip，geteway(绿色圈)是配置网关，需与规定IP相对应。注意格式不要变，修改完成后使用wq保存退出指令，修改结束后执行reboot指令，配置文件修改重启生效。无线APN配置接入点APN（AccessPointName）用来标识用户要访问的外部PDN网络，例如Internet和IMS网络。通过执行wwanapnadd命令在APN模板中配置APN，该命令采用交互式输入，先输入wwanapnadd，然后依次输入对应参数。指令解析：#为LTE接口配置APN，命名为LTEapn，用户名为admin，密码为admin@LTE，认证方式为chap。root@root:~#wwanapnaddEnterapnname(1-99):LTEapnEnterusername(1-64):adminEnterpassword(1-32):Enterauthentication(paporchap):chapEnterdevname(1-64):ppp0#如果LTE模块有两个模组，在配置APN时，需要对其中一个或全部进行配置操作。为第一个模组LTE接口配置APN，命名为LTEapn，用户名为admin，密码为admin@LTE，认证方式为chaproot@root:~#wwanapnaddEnterapnname(1-99):LTEapnEnterusername(1-64):adminEnterpassword(1-32):Enterauthentication(paporchap):chapEnterdevname(1-64):ppp0addapnLTEapnsuccessfully(或者addapnLTEapnfailed)#删除一个模组内命名为LTEapn的APN设置。root@root:~#wwanapndeleteLTEapnppp0Del-apn:LTEapnDevice:ppp0APN–LTEapnfordevice–ppp0Deleted.root@root:~##查询一个模组内命名为LTEapn的APN设置。root@root:~#wwanapnshowdevallApnInformationbeginppp0：apn:LTEapnuser:adminauthentication-mode:chapppp1：apn:LTEapnuser:adminauthentication-mode:chaproot@root:~#wwanapnshowdevppp0ApnInformationbeginppp0:apn:LTEapnuser:adminauthentication-mode:chaproot@root:~##向LTEModem发送AT指令AT+CSQ查询信号强度。root@root:~#wwanatsend“AT+GMM”devppp0+GMM:N720OK关于双无线模组配置：（1）准备工作在做网络配置之前，需要知道双4G模块在系统的系统设备名称，例如对于双4G模块虚拟的两个网卡名称分别为ppp-0和ppp-1。需要知道应用APP各自连接的主站IP地址和端口号。当然，还需要知道连接的主站都是使用的哪个SIM卡，即需要知道各主站都是用的哪个APN设置及哪个网卡设备。以下表为例：网卡设备名APN名称主站IP及端口ppp-0YingxiaoAPN232.435.12.34:22ppp-1PeidianAPN42:22以上信息都知道之后，再做下一步配置工作。（2）本地系统内路由配置首先，设置默认网关，让所有IP包默认情况下均通过ppp-0转发，在操作系统下输入如下指令：routeadddefaultdevppp-0然后，单独为另外一个主站访问设置转发特例，所有456.232开头的，全部走ppp-1。在操作系统下输入如下指令：routeadd-net4netmaskdevppp-1（3）永久解决方案解决双同时4G连接两个测试主站（例如同时连接104测试主站和698测试主站），并且设备掉电重启或系统重启后仍可以自动连接测试主站。具体操作步骤：上传add_route.sh脚本到/root目录下（通过Xshell工具上传）根据实际主站IP地址对脚本进行修改，修改为现场需要的固定IP，注意保存。查看修改的的脚本是否正确，仔细核对IP信息，与修改的要一致为脚本附加执行权限，执行指令：chmod777/root/add_route.sh添加脚本到看门狗程序的配置文件中执行指令：vi/etc/proc_conf插入/root/add_route.sh（注意格式，否则会导致系统死机），输入：wq保存配置文件在终端系统中输入sync后reboot重启系统系统重启后执行route-n查看添加的路由是否成功容器管理创建容器创建104app的容器并运行的指令如下：containerinstall104app-104.tar–disk200m–p9001:9001指令解析：创建容器指令：containerinstallcontainerapp-name[-vdirection][-devdev-parameter][-cpucpu-number][-memmem-parameter][-diskdisk-parameter]固定指令（必选）：containerinstall目标容器名（必选）：container目标软件包名（必选）：app-name挂载的宿主机文件夹（可选）：[-vdirection]表示映射的设备（可选）：[-devdev-parameter]表示映射的端口（可选）：[-pparameter:parameter]表示cpu的配置资源（可选）：[-cpucpu-number]表示内存的配置资源（可选）：[-memmem-parameter]表示存储资源配置（可选）：[-diskdisk-parameter]修改容器修改104app的容器并运行的指令如下：containerconfig104–disk300m–p9001:9001-dev/dev/spidev2.0:/dev/spidev2.0-v/opt/app:/opt/app指令解析：修改容器指令：containerconfigcontainer[-vdirection][-devdev-parameter][-cpucpu-number][-memmem-parameter][-diskdisk-parameter]固定指令（必选）：containerconfig目标容器名（必选）：container挂载的宿主机文件夹（可选）：[-vdirection]表示映射的设备（可选）：[-devdev-parameter]表示映射的端口（可选）：[-pparameter:parameter]表示cpu的配置资源（可选）：[-cpucpu-number]表示内存的配置资源（可选）：[-memmem-parameter]表示存储资源配置（可选）：[-diskdisk-parameter]查看容器可以查看容器的状态。显示容器的状态（running/stopped）、IP地址、CPU配置参数、CPU使用率、内存配置和内存占用率，当容器处于停止状态时，CPU使用率和内存占用率显示为0。查询容器状态：containerstatuscontainer指令解析：固定指令（必选）：containerstatus目标容器名（必选）：container启动容器启动容器指令：containerstartcontainer指令解析：固定指令（必选）：containerstart目标容器名（必选）：container停止容器停止容器指令：containerstopcontainer指令解析：固定指令（必选）：containerstop目标容器名（必选）：container重启容器重启容器指令：containerrestartcontainer指令解析：固定指令（必选）：containerrestart目标容器名（必选）：container删除容器需要删除容器时，可以通过执行containeruninstallcontainer命令进行设置。删除容器：containeruninstallcontainer指令解析：固定指令（必选）：containeruninstall目标容器名（必选）：container应用管理应用安装应用安装包可以安装到已经存在容器中，如上文提到的容器104，使用app-jc.tar：appm-i-c104-napp-jc-f/usr/local/default/apps/app-jc.tar指令解析：创建容器指令：appm-i[-cpucpu-number][-memmem-parameter]-ccontainer-name[-napp-name]-ffile-path固定指令（必选）：appm-i表示cpu的配置资源（可选）：[-cpucpu-number]表示内存的配置资源（可选）：[-memmem-parameter]目标容器名（必选）：-ccontainer-name目标软件包名（可选）：[-napp-name]指定APP文件包及路径（必选）：-ffile-path应用查询可以查看软件的状态。显示软件的状态（running/stopped）、CPU，内存等信息。安装软件：appm-I-ccontainer-name[-napp-name][-l]指令解析：固定指令（必选）：appm-I目标容器名（必选）：-ccontainer-name目标软件（可选）：[-napp-name]显示服务日志信息（可选）：[-l]例：应用启动启动软件：appm-s-ccontainer-name-napp-name指令解析：固定指令（必选）：appm-s目标容器名（必选）：-ccontainer-name目标软件（必选）：-napp-name例:应用停止启动软件：appm-S-ccontainer-name-napp-name指令解析：固定指令（必选）：appm-S目标容器名（必选）：-ccontainer-name目标软件（必选）：-napp-name例：应用删除删除软件：appm-u-ccontainer-name-napp-name指令解析：固定指令（必选）：appm-u目标容器名（必选）：-ccontainer-name目标软件（必选）：-napp-name例：本地MQTT服务接入无论是局域网模式还是4G模式，都需要使用配置brokeIP：进行如下操作：连接到融合终端系统输入账户名密码。（如若使用网络调试，需修改融合终端的IP，如果使用局域网调试，则需要到指定位置修改IP的配置文件）进入系统后执行vi/etc/sysConf.yaml得到以下图片：修改标红色方框，切记不要改乱格式。融合终端有两种编辑方式，Vi和nano都可以用，用户可以根据习惯使用。修改上图圈红地方，此处是与物联管理平台broke的IP地址和端口号，格式不要变化。修改完之后执行cat/etc/sysConf.yaml看看相应位置是否更改成功，更改成功执行reboot重启指令，修改配置文件重启生效。创建应用程序指令智芯104程序所有想要安装在本系统的docker内的app都要按照app打包说明进行app打包终端默认安装路径是/usr/local/default/apps，所以创建容器时，默认路径中有指定的安装包，直接使用安装包就可以创建容器。containerinstall104app-104.tar104程序配合使用的各个程序如下表所示：序号名称包名备注1104APPapp-104.tar可执行程序为pro1042交采APPapp-jc.tar可执行程序为appjc7.0.43极值APPjizhi.tar可执行程序为jizhi4交采底板程序jc7.hex交采底板程序交采底板的烧写，需要使用交采程序执行，具体执行如下所示root@SCT230A:~/tmp#tar-xvfapp-jc.tar//解压交采程序app-jc/app-jc/sign.cfgapp-jc/app.cfgapp-jc/version.cfgapp-jc/bin/app-jc/bin/jc_engAcc2.jsonapp-jc/bin/jc_engAcc1.jsonapp-jc/bin/jc_appcfg.jsonapp-jc/bin/exist.testapp-jc/bin/appjc7.0.4cdapp-jc/bin//进入交采程序可执行目录./appjc7.0.4-pFjc7.hex//执行烧写交采底板程序创建智芯104程序containerinstall104app-104.tar-p9004:9004-disk1000m-dev/dev/spidev2.0:/dev/spidev2.0-v/data/app:/data/app//使用104安装包，创建104容器appm-i-c104-f/usr/local/default/apps/app-jc.tar//创建交采appm-i-c104-f/usr/local/default/apps/jizhi.tar//创建极值104程序104程序配合使用的各个程序如下表所示：序号名称包名备注1104APPappd-104.tar可执行程序为Daqo1042交采APPappd-jc.tar可执行程序为appjc7.0.1.dq.emcapp-jc.tar可执行程序为appjc7.0.4,烧写交采底板。3极值APPjizhi.tar可执行程序为jizhi4交采底板程序jc7.hex5历史文件historyflie.tar可执行程序为historyflie6数据库appd-base.tarDaqoBase交采底板程序烧写步骤参照4.1.1创建104程序//使用数据库安装包，创建db容器containerinstalldbappd-base.tar-p2404:2404-disk1000m-dev/dev/spidev2.0:/dev/spidev2.0-dev/dev/pt100-i2c:/dev/pt100-i2c-v/mnt/nand:/mnt/nand//创建104appappm-i-cdb-f/usr/local/default/apps/appd-104.tar//创建交采appm-i-cdb