diff --git a/docs/source/bsp/arm64/rk3568/RKDevTool1.png b/docs/source/bsp/arm64/rk3568/RKDevTool1.png new file mode 100644 index 0000000000000000000000000000000000000000..6e2058c568e35032432398006a17214cc5a9f772 Binary files /dev/null and b/docs/source/bsp/arm64/rk3568/RKDevTool1.png differ diff --git a/docs/source/bsp/arm64/rk3568/add_partition.png b/docs/source/bsp/arm64/rk3568/add_partition.png new file mode 100644 index 0000000000000000000000000000000000000000..755ab8d8186548bbd612175cbd77dd70e0f029d9 Binary files /dev/null and b/docs/source/bsp/arm64/rk3568/add_partition.png differ diff --git a/docs/source/bsp/arm64/rk3568/choose_partition.png b/docs/source/bsp/arm64/rk3568/choose_partition.png new file mode 100644 index 0000000000000000000000000000000000000000..ae595ce8d741aaf33dc5aa73c5c21f626d6d2cdd Binary files /dev/null and b/docs/source/bsp/arm64/rk3568/choose_partition.png differ diff --git a/docs/source/bsp/arm64/rk3568/compare_rootfs_address.png b/docs/source/bsp/arm64/rk3568/compare_rootfs_address.png new file mode 100644 index 0000000000000000000000000000000000000000..5d7d2957e3ea41cc3909cdb5f055fc3f5c724b23 Binary files /dev/null and b/docs/source/bsp/arm64/rk3568/compare_rootfs_address.png differ diff --git a/docs/source/bsp/arm64/rk3568/console1.png b/docs/source/bsp/arm64/rk3568/console1.png new file mode 100644 index 0000000000000000000000000000000000000000..5d6f118d4d50744f8bc4741113a2883038307f99 Binary files /dev/null and b/docs/source/bsp/arm64/rk3568/console1.png differ diff --git a/docs/source/bsp/arm64/rk3568/console2.png b/docs/source/bsp/arm64/rk3568/console2.png new file mode 100644 index 0000000000000000000000000000000000000000..1a43b9cf8882351d0b6d65bc4d301f8f2f252138 Binary files /dev/null and b/docs/source/bsp/arm64/rk3568/console2.png differ diff --git a/docs/source/bsp/arm64/rk3568/console_link.png b/docs/source/bsp/arm64/rk3568/console_link.png new file mode 100644 index 0000000000000000000000000000000000000000..25e2197d8c2b487453308011128dbf523815ae22 Binary files /dev/null and b/docs/source/bsp/arm64/rk3568/console_link.png differ diff --git a/docs/source/bsp/arm64/rk3568/device_parted_scan.png b/docs/source/bsp/arm64/rk3568/device_parted_scan.png new file mode 100644 index 0000000000000000000000000000000000000000..cedbfe21c1190c807038a740a2ad41883f376428 Binary files /dev/null and b/docs/source/bsp/arm64/rk3568/device_parted_scan.png differ diff --git a/docs/source/bsp/arm64/rk3568/ifconfig.png b/docs/source/bsp/arm64/rk3568/ifconfig.png new file mode 100644 index 0000000000000000000000000000000000000000..b71c1f9279301e9dc745e193c3b10c7d9998d260 Binary files /dev/null and b/docs/source/bsp/arm64/rk3568/ifconfig.png differ diff --git a/docs/source/bsp/arm64/rk3568/index.rst b/docs/source/bsp/arm64/rk3568/index.rst new file mode 100644 index 0000000000000000000000000000000000000000..753e10f780c8e335a0e3f14a737cf3b68bde2f6d --- /dev/null +++ b/docs/source/bsp/arm64/rk3568/index.rst @@ -0,0 +1,11 @@ +.. _board_rk3568: + + +RK3568 +################################# + + +.. toctree:: + :maxdepth: 1 + + rk3568.rst diff --git a/docs/source/bsp/arm64/rk3568/install_driver1.png b/docs/source/bsp/arm64/rk3568/install_driver1.png new file mode 100644 index 0000000000000000000000000000000000000000..206a58067839593f323a498d6d69d90698a91874 Binary files /dev/null and b/docs/source/bsp/arm64/rk3568/install_driver1.png differ diff --git a/docs/source/bsp/arm64/rk3568/install_driver2.png b/docs/source/bsp/arm64/rk3568/install_driver2.png new file mode 100644 index 0000000000000000000000000000000000000000..dc37f038234d87addf2abd279fef5bada0415c30 Binary files /dev/null and b/docs/source/bsp/arm64/rk3568/install_driver2.png differ diff --git a/docs/source/bsp/arm64/rk3568/install_driver3.png b/docs/source/bsp/arm64/rk3568/install_driver3.png new file mode 100644 index 0000000000000000000000000000000000000000..8297c1980835fa9822f70e8a93d3da61816b039b Binary files /dev/null and b/docs/source/bsp/arm64/rk3568/install_driver3.png differ diff --git a/docs/source/bsp/arm64/rk3568/rk3568.rst b/docs/source/bsp/arm64/rk3568/rk3568.rst new file mode 100644 index 0000000000000000000000000000000000000000..86cae868446132077b3b3e428c14c04c93758d55 --- /dev/null +++ b/docs/source/bsp/arm64/rk3568/rk3568.rst @@ -0,0 +1,215 @@ +.. _board_rk3568_build: + +RK3568板卡镜像构建与使用 +###################################### + +本章主要介绍openEuler Embedded中RK3568系列板卡的构建,使用和特性介绍。 + +RK3568镜像构建指导 +*********************************** + +**构建指导** + +- 参照 :ref:`openeuler_embedded_oebuild` 完成oebuild安装,并详细了解构建过程 + +- 依次执行以下命令完成构建 + + .. code-block:: console + + # 生成ok3568配置文件 + oebuild generate -p ok3568 + + #或生成ryd-3568配置文件 + oebuild generate -p ryd-3568 + + # 进入构建交互终端 + oebuild bitbake + + # 构建镜像 + bitbake openeuler-image + + # 构建sdk + bitbake openeuler-image -c populate_sdk + +- 二进制介绍: + + 1. Image: 飞凌ok3568内核镜像 + + 2. openeuler-glibc-x86_64-openeuler-image-aarch64-ok3568-toolchain-22.09\*.sh: SDK工具链 + + 3. boot\*.img: openEuler Embedded 适用ok3568内核镜像 + + 4. openeuler-image-ok3568-\*.rootfs.ext4: 适用ok3568根文件系统 + +镜像使用方法 +*********************************** + +1.镜像使用 + +1) 镜像烧录前查看/修改文件 + +创建挂载目录 + +.. code-block:: console + + mkdir ${WORKDIR}/rootfs + +挂载rootfs + +.. code-block:: console + + mount -t ext4 openeuler-image-ok3568-\*.rootfs.ext4 ${WORKDIR}/rootfs + +挂载完成后,可以查看OK3568根文件系统的文件。 + +2.镜像烧录: + +- windows + + 将文件DriverAssitant_v5.11.zip解压到任意目录,以管理员权限运行打开DriverInstall.exe 程序,然后点击“驱动安装”进行安装。 + +.. image:: install_driver1.png + +.. image:: install_driver2.png + +.. image:: install_driver3.png + +内核镜像和文件系统烧写方法 +*********************************** + +1. 将瑞芯微开发工具RKDevTool_Release.zip解压到全英文路径下,打开瑞芯微开发工具RKDevTool,使用 Type-C 线连接开发板和主机,按住开发板的 Recovery键不要松开,然后按下 RESET键系统复位,大约两秒后松开 Recovery键,瑞芯微开发工具 RKDevTool_将提示发现 LOADER设备。 + +.. image:: switch_turn_to_off.png + +.. image:: RKDevTool1.png + +2. 点击“设备分区表”按钮,将自动读取分区地址。会有某些分区读不到的提示,点击确定即可。 + +.. image:: device_parted_scan.png + +在地址栏右键选择添加项,添加文件系统的地址。 + +.. image:: add_partition.png + +.. image:: compare_rootfs_address.png + +3. 勾选Boot和rootfs,并选择Boot和rootfs的路径。 + +.. image:: choose_partition.png + +4. 点击“执行”按钮将自动烧写内核和文件系统,并重新启动。 + +.. image:: start_burning.png + +基于openEuler Embedded OK3568使用 +********************************************** + +启用OK3568 +*********************************** + +硬件版本要求:飞凌OK3568 + +默认用户名:root,密码:第一次启动没有默认密码,需重新配置,且密码强度有相应要求, 需要数字、字母、特殊字符组合最少8位,例如openEuler@2021。 + +将刷写镜像后的OK3568核心板通电启用。 + +**OK3568登录方式** + +1.本地登录 + +a.使用串口登录: + +镜像使能了串口登录功能,按照ok3568的串口连接方式,如下图,可以启用串口操作。 + +示例:使用ttyusb转接器,将OK3568的串口通过USB连接到putty: + +.. image:: console_link.png + +b.使用HDMI登录: + +OK3568连接显示器(OK3568视频输出接口为HDMI)、键盘、鼠标后,启动OK3568,可以看到OK3568启动日志输出到显示器上。待ok3568启动成功,输入用户名(root)和密码登录。 + +2.ssh 远程登录 + +**网络配置** + +**启动后无线网卡配置** + +使用终端连接工具通过串口连接开发板 + +.. image:: console1.png + +.. image:: console2.png + +使用wpa_passphrase 工具将wifi密码加密,生成配置 + +执行命令: + +wpa_passphrase + +.. image:: wpa_passphrase.png + +将生成的配置写入配置文件/etc/wpa_supplicant.conf: + +执行命令: + +.. code-block:: console + + vi /etc/wpa_supplicant.conf + +.. image:: wpa_supplicant.png + +**启用wifi网卡** + +执行命令: + +.. code-block:: console + + ifup mlan0 + +启用wifi网卡后,会自动生成IP,可直接查看网卡信息。 + +执行命令:ifconfig + +.. image:: ifconfig.png + +使用ssh命令登录: + +.. code-block:: console + + ssh root@x.x.x.x + +**分区扩容** + +默认根目录分区空间比较小,在使用之前,需要对分区进行扩容(在23.03及其之后的版本中,已实现自动扩容,首次烧录镜像启动会自动执行扩容并提示重启) + +以下为手动扩容方法 + +- 查看磁盘分区信息 + +执行 fdisk -l 命令查看磁盘分区信息。回显如下: + +.. code-block:: console + + Number Start (sector) End (sector) Size Name + 1 16384 24575 4096K uboot + 2 24576 32767 4096K misc + 3 32768 98303 32.0M boot + 4 98304 163839 32.0M recovery + 5 163840 229375 32.0M backup + 6 229376 12812287 6144M rootfs + 7 12812288 13074431 128M oem + 8 13074432 30777279 8643M userdata + +对应数据分区为 rootfs,与userdata + +ok3568镜像特性介绍 +************************** + +1.ok3568硬件特性,参考:RK3568手册GPIO + + 目前已使能串口设备,可以访问uart,其他硬件特性目前支持、无线网卡、GPU、TF卡、以太网卡、USB Host、SPI、HDMI。 + +2.支持百级嵌入式软件包,见软件包功能列表。 + +3.支持部署rt实时内核。 \ No newline at end of file diff --git a/docs/source/bsp/arm64/rk3568/start_burning.png b/docs/source/bsp/arm64/rk3568/start_burning.png new file mode 100644 index 0000000000000000000000000000000000000000..1182c137180904d11600b6eb7fda3fe761db91b5 Binary files /dev/null and b/docs/source/bsp/arm64/rk3568/start_burning.png differ diff --git a/docs/source/bsp/arm64/rk3568/switch_turn_to_off.png b/docs/source/bsp/arm64/rk3568/switch_turn_to_off.png new file mode 100644 index 0000000000000000000000000000000000000000..265319f2d8d60aa5a1f619f3bb8921c4f72bb52f Binary files /dev/null and b/docs/source/bsp/arm64/rk3568/switch_turn_to_off.png differ diff --git a/docs/source/bsp/arm64/rk3568/wpa_passphrase.png b/docs/source/bsp/arm64/rk3568/wpa_passphrase.png new file mode 100644 index 0000000000000000000000000000000000000000..11de945145abc6da4a913358d3adb6a81c191880 Binary files /dev/null and b/docs/source/bsp/arm64/rk3568/wpa_passphrase.png differ diff --git a/docs/source/bsp/arm64/rk3568/wpa_supplicant.png b/docs/source/bsp/arm64/rk3568/wpa_supplicant.png new file mode 100644 index 0000000000000000000000000000000000000000..759f2b7bda1928d24e0301a203a57f7fb35237f0 Binary files /dev/null and b/docs/source/bsp/arm64/rk3568/wpa_supplicant.png differ