【授人鱼不如授人以渔】私人定制专属的RedPill-DSM7.X引导文件并添加扩展驱动（编译DSM7.X引导教程）

2020年10月14日更新：

【再次重申】

编译绝对不是一件容易的事，满足下面“编译要求”的可继续，不满足要求的请自觉放弃，否则连失败提示都看不懂的话没法玩了！

【编译是什么？】
        程序是靠人写出来的，人写出来的程序统称为“源代码”。“源代码”可以使用任意一个文本编辑工具打开查看，但是这个“源代码”只是人类能看懂，计算机系统是看不懂的（学过计算机基础的都知道：计算机只认识0和1），那么需要把“源代码”文件转换为计算机能“看懂"的文件，这个转换的过程就是“编译”。

【编译常见问题】
        正常情况下，编译DSM7.X引导，只需要简单敲几行命令，然后静静的等待编译完成，最快只需要几分钟就能出结果。但是，也不排除可能会遇到编译失败的情况，失败的原因有很多，比如：你在什么操作系统平台下操作、你搭建的编译环境、你修改的源代码是否正确、你使用的网络是否稳定、文件下载是否完整、可用的磁盘空间是否足够等等。
        如果你遇到编译失败时，请自行分析失败原因，往往需要个人有一定程度的技术经验积累才能解决失败。

【编译要求】
        熟练掌握计算机基础知识，对 Linux 系统有丰富的使用经验，并且具备一定程度的英语阅读理解能力，逻辑思维较强，有耐心。（小白劝退！）

【部署编译环境】
※一台安装好Linux操作系统的电脑，本教程使用的是用VMware安装的Ubuntu 20.04.1 64 位桌面版；理论上直接在群晖系统下也可以进行编译，如果你不用担心数据安全的话也可以这么做；
※这台Linux电脑可以畅通无阻的访问互联网，必须能正常访问github网站和google网站的，嘿嘿你懂的；
※在Linux系统中部署好编译环境。如果Linux系统还没部署好环境的，请复制以下命令到Ubuntu 中安装环境（命令很长，如果文章显示不齐的，请刷新一次），复制一条命令运行结束后再复制另外一条运行：

apt install gcc make git unzip wget xz-utils libsdl2-dev libsdl2-mixer-dev libfreeimage-dev libfreetype6-dev libcurl4-openssl-dev rapidjson-dev libasound2-dev libgl1-mesa-dev build-essential libboost-all-dev cmake fonts-droid-fallback libvlc-dev libvlccore-dev vlc-bin texinfo premake4 golang libssl-dev curl patchelf xmlstarlet default-jre xsltproc

apt-get update && apt-get install --yes --no-install-recommends ca-certificates build-essential git libssl-dev curl cpio bspatch vim gettext bc bison flex dosfstools kmod && rm -rf /var/lib/apt/lists/* /tmp/* && curl --progress-bar --output /usr/bin/jq --location https://github.com/stedolan/jq/releases/download/jq-1.6/jq-linux64 && chmod +x /usr/bin/jq

【源代码仓库】
※RedPill项目组官方原版引导的源代码仓库（不含内核文件，默认只支持DS3615xs_6.2.4-25556、DS3615xs_7.0-41222、DS918+_6.2.4-25556、DS918+_7.0-41890）：
https://github.com/RedPill-TTG/redpill-load

※RedPill项目组官方原版引导内核文件的源代码仓库（内核版本：redpill-linux-v3.10.105、redpill-linux-v3.10.108、redpill-linux-v4.4.59、redpill-linux-v4.4.180）：
https://github.com/RedPill-TTG/redpill-lkm

※RedPill项目组官方原版SAS硬盘的扩展驱动仓库：
https://github.com/RedPill-TTG/redpill-sas-activator

※tossp大神的RedPill引导一键编译源代码仓库（支持DS3615xs_6.2.4-25556、DS3615xs_7.0-41222、DS3615xs_7.0.1-42218、DS918+_6.2.4-25556、DS918+_7.0-41890、DS918+_7.0.1-42218）：
https://github.com/tossp/redpill-tool-chain

※pocopico大神的扩展驱动源代码仓库：
https://github.com/pocopico/rp-ext

※pocopico大神的DS3615xs_7.X扩展驱动成品仓库：
https://github.com/pocopico/3.10.108-modules

※pocopico大神的DS918+_7.X扩展驱动成品仓库：
https://github.com/pocopico/4.4.180plus-modules

【编译方法和优缺点】
        目前RedPill引导编译的方法大致有两种：一种是使用RedPill原版的源代码进行编译，优点是原汁原味+扩展性非常强（如果你是高手，可以随意定制属于你自己的东西），缺点是默认不支持7.01-42218版本（当然，如果你有能力的话可以自行添加对7.01版本支持的文件）；另外一种方法是使用其他大神维护的分支仓库进行编译，优点是操作简单（可以一键编译，大大降低劳动强度），缺点是可定制的东西不多（或者换句话说：我们也不会再去深入的折腾）。
        如果把编译引导文件的过程，比喻成盖一栋房子，那么你可以理解为：RedPill已经为我们搭建好了地基，至于你在地面上怎么加盖房子就看你的本事了！所以才有了很多大神在RedPill仓库的基础上建立了很多自己的分支，博主本次使用tossp大神的分支仓库进行一键编译当作教程，在此对RedPill项目组及上面提到的诸位大神表示衷心的感谢！

【编译步骤】
1、在电脑浏览器打开【tossp大神的RedPill引导一键编译源代码仓库】，在”Code“的三角形点出菜单，选择”Download ZIP“，打包源代码下载到本地电脑；

2、我这里给压缩包起的名字是”20211009“；

3、把压缩文件解压出来，得到一个文件夹“redpill-tool-chain-master”；

4、文件夹的名字太长了，把它再改个名字“20211009”，把这个文件夹复制；

5、到Ubuntu 20.04.1 64 位桌面版的主目录，我在主目录下建立了子文件夹，“20211009”粘贴到子文件夹下；

6、进入“20211009”文件夹，找到“sample_user_config.json”文件，右键，用文本编辑器打开；

7、里面默认的内容如下图；

8、根据自己实际情况，修改pid、vid、sn、mac1这四个参数，因为等下使用ESXI虚拟机安装，所以我只改了sn和mac1；

9、改好这四个参数，点下图三横线，在弹出的菜单选“另存为”；

10、名称这里写：apollolake_user_config.json（编译DS918+的引导，必须要用此文件名，不可以更改），保存；

11、看到显示的文件名变成“apollolake_user_config.json”就可以了；

12、如果需要编译DS3615xs的引导，在改好参数以后，选“另存为”；

13、名称这里写：bromolow_user_config.json（编译DS3615xs的引导，必须要用此文件名，不可以更改），保存；

14、看到显示的文件名变成“bromolow_user_config.json”就可以了；

15、已经建立好的两个文件：apollolake_user_config.json和bromolow_user_config.json；

16、找到redpill_tool_chain.sh文件，右键，属性；

17、把“上级文件夹”显示的内容全部选中，右键，复制（如果路径很长会显示不全，但最右边会显示有三个小点，复制的时候这三个小点也要一起复制）；

18、打开Ubuntu的终端，输入 sudo -i 回车；

19、输入当前Ubuntu 登录账号的密码，需要注意的是：输入密码的时候，屏幕上是没有东西显示出来的，不要以为是系统卡了；

20、输完密码后按回车键；

21、此时可以看到最左边显示为root@开头；

22、输入“cd”跟一个空格后，点右键，粘贴，此时自动把第17步骤复制的路径粘贴上去，回车；

23、路径已经切换到“20211009”下了；

24、再回到文件属性这里，把“redpill_tool_chain.sh”这个文件名复制一下；

25、输入“./”跟一个空格后，点右键，粘贴，此时自动把第24步骤复制的文件名粘贴上去；

26、回车；

27、此时会显示编译脚本的使用说明，使用非常简单，就是“./redpill_tool_chain 参数1 参数2”；
参数1包括：
（1）build ：为指定的DSM版本（通过参数2来控制）下载构建编译镜像；
（2）auto ：利用编译镜像全自动进行引导文件的编译工作（镜像自动启动，自动编译，编译完成后镜像自动关闭）；
（3）run ：利用编译镜像手动进行引导文件的编译工作（进入 Bash 终端交互式编译）；
（4）clean ：删除指定版本的DSM版本镜像（或者加all参数删除未使用的全部镜像文件）；
（5）add ：添加扩展驱动（需要在参数2添加上驱动的地址）；
（6）del ：删除已经添加的扩展驱动（需要在参数2添加上驱动名称）；
参数2包括：
（1）当参数1为前四种时，参数2可以选择：bromolow-6.2.4-25556、bromolow-7.0-41222、bromolow-7.0.1-42218、apollolake-6.2.4-25556、apollolake-7.0-41890、apollolake-7.0.1-42218的任意一种，bromolow分别对应的是DS3615xs，apollolake对应的是DS918+；
（2）当参数1为add 时，参数2为驱动程序的网页地址链接；
（3）当参数1为del 时，参数2为驱动程序的名称；

28、在电脑浏览器打开【pocopico大神的扩展驱动源代码仓库】，根据需要选择你要加入的驱动，本教程需要加入的是ESXI需要用的vmxnet3驱动程序和LSI 2308阵列卡需要用的mp2sas驱动程序；

29、先点mp2sas进入；

30、找到rpext-index.json文件，点击打开；

31、可以在源代码看到有ds3615xs_42218以及ds918_42218字样，表示该驱动程序支持7.01-42218版本（这里列出了什么版本，就表示什么版本可以用）；

32、点下图位置的Raw；

33、在浏览器地址栏中，全部选择，右键，复制；

34、输入"./redpill_tool_chain add"后，点右键粘贴，完整的命令是：

./redpill_tool_chain add https://raw.githubusercontent.com/pocopico/rp-ext/main/mpt2sas/rpext-index.json

35、回车，开始下载扩展驱动，下载成功会显示“Installation is complete！”；

36、用同样的方法，把vmxnet3的驱动程序地址复制出来；

37、粘贴上去，完整的命令是：

./redpill_tool_chain add https://raw.githubusercontent.com/pocopico/rp-ext/main/vmxnet3/rpext-index.json

38、回车，开始下载扩展驱动，下载成功会显示“Installation is complete！”；

39、添加好扩展驱动，输入命令开始构建DS918+_7.0.1-42218引导文件的编译镜像（构建成功显示如下图，如果出错会有红色字显示）：

./redpill_tool_chain build apollolake-7.0.1-42218

40、输入命令，全自动编译DS918+_7.0.1-42218引导文件；

./redpill_tool_chain auto apollolake-7.0.1-42218

41、耐心等待编译，此时会看到刚才下载的mpt2sas驱动和vmxnet3驱动已经被成功的添加进去，编译成功会显示“Creating Loader image at /opt/redpill-load/images/redpill-DS918+_7.0.1-42218*********.img...[OK]”的字样（如果编译出错，会有红色的信息显示）；

42、找到“20211009”的“images”文件夹，进入；

43、就看到编译出来的引导文件了；

44、复制出来，改好文件名，设置好ESXI虚拟机，我这里设置用UEFI方式引导，需要注意的是：在“是否为此虚拟机启用UEFI安全引导”这里不要打勾；

45、ESXI安装群晖的过程此处就不在重复了，需要学习的可以去查阅《VMware vSphere（ESXI）6.7安装黑群晖DS918-7.01教程（ESXI虚拟机安装群晖DS918-7.01保姆级教程）》；

46、进入群晖系统后，在存储空间管理员，可以看到阵列卡的硬盘都在呢；

47、建立好存储，复制个电影测试看看是否正常，结果非常满意！

【使用官方原码编译流程】
        由于使用RedPill官方原代码进行编译的步骤比较复杂，本文不做具体操作。大致的流程如下：

1、先使用https://github.com/RedPill-TTG/redpill-lkm源代码，编译出redpill-linux-v3.10.105.ko、redpill-linux-v3.10.108.ko、redpill-linux-v4.4.59+.ko、redpill-linux-v4.4.180+.ko这四个内核文件；

2、下载https://github.com/RedPill-TTG/redpill-load源代码到Linux系统中；

3、把编译好的四个内核文件复制到redpill-load源代码的ext/rp-lkm目录下；

4、把以下代码复制，并根据实际修改好pid、vid、sn、mac1这四个参数，保存到redpill-load源代码的目录下，文件命名为：user_config.json；

{
  "extra_cmdline": {
        "pid": "0x0001",
        "vid": "0x46f4",
        "sn": "1234XXX123",
        "mac1": "XXYYXXYYXXYY"
    },
    "synoinfo": {},
    "ramdisk_copy": {},
    "extensions": []
}

5、打开终端，切换到root用户，进入redpill-load源代码目录下；

6、添加扩展驱动，命令格式如下：

./ext-manager.sh add https://raw.githubusercontent.com/*******/rpext-index.json

7、开始编译DS918+：

./build-loader.sh "DS918+" "7.0-41890"

8、或者编译DS3615xs：

./build-loader.sh "DS3615xs" "7.0-41222"