{"result":{"seoKeyword":"","createUserId":1,"wikiInfo":[{"productId":15,"children":[{"productId":15,"children":[],"pid":18,"id":19,"sort":0,"title":"1.1. 1. 产品简介","content":"

1.1. 1. 产品简介<\/strong><\/h2>\n\n
Firefly集群服务器是一款高密度ARM核心板卡的集群服务器。服务器采用机架式服务器规格设计，核心板卡基于Rockchip芯片平台。通过Firefly的创新设计和软件支持，使得集群服务器在云手机、边缘计算等多领域具有良好的适应性。Firefly集群服务器经过多个软硬件版本迭代，现已经具有完善合理的软硬件系统支持，并且具有以下特色：<\/p>\n\n
\n\t
\n\t
高密度核心：<\/p>\n\t<\/li>\n<\/ul>\n\n
R1版集群服务器为1U规格，支持集成11个独立核心板卡。<\/p>\n\n
R2版集群服务器为2U规格，支持集成72个独立板卡。<\/p>\n\n
\n\t
\n\t
核心板卡可配置<\/p>\n\t<\/li>\n<\/ul>\n\n
根据业务场景的需求，集群服务器的核心板卡可以选择不同的规格。并且也支持不同规格板卡混插。如云手机、AI运算、区块链运算等，都可以选用不同规格的核心板卡。<\/p>\n\n
\n\t
\n\t
核心板软件系统独立<\/p>\n\t<\/li>\n<\/ul>\n\n
集群服务器各个核心板卡可独立运行Android/Linux 操作系统。单个核心板故障不会导致整个服务器宕机。<\/p>\n\n
\n\t
\n\t
BMC可视化管理系统<\/p>\n\t<\/li>\n<\/ul>\n\n
通过集群服务器的BMC管理单元，可以实现用户在web浏览器对核心板卡的监测、配置、系统更新等操作。<\/p>\n\n
\n\t
\n\t
热插拔设计<\/p>\n\t<\/li>\n<\/ul>\n\n
集群服务器的电源单元、子核心板单元、网络单元、温控单元、扩展存储单元均采用热插拔设计，可以有效降低服务器的部署和维护工作。<\/p>\n\n
\n\t
\n\t
冗余设计<\/p>\n\t<\/li>\n<\/ul>\n\n
集群服务器的电源管理单元和网络管理单元采用冗余设计，可以应对部分电源和网络的突发故障。<\/p>\n\n
\n\t
\n\t
温控设计<\/p>\n\t<\/li>\n<\/ul>\n\n
集群服务器集成温控单元，通过监测服务器内环境温度和核心温度，可以有效调节散热风扇工作状态，优化服务器的整体性能和稳定性。<\/p>\n<\/div>\n"},{"productId":15,"children":[],"pid":18,"id":30,"sort":0,"title":"1.2. 2. 产品规格","content":"
1.2. 2. 产品规格<\/h2>\n\n
1.2.1. (1). 技术规格<\/strong><\/p>\n\n
\n\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t
型号<\/strong><\/td>\n\t\t\t Cluster Server R1<\/strong><\/td>\n\t\t\t Cluster Server R2<\/strong><\/td>\n\t\t<\/tr>\n\t\t
核心板卡数<\/span><\/td>\n\t\t\t 11<\/span><\/td>\n\t\t\t 72 (热插拔设计)<\/span><\/td>\n\t\t<\/tr>\n\t\t
构架<\/span><\/td>\n\t\t\t ARM架构<\/span><\/td>\n\t\t\t ARM架构<\/span><\/td>\n\t\t<\/tr>\n\t\t
操作系统<\/span><\/td>\n\t\t\t 支持Android、Ubuntu、Linux操作系统<\/span><\/td>\n\t\t\t 支持Android、Ubuntu、Linux操作系统<\/span><\/td>\n\t\t<\/tr>\n\t\t
网络<\/span><\/td>\n\t\t\t 1GE千兆RJ45网口4个其中：主核心板网口1个，普通网口3个<\/span><\/td>\n\t\t\t 双网卡冗余设计，单网卡集成：千兆网口(RJ45)×2、万兆网口(SFP )×2BMC网络接口<\/span><\/td>\n\t\t<\/tr>\n\t\t
4G<\/span><\/td>\n\t\t\t 4G/LTE/5G网络(可选配)<\/span><\/td>\n\t\t\t 不支持<\/span><\/td>\n\t\t<\/tr>\n\t\t
显示<\/span><\/td>\n\t\t\t 1×Mini HDMI 2.0，4K@60Hz(控制主板显示)<\/span><\/td>\n\t\t\t 1×Mini HDMI 2.0，4K@60Hz(控制主板显示)<\/span><\/td>\n\t\t<\/tr>\n\t\t
扩展存储<\/span><\/td>\n\t\t\t 3.5寸STAT硬盘<\/span><\/td>\n\t\t\t 3.5寸STAT硬盘 / SD卡<\/span><\/td>\n\t\t<\/tr>\n\t\t
USB<\/span><\/td>\n\t\t\t 2个USB2.0 HOST1 个 Type-C(处理器核心板调试用)<\/span><\/td>\n\t\t\t 1 × USB3.0 HOST<\/span><\/td>\n\t\t<\/tr>\n\t\t
电源<\/span><\/td>\n\t\t\t 300W AC电源(输入：100V AC～240V AC)<\/span><\/td>\n\t\t\t 双路冗余电源设计：AC 100~240V 50/60Hz，1300W / 800W 可选<\/span><\/td>\n\t\t<\/tr>\n\t\t
散热<\/span><\/td>\n\t\t\t 散热片 5个高速散热风扇<\/span><\/td>\n\t\t\t 散热片 2组风扇模组：风扇模组1(3×2冗余风扇设计)、风扇模组2(2×2冗余风扇设计)<\/span><\/td>\n\t\t<\/tr>\n\t\t
UID<\/span><\/td>\n\t\t\t 无<\/span><\/td>\n\t\t\t UID按键×1<\/span><\/td>\n\t\t<\/tr>\n\t\t
硬件看门狗<\/span><\/td>\n\t\t\t 有<\/span><\/td>\n\t\t\t \n\t\t\t
有<\/span><\/p>\n\t\t\t<\/td>\n\t\t<\/tr>\n\t<\/tbody>\n<\/table>\n\n
1.2.2. (2). 子板规格<\/strong><\/p>\n\n
\n\n\t\n\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t
型号<\/th>\n\t\t\t Cluster Server R1<\/th>\n\t\t\t Cluster Server R2<\/th>\n\t\t<\/tr>\n\t<\/thead>\n\t
节点数<\/td>\n\t\t\t 一体化1U服务器<\/td>\n\t\t\t 9个刀片节点
\n\t\t\t每个节点都能配置8个处理器核心板
\n\t\t\t节点9可用于安装2个3.5寸SATA/SSD硬盘<\/td>\n\t\t<\/tr>\n\t\t
核心数<\/td>\n\t\t\t 最高可配置11个处理器核心板<\/td>\n\t\t\t 最高可配72个处理器核心板<\/td>\n\t\t<\/tr>\n\t\t
核心板<\/td>\n\t\t\t RK3399(AI)核心板(Core-3399-JD4)
\n\t\t\tRK3328核心板(Core-3328-JD4)
\n\t\t\tRK1808(AI)核心板(Core-1808-JD4)
\n\t\t\tRK3588核心板(Core-3588SJD4)<\/td>\n\t\t\t RK3399(AI)核心板(Core-3399-JD4)
\n\t\t\tRK3328核心板(Core-3328-JD4)
\n\t\t\tRK1808(AI)核心板(Core-1808-JD4)
\n\t\t\tRK3588核心板(Core-3588SJD4)<\/td>\n\t\t<\/tr>\n\t\t
内存<\/td>\n\t\t\t 1GB / 2GB / 4GB<\/td>\n\t\t\t 1GB / 2GB / 4GB<\/td>\n\t\t<\/tr>\n\t\t
存储<\/td>\n\t\t\t eMMC
\n\t\t\t3.5英寸硬盘
\n\t\t\t1个SATA/SSD硬盘<\/td>\n\t\t\t eMMC
\n\t\t\t3.5英寸SATA/SSD硬盘位x2(节点9)
\n\t\t\tSD卡 x1<\/td>\n\t\t<\/tr>\n\t<\/tbody>\n<\/table>\n<\/div>\n\n
说明： Firefly后期会持续推出更高性能，更大内存的的核心子板，支持8 / 16G内存<\/strong><\/p>\n\n
\n
1.2.3. (3). 物理规格<\/strong><\/h3>\n\n
\n\n\t\n\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t
型号<\/th>\n\t\t\t Cluster Server R1<\/th>\n\t\t\t Cluster Server R2<\/th>\n\t\t<\/tr>\n\t<\/thead>\n\t
尺寸<\/td>\n\t\t\t 标准1U机架式：490mm x 390mm x 44.4mm<\/td>\n\t\t\t 标准2U服务器机箱：580mm x 434mm x 88.8mm<\/td>\n\t\t<\/tr>\n\t\t
重量<\/td>\n\t\t\t 服务器主机：5.8kg 包装总重：7.2 kg<\/td>\n\t\t\t 包装总重量：29 kg<\/td>\n\t\t<\/tr>\n\t<\/tbody>\n<\/table>\n<\/div>\n<\/div>\n\n
\n
1.2.4. (4). 环境规格<\/strong><\/h3>\n\n
\n\n\t\n\t\t\n\t\t\t\n\t\t\n\t\t\t\n\t\t\t
型号<\/th>\n\t\t\t Cluster Server R1<\/th>\n\t\t\t Cluster Server R2<\/th>\n\t\t<\/tr>\n\t<\/thead>\n\t
工作温度<\/td>\n\t\t\t 0ºC - 40ºC<\/td>\n\t\t\t 0ºC - 50ºC<\/td>\n\t\t<\/tr>\n\t\t
工作湿度<\/td>\n\t\t\t 8%RH~95%RH<\/td>\n\t\t\t 10%RH~80%RH<\/td>\n\t\t<\/tr>\n\t<\/tbody>\n<\/table>\n<\/div>\n<\/div>\n"}],"pid":0,"id":18,"sort":0,"title":"产品介绍","content":""},{"productId":15,"children":[],"pid":0,"id":77,"sort":2,"title":"使用说明","content":"
2. 使用说明<\/strong><\/h1>\n\n
\n
2.1. 1. 整机说明<\/strong><\/h2>\n\n
\n
2.1.1. (1). 实物图<\/strong><\/h3>\n\n
\n\t
\n\t
集群服务器 Cluster Server R2 (9刀)<\/p>\n\n\t
$\"\"$ <\/p>\n\n\t
$\"\"$ <\/p>\n\n\t
$\"\"$ <\/p>\n\t<\/li>\n<\/ul>\n\n
《旧款集群服务器 Cluster Server R2 (6刀不维护)实物图》<\/a><\/p>\n\n
\n
\n
2.1.2. (2). 按键说明<\/strong><\/h3>\n\n
\n\t
\n\t
1. POWER LED x2<\/strong> 电源状态指示灯：分别对应主机左右（正面图）2个电源，电源正常为绿色，电源异常或缺失则相应位置的LED为红色。<\/p>\n\t<\/li>\n\t
\n\t
2. BMC LED<\/strong> 主板状态指示灯：主机main主板正常进入系统后亮起。<\/p>\n\t<\/li>\n\t
\n\t
3. FAN LED x2<\/strong> 风扇状态指示灯：风扇正常为绿色，风扇转速异常或没接入风扇模块则相应位置的LED为红色，并响起蜂鸣器提示声。<\/p>\n\t<\/li>\n\t
\n\t
4. UID LED<\/strong> UID指示灯：按下UID按键（背面图的10号键）后常亮，便于机房维护人员使用。<\/p>\n\t<\/li>\n\t
\n\t
5. NET LED x2<\/strong> 交换机状态显示灯，正常为绿色，交换机异常或没有接入则相应位置的LED为红色。<\/p>\n\t<\/li>\n\t
\n\t
6. POWER KEY<\/strong> 电源按键：按下按键不松开，听到蜂鸣器提示声，等提示声消失后立即松开按键（持续时间为3s）。详情可查看开关机操作。<\/p>\n\t<\/li>\n\t
\n\t
7. RESTART KEY<\/strong> 复位按键：按下复位键，main板强制重启。<\/p>\n\t<\/li>\n<\/ul>\n<\/div>\n\n
\n
2.1.3. (3). 网络拓扑图<\/strong><\/h3>\n\n
$\"\"$ <\/p>\n\n
\n
\n
2.1.4. (4). 开关机<\/strong><\/h3>\n\n
\n\t
\n\t
正常开机：在主机关机状态下，按下POWER KEY<\/span>不松开，持续几秒。<\/p>\n\t<\/li>\n\t
\n\t
正常关机：在主机开机状态下，按下POWER KEY<\/span>不松开，并听到蜂鸣器提示声，持续3s，主机确认关机状态后蜂鸣器提示声消失，立即松开按键。主机进行正常关机。<\/p>\n\t<\/li>\n\t
\n\t
强制关机（一般情况下不建议使用）：在主机开机状态下，按下POWER KEY<\/span>不松开，并听到蜂鸣器提示声，持续5s，主机强制断电。<\/p>\n\t<\/li>\n<\/ul>\n\n
实现正常关机<\/strong>的条件是main core安装的linux系统，并安装了**firefly-sr-service-*.deb<\/strong>，出厂固件默认已安装。<\/p>\n<\/div>\n<\/div>\n\n
\n
2.2. 2. BMC管理系统<\/strong><\/h2>\n\n
BMC管理系统是一套运行集群服务器BMC管理单元上的软件系统，BMC管理单元是一块使用RK3399作为主控芯片的控制板(以下简称主板)，主板运行Ubuntu 18.04系统，通过网络和USB接口与集群服务器内其它核心板(以下简称子板)进行数据交互，实现对集群服务器各个核心板卡的监测和管理。其软件栈的组成为：<\/p>\n\n
\n\t
\n\t
node_exporter: 运行在主板和子板上，负责收集设备的监控数据。<\/p>\n\t<\/li>\n\t
\n\t
Prometheus: 运行在主板上，负责收集和存储各个设备的监控数据。<\/p>\n\t<\/li>\n\t
\n\t
Grafana: 运行在主板上，负责监控图表的集中显示。<\/p>\n\t<\/li>\n<\/ul>\n\n
该方案的优点是，由主板统一布署 node_exporter 到各个设备上(子板的操作系统可以是 Android 或 Ubuntu)，以直观的图表方式显示各个子板的资源使用状况。<\/p>\n\n
\n
2.2.1. (1). 登录<\/strong><\/h3>\n\n
\n\t
\n\t
外接HDMI显示器：<\/p>\n\t<\/li>\n<\/ul>\n\n
通过集群服务器的HDMI接口接显示器，接入鼠标键盘，可以登入BMC管理单元Ubuntu系统，打开系统浏览器，在地址栏输入 http://127.0.0.1:3000<\/span> 并回车即可访问，⽆需任何配置。<\/p>\n\n
\n\t
\n\t
使用BMC扫描工具：<\/p>\n\t<\/li>\n<\/ul>\n\n
通过BMC扫描工具可获取同一局域网内所有的BMC管理系统IP地址，打开工具后会默认扫描一次局域网，也可通过刷新按钮 $\"_images/wps1.jpg\"$ 手动扫描，根据软件界面中呈现的BMC管理系统IP地址列表项，点击ACTIONS下相应的 $\"_images/wps2.jpg\"$ 图标即可打开外部浏览器并进入相应IP地址的BMC管理系统登录页面。<\/p>\n\n
$\"\"$ <\/p>\n\n
\n
\n\t
\n\t
BMC系统初始用户名：admin<\/span> 密码：admin<\/span>，点击登录<\/span>按钮，进⼊默认的设备列表页⾯。<\/p>\n\t<\/li>\n<\/ul>\n\n
$\"\"$ <\/p>\n<\/div>\n\n
\n
2.2.2. (2). 设备列表<\/strong><\/h3>\n\n
\n
\n
\n
登录后默认进入设备列表页面。任何时候需要访问设备列表页面，点击左边工具栏上的 $\"_images/wps5.jpg\"$ 图标即可进入：<\/p>\n\n
$\"\"$ <\/p>\n\n
这是集群服务器所有设备的列表，每个卡片代表一块设备。<\/p>\n\n
设备列表页面的左上角，有两个下拉列表：<\/p>\n\n
$\"_images/wps7.jpg\"$ <\/p>\n\n
(1). 设备：可以过滤需要显示的设备，这在设备比较多的情况下很有用。<\/p>\n\n
(2). 离线设备：仅供快速查看离线设备的列表。<\/p>\n\n
往下看，这是服务器提供的外设接口图(仅R1 有此面板)：4个网口，双层USB，HDMI，OTG，Sim Card，磁盘；<\/p>\n\n
$\"_images/wps8.jpg\"$ <\/p>\n\n
U：LAN 表示：上方黄色的LED灯的亮/灭对应着该设备的网络状态；<\/p>\n\n
D：WORK 表示：下方绿色的LED灯的亮/灭对应着该设备的工作状态；<\/p>\n\n
每个设备卡片，根据状态有不同的显示：<\/p>\n\n
\n\t
\n\t
当设备可以通过 adb 访问，并进入正常的操作系统：
\n\t $\"_images/wps9.jpg\"$ <\/p>\n\n\t
\n\t\t
\n\t\t
卡片顶部左边以绿色字样显示“设备可用”状态，后跟设备的当前操作系统，右边显示的是软件操作系统的版本和硬件版本（硬件版本仅 R2 有）；<\/p>\n\t\t<\/li>\n\t\t
\n\t\t
左边的图标表示核心板的 CPU 型号(CPU 核数和最高频率)、DDR 内存(4G) 和 eMMC 容量(32G)；<\/p>\n\t\t<\/li>\n\t\t
\n\t\t
“sub04”: 表示设备的 SUB 编号；<\/p>\n\t\t<\/li>\n\t\t
\n\t\t
$\"_images/wps10.jpg\"$ ：点击该按钮进入 Shell 终端窗口；<\/p>\n\t\t<\/li>\n\t\t
\n\t\t
$\"_images/wps11.jpg\"$ ：点击该按钮进入该设备的资源明细终端窗口；<\/p>\n\t\t<\/li>\n\t\t
\n\t\t
$\"_images/wps12.jpg\"$ ：点击该按钮重置设备电源；<\/p>\n\t\t<\/li>\n\t\t
\n\t\t
卡片右边第二行显示该设备的主网络接口的 IP 地址及连接速率，鼠标悬停时会显示所有网络接口地址和速率(目前仅主板有多个网络接口)；<\/p>\n\t\t<\/li>\n\t\t
\n\t\t
四个方块图分别显示 CPU、内存和磁盘的使用率，以及 CPU 的温度。<\/p>\n\t\t<\/li>\n\t<\/ul>\n\t<\/li>\n\t
\n\t
当设备处于离线状态，即设备由于物理移除、固件失效或操作系统异常等原因导致与主板的 usb 通讯失效时：
\n\t $\"_images/wps13.jpg\"$ <\/p>\n\n\t
\n\t\t
\n\t\t
卡片顶部以橙色字样显示“设备不可用”状态；<\/p>\n\t\t<\/li>\n\t\t
\n\t\t
$\"_images/wps14.jpg\"$ ：点击该按钮重置设备电源。<\/p>\n\t\t<\/li>\n\t<\/ul>\n\t<\/li>\n\t
\n\t
当设备处理维护状态，即设备处于系统升级模式（loader<\/span>)、固件升级系统（netrecovery<\/span>)、安卓急救模式（android_recovery<\/span>)或 ADB 离线（android_offline<\/span>)，将会显示:
\n\t $\"_images/wps14_1.jpg\"$ <\/p>\n\n\t
\n\t\t
\n\t\t
卡片顶部以黄色字样显示“设备维护”状态，后跟设备的明细状态。<\/p>\n\t\t<\/li>\n\t\t
\n\t\t
设备信息均为空，维护状态下不采集监控数据。<\/p>\n\t\t<\/li>\n\t\t
\n\t\t
$\"_images/wps14.jpg\"$ ：点击该按钮重置设备电源。<\/p>\n\t\t<\/li>\n\t<\/ul>\n\t<\/li>\n<\/ol>\n<\/div>\n\n
\n
2.2.3. (3). 仪表盘列表<\/strong><\/h3>\n\n
在设备列表或其它仪表盘页面中，点击最左上角的仪表盘名称：<\/p>\n\n
$\"_images/wps15.jpg\"$ <\/p>\n\n
可以查看更多的仪表盘：<\/p>\n\n
$\"_images/wps16.jpg\"$ <\/p>\n\n
目前有以下仪表盘：<\/p>\n\n
\n\t
\n\t
设备概览<\/p>\n\t<\/li>\n\t
\n\t
设备明细<\/p>\n\t<\/li>\n\t
\n\t
CPU 频率与温度监控<\/p>\n\t<\/li>\n<\/ul>\n\n
在仪表盘页面中，右上角的工具条，可以选择浏览时段，以及多长间隔自动更新。下图就显示最近 6 小时的数据，并每 5 秒更新一次。<\/p>\n\n
$\"_images/wps17.jpg\"$ <\/p>\n\n
点击 $\"_images/wps18.jpg\"$ 按钮可手工刷新监控数据页面显示。<\/p>\n\n
\n
2.2.3.1. A. 设备概览<\/strong><\/h3>\n\n
通过仪表盘列表，或点击左边工具栏上的 $\"_images/wps19.jpg\"$ 图标即可进入设备概览页面：<\/p>\n\n
$\"\"$ <\/p>\n\n
设备概览页面将所有设备的 CPU、内存、磁盘和网络这四项数据集中显示在一起：<\/p>\n\n
\n\t
\n\t
鼠标悬停在曲线图上即可显示设备的明细数值。<\/p>\n\t<\/li>\n\t
\n\t
右上的“告警列表”，当 CPU、内存和磁盘超过红色警戒线一段时间，即触发告警动作，例如发送邮件等(此项功能需配置相关参数，待加说明)。<\/p>\n\t<\/li>\n\t
\n\t
右下的“设备列表”，列出所有在线设备的结点名称和 IP 地址，方便查看。鼠标点击即可查看该设备的设备明细页面。<\/p>\n\t<\/li>\n<\/ul>\n<\/div>\n\n
\n
2.2.3.2. B. 设备明细<\/strong><\/h3>\n\n
有以下几种方法可以进入设备明细页面：<\/p>\n\n
\n\t
\n\t
设备列表页面中点击设备卡上的 $\"_images/wps21.jpg\"$ 按钮；<\/p>\n\t<\/li>\n\t
\n\t
设备概览页面中点击右边设备列表上的表格项；<\/p>\n\t<\/li>\n\t
\n\t
通过仪表盘列表进入。<\/p>\n\t<\/li>\n<\/ol>\n\n
$\"\"$ <\/p>\n\n
设备明细页面，提供资源的详细监控数据，用户可以选择其中一个设备来查看其详细的资源使用情况。<\/p>\n\n
左上的结点下拉选择框可以切换设备的明细显示，IP 地址即为该设备的所有网络接口的 IP 地址(仅作信息显示之用)：<\/p>\n\n
$\"_images/wps23.png\"$ <\/p>\n\n
右边的快速工具条，点击即可打开该设备的 Shell 终端窗口：<\/p>\n\n
$\"_images/wps24.jpg\"$ <\/p>\n\n
利用右边的滚动条往下翻，可见更多的监控项：<\/p>\n\n
$\"\"$ <\/p>\n<\/div>\n\n
\n
2.2.3.3. C. CPU频率与温度监控<\/strong><\/h3>\n\n
CPU 频率与温度监控页面用作开发阶段比对 CPU 频率与 SOC、GPU 温度的关系，看是否会因为风扇散热性能不足导致温度持续上升，进而导致 CPU 强制降频。<\/p>\n\n
$\"\"$ <\/p>\n\n
RK3399 有 6 个 CPU 核心，分别是小核 0~3, 大核 4~5。一般观测大核即可，因为页面空间原因，同一时间只显示一个核心。通过上部的下拉条可以切换核心显示：<\/p>\n\n
$\"_images/wps28.jpg\"$ <\/p>\n<\/div>\n<\/div>\n\n
\n
2.2.4. (4). Shell终端窗口<\/strong><\/h3>\n\n
有以下几种方法可以进入设备的 Shell 终端窗口：<\/p>\n\n
\n\t
\n\t
点击设备列表页面中点击设备卡上的 $\"_images/wps29.jpg\"$ 按钮；<\/p>\n\t<\/li>\n\t
\n\t
点击设备明细页面右上角的快速工具条 $\"_images/wps30.jpg\"$ <\/p>\n\t<\/li>\n<\/ol>\n\n
$\"\"$ <\/p>\n\n
主板的 Shell 终端窗口是主板 Ubuntu 系统下的 root shell，拥有超级用户的权限，可以执行各种系统维护命令，以及通过 adb 去操作各个子板。<\/p>\n\n
子板的 Shell 终端窗口是 adb shell，可以运行 su 命令切换成 root 用户。<\/p>\n\n
为方便管理，Firefly 集群监控系统引进命令行管理工具 bmc，能快速地进行各种日常子板操作和批量操作，详情请参见《bmc 命令行工具》<\/a>一章。<\/p>\n<\/div>\n\n
\n
2.2.5. (5). 子板固件升级<\/strong><\/h3>\n\n
准备工作：<\/p>\n\n
\n\t
\n\t
重要<\/strong>: 主板和要升级的子板都需要获得有效的 DHCP IP 地址，请务必插好网线。<\/p>\n\t<\/li>\n\t
\n\t
集群服务器的 OTG USB 口与外部 PC 机的连接必须断开。<\/p>\n\t<\/li>\n\t
\n\t
固件需要以 “.img” 扩展名结尾，并放到主板的 /home/firefly/Firmware 目录里。<\/p>\n\t<\/li>\n<\/ul>\n\n
点击左边工具栏上的 $\"_images/wps32.jpg\"$ 图标即可进入子板固件升级页面：<\/p>\n\n
$\"\"$ <\/p>\n\n
点击右上角的按钮 $\"_images/wps34.jpg\"$ 进入“新增子板固件升级”页面：<\/p>\n\n
$\"\"$ <\/p>\n\n
\n\t
\n\t
选择升级固件，在下拉列表中选择即可。<\/p>\n\t<\/li>\n\t
\n\t
选择升级设备：左边是可用的设备列表，右边则是待升级的设备列表。<\/p>\n\n\t
\n\t\t
\n\t\t
若要升级所有的设备，按“添加全部”按钮，可将所有的可用设备添加到右边的列表中。<\/p>\n\t\t<\/li>\n\t\t
\n\t\t
若要升级一两个设备，直接鼠标双击对应的设备，可将单个设备添加到右边的列表中。<\/p>\n\t\t<\/li>\n\t\t
\n\t\t
设备列表上方的编辑框是做筛选之用，可快速筛选出需要的设备。<\/p>\n\t\t<\/li>\n\t\t
\n\t\t
按“删除全部”按钮，可清空待升级的设备列表。<\/p>\n\t\t<\/li>\n\t\t
\n\t\t
Ctrl 鼠标点击，可以增加或删除单个设备的选择；Shift 鼠标点击则可以增加或删除连续设备的选择。这跟 Windows 上的列表选择操作是一致的。选择设备后，按相应的“添加”或“删除”按钮即可将设备添加或移除到待升级的设备列表。<\/p>\n\t\t<\/li>\n\t<\/ul>\n\t<\/li>\n\t
\n\t
按“升级固件”按钮，即可开始固件升级。<\/p>\n\t<\/li>\n<\/ul>\n\n
刚提交的页面是这样的：<\/p>\n\n
$\"_images/wps36.jpg\"$ <\/p>\n\n
固件的升级时间较长(涉及到后台一系列切换和读写操作)，请耐心等待。后台是隔 15 秒刷新一次进度，界面会显示如下的进度页面：<\/p>\n\n
$\"_images/wps37.jpg\"$ <\/p>\n\n
\n\t
\n\t
左边是升级设备和进度列表。<\/p>\n\t<\/li>\n\t
\n\t
右上是升级进度折线图。<\/p>\n\t<\/li>\n\t
\n\t
右下即是已完成的设备列表(包括成功和出错的)。<\/p>\n\t<\/li>\n<\/ul>\n<\/div>\n\n
\n
2.2.6. (6). 修改密码<\/strong><\/h3>\n\n
鼠标移到左下角用户头像，在弹出菜单中选择“修改密码”：<\/p>\n\n
$\"\"$ <\/p>\n\n
输入旧密码、新密码和确认新密码，最后按“修改密码”按钮即可。<\/p>\n<\/div>\n\n
\n
2.2.7. (7). BMC 升级<\/strong><\/h3>\n\n
鼠标移至左下角的帮助图标：<\/p>\n\n
$\"_images/wps38_1.jpg\"$ <\/p>\n\n
在弹出菜单中选择“检查更新”。如果 BMC 有新版本，将会弹出对话框，并显示更新日志：<\/p>\n\n
$\"_images/wps38_2.jpg\"$ <\/p>\n\n
点击对话框右上角的“安装”按钮，系统将会自动下载安装包、安装并自动刷新界面。<\/p>\n<\/div>\n<\/div>\n\n
\n
2.3. 3. 其它使用说明<\/strong><\/h2>\n\n
\n
2.3.1. (1). 恢复出厂设置<\/strong><\/h3>\n\n
在终端输入以下命令：<\/p>\n\n
\n
\n
\nsudo recovery reset<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
系统进入恢复模式进行恢复出厂设置，大约30s后会自动重启进入系统。<\/p>\n<\/div>\n\n
\n
2.3.2. (2). 变砖急救方法<\/strong><\/h3>\n\n
如果Cluster Server R2<\/strong>系统严重损坏无法正常使用，有2种方法：<\/p>\n\n
\n
2.3.2.1. (2.1). 使用SD card制作升级卡重装系统<\/h4>\n\n
Cluster Server R2<\/strong>预留的SD卡接口（后视图的7号标签）除了可以用来读写SD卡之外，还可以用来在紧急情况下烧写系统。<\/p>\n\n
\n\t
\n\t
制作sd升级卡<\/a><\/p>\n\t<\/li>\n\t
\n\t
插入SD卡到SD卡槽（后视图的7号标签）<\/p>\n\t<\/li>\n\t
\n\t
重新开机或主机在上电状态下按下复位按键,进入main core启动并进入烧写模式<\/p>\n\t<\/li>\n\t
\n\t
烧写完成后立即拔出SD卡，系统自动重新启动（升级后的第一次启动略慢，大约比正常启动多30s）。<\/p>\n\t<\/li>\n<\/ol>\n\n
可以任选一种以下方法来确认是否进入烧写模式：<\/p>\n\n
\n\t
\n\t
透过风扇模组（后视图便签2）可以看到，主机内部main core位置会有黄灯闪烁<\/p>\n\t<\/li>\n\t
\n\t
Console（后视图标签12）接入串口（波特率为115200）会打印烧写信息<\/p>\n\t<\/li>\n\t
\n\t
接入Mini HDMI，会显示烧写信息<\/p>\n\t<\/li>\n<\/ul>\n\n
可以任选一种以下方法来确认是否烧写完成：<\/p>\n\n
\n\t
\n\t
透过风扇模组（后视图便签2）可以看到，主机内部main core位置会有黄灯停止闪烁，并常亮<\/p>\n\t<\/li>\n\t
\n\t
Console（后视图标签12）接入串口（波特率为115200）看到Please remove SD CARD!!!, wait for reboot.<\/span>提示信息后立即拔出SD卡。<\/p>\n\t<\/li>\n\t
\n\t
接入Mini HDMI，会显示烧写信息，看到Please remove SD CARD!!!, wait for reboot.<\/span>提示信息后立即拔出SD卡。<\/p>\n\t<\/li>\n<\/ul>\n\n
$\"\"$ <\/p>\n<\/div>\n\n
\n
2.3.2.2. (2.2). 通过另外一台服务器升级（需拆机不推荐使用）<\/span><\/h4>\n\n
拆除main core的核心板，将该核心板当做另外一台Cluster Server R2<\/strong>的子板，通过BMC软件升级相应的主板固件程序<\/p>\n\n
\n\t
\n\t
关闭主机电源<\/p>\n\t<\/li>\n\t
\n\t
按压了蓝色卡扣，拔出主核心板抽屉（后视图标签2风扇模组的正下方底部抽屉），取出main core的核心板<\/p>\n\t<\/li>\n\t
\n\t
将核心板放人另外一台Cluster Server R2的子板抽屉，进入BMC软件服务进行系统烧写<\/p>\n\t<\/li>\n\t
\n\t
升级完成后重新安装回主核心板抽屉（后视图标签2风扇模组的正下方底部抽屉）的main core位置，插入抽屉（注意要完全插入否则无法开机）<\/p>\n\t<\/li>\n\t
\n\t
接上电源，正常启动系统。<\/p>\n\t<\/li>\n<\/ol>\n<\/div>\n<\/div>\n\n
\n
2.3.3. (3). 子板ADB丢失处理方法<\/strong><\/h3>\n\n
子板ADB连接丢失一般有这3种情况：<\/p>\n\n
\n\t
\n\t
USB通信链路异常<\/p>\n\t<\/li>\n\t
\n\t
子板ADB服务异常<\/p>\n\t<\/li>\n\t
\n\t
子板系统崩溃<\/p>\n\t<\/li>\n<\/ul>\n\n
常规处理方法：<\/p>\n\n
\n\t
\n\t
复位子板所在USB HUB的电源，恢复无效则执行2操作（可能会造成更多子板ADB丢失，建议执行操作2）<\/span><\/p>\n\t<\/li>\n\t
\n\t
使用BMC管理系统来重置子板电源，恢复无效则执行3操作<\/p>\n\t<\/li>\n\t
\n\t
使用BMC管理系统给该子板重新安装系统<\/p>\n\t<\/li>\n<\/ol>\n<\/div>\n\n
\n
2.3.4. (4). openstf<\/strong><\/h3>\n\n
BMC固件已经安装了openstf，但是因为资源占用问题默认关闭openstf，如果想开启服务可以输入以下命令:<\/p>\n\n
\n
\n
\nsudo systemctl start openstf<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
注意：安卓10目前不支持openstf<\/p>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
3. 应用场景<\/strong><\/h1>\n\n
\n
3.1. 1. 云手机<\/strong><\/h2>\n\n
Firefly集群服务器的每一个核心板卡都可以独立运行一个Android系统。用户可以将自己的手机应用部署到每个核心板上。针对云手机应用场景，Firefly集群服务器增加了以下功能。<\/p>\n\n
\n
3.1.1. (1). 虚拟硬件设备<\/strong><\/h3>\n\n
包括虚拟摄像头、虚拟声卡等。专业技术支持和更详细资料请联系商务。<\/p>\n\n
\n\t
\n\t
虚拟摄像头<\/p>\n\t<\/li>\n<\/ul>\n\n
智能设备在没有安装摄像头或不能安装摄像头的情况下，会导致需要打开摄像头的应用无法使用；而Firefly的虚拟摄像头技术案例可在Firefly集群服务器上虚拟出多个摄像头，通过虚拟摄像头，用户可把准备好的视频文件/图片等加载进去，让这些虚拟摄像头输出这些图像信息。<\/p>\n\n
\n\t
\n\t
虚拟声卡<\/p>\n\t<\/li>\n<\/ul>\n\n
众所周知在没有声卡的设备上播放音频、视频文件，会出现“没有找到音频设备…”“由于声音，设备出现问题…”等等提示而不能播放。而Firefly的虚拟声卡技术案例可在Firefly集群服务器上虚拟出声卡，可以让没有声卡的设备播放音频文件，而不会因为提示没有设备而不能播放。<\/p>\n<\/div>\n\n
\n
3.1.2. (2). NFS，iSCSI网络存储<\/strong><\/h3>\n\n
Firefly 集群服务器上(包括android,linux系统)提供NFS，iSCSI网络存储方案，实现存储资源统一管理。专业技术支持和更详细资料请联系商务。<\/p>\n\n
\n\t
\n\t
NFS<\/p>\n\t<\/li>\n<\/ul>\n\n
NFS( Network File System，网络文件系统)，对于在同一个网络上的多个用户间共享目录和文件很有用途。通过使用NFS,用户和程序可以像访问本地文件一样访问远程系统上的文件。<\/p>\n\n
\n\t
\n\t
iSCSI<\/p>\n\t<\/li>\n<\/ul>\n\n
iSCSI( Internet Small Computer System Interface，Internet小型计算机系统接口)。iSCSI使用了TCP/IP协议(一般使用TCP端口860和3260)，透过两部计算机之间利用iSCSI的协议来交换SCSI命令，让计算机可以透过高速的局域网集线来把SAN(存储局域网)模拟成为本地的储存装置。可以使用它来连接服务器计算机 (例如，数据库服务器)和磁盘卷上存储阵列。较NFS其读写效率、稳定性更好。<\/p>\n<\/div>\n\n
\n
3.1.3. (3). 虚拟Android系统<\/strong><\/h3>\n\n
虚拟Android系统是指在一个Soc中，利用容器和虚拟设备技术，虚拟出多个Android系统，每个Android系统之间独立运行。对于用户而言，如果一个子核心板虚拟三个Android设备，那么一个集群服务器最多可以虚拟216个Android设备。虚拟Android系统在应用程序测试、社交媒体运营等邻域有着广泛的应用。<\/p>\n<\/div>\n<\/div>\n\n
\n
3.2. 2. 云计算<\/strong><\/h2>\n\n
Firefly集群服务器的子核心板有多种配置(参见)。其中RK3399采用双核A72 4核A53架构，集成MaliT860P4 GPU。而RK1126采用RK最新一代NPU架构，AI算力最高可达3T。所以使用Firefly集群服务器作为云计算平台，也是很合适的。针对云计算平台，Firefly集群服务器增强了以下功能支持。<\/p>\n\n
\n
3.2.1. (1). Ubuntu Minimal系统支持<\/strong><\/h3>\n\n
Ubuntu系统在工作环境搭建，部署，更新等环节都非常方便。Firefly集群服务器子核心板搭载的Ubuntu Minimal系统，具有以下优势：<\/p>\n\n
\n\t
\n\t
没有桌面环境，占用资源少，在简化网络管理之后，只需40M内存；<\/p>\n\t<\/li>\n\t
\n\t
针对嵌入式平台，精简系统服务。<\/p>\n\t<\/li>\n\t
\n\t
提供基于Rockchip VPU Mpp 的视频硬编解码支持。<\/p>\n\t<\/li>\n\t
\n\t
提供基于Arm Mali GPU的OpenGL、OpenCL支持。<\/p>\n\t<\/li>\n\t
\n\t
适配QT、Docker、Electron等开发框架。<\/p>\n\t<\/li>\n\t
\n\t
提供一系列接口，以操作板载资源设备。<\/p>\n\t<\/li>\n\t
\n\t
系统采用overlayfs文件系统，支持导出rootfs，二次打包，恢复出厂设置等功能<\/p>\n\t<\/li>\n<\/ul>\n<\/div>\n\n
\n
3.2.2. (2). 多路IPC解码 AI推理<\/strong><\/h3>\n\n
\u200b Firefly集群服务器，核心板搭配方案采用RK3399 RK1808 x N，实现了多路网络视频流解码与AI分析。该方案中，集群服务器连接多路网络摄像头进行视频数据采集，利用RK3399强大的视频解码功能对采集到的视频流解码后分发给AI加速芯片RK1808完成AI分析；然后再收集AI分析的结果，实时输出到用户端。<\/p>\n\n
详细介绍参见：多路视频解码与AI分析<\/a><\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n"},{"productId":15,"children":[{"productId":15,"children":[],"pid":78,"id":79,"sort":1,"title":"1.BMC二次开发","content":"
\n
\n
\n
1. BMC二次开发<\/strong><\/h1>\n\n\n
1.1. 监控数据获取<\/strong><\/h2>\n\n所有监控数据都存储到主板的 Prometheus<\/a> 数据库里，可以使用其命令工具 promtool 去获取监控数据。<\/p>\n\n
监控数据是透过 node_exporter<\/a> 去获取的。<\/p>\n\n
网页的仪表盘定义 json 文件存放在 /var/lib/grafana/dashboards/ 里。<\/p>\n\n
\n
1.1.1. 获取所有子板的即时在线状态<\/strong><\/h3>\n\n**
\n
\n
\n$ promtool query instant http://127.0.0.1:9090 node_cluster_up\nnode_cluster_up{instance="127.0.0.1:9100", job="node", nodename="main", state="android", subnode="sub1-01"} => 1 @[1608772515.659]\nnode_cluster_up{instance="127.0.0.1:9100", job="node", nodename="main", state="android", subnode="sub1-02"} => 1 @[1608772515.659]\nnode_cluster_up{instance="127.0.0.1:9100", job="node", nodename="main", state="android", subnode="sub1-03"} => 1 @[1608772515.659]\nnode_cluster_up{instance="127.0.0.1:9100", job="node", nodename="main", state="android", subnode="sub1-04"} => 1 @[1608772515.659]\n...<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
\n\t
\n\t
subnode: 子板编号<\/p>\n\t<\/li>\n\t
\n\t
state：子板状态<\/p>\n\n\t
\n\t\t
\n\t\t
android：子板运行的操作系统为 Android。<\/p>\n\t\t<\/li>\n\t\t
\n\t\t
linux：子板运行操作系统为 Linux。<\/p>\n\t\t<\/li>\n\t\t
\n\t\t
netrecovery：子板处于辅助升级系统 netrecovery 状态。<\/p>\n\t\t<\/li>\n\t\t
\n\t\t
offline：子板离线，无法通过 USB 连接检测到。<\/p>\n\t\t<\/li>\n\t\t
\n\t\t
online：子板能通过 USB 连接检测到，但无法解析进一步的状态。<\/p>\n\t\t<\/li>\n\t\t
\n\t\t
loader：子板处于 Loader 状态。<\/p>\n\t\t<\/li>\n\t\t
\n\t\t
fastboot：子板处于 Fastboot 状态。<\/p>\n\t\t<\/li>\n\t\t
\n\t\t
adb：子板被识别为 adb 设备，但暂未识别到其操作系统。<\/p>\n\t\t<\/li>\n\t\t
\n\t\t
adb_offline: 子板被识别为处于 offline 状态的 adb 设备，无法进行正常 adb 操作。<\/p>\n\t\t<\/li>\n\t\t
\n\t\t
android_recovery: 子板进入了 Android 的 recovery 系统。<\/p>\n\t\t<\/li>\n\t<\/ul>\n\t<\/li>\n\t
\n\t
metric:<\/p>\n\n\t
\n\t\t
\n\t\t
1.0: 子板处于 android 或 linux 状态。<\/p>\n\t\t<\/li>\n\t\t
\n\t\t
0.0: 子板处于 offline 状态。<\/p>\n\t\t<\/li>\n\t\t
\n\t\t
0.5: 子板处于上述状态之外。<\/p>\n\t\t<\/li>\n\t<\/ul>\n\t<\/li>\n<\/ul>\n<\/div>\n\n
\n
1.1.2. 获取主机温度<\/strong><\/h3>\n\n
\n
1.1.2.1. A. 获取主板温度(仅R2)<\/strong><\/h4>\n\n
通过读取底板上的热敏电阻来获取其温度(单位：摄氏度)：<\/p>\n\n
\n
\n
\n$ promtool query instant http://127.0.0.1:9090 'node_hwmon_temp_celsius{chip=~"platform_ntc."}'\nnode_hwmon_temp_celsius{chip="platform_ntc", instance="127.0.0.1:60101", job="node", nodename="sub1-01", sensor="temp1"} => 34.779 @[1608773513.849]\nnode_hwmon_temp_celsius{chip="platform_ntc", instance="127.0.0.1:60102", job="node", nodename="sub1-02", sensor="temp1"} => 42.81 @[1608773513.849]\nnode_hwmon_temp_celsius{chip="platform_ntc", instance="127.0.0.1:60103", job="node", nodename="sub1-03", sensor="temp1"} => 43.305 @[1608773513.849]\n...<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
1.1.2.2. B. 获取主机内环境温度(仅R2)<\/strong><\/h4>\n\n
通过读取主机内的 ds18b20 温度传感器的数据来获取主机内的环境温度(单位：摄氏度)：<\/p>\n\n
\n
\n
\n$ promtool query instant http://127.0.0.1:9090 'node_cluster_env_temp_celsius'<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
1.1.3. 获取风扇的转速(仅R2)<\/strong><\/h3>\n\n
单位：RPM (转/分钟)<\/p>\n\n
\n
\n
\n$ promtool query instant http://127.0.0.1:9090 node_cluster_fan_speed\nnode_cluster_fan_speed{fan="fan1", instance="127.0.0.1:9100", job="node", nodename="main"} => 7812 @[1607501007.839]\nnode_cluster_fan_speed{fan="fan2", instance="127.0.0.1:9100", job="node", nodename="main"} => 7936 @[1607501007.839]\n...<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
\n\t
\n\t
R2v2 有 10 块能监控转速的风扇。<\/p>\n\t<\/li>\n<\/ul>\n<\/div>\n\n
\n
1.1.4. 获取接入硬盘状态<\/strong><\/h3>\n\n
获取硬盘设备名称和型号：<\/p>\n\n
\n
\n
\n$ promtool query instant http://127.0.0.1:9090 node_cluster_disk_up\nnode_cluster_disk_up{device="sda", instance="127.0.0.1:9100", job="node", model="ST1000DM010-2EP1", nodename="main"} => 1 @[1609228221.442]<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
获取硬盘总容量（单位：字节）：<\/p>\n\n
\n
\n
\n$ promtool query instant http://127.0.0.1:9090 node_cluster_disk_bytes_total\nnode_cluster_disk_bytes_total{device="sda", instance="127.0.0.1:9100", job="node", nodename="main"} => 1000204886016 @[1609228289.651]<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
获取硬盘已使用空间（单位：字节）：<\/p>\n\n
\n
\n
\n$ promtool query instant http://127.0.0.1:9090 node_cluster_disk_bytes__used\nnode_cluster_disk_bytes_used{device="sda", instance="127.0.0.1:9100", job="node", nodename="main"} => 121475072 @[1609228366.843]<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
1.1.5. 获取所有设备的 IP 地址<\/strong><\/h3>\n\n
\n
\n
\n$ promtool query instant http://127.0.0.1:9090 node_network_ipaddr\nnode_network_ipaddr{device="eth0", instance="127.0.0.1:60101", ipaddr="168.168.101.198", job="node", nodename="sub1-01"} => 1 @[1609396443.993]\nnode_network_ipaddr{device="eth0", instance="127.0.0.1:60102", ipaddr="168.168.100.180", job="node", nodename="sub1-02"} => 1 @[1609396443.993]\nnode_network_ipaddr{device="eth0", instance="127.0.0.1:60103", ipaddr="168.168.101.145", job="node", nodename="sub1-03"} => 1 @[1609396443.993]\n...<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
\n\t
\n\t
device: 网络接口名称，各个子板仅有一个以太网接口 eth0, 主板有多个。每个网络接口对应一个 IP 地址。<\/p>\n\t<\/li>\n\t
\n\t
ipaddr：IP 地址，如果尚没有取得 IP 地址，则为 “0.0.0.0”。<\/p>\n\t<\/li>\n\t
\n\t
nodename：子板 sub 编号，或主板 main。<\/p>\n\t<\/li>\n<\/ul>\n<\/div>\n<\/div>\n\n
\n
1.2. 硬件控制<\/strong><\/h2>\n\n
\n
1.2.1. 重置子板电源<\/strong><\/h3>\n\n
\n\t
\n\t
功能: 重置子板电源<\/p>\n\t<\/li>\n\t
\n\t
描述: 通过操控子板的 RESET 脚来重置子板电源，达到强制重启子板的目的。如果子板没有 RESET 脚，则通过关闭、打开电源来实现。<\/p>\n\t<\/li>\n\t
\n\t
调用:<\/p>\n\n\t
\n\t\t
\n\t\t
命令行可运行： /usr/bin/bmc <子板SUB编号> reset<\/p>\n\t\t<\/li>\n\t\t
\n\t\t
Web API：GET http://localhost:7070/api/reset/<子板SUB编号><\/span><\/p>\n\t\t<\/li>\n\t<\/ul>\n\t<\/li>\n<\/ul>\n<\/div>\n\n
\n
1.2.2. 重启子板操作系统<\/strong><\/h3>\n\n
\n\t
\n\t
功能: 重启子板操作系统<\/p>\n\t<\/li>\n\t
\n\t
描述: 首先通过 adb reboot 命令来重启系统，如果 10 秒内没有反应，则通过复位电源的方式强行重启子板。<\/p>\n\t<\/li>\n\t
\n\t
调用:<\/p>\n\n\t
\n\t\t
\n\t\t
命令行可运行： /usr/bin/bmc <子板SUB编号> reboot<\/p>\n\t\t<\/li>\n\t\t
\n\t\t
Web API：GET http://localhost:7070/api/reboot/<子板SUB编号><\/span><\/p>\n\t\t<\/li>\n\t<\/ul>\n\t<\/li>\n<\/ul>\n<\/div>\n\n
\n
1.2.3. 打开子板电源(仅R2)<\/strong><\/h3>\n\n
\n\t
\n\t
功能：打开子板电源<\/p>\n\t<\/li>\n\t
\n\t
描述：通过操控子板的 POWER 脚来打开子板电源。集群服务器开机默认打开所有子板电源。<\/p>\n\t<\/li>\n\t
\n\t
调用:<\/p>\n\n\t
\n\t\t
\n\t\t
命令行可运行： /usr/bin/bmc <子板SUB编号> poweron<\/p>\n\t\t<\/li>\n\t\t
\n\t\t
Web API：GET http://localhost:7070/api/poweron/<子板SUB编号><\/span><\/p>\n\t\t<\/li>\n\t<\/ul>\n\t<\/li>\n<\/ul>\n<\/div>\n\n
\n
1.2.4. 关闭子板电源(仅R2)<\/strong><\/h3>\n\n
\n\t
\n\t
功能：关闭子板电源<\/p>\n\t<\/li>\n\t
\n\t
描述：通过操控子板的 POWER 脚来关闭子板电源。<\/p>\n\t<\/li>\n\t
\n\t
调用:<\/p>\n\n\t
\n\t\t
\n\t\t
命令行可运行： /usr/bin/bmc <子板SUB编号> poweroff<\/p>\n\t\t<\/li>\n\t\t
\n\t\t
Web API：GET http://localhost:7070/api/poweroff/<子板SUB编号><\/span><\/p>\n\t\t<\/li>\n\t<\/ul>\n\t<\/li>\n<\/ul>\n<\/div>\n<\/div>\n\n
\n
1.3. 固件升级<\/strong><\/h2>\n\n
使用脚本添加固件升级任务：<\/p>\n\n
\n
\n
\nsudo netrecovery-master queue <固件文件绝对路径> <子板SUB编号> [<子板SUB编号> ...]<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
例如：<\/p>\n\n
\n
\n
\nsudo netrecovery-master queue /home/firefly/Firmware/xxx.img sub1-01 sub1-02<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
查看固件升级进度：<\/p>\n\n
\n
\n
\n$ promtool query instant http://127.0.0.1:9090 node_cluster_firmware_upgrade_stat\nnode_cluster_firmware_upgrade_stat{firmware="SR-C11G-3399JD4_Android10_HDMI_201202.img", instance="127.0.0.1:9100", job="node", node="sub02", nodename="main", state="done"} => 100 @[1608795873.055]\nnode_cluster_firmware_upgrade_stat{firmware="SR-C11G-3399JD4_Android10_HDMI_201202.img", instance="127.0.0.1:9100", job="node", node="sub03", nodename="main", state="done"} => 100 @[1608795873.055]<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
\n\t
\n\t
node: 升级固件的子板编号。<\/p>\n\t<\/li>\n\t
\n\t
state: preparing: 正在准备；flashing: 正在烧写；done: 已完成；error：出错。<\/p>\n\t<\/li>\n\t
\n\t
metric: 烧写进度百分比，例如 100 表示已全部完成(100%)。<\/p>\n\t<\/li>\n<\/ol>\n\n
注意：有可能出现同一块子板有两种不同的 state，这时如果存在 state=”flashing” 则表示子板尚在烧写中，因此更稳妥的办法是，先查 flashing 进度，如果有则在升级中，如果没有则再查是完成还是出错：<\/p>\n\n
\n
\n
\n$ promtool query instant http://127.0.0.1:9090 'node_cluster_firmware_upgrade_stat{node="sub02",state="flashing"}'\n$ promtool query instant http://127.0.0.1:9090 'node_cluster_firmware_upgrade_stat{node="sub02",state=~"done|error"}'\nnode_cluster_firmware_upgrade_stat{firmware="SR-C11G-3399JD4_Android10_HDMI_201202.img", instance="127.0.0.1:9100", job="node", node="sub02", nodename="main", state="done"} => 100 @[1608796078.37]<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
1.4. 子板上传下载文件，运行命令<\/strong><\/h2>\n\n
以下命令使用 bmc_adb，此脚本是对 adb 命令的包装，使用户可以方便地使用子板编号去操作对应子板，而不用理会实际的子板 adb 序列号。当然，adb 命令也可以使用。<\/p>\n\n
\n
1.4.1. 从主板上传文件到子板<\/strong><\/h3>\n\n
在主板上运行：<\/p>\n\n
\n
\n
\n$ bmc_adb -s sub01 push home.json /data/local/tmp<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
1.4.2. 从子板下载文件到主板<\/strong><\/h3>\n\n
在主板上运行：<\/p>\n\n
\n
\n
\n$ bmc_adb -s sub01 pull home.json /data/local/tmp<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
1.4.3. 在子板运行特定命令<\/strong><\/h3>\n\n
在主板上运行：<\/p>\n\n
\n
\n
\n$ bmc_adb -s sub01 shell ifconfig<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
1.5. bmc 命令行工具<\/strong><\/h2>\n\n
bmc 命令行工具必须在主板(即结点名称为 main 的设备)的 Shell 终端窗口下运行，当然，远程通过 ssh 连接到主板也可使用。<\/p>\n\n
获取命令帮助：<\/p>\n\n
\n
\n
\n$ bmc --help\nUsage:\n\n bmc list [--offline] []\n List all the active nodes usable with adb, optionally matched by pattern\n\n bmc serials\n List all the active nodes with coresponding adb serial.\n\n bmc {reset|poweron|poweroff}\n Invoke reset, poweron or power off on \n\n bmc state\n Show node state\n\n bmc shell [...]\n Invoke shell with command.\n\n bmc forall %{node}<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
\n
1.5.1. 显示 adb 设备列表<\/strong><\/h3>\n\n
列出所有在线（adb 成功连接）设备：<\/p>\n\n
\n
\n
\n$ bmc list\nsub03\nsub04\nsub05\nsub06\nsub07\nsub08\nsub09\nsub10<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
列出所有 adb 状态为 offline 的设备：<\/p>\n\n
\n
\n
\n$ bmc list --offline<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
1.5.2. 列出子板编号和 adb 序列号的对应关系<\/strong><\/h3>\n\n
\n
\n
\n$ bmc serials\nsub02 B09CCSUB02 usb:2-1.2.3\nsub03 A8232SUB03 usb:2-1.2.4\nsub06 4DE1ESUB06 usb:2-1.2.7\nsub07 505C3SUB07 usb:2-1.1.2\nsub08 FFBCCSUB08 usb:2-1.4\nsub09 710AFSUB09 usb:2-1.1.1<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
1.5.3. 重置子板的电源<\/strong><\/h3>\n\n
\n
\n
\n$ bmc sub03 reset\n okay<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
1.5.4. 打开、关闭子板电源（仅R2)<\/strong><\/h3>\n\n
关闭子板电源：<\/p>\n\n
\n
\n
\n$ bmc sub1-01 poweroff\n okay<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
打开子板电源：<\/p>\n\n
\n
\n
\n$ bmc sub1-01 poweron\n okay<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
1.5.5. 查看子板状态<\/strong><\/h3>\n\n
查看子板的明细状态：<\/p>\n\n
\n
\n
\n# 单个子板\n$ bmc sub1-01 state\nandroid\n\n# 所有子板\n$ bmc state\nmain: linux\nsub1-01: android\nsub1-02: android\n...<\/span>\n\n# 所有状态为 offline 的子板\n$ bmc state | grep offline\nsub7-01: offline\nsub7-02: offline\nsub7-03: offline\n...<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
列出 sub3-01 的 adb 状态和 ifconfig 结果：<\/p>\n\n
\n
\n
\n$ bmc sub3-01\nnode: sub3-01\nstate: android\nadb_state: device\nifconfig:\neth0 Link encap:Ethernet HWaddr ae:bb:8b:e7:b4:38 Driver rk_gmac-dwmac\n inet addr:168.168.100.171 Bcast:168.168.255.255 Mask:255.255.0.0\n inet6 addr: fe80::7298:5297:6ab9:7fd0/64 Scope: Link\n UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1\n RX packets:66181 errors:0 dropped:0 overruns:0 frame:0\n TX packets:190 errors:0 dropped:0 overruns:0 carrier:0\n collisions:0 txqueuelen:1000\n RX bytes:4414382 TX bytes:22295\n Interrupt:27\n\nlo Link encap:Local Loopback\n inet addr:127.0.0.1 Mask:255.0.0.0\n inet6 addr: ::1/128 Scope: Host\n UP LOOPBACK RUNNING MTU:65536 Metric:1\n RX packets:715 errors:0 dropped:0 overruns:0 frame:0\n TX packets:715 errors:0 dropped:0 overruns:0 carrier:0\n collisions:0 txqueuelen:1000\n RX bytes:885911 TX bytes:885911<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
1.5.6. 进入子板 shell 或在子板执行命令<\/strong><\/h3>\n\n
进入 sub03 的 adb shell：<\/p>\n\n
\n
\n
\n$ bmc sub03 shell\nrk3399_firefly_sr_c11g_jd4:/ $<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
在 sub03 上运行命令：<\/p>\n\n
\n
\n
\n$ bmc sub03 shell id\nuid=2000(shell) gid=2000(shell) groups=2000(shell),1004(input),1007(log),1011(adb),1015(sdcard_rw),1028(sdcard_r),3001(net_bt_admin),3002(net_bt),3003(inet),3006(net_bw_stats),3009(readproc) context=u:r:shell:s0<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
1.5.7. 批量执行命令<\/strong><\/h3>\n\n
bmc<\/span> 提供了可以批量执行命令的快捷方式 bmc forall<\/span>，此命令从标准输入读入子板编号，替换命令行上的 %{node} <\/span>参数再执行命令。例如：<\/p>\n\n
批量获取子板 adb 状态，%{node}<\/span> 会被替换为实际的设备结点：<\/p>\n\n
\n
\n
\n$ echo sub03 sub04 | bmc forall adb -s %{node} get-state\n>>> adb -s sub03 get-state\ndevice\n>>> adb -s sub04 get-state\ndevice<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
为了简化操作，bmc forall <\/span>对 reset<\/span>, poweron<\/span> 和 poweroff<\/span> 命令提供了快捷支持。<\/p>\n\n
批量重置子板电源：<\/p>\n\n
\n
\n
\n$ echo sub03 sub04 | bmc forall reset\n>>> bmc sub03 reset\n okay\n>>> bmc sub04 reset\n okay\n\n# 等价于\n$ echo sub03 sub04 | bmc forall bmc %{node} reset<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
另外，bmc forall<\/span> 也对 shell<\/span> 命令还提供了简化。<\/p>\n\n
例如，批量获取子板 Android 序列号：<\/p>\n\n
\n
\n
\n$ echo sub03 sub04 | bmc forall shell getprop ro.serialno\n>>> bmc sub03 shell getprop ro.serialno\nA82328MDDT\n>>> bmc sub04 shell getprop ro.serialno\n2E8178MDDT\n\n# 等价于\n$ echo sub03 sub04 | bmc forall bmc %{node} shell getprop ro.serialno<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
1.5.8. 查询监控数据<\/strong><\/h3>\n\n
promtool<\/span> 是 Prometheus<\/span> 提供的命令行工具，可用于查询数据库等功能。<\/p>\n\n
bmc query<\/span> 是 promtool <\/span>的快捷查询方式，不加参数默认返回 node_cluster_up<\/span> 的值：<\/p>\n\n
\n
\n
\n$ bmc query\nnode_cluster_up{instance="127.0.0.1:9100", job="node", nodename="main", state="android", subnode="sub1-01"} => 1 @[1609227870.112]\n...<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
也可以直接指定需要查询的参数，参数请参阅 node_exporter <\/span>文档和 BMC 的 API 说明。<\/p>\n\n
以下是插入硬盘后查询其状态：<\/p>\n\n
\n
\n
\n$ bmc query node_cluster_disk_up\nnode_cluster_disk_up{device="sda", instance="127.0.0.1:9100", job="node", model="ST1000DM010-2EP1", nodename="main"} => 1 @[1609228042.393]<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
1.5.9. 写入序列号，以太网 MAC 地址等(v1.3 新增)<\/strong><\/h3>\n\n
命令格式：<\/p>\n\n
\n
\n
\nbmc {main|sub??} vendor []<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
\n\t
\n\t
<\/span>:<\/p>\n\n\t
\n\t\t
\n\t\t
sn: 对应 VENDOR_SN_ID，用来修改 Android 系统的 ro.serialno 属性。<\/p>\n\t\t<\/li>\n\t\t
\n\t\t
lan: 对应 VENDOR_LAN_MAC_ID, eth0 网卡的 MAC 地址，设置后重启生效。<\/p>\n\t\t<\/li>\n\t\t
\n\t\t
更多类型请在主控板运行：/usr/share/bmc/vendor_storage_linux -h<\/span>。<\/p>\n\t\t<\/li>\n\t<\/ul>\n\t<\/li>\n\t
\n\t
<\/span>: 该参数可选，若提供则写入，否则是读取。<\/p>\n\t<\/li>\n<\/ul>\n\n
例如，要对 sub8-09<\/span> 写入 MAC 地址 ae:0e:fb:84:0f:c2<\/span>:<\/p>\n\n
\n
\n
\n# 写入\n$ bmc sub8-09 vendor lan ae0efb840fc2\n\n# 读取\n$ bmc sub8-09 vendor lan<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
该命令实际是对 /usr/share/bmc/vendor_storage_linux <\/span>（Linux 系统) 和 /usr/share/bmc/vendor_storage_android<\/span> （Android 系统) 的包装，更高级的用法可以直接调用原始命令。<\/p>\n<\/div>\n\n
\n
1.5.10. 列出主子板的软硬件版本号(v1.3 新增)<\/strong><\/h3>\n\n
列出主板和所有子板的软硬件版本号：<\/p>\n\n
\n
\n
\n$ bmc versions\nmain linux OS:Ubuntu18.04.4 HW:v1.0\nsub1-01 android OS:CLUSTER-SERVER-R2_20210118 HW:v1.0\nsub1-02 android OS:CLUSTER-SERVER-R2_20210118 HW:v1.0\nsub1-03 android OS:CLUSTER-SERVER-R2_20210118 HW:v1.0\n...<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n"},{"productId":15,"children":[],"pid":78,"id":80,"sort":2,"title":"2.系统开发","content":"
\n
\n
\n
\n
\n
\n
2. 系统开发<\/strong><\/h1>\n\n
\n
2.1. 1. Android SDK<\/strong><\/h2>\n\n
\n
2.1.1. (1). 编译环境搭建<\/strong><\/h3>\n\n
\n
2.1.1.1. A. 准备工作<\/strong><\/h4>\n\n
编译 Android 对机器的配置要求较高：<\/p>\n\n
\n\t
\n\t
64 位 CPU<\/p>\n\t<\/li>\n\t
\n\t
16GB 物理内存交换内存<\/p>\n\t<\/li>\n\t
\n\t
250GB 空闲的磁盘空间<\/p>\n\t<\/li>\n<\/ul>\n\n
建议使用 Ubuntu 18.04 操作系统或更高版本<\/p>\n\n
\n\t
\n\t
Ubuntu 16.04 或 18.04 软件包安装参考：<\/p>\n\t<\/li>\n<\/ul>\n\n
\n
\n
\nsudo apt-get update\n\nsudo apt-get install git gnupg flex bison gperf libsdl1.2-dev \nlibesd-java libwxgtk3.0-dev squashfs-tools build-essential zip curl \nlibncurses5-dev zlib1g-dev pngcrush schedtool libxml2 libxml2-utils \nxsltproc lzop libc6-dev schedtool g -multilib lib32z1-dev lib32ncurses5-dev \nlib32readline-dev gcc-multilib libswitch-perl libssl-dev unzip zip device-tree-compiler \nliblz4-tool python-pyelftools python3-pyelftools -y<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
2.1.1.2. B. 编译FAQ<\/strong><\/h4>\n\n
由于每个人的PC系统版本和环境配置不一样，安装软件包后编译并不一定都会成功，可能会出现缺少某些软件包而引起的错误，如：<\/p>\n\n
\n
2.1.1.2.1. Q1<\/strong><\/h5>\n\n
\n
\n
\n OBJCOPY spl/u-boot-spl-nodtb.bin\n CAT spl/u-boot-spl-dtb.bin\n COPY spl/u-boot-spl.bin\n CFGCHK u-boot.cfg\nERROR: No 'dtc', please: apt-get install device-tree-compiler<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
此时视报错信息去安装缺少的软件包（dtc）即可<\/p>\n<\/div>\n\n
\n
2.1.1.2.2. Q2<\/strong><\/h5>\n\n
如果Kernel编译报lz4<\/span>的错误:<\/p>\n\n
\n
\n
\nLZ4C arch/arm64/boot/Image.lz4\nIncorrect parameters\nUsage :\n lz4 [arg] [input] [output]\n\ninput : a filename\n with no FILE, or when FILE is - or stdin, read standard input\nArguments :\n -1 : Fast compression (default)\n -9 : High compression\n -d : decompression (default for .lz4 extension)\n -z : force compression\n -f : overwrite output without prompting\n -h/-H : display help/long help and exit\narch/arm64/boot/Makefile:31: recipe for target 'arch/arm64/boot/Image.lz4' failed<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
可以先编译Android下面的lz4<\/span>并替换系统的lz4<\/span><\/p>\n\n
\n
\n
\nmmm external/lz4/\nsudo cp /usr/bin/lz4 /usr/bin/lz4.org # 备份\nsudo cp out/host/linux-x86/bin/lz4 /usr/bin/lz4 # 替换系统原有lz4<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
如果编译出现这种情况:<\/p>\n\n
\n
\n
\nerror: external/crosvm/rutabaga_gfx/Android.bp:91:1: "rutabaga_gfx_host_test_src_lib" depends on undefined module "libgfxstream_backend"\nerror: external/crosvm/rutabaga_gfx/Android.bp:13:1: "librutabaga_gfx" depends on undefined module "libgfxstream_backend"<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
那是因为需要先编译一次 Android 上层才可以,或者也可以直接从以下链接下载<\/a> lz4 到系统中，直接进行替换。<\/p>\n\n
\n
\n
\nsudo cp /usr/bin/lz4 /usr/bin/lz4.org # 备份\nsudo cp lz4 /usr/bin/lz4<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
2.1.2. (2). Android10.0 SDK<\/strong><\/h3>\n\n\n
2.1.2.1. A. 下载 Android10.0 SDK<\/strong><\/h4>\n\n
核心板 Core-3399-JD4 支持 Android10.0<\/span><\/p>\n\n
由于 SDK 较大，可以去下载页面选择云盘下载 Firefly-RK3399_Android10.0_git_20210114.7z：<\/p>\n\n
下载链接<\/a><\/p>\n\n
下载完成后，在解压前先校验下 MD5 码：<\/p>\n\n
\n
\n
\n$ md5sum /path/to/Firefly-RK3399_Android10.0_git_20210114.7z.001\n$ md5sum /path/to/Firefly-RK3399_Android10.0_git_20210114.7z.002\n10bf3ca46fa629f1965c5c9c8608db7e Firefly-RK3399_Android10.0_git_20210114.7z.001\nbd4c36fe268420bf6efe1a2617ab6b8b Firefly-RK3399_Android10.0_git_20210114.7z.002<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
然后解压：<\/p>\n\n
\n
\n
\ncd ~/proj/\n7z x ./Firefly-RK3399_Android10.0_git_20210114.7z.001 -ork3399_Android10.0cd ./rk3399_Android10.0\ngit reset --hard<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
注意：解压后务必要先更新下远程仓库。以下为从 gitlab 处更新的方法：<\/p>\n\n
\n
\n
\n#1. 进入SDK根目录\ncd ~/proj/rk3399_Android10.0\n\n#2. 下载远程bundle仓库\ngit clone https://gitlab.com/TeeFirefly/rk3399-android10.0-bundle.git .bundle\n\n#3. 若下载仓库失败，目前bundle仓库占用空间较大，所以同步的时候可能会出现卡住或失败的问题，\n# 可以从下方百度云链接下载并解压到SDK根目录，解压指令如下：\n7z x rk3399-android10.0-bundle.7z -r -o. && mv rk3399-android10.0-bundle/ .bundle/\n\n#4. 更新SDK，并且后续更新不需要再次拉取远程仓库，直接执行以下命令即可\n.bundle/update\n\n#5. 按照提示已经更新内容到 FETCH_HEAD,同步FETCH_HEAD到firefly分支\n\ngit rebase FETCH_HEAD<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
2.1.2.2. B. 编译方法<\/strong><\/h4>\n\n
\n
2.1.2.2.1. a. R2编译方法<\/strong><\/h5>\n\n
\n
2.1.2.2.1.1. 脚本自动编译<\/strong><\/h6>\n\n
\n
\n
\n./FFTools/make.sh -d rk3399-firefly-cs-r2 -j8 -l rk3399_firefly_cs_r2-userdebug\n./FFTools/mkupdate/mkupdate.sh -l rk3399_firefly_cs_r2-userdebug<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
2.1.2.2.1.2. 手动编译<\/strong><\/h6>\n\n
编译前执行如下命令配置环境变量：<\/p>\n\n
\n
\n
\nexport JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64\nexport PATH=$JAVA_HOME/bin:$PATH\nexport CLASSPATH=.:$JAVA_HOME/lib:$JAVA_HOME/lib/tools.jar<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
\n\t
\n\t
编译 kernel：<\/p>\n\t<\/li>\n<\/ul>\n\n
\n
\n
\ncd ~/proj/rk3399_Android10.0/kernel/\nmake ARCH=arm64 firefly_defconfig android-10.config rk3399.config\nmake ARCH=arm64 BOOT_IMG=../rockdev/Image-rk3399_firefly_cs_r2/boot.img rk3399-firefly-cs-r2.img -j8<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
注意：若进行内核debug，需要将resource.img和kernel.img打包进去boot.img后对boot分区进行烧写才能生效。<\/p>\n\n
\n\t
\n\t
编译 uboot：<\/p>\n\t<\/li>\n<\/ul>\n\n
\n
\n
\ncd ~/proj/rk3399_Android10.0/u-boot/\n./make.sh rk3399<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
\n\t
\n\t
编译 Android：<\/p>\n\t<\/li>\n<\/ul>\n\n
\n
\n
\ncd ~/proj/rk3399_Android10.0/\nsource FFTools/build.sh\nlunch rk3399_firefly_cs_r2-userdebug\nmake -j8\n./mkimage.sh<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
打包成统一固件 update.img<\/strong><\/p>\n\n
编译完可以用Firefly官方的脚本打包成统一固件，执行如下命令：<\/p>\n\n
\n
\n
\ncd ~/proj/rk3399_Android10.0/\n./FFTools/mkupdate/mkupdate.sh -l rk3399_firefly_cs_r2-userdebug<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
打包完成后将在rockdev/Image-rk3399_firefly_cs_r2/ 目录下生成统一固件： product名XXX_XXX_日期XXX.img 在 Windows 下打包统一固件 update.img 也很简单，将编译生成的文件拷贝到 AndroidTool 的 rockdevImage 目录中，然后运行 rockdev 目录下的 mkupdate.bat 批处理文件即可创建 update.img 并存放到 rockdevImage 目录里。<\/p>\n<\/div>\n<\/div>\n\n
\n
2.1.2.2.2. b. 分区镜像<\/strong><\/h5>\n\n
\n\t
\n\t
boot.img 包含ramdis、kernel、dtb<\/p>\n\t<\/li>\n\t
\n\t
dtbo.img Device Tree Overlays<\/p>\n\t<\/li>\n\t
\n\t
kernel.img includekernel，目前无法单独烧写，需要打包到boot.img内烧写<\/p>\n\t<\/li>\n\t
\n\t
MiniLoaderAll.bin 包含一级loader<\/p>\n\t<\/li>\n\t
\n\t
misc.img 包含recovery-wipe开机标识信息，烧写后会进行recovery<\/p>\n\t<\/li>\n\t
\n\t
odm.img 包含android odm，包含在super.img分区内,单独烧写需要用fastboot烧写<\/p>\n\t<\/li>\n\t
\n\t
parameter.txt 包含分区信息<\/p>\n\t<\/li>\n\t
\n\t
pcba_small_misc.img 包含pcba开机标识信息，烧写后会进入简易版pcba模式<\/p>\n\t<\/li>\n\t
\n\t
pcba_whole_misc.img 包含pcba开机标识信息，烧写后会进入完整版pcba模式<\/p>\n\t<\/li>\n\t
\n\t
recovery.img 包含recovery-ramdis、kernel、dtb<\/p>\n\t<\/li>\n\t
\n\t
resource.img 包含dtb，kernel和uboot阶段的log及uboot充电logo，目前无法单独烧写，需要打包到boot.img内烧写<\/p>\n\t<\/li>\n\t
\n\t
super.img 包含odm、vendor、system分区内容<\/p>\n\t<\/li>\n\t
\n\t
system.img 包含android system，包含在super.img分区内,单独烧写需要同fastboot烧写<\/p>\n\t<\/li>\n\t
\n\t
trust.img 包含BL31、BL32<\/p>\n\t<\/li>\n\t
\n\t
uboot.img 包含uboot固件<\/p>\n\t<\/li>\n\t
\n\t
vbmeta.img 包含avb校验信息，用于AVB校验<\/p>\n\t<\/li>\n\t
\n\t
vendor.img 包含android vendor，包含在super.img分区内,单独烧写需要同fastboot烧写<\/p>\n\t<\/li>\n\t
\n\t
update.img 包含以上需要烧写的img文件，可以用于工具直接烧写整个固件包<\/p>\n\t<\/li>\n<\/ul>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
2.1.3. (3). Android12.0 SDK<\/strong><\/h3>\n\n
\n
2.1.3.1. A. 下载 Android12.0 SDK<\/strong><\/h4>\n\n
核心板 Core-3588SJD4 支持 Android12.0<\/span><\/p>\n\n
\n\t
\n\t
SDK 源码与 bundle 压缩包均存放在云盘中。SDK通过邮件的方式获取，把订单号发送到sales@t-firefly.com<\/span>邮箱并注明需要的SDK名称firefly_rk3588_android12.0_git_20220311<\/p>\n\t<\/li>\n\t
\n\t
下载完成后，在解压前先校验下 MD5 码：<\/p>\n\t<\/li>\n<\/ul>\n\n
\n
\n
\n$ md5sum /path/to/firefly_rk3588_android12.0_git_20220311.7z.001\n$ md5sum /path/to/firefly_rk3588_android12.0_git_20220311.7z.002\n$ md5sum /path/to/firefly_rk3588_android12.0_git_20220311.7z.003\n$ md5sum /path/to/firefly_rk3588_android12.0_git_20220311.7z.004\n$ md5sum /path/to/firefly_rk3588_android12.0_git_20220311.7z.005\n$ md5sum /path/to/firefly_rk3588_android12.0_git_20220311.7z.006\n\n8f48ca82f247426d0a7111b851d65f0f firefly_rk3588_android12.0_git_20220311.7z.001\ne99d68485860b86c2ec5b67aeda7249d firefly_rk3588_android12.0_git_20220311.7z.002\ncb45fc9e39848b459398467c08acd6f1 firefly_rk3588_android12.0_git_20220311.7z.003\n7774a64cc73dbf4381c100ad1d703fa9 firefly_rk3588_android12.0_git_20220311.7z.004\ncd53c8c752a5162a0638da1cf9a0ed8f firefly_rk3588_android12.0_git_20220311.7z.005\nfd7744c8098791a8f1dd62527fcac32c firefly_rk3588_android12.0_git_20220311.7z.006<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
\n\t
\n\t
然后解压<\/p>\n\t<\/li>\n<\/ul>\n\n
\n
\n
\ncd ~/proj/\n7z x ./firefly_rk3588_android12.0_git_20220311.7z.001 -oRK3588_Android12.0\ncd ./RK3588_Android12.0\ngit reset --hard<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
注意：不要在共享文件夹、挂载文件夹以及非英文目录解压SDK，避免产生不必要的错误<\/span><\/p>\n\n
\n\t
\n\t
下载 SDK 后，从 gitlab 处更新代码的方法：<\/p>\n\t<\/li>\n<\/ul>\n\n
\n
\n
\n#1. 进入 SDK 根目录\ncd ~/proj/RK3588_Android12.0\n\n#2. 下载远程 bundle 仓库\ngit clone https://gitlab.com/T-Firefly/rk3588-android12.0-bundle.git .bundle\n\n#3. bundle仓库会随着更新的资源越多而会越来越大，如果bundle仓库下载速度缓慢或若下载失败，\n# 请在资源下载界面选择对应的机器bundle文件进行下载并解压到SDK根目录，解压指令如下:\n\n7z x rk3588-android12.0-bundle.7z -r -o. && mv rk3588-android12.0-bundle .bundle\n\n#4. 更新 SDK，并且后续更新不需要再次拉取远程仓库，直接执行以下命令即可\n.bundle/update\n\n#5. 按照提示已经更新内容到 FETCH_HEAD,同步 FETCH_HEAD 到 firefly 分支\ngit rebase FETCH_HEAD<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
2.1.3.2. B. 编译方法<\/strong><\/h4>\n\n
\n
2.1.3.2.1. a. R2编译方法<\/strong><\/h5>\n\n
\n
2.1.3.2.1.1. 脚本自动编译<\/strong><\/h6>\n\n
\n
\n
\n./FFTools/make.sh -d rk3588s-firefly-cs-r2 -j8 -l rk3588s_firefly_cs_r2-userdebug\n./FFTools/mkupdate/mkupdate.sh -l rk3588s_firefly_cs_r2-userdebug<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
2.1.3.2.1.2. 手动编译<\/strong><\/h6>\n\n
\n\t
\n\t
编译 kernel：<\/p>\n\t<\/li>\n<\/ul>\n\n
\n
\n
\ncd ~/path/to/sdk/kernel-5.10\nexport PATH=../prebuilts/clang/host/linux-x86/clang-r416183b/bin:$PATH\nalias msk='make CROSS_COMPILE=aarch64-linux-gnu- LLVM=1 LLVM_IAS=1'\nmsk ARCH=arm64 firefly_defconfig android-11.config pcie_wifi.config\nmsk ARCH=arm64 BOOT_IMG=../rockdev/Image-rk3588s_firefly_cs_r2/boot.img rk3588s-firefly-cs-r2.img -j8<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
\n\t
\n\t
编译 uboot：<\/p>\n\t<\/li>\n<\/ul>\n\n
\n
\n
\ncd ~/path/to/sdk/u-boot/\n./make.sh rk3588<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
\n\t
\n\t
编译 Android：<\/p>\n\t<\/li>\n<\/ul>\n\n
\n
\n
\ncd ~/path/to/sdk/\nsource build/envsetup.sh\nlunch rk3588s_firefly_cs_r2-userdebug\nmake installclean\nmake -j8\n./mkimage.sh<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
打包成统一固件 update.img<\/strong><\/p>\n\n
编译完可以用Firefly官方的脚本打包成统一固件，执行如下命令：<\/p>\n\n
\n
\n
\ncd ~/path/to/sdk/\n./FFTools/mkupdate/mkupdate.sh -l rk3588s_firefly_cs_r2-userdebug<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
打包完成后将在rockdev/Image-rk3588s_firefly_cs_r2/ 目录下生成统一固件： product名XXX_XXX_日期XXX.img 在 Windows 下打包统一固件 update.img 也很简单，将编译生成的文件拷贝到 AndroidTool 的 rockdevImage 目录中，然后运行 rockdev 目录下的 mkupdate.bat 批处理文件即可创建 update.img 并存放到 rockdevImage 目录里。<\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
2.2. 2. Android 系统定制，应用开发<\/strong><\/h2>\n\n
参考 Firefly Android 使用手册<\/a><\/p>\n<\/div>\n\n
\n
2.3. 3. Linux SDK<\/strong><\/h2>\n\n
为了方便用户的使用与开发，官方提供了 Linux 开发的整套 SDK，本章详细的说明 SDK 的具体用法。<\/p>\n\n
注意：<\/strong> Linux SDK只适用于集群服务器子板的系统开发。<\/p>\n\n
\n
2.3.1. 3.1 Ubuntu 18.04<\/strong><\/h3>\n\n
核心板 Core-3399JD4 支持 Ubuntu 18.04<\/span><\/p>\n\n
\n
2.3.1.1. (1). 准备工作<\/strong><\/h3>\n\n\n
2.3.1.1.1. A. 下载 Firefly_Linux_SDK 分卷压缩包<\/strong><\/h4>\n\n由于 Firefly_Linux_SDK 源码包比较大，部分用户电脑不支持4G以上文件或单个文件网络传输较慢, 所以我们采用分卷压缩的方法来打包SDK。用户可以通过如下方式获取 Firefly_Linux_SDK源码包：<\/strong>Firefly_Linux_SDK源码包<\/a><\/p>\n\n
下载完成后先验证一下 MD5 码：<\/p>\n\n
\n
\n
\n$ md5sum rk3399_linux_release_v2.5.1_20210301_split_dir/firefly_split\n2cf71e64d35eb8083a4a0fc30c256484 rk3399_linux_release_v2.5.1_20210301_split_dir/rk3399_linux_release_v2.5.1_20210301_firefly_split.file0\nf0e9292b3816a8f1ce0eb1eeb483ad56 rk3399_linux_release_v2.5.1_20210301_split_dir/rk3399_linux_release_v2.5.1_20210301_firefly_split.file1\nc6aaa5d761d0e7917bea1cb78a0e7229 rk3399_linux_release_v2.5.1_20210301_split_dir/rk3399_linux_release_v2.5.1_20210301_firefly_split.file2\n16022cc729d06a28fec30ac52885d91c rk3399_linux_release_v2.5.1_20210301_split_dir/rk3399_linux_release_v2.5.1_20210301_firefly_split.file3\n565426354c01d56c7d48479dd7f3c35b rk3399_linux_release_v2.5.1_20210301_split_dir/rk3399_linux_release_v2.5.1_20210301_firefly_split.file4\n313d311f1705fbfb7bfc45b7937ecf24 rk3399_linux_release_v2.5.1_20210301_split_dir/rk3399_linux_release_v2.5.1_20210301_firefly_split.file5<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
2.3.1.1.2. 解压 Firefly_Linux_SDK 分卷压缩包<\/h4>\n\n
确认无误后，就可以解压：<\/p>\n\n
\n
\n
\ncat rk3399_linux_release_v2.5.1_20210301_split_dir/firefly_split* | tar -xzv\n\n#本SDK文件夹内包含一个 .repo 目录,解压之后,在当前目录下执行以下操作\ncd rk3399_linux_release_v2.5.1_20210301\nls -al\n\n.repo/repo/repo sync -l\n.repo/repo/repo sync -c --no-tags\n.repo/repo/repo start firefly --all<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
2.3.1.1.3. 更新 Firefly_Linux_SDK<\/h4>\n\n
后续可以使用以下命令更新 SDK<\/p>\n\n
\n
\n
\n.repo/repo/repo sync -c --no-tags<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
2.3.1.2. (2). Linux_SDK 目录介绍<\/strong><\/h4>\n\n
目录：<\/p>\n\n
\n
\n
\n── linux_sdk\n ├── app\n ├── buildroot buildroot 根文件系统的编译目录\n ├── build.sh -> device/rockchip/common/build.sh 全自动编译脚本\n ├── device 编译相关配置文件\n ├── distro debian 根文件系统生成目录\n ├── docs 文档\n ├── envsetup.sh -> buildroot/build/envsetup.sh\n ├── external\n ├── kernel 内核\n ├── Makefile -> buildroot/build/Makefile\n ├── mkfirmware.sh -> device/rockchip/common/mkfirmware.sh rockdev链接更新脚本\n ├── prebuilts\n ├── rkbin\n ├── rkflash.sh -> device/rockchip/common/rkflash.sh 烧写脚本\n ├── rootfs debian根文件系统编译目录\n ├── tools 烧写、打包工具\n └── u-boot<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
2.3.1.3. (3). 搭建 SDK 编译环境<\/strong><\/h3>\n\n
Ubuntu 固件:(根文件系统请使用官方提供的根文件系统镜像)<\/p>\n\n
\n
\n
\nsudo apt-get update\n\nsudo apt-get install repo git-core gitk git-gui gcc-arm-linux-gnueabihf u-boot-tools device-tree-compiler \ngcc-aarch64-linux-gnu mtools parted libudev-dev libusb-1.0-0-dev python-linaro-image-tools \nlinaro-image-tools gcc-arm-linux-gnueabihf libssl-dev liblz4-tool genext2fs lib32stdc 6 \ngcc-aarch64-linux-gnu g conf autotools-dev libsigsegv2 m4 intltool libdrm-dev curl sed make \nbinutils build-essential gcc g bash patch gzip bzip2 perl tar cpio python unzip rsync file bc wget \nlibncurses5 libqt4-dev libglib2.0-dev libgtk2.0-dev libglade2-dev cvs git mercurial rsync openssh-client \nsubversion asciidoc w3m dblatex graphviz python-matplotlib libc6:i386 libssl-dev texinfo fakeroot \nlibparse-yapp-perl default-jre patchutils<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
注意：<\/strong><\/em> Ubuntu17.04 或者更高的系统还需要如下依赖包：<\/p>\n\n
\n\t
\n\t
sudo apt-get install lib32gcc-7-dev g -7 libstdc -7-dev<\/p>\n\t<\/li>\n<\/ol>\n<\/div>\n\n
\n
2.3.1.4. (4). 编译 SDK<\/strong><\/h3>\n\n
编译前配置<\/strong><\/p>\n\n
配置文件 CS-R2-3399-jd4-sub-ubuntu.mk:<\/p>\n\n
\n
\n
\n./build.sh CS-R2-3399-jd4-sub-ubuntu.mk<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
文件路径在 device/rockchip/rk3399/<\/span><\/p>\n\n
如果配置文件生效会连接到 device/rockchip/.BoardConfig.mk ,检查该文件可以验证是否配置成功<\/p>\n\n
\n
\n
\n#!/bin/bash\nCMD=`realpath $BASH_SOURCE`\nCUR_DIR=`dirname $CMD`\nsource $CUR_DIR/BoardConfig.mk\n# Uboot defconfig\nexport RK_UBOOT_DEFCONFIG=firefly-rk3399\n# Kernel defconfig\nexport RK_KERNEL_DEFCONFIG=firefly_linux_defconfig\n# Kernel dts\nexport RK_KERNEL_DTS=rk3399-firefly\n# parameter for GPT table\nexport RK_PARAMETER=parameter-ubuntu.txt\n# packagefile for make update image\nexport RK_PACKAGE_FILE=rk3399-ubuntu-package-file\n# Set rootfs type, including ext2 ext4 squashfs\nexport RK_ROOTFS_TYPE=ext4\n# rootfs image path\nexport RK_ROOTFS_IMG=ubuntu_rootfs/rk3399_ubuntu_rootfs.img\n# recovery ramdisk\nexport RK_RECOVERY_RAMDISK=recovery-arm64.cpio.gz\n# Set userdata partition type\nexport RK_USERDATA_FS_TYPE=ext4\n# Buildroot config\nexport RK_CFG_BUILDROOT=\n# Recovery config\nexport RK_CFG_RECOVERY=\n#OEM config\nexport RK_OEM_DIR=\n#userdata config\nexport RK_USERDATA_DIR=<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
注意,十分重要！！<\/strong><\/em><\/span><\/span><\/p>\n\n
前往下载页面下载对应的Ubuntu 根文件系统镜像<\/a><\/p>\n\n
把得到的镜像放到 SDK 的指定目录:<\/p>\n\n
\n
\n
\n#解压\ntar -xvf rk3399_ubuntu18.04_LXDE.img.tgz\n\n#sdk根目录下\nmkdir ubunturootfs\nmv rk3399_ubuntu18.04_LXDE.img ubunturootfs/\n\n#修改firefly-rk3399-ubuntu.mk文件\nvim device/rockchip/RK3399/firefly-rk3399-ubuntu.mk\n\n#把RK_ROOTFS_IMG属性改成ubuntu文件系统镜像得路径(也就是rk3399_ubuntu18.04_LXDE.img)\n\nRK_ROOTFS_IMG=ubunturootfs/rk3399_ubuntu18.04_LXDE.img<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
注意：<\/strong><\/em><\/span> Ubuntu 根文件系统镜像存放路径不能错。<\/p>\n\n
\n
\n
\n#全自动编译的固件\n$ ./build.sh\n\n#部分编译\n\n$ ./build.sh kernel\n$ ./build.sh uboot\n$ ./build.sh recovery\n\n#运行 ./mkfirmware.sh 会自动更新 rockdev/rootfs.img 的链接。\n$ ./build.sh firmware\n\n#固件打包\n#每次打包固件前先确保 rockdev/ 目录下文件链接是否正确:\n$ ls -l\n\n├── boot.img -> ~/project/linux_sdk/kernel/boot.img\n├── idbloader.img -> ~/project/linux_sdk/u-boot/idbloader.img\n├── MiniLoaderAll.bin -> ~/project/linux_sdk/u-boot/rk3399_loader_v1.14.115.bin\n├── misc.img -> ~/project/linux_sdk/device/rockchip/rockimg/wipe_all-misc.img\n├── parameter.txt -> ~/project/linux_sdk/device/rockchip/RK3399/parameter-ubuntu.txt\n├── recovery.img -> ~/project/linux_sdk/buildroot/output/rockchip_rk3399_recovery/images/recovery.img\n├── rootfs.img -> ~/project/linux_sdk/ubunturootfs/rk3399_ubuntu18.04_LXDE.img\n├── trust.img -> ~/project/linux_sdk/u-boot/trust.img\n├── uboot.img -> ~/project/linux_sdk/u-boot/uboot.img\n└── userdata.img\n\n#打包统一固件\n# 注意：打包前请确认 tools/linux/Linux_Pack_Firmware/rockdev/package-file 是否正确。打包会根据此文件进行分区打包。此文件链接会在 ./build.sh firefly-rk3399-ubuntu.mk 命令时更新，如果配置不对请返回编译前配置一节重新配置一次。\n\n整合统一固件：\n\n$ ./build.sh updateimg<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
2.3.1.5. (5). 分区介绍<\/strong><\/h3>\n\n
\n
2.3.1.5.1. A. parameter.txt<\/h4>\n\n
parameter.txt 包含了固件的分区信息十分重要,你可以在 device/rockchip/rk3399 目录下找到一些 parameter.txt 文件,下面以 parameter-debian.txt 为例子做介绍:<\/p>\n\n
\n
\n
\nFIRMWARE_VER: 8.1\nMACHINE_MODEL: RK3399\nMACHINE_ID: 007\nMANUFACTURER: RK3399\nMAGIC: 0x5041524B\nATAG: 0x00200800\nMACHINE: 3399\nCHECK_MASK: 0x80\nPWR_HLD: 0,0,A,0,1\nTYPE: GPT\nCMDLINE: mtdparts=rk29xxnand:0x00002000@0x00004000(uboot),0x00002000@0x00006000(trust),0x00002000@0x00008000(misc),0x00010000@0x0000a000(boot),0x00010000@0x0001a000(recovery),0x00010000@0x0002a000(backup),0x00020000@0x0003a000(oem),0x00700000@0x0005a000(rootfs),-@0x0075a000(userdata:grow)\nuuid:rootfs=614e0000-0000-4b53-8000-1d28000054a9<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
CMDLINE 属性是我们关注的地方。以 Uboot 为例 0x00002000@0x00004000(uboot) 中 0x00004000 为 Uboot 分区的起始位置 0x00002000 为分区的大小。后面的分区规则相同。用户可以根据自己需要增减或者修改分区信息，但是请最少保留 uboot, trust, boot, rootfs 分区，这是机器能正常启动的前提条件。parameter-ubuntu.txt 中使用的就是这样的最简分区方案。<\/p>\n\n
分区介绍：<\/p>\n\n
\n\t
\n\t
uboot 分区: 烧写 uboot 编译出来的 uboot.img。<\/p>\n\t<\/li>\n\t
\n\t
trust 分区: 烧写 uboot 编译出来的 trust.img。<\/p>\n\t<\/li>\n\t
\n\t
misc 分区: 烧写 misc.img。开机检测进入 recovery 模式。(可省略)<\/p>\n\t<\/li>\n\t
\n\t
boot 分区: 烧写 kernel 编译出来的 boot.img 包含 kernel 和设备树信息。<\/p>\n\t<\/li>\n\t
\n\t
recovery 分区: 烧写 recovery.img。(可省略)<\/p>\n\t<\/li>\n\t
\n\t
backup 分区: 预留,暂时没有用。后续跟 android 一样作为 recovery 的 backup 使用。(可省略)<\/p>\n\t<\/li>\n\t
\n\t
oem 分区: 给厂家使用,存放厂家的 app 或数据。只读。代替原来音箱的 data 分区。挂载在/oem 目录。(可省略)<\/p>\n\t<\/li>\n\t
\n\t
rootfs 分区: 存放 buildroot 或者 debian 编出来的 rootfs.img,只读.<\/p>\n\t<\/li>\n\t
\n\t
userdata 分区 : 存放 app 临时生成的文件或者是给最终用户使用。可读写,挂载在 /userdata 目录下。(可省略)<\/p>\n\t<\/li>\n<\/ol>\n<\/div>\n\n
\n
2.3.1.5.2. B. package-file<\/h4>\n\n
package-file文件应当与 parameter 保持一致，用于固件打包。可以在 tools/linux/Linux_Pack_Firmware/rockdev 下找到相关文件。以 rk3399-ubuntu-package-file 为例介绍:<\/p>\n\n
\n
\n
\n# NAME Relative path\n#\n#HWDEF HWDEF\npackage-file package-file\nbootloader Image/MiniLoaderAll.bin\nparameter Image/parameter.txt\ntrust Image/trust.img\nuboot Image/uboot.img\nboot Image/boot.img\nrootfs:grow Image/rootfs.img\nbackup RESERVED<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
以上是 SDK 编译后生成的镜像文件。根据 parameter.txt 只打包自己用到的 img 文件。<\/p>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
2.3.2. 3.2 Ubuntu 20.04<\/strong><\/h2>\n\n
核心板 Core-3588SJD4 支持 Ubuntu 20.04<\/span><\/p>\n\n
\n
2.3.2.1. (1) 获取 SDK<\/strong><\/h4>\n\n
首先准备一个空文件夹用于存放 SDK，建议在 home 目录下，本文以 ~/proj <\/span>为例<\/p>\n\n
不要在虚拟机共享文件夹以及非英文目录存放、解压SDK，且不要使用 sudo root 权限操作, 避免产生不必要的错误<\/span><\/p>\n\n
\n
2.3.2.1.1. 安装工具<\/h4>\n\n
获取 SDK 需要先安装：<\/p>\n\n
\n
\n
\nsudo apt update\nsudo apt install -y repo git python<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
2.3.2.1.2. 初始化仓库<\/h4>\n\n
\n\t
\n\t
方法一（推荐国内用户使用）<\/p>\n\t<\/li>\n<\/ul>\n\n
SDK 源码存放于 gitlab，国内用户可能下载完整的 SDK 仓库速度比较慢，所以我们提供了一个 SDK 基础包(Linux SDK<\/a>)，国内用户只需要在此基础包上同步 gitlab 上的代码就可以了<\/strong><\/p>\n\n
下载完成后先验证一下 MD5 码：<\/p>\n\n
\n
\n
\n$ md5sum rk3588_linux_release_20230114_v1.0.6c_0\nc3bcb3f92bd139f72551c89f75d39bfa rk3588_linux_release_20230114_v1.0.6c_00\nebb658571a645d4af1e2b569709480b7 rk3588_linux_release_20230114_v1.0.6c_01\n9761cc324e9f7133500b590c441b0307 rk3588_linux_release_20230114_v1.0.6c_02\n7adc9fe2158d7681554dce1def238f49 rk3588_linux_release_20230114_v1.0.6c_03\n3d9201e3849b8a523c05920bebe28b39 rk3588_linux_release_20230114_v1.0.6c_04\n6faaee006fe60fc9be60a64a01506cb6 rk3588_linux_release_20230114_v1.0.6c_05<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
确认无误后，就可以解压：<\/p>\n\n
\n
\n
\n# 解压\nmkdir -p ~/proj/rk3588_sdk\ncd ~/proj/rk3588_sdk\ncat path/to/rk3588_linux_release_20230114_v1.0.6c_0 | tar -xv\n\n# 导出数据\n.repo/repo/repo sync -l<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
\n\t
\n\t
方法二<\/p>\n\t<\/li>\n<\/ul>\n\n
通过 repo 拉取代码，此方法对网络要求较高，有条件可以使用<\/p>\n\n
可选择获取完整 SDK 或者 BSP：<\/p>\n\n
\n
\n
\nmkdir ~/proj/rk3588_sdk/\ncd ~/proj/rk3588_sdk/\n\n## 完整 SDK\nrepo init --no-clone-bundle --repo-url https://gitlab.com/firefly-linux/git-repo.git -u https://gitlab.com/firefly-linux/manifests.git -b master -m rk3588_linux_release.xml\n\n## BSP （只包含基础仓库和编译工具）\n## BSP 包括 device/rockchip 、docs 、 kernel 、 u-boot 、 rkbin 、 tools 和交叉编译链\nrepo init --no-clone-bundle --repo-url https://gitlab.com/firefly-linux/git-repo.git -u https://gitlab.com/firefly-linux/manifests.git -b master -m rk3588_linux_bsp_release.xml<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
2.3.2.1.3. 同步代码<\/h4>\n\n
执行如下命令同步代码：<\/p>\n\n
\n
\n
\n# 进入 SDK 根目录\ncd ~/proj/rk3588_sdk\n\n# 同步\n.repo/repo/repo sync -c --no-tags\n.repo/repo/repo start firefly --all<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
后续可以使用以下命令更新 SDK：<\/p>\n\n
\n
\n
\n.repo/repo/repo sync -c --no-tags<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
因为网络环境等原因，.repo/repo/repo sync -c --no-tags <\/span>命令更新代码可能会失败，可多次反复执行。<\/p>\n<\/div>\n<\/div>\n\n
\n
2.3.2.2. (2) Linux SDK 配置介绍<\/strong><\/h3>\n\n
\n
2.3.2.2.1. 目录介绍<\/h4>\n\n
\n
\n
\n$ tree -L 1\n.\n├── app\n├── buildroot # Buildroot 根文件系统编译目录\n├── build.sh -> device/rockchip/common/build.sh # 编译脚本\n├── device # 编译相关配置文件\n├── docs # 文档\n├── envsetup.sh -> buildroot/build/envsetup.sh\n├── external\n├── kernel\n├── Makefile -> buildroot/build/Makefile\n├── mkfirmware.sh -> device/rockchip/common/mkfirmware.sh # 链接脚本\n├── prebuilts # 交叉编译工具链\n├── rkbin\n├── rkflash.sh -> device/rockchip/common/rkflash.sh # 烧写脚本\n├── tools # 工具目录\n├── u-boot<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
2.3.2.2.2. 配置文件介绍<\/h4>\n\n
在 device/rockchip/rk3588/<\/span> 目录下，有不同板型的配置文件(xxxx.mk)，用于管理 SDK 每个环节的编译配置，相关配置介绍：<\/p>\n\n
\n
\n
\n# Target arch\nexport RK_ARCH=arm64 # 64位 ARM 架构\n# Uboot defconfig\nexport RK_UBOOT_DEFCONFIG=xxxx_defconfig # u-boot 配置文件\n# Kernel defconfig\nexport RK_KERNEL_DEFCONFIG=xxxx_defconfig # kernel 配置文件\n# Kernel defconfig fragment\nexport RK_KERNEL_DEFCONFIG_FRAGMENT=xxxx.config # kernel 配置文件（fragment）\n# Kernel dts\nexport RK_KERNEL_DTS=xxxx.dts # dts 文件\n# parameter for GPT table\nexport RK_PARAMETER=parameter-xxxx.txt # 分区表\n# rootfs image path\nexport RK_ROOTFS_IMG=ubuntu_rootfs/rootfs.img # 根文件系统路径<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
2.3.2.2.3. 分区说明<\/h3>\n\n
\n
2.3.2.2.3.1. parameter 分区表<\/h4>\n\n
路径：device/rockchip/rk3588/parameter-xxxxxx-fit.txt<\/span><\/p>\n\n
\n
\n
\nFIRMWARE_VER: 1.0\nMACHINE_MODEL: RK3588\nMACHINE_ID: 007\nMANUFACTURER: RK3588\nMAGIC: 0x5041524B\nATAG: 0x00200800\nMACHINE: 0xffffffff\nCHECK_MASK: 0x80\nPWR_HLD: 0,0,A,0,1\nTYPE: GPT\nCMDLINE: mtdparts=rk29xxnand:0x00002000@0x00004000(uboot),0x00002000@0x00006000(misc),0x00020000@0x00008000(boot:bootable),0x00040000@0x00028000(recovery),0x00010000@0x00068000(backup),0x00c00000@0x00078000(rootfs),0x00040000@0x00c78000(oem),-@0x00cb8000(userdata:grow)\nuuid:rootfs=614e0000-0000-4b53-8000-1d28000054a9<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
CMDLINE 属性是我们关注的地方，以 uboot 为例， 0x00002000@0x00004000(uboot) 中 0x00004000 为uboot 分区的起始位置，0x00002000 为分区的大小，以此类推。<\/p>\n<\/div>\n\n
\n
2.3.2.2.3.2. package-file<\/h4>\n\n
package-file 文件用于打包固件时确定需要的分区镜像和镜像路径，同时它需要与 parameter.txt 文件保持一致。<\/p>\n\n
路径：tools/linux/Linux_Pack_Firmware/rockdev/rk3588-package-file<\/span><\/p>\n\n
\n
\n
\n# NAME Relative path\n#\n#HWDEF HWDEF\npackage-file package-file\nbootloader Image/MiniLoaderAll.bin\nparameter Image/parameter.txt\nuboot Image/uboot.img\nmisc Image/misc.img\nboot Image/boot.img\nrecovery Image/recovery.img\nrootfs Image/rootfs.img\nuserdata RESERVED\nbackup RESERVED<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
2.3.2.3. (3) 编译 Ubuntu20.04 固件<\/strong><\/h4>\n\n
本章介绍 Ubuntu 固件的编译流程，推荐在 Ubuntu 18.04 系统环境下进行开发，若使用其它系统版本，可能需要对编译环境做相应调整。<\/p>\n\n
本教程的编译部分适用于 v1.0.6e 以上 SDK 版本<\/span><\/p>\n\n
\n
\n
\n$ readlink -f .repo/manifest.xml\n/home/daijh/p/rk3588/.repo/manifests/rk3588/rk3588_linux_release_20230301_v1.0.6e.xml<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
\n
2.3.2.3.1. 准备工作<\/h3>\n\n
搭建编译环境:<\/p>\n\n
\n
\n
\nsudo apt-get install repo git ssh make gcc libssl-dev liblz4-tool \nexpect g patchelf chrpath gawk texinfo chrpath diffstat binfmt-support \nqemu-user-static live-build bison flex fakeroot cmake gcc-multilib g -multilib\nunzip \ndevice-tree-compiler ncurses-dev <\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
2.3.2.3.2. 编译 SDK<\/h3>\n\n
\n
2.3.2.3.2.1. 编译前配置<\/h4>\n\n
在 device/rockchip/rk3588/<\/span> 目录下，有不同板型的配置文件，选择配置文件：<\/p>\n\n
\n
\n
\n./build.sh CS-R2-3588s-jd4-sub-minimal-ubuntu.mk<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
2.3.2.3.2.2. 全自动编译<\/h4>\n\n
\n\t
\n\t
下载根文件系统：Ubuntu 根文件系统(64位)<\/a>，放到 SDK 路径下<\/p>\n\t<\/li>\n<\/ul>\n\n
\n
\n
\n7z x ubuntu-aarch64-rootfs.7z\nmkdir ubuntu_rootfs\nmv ubuntu-aarch64-rootfs.img ubuntu_rootfs/rootfs.img\n<\/span><\/pre>\n<\/div>\n<\/div>\n\n
\n\t
\n\t
开始编译<\/p>\n\t<\/li>\n<\/ul>\n\n
\n
\n
\n./build.sh\n<\/span><\/pre>\n<\/div>\n<\/div>\n\n
生成的完整固件会保存到 rockdev/pack/<\/span> 目录。<\/p>\n<\/div>\n\n
\n
2.3.2.3.2.3. 部分编译<\/h4>\n\n
\n\t
\n\t
编译 u-boot<\/p>\n\t<\/li>\n<\/ul>\n\n
\n
\n
\n./build.sh uboot<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
\n\t
\n\t
编译 kernel<\/p>\n\t<\/li>\n<\/ul>\n\n
\n
\n
\n./build.sh extboot<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
\n\t
\n\t
编译 recovery<\/p>\n\t<\/li>\n<\/ul>\n\n
\n
\n
\n./build.sh recovery<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
\n\t
\n\t
下载根文件系统：Ubuntu 根文件系统(64位)<\/a>，放到 SDK 路径下<\/p>\n\t<\/li>\n<\/ul>\n\n
\n
\n
\n7z x ubuntu-aarch64-rootfs.7z\nmkdir ubuntu_rootfs\nmv ubuntu-aarch64-rootfs.img ubuntu_rootfs/rootfs.img<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
\n\t
\n\t
更新各部分镜像链接到 rockdev/<\/span> 目录<\/p>\n\t<\/li>\n<\/ul>\n\n
\n
\n
\n./mkfirmware.sh<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
\n\t
\n\t
打包固件，生成的完整固件会保存到 rockdev/pack/<\/span> 目录<\/p>\n\t<\/li>\n<\/ul>\n\n
\n
\n
\n./build.sh updateimg<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
2.4. 4. Linux 系统定制，应用开发<\/strong><\/h2>\n\n
参考Firefly Ubuntu 使用手册<\/a><\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n"}],"pid":0,"id":78,"sort":3,"title":"二次开发","content":""},{"productId":15,"children":[],"pid":0,"id":81,"sort":3,"title":"FAQ","content":"
\n
\n
\n
\n
\n
\n
FAQ<\/strong><\/h1>\n\n\n
1.1. 1.硬件看门狗如何使用？<\/strong><\/h2>\n\n
硬件看门狗的主体是一个定时电路，其主要作用是监控、管理CPU的运行状态，并对处于异常状态中的CPU进行复位操作，使其能重新工作。<\/p>\n\n
Android10.0 出厂固件没有打开硬件看门狗，如果客户需要可自行实现软件程序去使用硬件看门狗，下面提供硬件看门狗的操作方法：<\/p>\n\n
\n\t
\n\t
使能看门狗<\/p>\n\t<\/li>\n<\/ul>\n\n
\n
\n
\necho e > "/dev/wdt_crl"<\/span><\/pre>\n<\/div>\n<\/div>\n\n
\n\t
\n\t
设置超时时间(喂狗)<\/p>\n\t<\/li>\n<\/ul>\n\n
支持设置4种超时时间:0.64s、2.56s、10.24s、40.96s，对应往设备节点里写0、1、2、3。客户可根据自己的需要设置不同的超时时间，例如客户需要设置超时时间为2.56s，则为：<\/p>\n\n
\n
\n
\necho 1 > "/dev/wdt_crl"<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
软件程序需要定时设置超时时间对看门狗内的定时器清零(俗称“喂狗”)。<\/p>\n\n
当CPU出现故障，则不能继续提供“喂狗”信号，就使得看门狗内的定时器不断累加而溢出，从而产生复位信号对CPU进行复位重启系统，使CPU重新工作。<\/p>\n\n
\n\t
\n\t
关闭看门狗<\/p>\n\t<\/li>\n<\/ul>\n\n
\n
\n
\necho d > "/dev/wdt_crl"<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
1.2. 2.BMC 常见问题<\/strong><\/h2>\n\n
\n
1.2.1. BMC 上的设备均显示为不可用<\/h3>\n\n
原因有多样，请按照以下顺序逐一排查：<\/p>\n\n
\n\t
\n\t
将显示时间范围调整到最近半小时，看有没有输出。<\/p>\n\t<\/li>\n\t
\n\t
运行 adb devices <\/span>看有没有设备列出。<\/p>\n\n\t
如果没有，确保 USB OTG 口没有连接到电脑上，如果 USB OTG 口也没有连接，请检查核心板连接和电源，排除硬件问题。<\/p>\n\t<\/li>\n\t
\n\t
运行 bmc query<\/span> ，正常情况下有如下返回：<\/p>\n\n\t
\n\t
\n\t
\nroot@firefly:~# bmc query\nnode_cluster_up{instance="127.0.0.1:9100", job="node", nodename="main", subnode="main"} => 1 @[1603356844.328]\nnode_cluster_up{instance="127.0.0.1:9100", job="node", nodename="main", subnode="sub01"} => 1 @[1603356844.328]\nnode_cluster_up{instance="127.0.0.1:9100", job="node", nodename="main", subnode="sub02"} => 1 @[1603356844.328]\n...<\/span>\n<\/pre>\n\t<\/div>\n\t<\/div>\n\n\t
如果没有，检查主板上的 node_exporter<\/span> 有没有运行：<\/p>\n\n\t
\n\t
\n\t
\nroot@firefly:~# bmc main metrics | grep node_cluster_up\n# HELP node_cluster_up Value is 1 if the cluster subnode is 'up', 0 otherwise.\n# TYPE node_cluster_up gauge\nnode_cluster_up{state="android",subnode="sub02"} 1\nnode_cluster_up{state="android",subnode="sub03"} 1\n...<\/span>\n<\/pre>\n\t<\/div>\n\t<\/div>\n\n\t
如果没有输出，则主板上的 node_exporter <\/span>运行出错。<\/p>\n\n\t
如果有输出， Prometheus<\/span> 服务并没有去收集主板的 node_exporter<\/span> 数据，运行出错。<\/p>\n\t<\/li>\n\t
\n\t
运行 sudo systemctl status prometheus<\/span> 查看该服务的状态。<\/p>\n\t<\/li>\n\t
\n\t
运行 sudo journalctl -u prometheus<\/span> 查看该服务的运行日志，定位错误的原因。<\/p>\n\n\t
\n\t\t
\n\t\t
如果日志含有出错信息：”Handle Corrupt Prometheus Write-Ahead Log (WAL)”<\/p>\n\n\t\t
请尝试删除该坏文件并重启服务：<\/p>\n\n\t\t
\n\t\t
\n\t\t
\nsudo systemctl restart prometheus<\/span>\n<\/pre>\n\t\t<\/div>\n\t\t<\/div>\n\t\t<\/li>\n\t\t
\n\t\t
如果日志含有出错信息：”Error on ingesting out-of-order samples”<\/p>\n\n\t\t
当服务器时间和浏览器时间不一致，例如服务器时间是 7-01，浏览器是 7-21，这会导致浏览器发送的查询命令要求返回对于服务器来讲是未来的数据，得到的响应结果为空，进而导致显示界面为空。<\/p>\n\n\t\t
系统默认是使用 NTP 自动更新时间的，如果由于网络原因无法使用 NTP，就要手工同步时间：<\/p>\n\n\t\t
\n\t\t
\n\t\t
\nsudo timedatectl set-ntp false # 关闭 NTP\nsudo timedatectl set-timezone Asia/Shanghai # 设置本地时区\nsudo timedatectl set-time "2021-10-14 15:48:29" # 设置本地时间\ntimedatectl status # 检查结果，注意时区和时间<\/span>\n<\/pre>\n\t\t<\/div>\n\t\t<\/div>\n\n\t\t
然后重置 Prometheus:<\/p>\n\n\t\t
\n\t\t
\n\t\t
\nsudo systemctl stop prometheus\nsudo rm -rf /var/lib/prometheus/metrics2/\nsudo systemctl start prometheus<\/span>\n<\/pre>\n\t\t<\/div>\n\t\t<\/div>\n\t\t<\/li>\n\t<\/ul>\n\t<\/li>\n<\/ul>\n<\/div>\n\n
\n
1.2.2. 子板固件升级问题排查<\/h3>\n\n
\n
1.2.2.1. 固件升级背景知识<\/h4>\n\n
子板固件升级系统分为两部分：<\/p>\n\n
\n\t
\n\t
Web 前端负责添加固件升级申请和升级进度的显示。<\/p>\n\t<\/li>\n\t
\n\t
后端netrecovery-master 负责实际的子板固件升级和进度更新。<\/p>\n\t<\/li>\n<\/ul>\n\n
子板固件升级流程为：<\/p>\n\n
\n\t
\n\t
切换子板到 Loader 模式。<\/p>\n\t<\/li>\n\t
\n\t
对处于 Loader 模式的子板设备写入辅助升级固件并重启进入升级系统（下称 netrecovery 模式）。<\/p>\n\t<\/li>\n\t
\n\t
对子板设置 DHCP IP 地址。<\/p>\n\t<\/li>\n\t
\n\t
子板运行固件升级程序，通过网络下载主板上的固件，同时烧写到 eMMC 存储。<\/p>\n\t<\/li>\n\t
\n\t
子板烧写成功，重启。<\/p>\n\t<\/li>\n<\/ol>\n\n
子板固件升级成功的必要条件：<\/p>\n\n
\n\t
\n\t
确保子板能够获取 DHCP IP 地址，而且主板与子板的网络要能相通。<\/p>\n\t<\/li>\n\t
\n\t
集群服务器的 OTG USB 口与外部 PC 机的连接必须断开。<\/p>\n\t<\/li>\n\t
\n\t
固件文件放在 /home/firefly/Firmware <\/span>目录里，后缀名为 “.img”。<\/p>\n\t<\/li>\n<\/ol>\n<\/div>\n\n
\n
1.2.2.2. Web 端提交固件升级申请后，进度一直是 0%<\/h4>\n\n
这个需要检查一下 netrecovery-master<\/span> 的日志：<\/p>\n\n
\n
\n
\nsudo journalctl -f -u netrecovery-master<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
查看是否有什么出错信息导致程序异常退出。<\/p>\n\n
要重启该服务，可以运行：<\/p>\n\n
\n
\n
\nsudo systemctl restart netrecovery-master<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
1.2.2.3. 升级提示 “switch to recovery failed”<\/h4>\n\n
设备无法切换到 Loader 模式，或者 Loader 模式下无法刷入 netrecovery<\/span> 均会出现这种错误。<\/p>\n\n
可以尝试过段时间后重试。如果都不行，只能使用 USB 线刷方式重新烧录固件。<\/p>\n<\/div>\n\n
\n
1.2.2.4. 查看子板升级的详细日志<\/h4>\n\n
下面以子板 sub1-01 为例子，请换成实际的设备号。<\/p>\n\n
\n
\n
\n# 看子板端日志\n$ bmc sub1-01 shell\n$ cd /tmp/log\n$ cat history # 查看命令列表，第一个数字是进程号\n$ cat .err # 查看错误输出\n\n# 如果子板端看不了，可以看一下主板端的运行结果：\n$ cd /var/netrecovery/sub1-01/state\n$ cat master-.out\n$ cat history # 主板会将子板的日志文件下载到本地供查看\n$ cat .err # 查看错误输出<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
1.2.3. Prometheus<\/h3>\n\n
\n
1.2.3.1. 如何查看 Prometheus 状态<\/h4>\n\n
运行服务状态：<\/p>\n\n
\n
\n
\nsudo systemctl status prometheus<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
运行服务日志：<\/p>\n\n
\n
\n
\nsudo journalctl -u prometheus<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
1.2.3.2. 如果查看 Prometheus 数据库大小<\/h4>\n\n
\n
\n
\nsudo du -hs /var/lib/prometheus/metrics2<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
1.2.3.3. 如何调整 Prometheus 的数据库存储空间管理策略<\/h4>\n\n
请修改 /etc/default/prometheus<\/span> 配置文件，当前默认的设定是：<\/p>\n\n
\n
\n
\nARGS="--storage.tsdb.retention.time=7d --storage.tsdb.retention.size=4GB"<\/span>\n<\/pre>\n<\/div>\n<\/div>\n\n
即仅保留 7 天以内、最大 4GB 的数据。<\/p>\n<\/div>\n\n
\n
1.2.3.4. 重置 Prometheus<\/h4>\n\n
以下操作会删除 Prometheus 所有数据并重启服务：<\/p>\n\n
\n
\n
\n```shell\nsudo systemctl stop prometheus\nsudo rm -rf /var/lib/prometheus/metrics2/*\nsudo systemctl start prometheus\n```<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
1.2.4. node_exporter 性能参数<\/h3>\n\n
\n
1.2.4.1. 打开的文件描述符 node_filefd_allocated<\/span><\/h4>\n\n
node_filefd_allocated 表示已经分配的文件描述符的数量。这个数字越高表明打开的文件数越多。<\/p>\n\n
参考：<\/p>\n\n
\n\t
\n\t
https://www.robustperception.io/kernel-file-descriptor-metrics-from-the-node-exporter<\/a><\/p>\n\t<\/li>\n<\/ul>\n<\/div>\n\n
\n
1.2.4.2. 每秒上下文切换次数 node_context_switches_total<\/span><\/h4>\n\n
node_context_switches_total <\/span>表示进程上下文切换的速率。这个数越高，表明进程数比较多而且切换频繁。<\/p>\n\n
参考：<\/p>\n\n
\n\t
\n\t
https://stackoverflow.com/questions/56724508/what-is-rate-node-context-switches-total-ans-why-ratenode-context-switches-tota<\/a><\/p>\n\t<\/li>\n<\/ul>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
1.3. 3.子板(Android系统)如何用命令设置静态或动态IP?<\/strong><\/h2>\n\n\n
1.3.1. 静态IP<\/h3>\n\n
以sub01为例，静态IP:192.168.1.240,子网掩码:255.255.0.0,网关:192.168.1.1,主DNS:202.96.128.86,副DNS:202.96.128.166:<\/p>\n\n
\n
\n
\n```shell\nbmc_adb -s sub01 root\nbmc_adb -s sub01 remount\nbmc_adb -s sub01 shell "fireflyapi ethernet setIpAddress 1 192.168.1.240 255.255.0.0 192.168.1.1 202.96.128.86 202.96.128.166"\n```<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n\n
\n
1.3.2. 动态IP<\/h3>\n\n
以sub01为例:<\/p>\n\n
\n
\n
\n```shell\nbmc_adb -s sub01 root\nbmc_adb -s sub01 remount\nbmc_adb -s sub01 shell "fireflyapi ethernet setIpAddress 0"\n```<\/span>\n<\/pre>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/div>\n"},{"productId":15,"children":[],"pid":0,"id":82,"sort":4,"title":"资源下载","content":"
资源下载<\/a><\/span><\/p>\n"}],"attachfirmware":"[{\"num\":1,\"name\":\"CS-R2-RK3588（SUB）Ubuntu 固件\",\"fileName\":\"co1.png\",\"fileUrl\":\"/upload/dsjyjy/3f5e75c8-8ae4-49b3-9331-9e6da16836f0.png\"}]","pic":"{\"name\":\"CSR2-N72R3588S.png\",\"url\":\"/upload/dsjyjy/1b4771e5-3c9b-4bce-9079-f01ed086f813.png\"}","seoTitle":"","categoryName":"算力服务器","content":"
产品参数<\/span><\/h2>\n\n
<\/p>\n\n
$\"\"$ <\/span><\/p>\n\n
\n\t\n\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t\n\t\t\t
参数<\/span><\/caption>\n\t
\n\t\t\t
产品名称<\/strong><\/p>\n\t\t\t<\/td>\n\t\t\t
基于RK3588S平台2U云手机服务器<\/td>\n\t\t<\/tr>\n\t\t
\n\t\t\t
产品型号<\/strong><\/p>\n\t\t\t<\/td>\n\t\t\t
CSR2-N72R3588S<\/td>\n\t\t<\/tr>\n\t\t
构架<\/strong><\/td>\n\t\t\t ARM架构<\/td>\n\t\t<\/tr>\n\t\t
\n\t\t\t
操作系统<\/strong><\/p>\n\t\t\t<\/td>\n\t\t\t
支持Android、Ubuntu、Linux操作系统<\/td>\n\t\t<\/tr>\n\t\t
\n\t\t\t
应用场景<\/strong><\/p>\n\t\t\t<\/td>\n\t\t\t
云手机、虚拟桌面、边缘计算、云游戏、云存储、区块链、多路视频编解码、应用多开等<\/td>\n\t\t<\/tr>\n\t\t
节点规格<\/strong><\/td>\n\t\t<\/tr>\n\t\t
节点数<\/strong><\/td>\n\t\t\t \n\t\t\t
9个刀片节点<\/p>\n\n\t\t\t
每个节点都能配置8个计算模块（8核64位RK3588S）<\/p>\n\n\t\t\t
节点9还可用于安装2个3.5寸SATA/SSD硬盘（支持热插拔）<\/p>\n\t\t\t<\/td>\n\t\t<\/tr>\n\t\t
核心数<\/strong><\/td>\n\t\t\t 最高可配72个计算模块（共576个ARM核心）<\/td>\n\t\t<\/tr>\n\t\t
核心板<\/strong><\/td>\n\t\t\t \n\t\t\t
RK3588S核心板（Core-3588SJD4）×72：<\/p>\n\n\t\t\t
八核64位处理器，最高主频2.4GHz，NPU最高算力6.0Tops<\/p>\n\n\t\t\t
RK3399（AI）核心板（Core-3399-JD4）×1：<\/p>\n\n\t\t\t
六核64位处理器，最高主频1.8GHz，用于BMC管理<\/p>\n\t\t\t<\/td>\n\t\t<\/tr>\n\t\t
内存<\/strong><\/td>\n\t\t\t 16GB LPDDR4（单片核心板Core-3588SJD4）<\/td>\n\t\t<\/tr>\n\t\t
存储<\/strong><\/td>\n\t\t\t \n\t\t\t
128GB eMMC内置存储器（单片核心板Core-3588SJD4）<\/p>\n\n\t\t\t
3.5英寸SATA/SSD硬盘位 x2（节点9），支持热插拔<\/p>\n\n\t\t\t
SD卡槽 x1<\/p>\n\t\t\t<\/td>\n\t\t<\/tr>\n\t\t
BMC 控制模块<\/strong><\/td>\n\t\t<\/tr>\n\t\t
BMC<\/strong><\/td>\n\t\t\t 集成BMC管理系统，提供基于Web的管理界面，BMC管理系统可进行二次开发<\/td>\n\t\t<\/tr>\n\t\t
网络<\/strong><\/td>\n\t\t\t \n\t\t\t
可同时接入多个运营商网络；支持内外网隔离、物理端口绑定聚合、网络负载平衡、流量限制<\/p>\n\n\t\t\t
双网卡冗余设计（可以实现内外网隔离），单网卡集成如下：<\/p>\n\n\t\t\t
千兆网口（RJ45）×2、<\/p>\n\n\t\t\t
万兆网口（SFP+）×2<\/p>\n\n\t\t\t
BMC网络接口 ×1<\/p>\n\n\t\t\t
Console调试接口×1<\/p>\n\t\t\t<\/td>\n\t\t<\/tr>\n\t\t
显示<\/strong><\/td>\n\t\t\t 1× Mini HDMI 2.0，4K@60Hz（控制主板显示）<\/td>\n\t\t<\/tr>\n\t\t
USB<\/strong><\/td>\n\t\t\t 1 × USB3.0 HOST<\/td>\n\t\t<\/tr>\n\t\t
指示灯<\/strong><\/td>\n\t\t\t \n\t\t\t
控制主板工作状态指示灯：1个<\/p>\n\n\t\t\t
单个子板（节点）每片核心板1个状态指示灯，共8个LED指示灯<\/p>\n\n\t\t\t
扶手处有8个指示灯，分别代表：风扇1，风扇2，交换机模块1，交换机模块2，<\/p>\n\n\t\t\t
UID识别，BMC工作指示灯，开关电源1，开关电源2<\/p>\n\t\t\t<\/td>\n\t\t<\/tr>\n\t\t
按键<\/strong><\/td>\n\t\t\t Reset×1、UID按键×1<\/td>\n\t\t<\/tr>\n\t\t
风扇模组<\/strong><\/td>\n\t\t<\/tr>\n\t\t
风扇<\/strong><\/td>\n\t\t\t \n\t\t\t
共2组风扇模组：<\/p>\n\n\t\t\t
风扇模组1（3×2冗余风扇设计）、风扇模组2（2×2冗余风扇设计）<\/p>\n\t\t\t<\/td>\n\t\t<\/tr>\n\t\t
电源模组<\/strong><\/td>\n\t\t<\/tr>\n\t\t
电源<\/strong><\/td>\n\t\t\t \n\t\t\t
双路冗余电源设计：<\/p>\n\n\t\t\t
AC 100~240V 50/60Hz，1300W / 800W 可选<\/p>\n\t\t\t<\/td>\n\t\t<\/tr>\n\t\t
外观环境<\/strong><\/td>\n\t\t<\/tr>\n\t\t
\n\t\t\t
规格尺寸<\/strong><\/p>\n\t\t\t<\/td>\n\t\t\t
标准的2U服务器机箱： 580mm x 434mm x 88.8mm<\/td>\n\t\t<\/tr>\n\t\t
\n\t\t\t
工作温度<\/strong><\/p>\n\t\t\t<\/td>\n\t\t\t
0ºC - 35ºC<\/td>\n\t\t<\/tr>\n\t\t
\n\t\t\t
工作湿度<\/strong><\/p>\n\t\t\t<\/td>\n\t\t\t
8%RH~95%RH<\/td>\n\t\t<\/tr>\n\t<\/tbody>\n<\/table>\n\n
<\/p>\n","attachTools":"[{\"num\":1,\"name\":\"Linux UpgradeTool\",\"fileName\":\"bus1.png\",\"fileUrl\":\"/upload/dsjyjy/dec1db8a-a2a3-440e-be57-28024ec272ef.png\"},{\"num\":2,\"name\":\"RK驱动助手\",\"fileName\":\"1.jpg\",\"fileUrl\":\"/upload/dsjyjy/a8839e1e-6ef2-4e38-9b14-c4161c611ed3.jpg\"}]","descList":[{"introColor":"#ffffff","titleColor":"#ffffff","productId":15,"intro":"","id":64,"sort":1,"pic":"{\"name\":\"1(1).jpg\",\"url\":\"/upload/djmh/298e2928-e392-411c-8eea-29354fdbb836.jpg\"}","title":"CSR2-N72R3588S\nARM集群服务器","content":"最高可配置72个RK3588S计算单元，可虚拟720台手机；支持游戏多开，应用多开；支持多种系统；配套BMC可视化管理系统，并支持二次开发；\n适用于虚拟桌面、云手机、区块链、云游戏、人脸识别服务器等领域"},{"introColor":"#ffffff","titleColor":"#ffffff","productId":15,"intro":"","id":65,"sort":2,"pic":"{\"name\":\"2.jpg\",\"url\":\"/upload/djmh/87f770cd-fea2-43c8-a666-1511103bde95.jpg\"}","title":"RK3588S计算单元","content":"最高可配置72个RK3588S八核64位计算单元，每个核心主频最高可达2.4GHz，算力6Tops，拥有576核的边缘计算能力；每个计算单元可配置16GB\nLPDDR4，128GB eMMC的大容量存储，可满足对存储要求高的应用需求"},{"introColor":"#ffffff","titleColor":"#ffffff","productId":15,"intro":"","id":95,"sort":3,"pic":"{\"name\":\"3.jpg\",\"url\":\"/upload/djmh/f551b2cc-57f4-469e-918a-ac65b7d5695d.jpg\"}","title":"游戏多开，运行无压力","content":"单个计算单元的Benchmark跑分高达639132，可轻松运行各种大型游戏；支持手游多开，端游多开，安卓模拟器多开；最高可同时运行360个王者荣耀\n或者144个原神，运行无压力"},{"introColor":"#ffffff","titleColor":"#ffffff","productId":15,"intro":"","id":96,"sort":4,"pic":"{\"name\":\"4.jpg\",\"url\":\"/upload/djmh/de72758a-9527-47b7-8e44-77072046c988.jpg\"}","title":"安全高速的网络通讯","content":"拥有4个万兆网口，4个千兆网口，可同时接入多个运营商网络；支持内外网隔离、物理端口绑定聚合、网络负载平衡、\n流量限制，保证网络通信的可靠性和安全性"},{"introColor":"#000000","titleColor":"#000000","productId":15,"intro":"","id":97,"sort":5,"pic":"{\"name\":\"5.jpg\",\"url\":\"/upload/djmh/11f450ff-2aa8-4b46-a44c-29d8e48e129b.jpg\"}","title":"配套BMC管理系统","content":"配套BMC智能管理系统，轻松完成实时监控、软件配置、硬件管理、故障排除、系统升级，并可提供二次开发"},{"introColor":"#000000","titleColor":"#000000","productId":15,"intro":"","id":98,"sort":6,"pic":"{\"name\":\"6.jpg\",\"url\":\"/upload/djmh/d38d45e5-aabd-4e2f-a116-268b033bf15f.jpg\"}","title":"模块化设计，稳定可靠","content":"电源、风扇、网络、存储全采用模块化设计，支持热拔插操作，无须掀盖，轻松维护，大幅提升运维效率"},{"introColor":"#ffffff","titleColor":"#ffffff","productId":15,"intro":"","id":99,"sort":7,"pic":"{\"name\":\"7.jpg\",\"url\":\"/upload/djmh/3e4a668b-63d3-4ac2-b73f-176a331a2e51.jpg\"}","title":"全冗余设计，稳定可靠","content":"电源、风扇、网络、存储全冗余设计，可实现独立看门狗、实时温度检测、自动故障检测、并行恢复等功能，保证产品能安全可靠、长期稳定运行"},{"introColor":"#000000","titleColor":"#000000","productId":15,"intro":"","id":100,"sort":8,"pic":"{\"name\":\"8.jpg\",\"url\":\"/upload/djmh/c4c953b5-f9fb-4dc1-89cf-c6c6f7c4bc15.jpg\"}","title":"标准2U机架服务器","content":"标准的2U机架服务器机箱设计，576mm机箱深度，完全匹配数据中心大部分类型的机柜"},{"introColor":"#000000","titleColor":"#000000","productId":15,"intro":"","id":101,"sort":9,"pic":"{\"name\":\"9.jpg\",\"url\":\"/upload/djmh/6c9d7810-07b0-46e1-9907-a48ccc637a3a.jpg\"}","title":"支持多种操作系统","content":"支持运行Android、Ubuntu、Linux操作系统，运行稳定可靠"},{"introColor":"#ffffff","titleColor":"#ffffff","productId":15,"intro":"
$\"\"$ <\/p>\n","id":102,"sort":10,"pic":"{\"name\":\"bg.jpg\",\"url\":\"/upload/djmh/d77d74c0-0a0f-4971-9f5d-b58d8c5e64b8.jpg\"}","title":"应用广泛","content":"广泛适用于云手机、虚拟桌面、边缘计算、云游戏、云存储、区块链、多路视频编解码、应用多开等应用场景"}],"seoContent":"","subName":"","attachCode":"[{\"num\":1,\"name\":\"RK356X/RK3588 RKNN SDK\",\"fileName\":\"bus3.png\",\"fileUrl\":\"/upload/dsjyjy/06d150ba-69d8-4958-8eb6-61345b1983f7.png\"}]","intro":"","attachSource":"[]","attachSystem":"[{\"num\":1,\"name\":\"RK驱动助手\",\"fileName\":\"RKDevTool_Release_v3.31.zip\",\"fileUrl\":\"/upload/djmh/4fd3a697-6dcd-49f7-9905-879f409568d0.zip\"}]","name":"CSR2-N72R3588S","id":15,"extentField":[{"fieldName":"是否新品（1是0否）","fieldKey":"isNew","fieldValue":""}],"attr":"[{\"uid\":\"vc-upload-1734591801573-5\",\"xhr\":{},\"size\":796477,\"response\":{\"result\":{\"name\":\"72节点576核云手机服务器 - CSR2-N72R3588S - 产品介绍.pdf\",\"url\":\"/upload/djmh/dba88c91-17db-420f-a2bb-a063c377f0b7.pdf\"},\"status\":1,\"info\":\"操作成功\"},\"name\":\"72节点576核云手机服务器 - CSR2-N72R3588S - 产品介绍.pdf\",\"lastModified\":1734592311184,\"type\":\"application/pdf\",\"percent\":100,\"originFileObj\":{\"uid\":\"vc-upload-1734591801573-5\"},\"status\":\"done\"}]","categoryId":8},"status":1,"info":"操作成功"}

资料下载

服务器

主机

CSR2-N72R3588S产品规格书

CSR2-N72R3588S
产品规格书