Skip to content

Commit

Permalink
The officially supported compilation environment is Ubuntu Jammy 22.0…
Browse files Browse the repository at this point in the history
…4.x amd64 only
  • Loading branch information
carbonfix committed Nov 21, 2023
1 parent 8c67840 commit 35f9a79
Show file tree
Hide file tree
Showing 3 changed files with 7 additions and 172 deletions.
58 changes: 1 addition & 57 deletions README-ja.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,46 +34,9 @@ Milk-V DuoはCV1800Bをベースにした超小型の組み込みプラットフ

## コンパイル環境の準備

- ローカルのUbuntuを使う場合`Ubuntu 20.04 LTS`をお勧めします。
<br>
(仮想マシンにインストールされたUbuntuやWSLやUbuntuのDockerも使えます。)
- 公式にサポートされているコンパイル環境は、`Ubuntu Jammy 22.04.x amd64` のみです。
- `mobaXterm`とか`Xshell`のようなシリアルポートツールをインストールしてください

### Ubuntu 20.04 LTSに必要なツール

依存関係をコンパイルするためにインストールするもの

```bash
sudo apt install -y pkg-config build-essential ninja-build automake autoconf libtool wget curl git gcc libssl-dev bc slib squashfs-tools android-sdk-libsparse-utils jq python3-distutils scons parallel tree python3-dev python3-pip device-tree-compiler ssh cpio fakeroot libncurses5 flex bison libncurses5-dev genext2fs rsync unzip dosfstools mtools tclsh ssh-client android-sdk-ext4-utils
```

注意: `cmake`は最低でも`3.16.5`以降が必要です。

システムにインストールされている`cmake`のバージョンを確認してください

```bash
cmake --version
```

`Ubuntu 20.04`のaptでデフォルトでインストールされている`cmake`のバージョンは

```text
cmake version 3.16.3
```
です。条件を満たしていないので手動で最新の`cmake`をインストールしてください

```bash
wget https://github.com/Kitware/CMake/releases/download/v3.27.6/cmake-3.27.6-linux-x86_64.sh
chmod +x cmake-3.27.6-linux-x86_64.sh
sudo sh cmake-3.27.6-linux-x86_64.sh --skip-license --prefix=/usr/local/
```

手動でインストールした`cmake``/usr/local/bin`に配置されます。`cmake --version`すると以下のように出力されるはずです。

```
cmake version 3.27.6
```

### Ubuntu 22.04 LTSに必要なツール

依存関係をコンパイルするためにインストールするもの
Expand All @@ -82,25 +45,6 @@ cmake version 3.27.6
sudo apt install -y pkg-config build-essential ninja-build automake autoconf libtool wget curl git gcc libssl-dev bc slib squashfs-tools android-sdk-libsparse-utils jq python3-distutils scons parallel tree python3-dev python3-pip device-tree-compiler ssh cpio fakeroot libncurses5 flex bison libncurses5-dev genext2fs rsync unzip dosfstools mtools tcl openssh-client cmake
```

SDKのmkimageコマンドは`libssl1.1`に依存しています。`dpkg -s libssl1.1`でインストールされているか確認してください

インストールされていない場合、2通りの方法でインストールできます。

1. 追加のリポジトリからインストール

```bash
echo "deb http://security.ubuntu.com/ubuntu focal-security main" | sudo tee /etc/apt/sources.list.d/focal-security.list
sudo apt update
sudo apt install libssl1.1
```

2. debパッケージを手動でダウンロードしてインストール

```bash
wget http://archive.ubuntu.com/ubuntu/pool/main/o/openssl/libssl1.1_1.1.0g-2ubuntu4_amd64.deb
sudo dpkg -i libssl1.1_1.1.0g-2ubuntu4_amd64.deb
```

## イメージのコンパイル

### SDKのソースコードをダウンロード
Expand Down
60 changes: 3 additions & 57 deletions README-zh.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,71 +34,17 @@ Milk-V Duo是一个基于CV1800B芯片的超紧凑嵌入式开发平台。它可

## 准备编译环境

- 使用本地的Ubuntu系统,推荐 `Ubuntu 20.04 LTS`
<br>
(也可以使用虚拟机中的Ubuntu系统、Windows中WSL安装的Ubuntu、基于Docker的Ubuntu系统)
- 使用本地的Ubuntu系统,官方支持的编译环境是 `Ubuntu Jammy 22.04.x amd64`
- 安装串口工具: `mobarXterm` 或者 `Xshell` 或者其他。

### Ubuntu 20.04 LTS 下需要安装的工具
### Ubuntu 22.04 LTS 下需要安装的工具包

安装编译依赖的工具:

```
sudo apt install -y pkg-config build-essential ninja-build automake autoconf libtool wget curl git gcc libssl-dev bc slib squashfs-tools android-sdk-libsparse-utils jq python3-distutils scons parallel tree python3-dev python3-pip device-tree-compiler ssh cpio fakeroot libncurses5 flex bison libncurses5-dev genext2fs rsync unzip dosfstools mtools tclsh ssh-client android-sdk-ext4-utils
```

注意:`cmake` 版本最低要求 `3.16.5`

查看系统中 `cmake` 的版本号

```bash
cmake --version
```

当前`Ubuntu 20.04`中用 apt 安装的 cmake 版本号为

```text
cmake version 3.16.3
```

不满足此SDK最低要求,需要手动安装目前最新的`3.27.6`版本

```
wget https://github.com/Kitware/CMake/releases/download/v3.27.6/cmake-3.27.6-linux-x86_64.sh
chmod +x cmake-3.27.6-linux-x86_64.sh
sudo sh cmake-3.27.6-linux-x86_64.sh --skip-license --prefix=/usr/local/
```
手动安装的`cmake``/usr/local/bin`中,此时用`cmake --version`命令查看其版本号, 应为

```
cmake version 3.27.6
```

### Ubuntu 22.04 LTS 下需要安装的工具

安装编译依赖的工具:
安装编译依赖的工具包:

```bash
sudo apt install -y pkg-config build-essential ninja-build automake autoconf libtool wget curl git gcc libssl-dev bc slib squashfs-tools android-sdk-libsparse-utils jq python3-distutils scons parallel tree python3-dev python3-pip device-tree-compiler ssh cpio fakeroot libncurses5 flex bison libncurses5-dev genext2fs rsync unzip dosfstools mtools tcl openssh-client cmake
```

另外,SDK中的mkimage命令依赖的`libssl1.1`,在 Ubuntu22.04 中已弃用,需要手动安装,以下两种方法都可以

1. 补源安装

```bash
echo "deb http://security.ubuntu.com/ubuntu focal-security main" | sudo tee /etc/apt/sources.list.d/focal-security.list
sudo apt update
sudo apt install libssl1.1
```

2. 手动下载deb包安装

```bash
wget http://archive.ubuntu.com/ubuntu/pool/main/o/openssl/libssl1.1_1.1.0g-2ubuntu4_amd64.deb
sudo dpkg -i libssl1.1_1.1.0g-2ubuntu4_amd64.deb
```

## 编译

### 获取SDK
Expand Down
61 changes: 3 additions & 58 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,72 +34,17 @@ Milk-V Duo is an ultra-compact embedded development platform based on the CV1800

## Prepare the Compilation Environment

- Using a local Ubuntu system, `Ubuntu 20.04 LTS` is recommended.
<br>
(You can also use Ubuntu installed in a virtual machine, Ubuntu installed through WSL on Windows, or Ubuntu-based systems using Docker)
- Using a local Ubuntu system, the officially supported compilation environment is `Ubuntu Jammy 22.04.x amd64` only!
- Install a serial port tool: `mobaXterm` or `Xshell` or others.

### Tools to be installed on Ubuntu 20.04 LTS
### Packages to be installed on Ubuntu 22.04 LTS

Install the tools that compile dependencies:

```bash
sudo apt install -y pkg-config build-essential ninja-build automake autoconf libtool wget curl git gcc libssl-dev bc slib squashfs-tools android-sdk-libsparse-utils jq python3-distutils scons parallel tree python3-dev python3-pip device-tree-compiler ssh cpio fakeroot libncurses5 flex bison libncurses5-dev genext2fs rsync unzip dosfstools mtools tclsh ssh-client android-sdk-ext4-utils
```

Note:`cmake` minimum version requirement is `3.16.5`

Check the version of `cmake` in the system

```bash
cmake --version
```

The version of `cmake` installed using apt in the current `Ubuntu 20.04` is

```text
cmake version 3.16.3
```

The minimum requirement of this SDK is not met. Manual installation of the latest version `3.27.6` is needed.

```bash
wget https://github.com/Kitware/CMake/releases/download/v3.27.6/cmake-3.27.6-linux-x86_64.sh
chmod +x cmake-3.27.6-linux-x86_64.sh
sudo sh cmake-3.27.6-linux-x86_64.sh --skip-license --prefix=/usr/local/
```

When manually installed, `cmake` is located in `/usr/local/bin`. To check its version, use the command `cmake --version`, which should display

```
cmake version 3.27.6
```

### Tools to be installed on Ubuntu 22.04 LTS

Install the tools that compile dependencies:
Install the packages that compile dependencies:

```bash
sudo apt install -y pkg-config build-essential ninja-build automake autoconf libtool wget curl git gcc libssl-dev bc slib squashfs-tools android-sdk-libsparse-utils jq python3-distutils scons parallel tree python3-dev python3-pip device-tree-compiler ssh cpio fakeroot libncurses5 flex bison libncurses5-dev genext2fs rsync unzip dosfstools mtools tcl openssh-client cmake
```
Additionally, the mkimage command in the SDK relies on `libssl1.1`. Sometimes the system won't contain that because it has been deprecated, use `dpkg -s libssl1.1` to check if you have installed it.

If not, the following two methods are both applicable:

1. Installation with additional repositories

```bash
echo "deb http://security.ubuntu.com/ubuntu focal-security main" | sudo tee /etc/apt/sources.list.d/focal-security.list
sudo apt update
sudo apt install libssl1.1
```

2. Manual download and installation of the deb package

```bash
wget http://archive.ubuntu.com/ubuntu/pool/main/o/openssl/libssl1.1_1.1.0g-2ubuntu4_amd64.deb
sudo dpkg -i libssl1.1_1.1.0g-2ubuntu4_amd64.deb
```
### Compiling with Windows Linux Subsystem (WSL)

If you wish to perform the compilation with WSL, there's an small issue building the image.
Expand Down

0 comments on commit 35f9a79

Please sign in to comment.