【OpenBMC】的内部README 模板

OpenBMC

本项目的AST2500分支核心代码的机型是ast2500-default，克隆代码后进入编译环境的命令为：
source setup ast2500-default

一、源码下载、配置以及编译

重要：请参阅confluence 详细步骤

二、代码使用方法

目前所有自定义修改的代码均在build/ast2500-default/workspace 目录完成，选择此目录可以避免和官网源代码混淆，同时此目录进行了版本控制（会进行提交，代码的忽略规则具体看主目录的.gitignore文件）

在build/ast2500-default/workspace目录下
所有新增的自定义配置文件均在目录：

recipes-phosphor

所有自定义修改过的源码在目录：

sources    #存放源码
appends	   #存放源码对应的编译文件.bbappend

1) 上传未在版本库管理的源码

devtool modify 可以把源码导出到sources 目录，并且在appends目录生成相应的.bbappend文件，为了比例执行git status出现大量无关紧要的记录，这两个目录默认都不在版本控制中，是被忽略的，如果需要上传新的源码，需要首先在.gitignore文件放开忽略

具体怎么做，假如要上传代码bmcweb
1.导出代码：devtool modify bmcweb，然后修改代码后编译并且升级验证通过；
2.放开忽略，修改主目录的[.gitignore]文件，添加如下五行：

#放开源码bmcweb
!build/ast2500-default/workspace/appends/bmcweb_git.bbappend    #放开.bbappend
!build/ast2500-default/workspace/sources/bmcweb/				  #放开源码目录
build/ast2500-default/workspace/sources/bmcweb/oe-logs			#屏蔽源码目录的oe-logs软链接，编译的时候会自动生成
build/ast2500-default/workspace/sources/bmcweb/oe-workdir         #屏蔽源码目录的oe-workdir软链接，编译的时候会自动生成

然后使用git status，bmcweb可以add了，之后使用git正常add、commit、push即可，下载再修改其中的代码只需add相应的文件即可。

2) 修改版本号

修改 build/ast2500-default/conf/local.conf 文件的VOPENBMC 变量。

# openbmc 版本号
VOPENBMC = "ast.1.1"

3）修改默认的静态IP

修改 build/ast2500-default/workspace/recipes-phosphor/network/systemd-conf/00-bmc-eth0.network文件的Address和Gateway项。
Address为默认静态IP地址，Gateway为默认IP地址的网关，需要对应上。

Address=172.31.1.55/24
Gateway=172.31.1.1

放在北京实验室机房中，172.31.1.xx 网段的地址，网关需要设置为Gateway=172.31.1.1，24为子网掩码对应255.255.255.0
放在北京办公位，IP地址需要设置192.168.2.xx网段，网关Gateway=192.168.2.254

了解更多官方文档

• OpenBMC 文档 存储库，深入了解 OpenBMC。
• 电子邮件：openbmc@lists.ozlabs.org https://lists.ozlabs.org/listinfo/openbmc
• Discord：https://discord.gg/69Km47zH98