coolsnowwolf-lede/README.md

179 lines
6.3 KiB
Markdown
Raw Permalink Normal View History

2022-09-28 19:47:22 +08:00
# 欢迎来到 Lean 的 LEDE 源码仓库
2024-09-11 23:08:24 +08:00
为国产龙芯 LOONGSON SoC loongarch64 / 飞腾 Phytium 腾锐 D2000 系列架构添加支持
2024-01-15 01:40:12 +08:00
2023-12-08 15:09:24 +08:00
I18N: [English](README_EN.md) | [简体中文](README.md) | [日本語](README_JA.md)
2022-08-04 19:32:08 +08:00
## 官方讨论群
2023-10-07 22:00:16 +08:00
2022-08-04 19:32:08 +08:00
如有技术问题需要讨论或者交流,欢迎加入以下群:
2023-10-07 22:00:16 +08:00
1. QQ 讨论群Op 固件技术研究群,号码 891659613加群链接[点击加入](https://qm.qq.com/q/IMa6Yf2SgC "Op固件技术研究群")
2024-09-11 23:08:24 +08:00
2. TG 讨论群OP 编译官方大群,加群链接:[点击加入](https://t.me/JhKgAA6Hx1 "OP 编译官方大群")
2022-10-12 00:46:48 +08:00
## 软路由 ArmSoM Sige 系列介绍
2023-09-09 23:45:24 +08:00
ArmSoM-Sige 系列:软路由、单板计算机、小型服务器与智能家居的全能之选。
2022-08-04 19:32:08 +08:00
2024-02-17 23:03:08 +08:00
[商品介绍页面 - ArmSom 品牌店](https://shop518100695.taobao.com/)
2023-09-09 23:45:24 +08:00
购买链接:
[![sige1-zh](doc/sige-zh.jpg)](https://item.taobao.com/item.htm?id=721197662185)
2023-06-09 03:22:36 +08:00
## 注意
2022-03-23 12:04:03 +08:00
1. **不要用 root 用户进行编译**
2. 国内用户编译前最好准备好梯子
3. 默认登陆IP 192.168.1.1 密码 password
## 编译命令
2021-01-24 20:03:22 +08:00
2024-02-17 23:03:08 +08:00
1. 首先装好 Linux 系统,推荐 Debian 或 Ubuntu LTS
2. 安装编译依赖
```bash
sudo apt update -y
sudo apt full-upgrade -y
2023-04-11 23:08:30 +08:00
sudo apt install -y ack antlr3 asciidoc autoconf automake autopoint binutils bison build-essential \
bzip2 ccache clang cmake cpio curl device-tree-compiler flex gawk gcc-multilib g++-multilib gettext \
genisoimage git gperf haveged help2man intltool libc6-dev-i386 libelf-dev libfuse-dev libglib2.0-dev \
libgmp3-dev libltdl-dev libmpc-dev libmpfr-dev libncurses5-dev libncursesw5-dev libpython3-dev \
libreadline-dev libssl-dev libtool llvm lrzsz msmtp ninja-build p7zip p7zip-full patch pkgconf \
python3 python3-pyelftools python3-setuptools qemu-utils rsync scons squashfs-tools subversion \
swig texinfo uglifyjs upx-ucl unzip vim wget xmlto xxd zlib1g-dev
```
3. 下载源代码,更新 feeds 并选择配置
```bash
git clone https://github.com/coolsnowwolf/lede
cd lede
./scripts/feeds update -a
./scripts/feeds install -a
make menuconfig
```
4. 下载 dl 库,编译固件
-j 后面是线程数,第一次编译推荐用单线程)
2020-03-25 11:06:38 +08:00
```bash
make download -j8
make V=s -j1
```
本套代码保证肯定可以编译成功。里面包括了 R24 所有源代码,包括 IPK 的。
你可以自由使用,但源码编译二次发布请注明我的 GitHub 仓库链接。谢谢合作!
2020-03-25 11:06:38 +08:00
二次编译:
```bash
cd lede
git pull
./scripts/feeds update -a
./scripts/feeds install -a
make defconfig
make download -j8
make V=s -j$(nproc)
```
如果需要重新配置:
```bash
2023-10-07 22:00:16 +08:00
rm -rf .config
make menuconfig
make V=s -j$(nproc)
```
2020-03-25 11:06:38 +08:00
编译完成后输出路径bin/targets
2020-03-25 11:06:38 +08:00
2023-10-07 22:00:16 +08:00
### 使用 WSL/WSL2 进行编译
由于 WSL 的 PATH 中包含带有空格的 Windows 路径,有可能会导致编译失败,请在 `make` 前面加上:
2021-07-19 20:57:32 +08:00
```bash
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
2021-07-19 20:57:32 +08:00
```
由于默认情况下,装载到 WSL 发行版的 NTFS 格式的驱动器将不区分大小写,因此大概率在 WSL/WSL2 的编译检查中会返回以下错误:
```txt
2023-10-07 22:00:16 +08:00
Build dependency: OpenWrt can only be built on a case-sensitive filesystem
```
一个比较简洁的解决方法是,在 `git clone` 前先创建 Repository 目录,并为其启用大小写敏感:
```powershell
# 以管理员身份打开终端
PS > fsutil.exe file setCaseSensitiveInfo <your_local_lede_path> enable
# 将本项目 git clone 到开启了大小写敏感的目录 <your_local_lede_path> 中
2024-02-17 23:03:08 +08:00
PS > git clone https://github.com/coolsnowwolf/lede <your_local_lede_path>
```
> 对已经 `git clone` 完成的项目目录执行 `fsutil.exe` 命令无法生效,大小写敏感只对新增的文件变更有效。
### macOS 原生系统进行编译
1. 在 AppStore 中安装 Xcode
2022-03-28 20:13:47 +08:00
2. 安装 Homebrew
```bash
2024-09-11 23:08:24 +08:00
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```
2022-03-28 20:13:47 +08:00
2024-09-11 23:08:24 +08:00
3. 使用 Homebrew 安装工具链、依赖与基础软件包:
2022-03-28 20:13:47 +08:00
```bash
brew unlink awk
brew install coreutils diffutils findutils gawk gnu-getopt gnu-tar grep make ncurses pkg-config wget quilt xz
brew install gcc@11
```
2022-03-28 20:13:47 +08:00
4. 然后输入以下命令,添加到系统环境变量中:
2022-03-28 20:13:47 +08:00
- intel 芯片的 mac
```bash
echo 'export PATH="/usr/local/opt/coreutils/libexec/gnubin:$PATH"' >> ~/.bashrc
echo 'export PATH="/usr/local/opt/findutils/libexec/gnubin:$PATH"' >> ~/.bashrc
echo 'export PATH="/usr/local/opt/gnu-getopt/bin:$PATH"' >> ~/.bashrc
echo 'export PATH="/usr/local/opt/gnu-tar/libexec/gnubin:$PATH"' >> ~/.bashrc
echo 'export PATH="/usr/local/opt/grep/libexec/gnubin:$PATH"' >> ~/.bashrc
echo 'export PATH="/usr/local/opt/gnu-sed/libexec/gnubin:$PATH"' >> ~/.bashrc
echo 'export PATH="/usr/local/opt/make/libexec/gnubin:$PATH"' >> ~/.bashrc
```
2024-09-11 23:08:24 +08:00
- apple 芯片的 mac
2024-09-11 23:08:24 +08:00
```zsh
echo 'export PATH="/opt/homebrew/opt/coreutils/libexec/gnubin:$PATH"' >> ~/.bashrc
echo 'export PATH="/opt/homebrew/opt/findutils/libexec/gnubin:$PATH"' >> ~/.bashrc
echo 'export PATH="/opt/homebrew/opt/gnu-getopt/bin:$PATH"' >> ~/.bashrc
echo 'export PATH="/opt/homebrew/opt/gnu-tar/libexec/gnubin:$PATH"' >> ~/.bashrc
echo 'export PATH="/opt/homebrew/opt/grep/libexec/gnubin:$PATH"' >> ~/.bashrc
echo 'export PATH="/opt/homebrew/opt/gnu-sed/libexec/gnubin:$PATH"' >> ~/.bashrc
echo 'export PATH="/opt/homebrew/opt/make/libexec/gnubin:$PATH"' >> ~/.bashrc
```
2022-03-28 20:13:47 +08:00
5. 重新加载一下 shell 启动文件 `source ~/.bashrc`,然后输入 `bash` 进入 bash shell就可以和 Linux 一样正常编译了
## 特别提示
2021-07-19 20:57:32 +08:00
2024-02-17 23:03:08 +08:00
1. 源代码中绝不含任何后门和可以监控或者劫持你的 HTTPS 的闭源软件, SSL 安全是互联网最后的壁垒,安全干净才是固件应该做到的。
2022-08-04 19:32:08 +08:00
2. 想学习 OpenWrt 开发,但是摸不着门道?自学没毅力?基础太差?怕太难学不会?跟着佐大学 OpenWrt 开发入门培训班助你能学有所成
报名地址:[点击报名](http://forgotfun.org/2018/04/openwrt-training-2018.html "报名")
2022-08-04 19:32:08 +08:00
3. QCA IPQ60xx 开源仓库地址:<https://github.com/coolsnowwolf/openwrt-gl-ax1800>
2020-05-14 15:22:39 +08:00
2022-08-04 19:32:08 +08:00
4. 存档版本仓库地址:<https://github.com/coolsnowwolf/openwrt>
2020-05-14 15:20:50 +08:00
## 捐贈
2020-03-23 14:37:37 +08:00
如果你觉得此项目对你有帮助,可以捐助我们,以鼓励项目能持续发展,更加完善
2023-04-11 23:08:30 +08:00
![star](doc/star.png)