1. 项目概述与核心价值最近在折腾一块国产化程度非常高的开发板——迅为电子的iTOP-LS2K0500。这块板子从CPU指令集到板上的每一个元器件都实现了100%的全国产化对于从事信创、嵌入式国产化替代或者单纯想了解龙芯生态的开发者来说是个非常不错的硬件平台。拿到开发板后第一道坎往往不是硬件本身而是搭建一个趁手、稳定的软件开发环境。官方资料里提供了一个已经搭建好编译环境的Ubuntu 20.04虚拟机镜像这能为我们省去大量配置依赖、安装交叉编译工具链的繁琐时间直接进入开发状态。今天这篇内容我就结合官方的指导文档和我自己实际操作的经历详细拆解一下如何从零开始在你的Windows电脑上把这个“开箱即用”的Ubuntu开发环境给跑起来。整个过程会涵盖虚拟机的安装、镜像的加载、以及初次登录后的基础确认目标是让你能无痛、高效地迈出使用iTOP-LS2K0500开发板的第一步。2. 环境准备虚拟机软件的选择与安装在加载官方Ubuntu镜像之前我们需要一个“容器”来运行它这就是虚拟机。虚拟机软件可以在你的Windows或macOS主机上模拟出一台完整的、独立的计算机我们在这台虚拟计算机里安装和运行Ubuntu系统从而与主机系统完全隔离避免环境冲突也方便随时备份和迁移。2.1 虚拟机软件选型为何是VMware Workstation市面上主流的虚拟机软件有VMware Workstation、VirtualBox等。官方资料推荐使用VMware我实测下来也倾向于这个选择原因有几个性能与兼容性VMware对硬件虚拟化的支持更成熟特别是对于需要直接调用CPU虚拟化指令如Intel VT-x/AMD-V的场景其性能损耗相对更小运行Ubuntu进行编译等重负载任务时更流畅。对于迅为提供的这个预配置镜像VMware的兼容性也经过了验证能确保所有预装工具和配置正常运作。快照与克隆功能这是开发者的“后悔药”和“复制机”。你可以在环境配置到完美状态时创建一个快照后续任何误操作导致环境崩溃都能一键回滚到这个干净状态。克隆功能则可以快速复制出多个相同的开发环境用于测试不同分支的代码非常高效。网络配置灵活VMware提供了NAT、桥接、仅主机等多种网络模式可以轻松配置虚拟机能上网、能与开发板通信、能与主机互访等复杂网络需求这对于嵌入式开发调试至关重要。当然VMware Workstation是商业软件需要许可证。官方提供了30天的试用期对于完成这个环境的搭建和初步探索是完全足够的。如果你有长期使用的需求可以考虑购买许可证或寻找其他合规的替代方案。2.2 VMware Workstation 15.5 安装实操详解官方资料包中提供了VMware 15.5的安装包你也可以从VMware官网下载更新版本如16.x。版本之间在基础功能上差异不大安装过程也大同小异。这里我以资料包中的VMware-workstation-full-15.5.0-14665864.exe为例一步步说明安装过程中的关键选择。步骤一启动安装与接受协议双击安装程序启动安装向导。第一个重要界面是“最终用户许可协议”。这里必须勾选“我接受许可协议中的条款”才能继续下一步。这是一个法律确认步骤务必阅读并理解。步骤二自定义安装路径接下来会让你选择安装位置。这里有一个非常重要的注意事项安装路径绝对不能包含中文或任何非ASCII字符如空格、特殊符号。最好保持默认路径通常是C:\Program Files (x86)\VMware\VMware Workstation\或者指定一个像D:\VMware这样的纯英文路径。路径中包含中文可能会导致虚拟机软件运行时出现各种难以排查的奇怪错误例如网络服务启动失败、虚拟机无法识别硬件等。步骤三用户体验设置这个界面通常会有两个复选框例如“启动时检查产品更新”和“加入VMware客户体验提升计划”。我的建议是取消勾选这两个选项。关闭自动更新可以避免在开发关键时期软件自动升级导致与现有虚拟机或工具的兼容性问题。客户体验计划则根据个人隐私偏好选择是否参与。步骤四创建快捷方式确保勾选“桌面”和“开始菜单程序文件夹”的复选框这样安装完成后你能方便地从桌面或开始菜单启动VMware提高日常使用效率。步骤五执行安装与完成确认上述设置后点击“安装”按钮。安装过程会自动进行期间可能会提示安装Windows相关的驱动和组件一律点击“是”或“允许”即可。安装完成后点击“完成”按钮退出向导。此时你的桌面上应该会出现“VMware Workstation Pro”的图标。步骤六首次运行与许可证首次双击桌面图标运行VMware时软件会提示你输入许可证密钥。如果你已经购买在此处输入即可激活。如果没有请务必选择“我希望试用VMware Workstation 15 30天”这个选项然后点击“继续”。这样你就可以获得30天的完整功能试用期。点击“完成”后你将看到VMware Workstation的主界面这意味着虚拟机平台已经准备就绪。注意安装过程中Windows Defender或第三方杀毒软件可能会弹出警告询问是否允许VMware相关驱动或服务进行更改。请务必选择“允许”或“添加信任”否则虚拟机网络功能可能无法正常使用。3. 加载与启动预配置的Ubuntu 20.04镜像虚拟机软件安装好后我们就要把主角——迅为提供的Ubuntu 20.04开发环境镜像——导入并运行起来。这个镜像文件通常是一个包含.vmx,.vmdk等文件的文件夹已经预装了针对iTOP-LS2K0500开发板所需的交叉编译工具链、库文件以及一些常用开发工具省去了我们数小时甚至数天的环境搭建时间。3.1 获取与解压镜像文件首先你需要从迅为官方提供的网盘资料中获取这个镜像。根据文档路径通常在iTOP-LS2K0500开发板资料\03_开发所需软件及驱动\06_搭建好编译环境的Ubuntu20.04系统。你会看到一个压缩包可能是.zip或.rar格式将其解压到一个路径不含中文和空格的目录下例如D:\VMware_Images\iTOP-LS2K0500_Ubuntu20。解压后你会看到里面有几个文件其中最关键的是扩展名为.vmx的文件它是虚拟机的配置文件。3.2 在VMware中打开虚拟机打开VMware Workstation在主页或“库”标签页点击“打开虚拟机”的选项或者直接按CtrlO。在弹出的文件浏览器中导航到你刚才解压镜像的文件夹选择那个.vmx配置文件然后点击“打开”。此时这个Ubuntu虚拟机就会出现在VMware左侧的库列表中。你可以选中它在右侧看到它的摘要信息包括操作系统类型、内存大小等。3.3 首次启动虚拟机的关键选择选中虚拟机点击工具栏上的“开启此虚拟机”按钮绿色三角图标。这时VMware会弹出一个非常重要的对话框询问你“我已移动该虚拟机(I moved it)” 或 “我已复制该虚拟机(I copied it)”这里必须选择“我已复制该虚拟机”。这个选择关系到虚拟机内部UUID通用唯一识别码的生成方式。如果你选择“我已移动它”VMware会保留原有的硬件标识符而选择“已复制”则会生成一套全新的标识符。由于我们是从官方镜像文件打开的这相当于复制了一份到你的电脑上选择“已复制”可以避免潜在的网卡MAC地址冲突等问题确保虚拟机网络能正常工作。点击“我已复制该虚拟机”后系统会开始启动。第一次启动时可能还会弹出一个关于“可移动设备”的提示框询问是否连接某些设备如虚拟光驱直接点击“否”或取消即可我们不需要从外部介质启动。3.4 系统登录与初始确认虚拟机启动后你会看到Ubuntu 20.04的GRUB引导界面如果设置了直接启动或者直接进入图形登录界面。根据文档这个预装系统的用户名和密码都是topeet。在登录界面点击用户“topeet”。在密码输入框输入密码“topeet”输入时密码不可见是正常的然后按回车键登录。成功登录后你将进入Ubuntu 20.04的桌面环境通常是GNOME。至此迅为提供的编译环境就已经成功加载并运行在你的虚拟机中了。实操心得首次启动后我建议先做两件事。第一立即为这个“干净”的状态创建一个VMware快照命名为“Initial_Clean_State”。这样以后任何时候环境被玩坏了都能瞬间恢复。第二打开终端快捷键CtrlAltT运行一下lsb_release -a和uname -a确认系统版本和内核信息再尝试运行一下资料中提到的交叉编译工具链命令例如ls2k0500-linux-gcc -v验证环境是否真的就绪。这能提前发现问题避免后续开发中卡在环境问题上。4. 虚拟机基础配置优化与资源分配成功启动Ubuntu只是第一步。为了让这个开发环境在后续的代码编译、文件传输等任务中更加流畅高效我们还需要根据自己主机的硬件情况对虚拟机进行一些基础配置的优化。这些设置在虚拟机处于“已关闭”状态下进行修改。4.1 内存与处理器分配这是影响虚拟机性能最直接的因素。点击VMware库中的虚拟机确保其已关闭然后选择“编辑虚拟机设置”。内存分配给虚拟机的内存大小。Ubuntu 20.04桌面版本身运行建议至少2GB。但我们要进行嵌入式开发经常需要同时打开IDE、浏览器、多个终端以及编译大型工程因此建议分配4GB4096 MB或以上。原则是在保证主机系统本身不卡顿的前提下通常主机内存应留有4-8GB余量尽可能多分配给虚拟机。例如如果你的主机是16GB内存分配6-8GB给虚拟机是比较理想的选择。处理器处理器数量这里指的是“处理器插槽”数通常保持默认的1即可。每个处理器的核心数量这才是分配CPU核心的关键。建议分配你主机物理核心数的一半或更多。例如你的CPU是4核8线程可以分配2个或4个核心给虚拟机。分配太多会影响主机性能分配太少则虚拟机编译速度会慢。对于开发编译分配2-4个核心是一个不错的起点。4.2 网络适配器设置网络配置决定了虚拟机如何与外界通信这对于下载软件包、与开发板进行网络调试至关重要。在“虚拟机设置”的“网络适配器”选项中最常用的模式是NAT模式虚拟机共享主机的IP地址上网。这是最简单方便的模式虚拟机可以无障碍访问外网主机也可以访问虚拟机。但局域网内的其他设备包括你的开发板默认无法直接访问到这台虚拟机。适合初期需要联网安装额外软件包的阶段。桥接模式虚拟机会在局域网中像一个独立的物理设备一样获取一个和主机同网段的IP地址。这样局域网内的所有设备包括开发板都能直接通过IP与虚拟机通信。这是后续进行网络调试如NFS挂载、TFTP下载、SSH登录开发板时推荐使用的模式。我建议在环境搭建初期先使用NAT模式确保虚拟机可以顺利更新软件源和安装工具。当需要与开发板联调时再关闭虚拟机将网络模式切换为桥接模式并记住虚拟机获取到的IP地址。4.3 共享文件夹设置可选但推荐为了方便在主机Windows和虚拟机Ubuntu之间传输文件可以设置共享文件夹。这样你可以在Windows下用熟悉的工具编辑代码然后在虚拟机中进行编译。在“虚拟机设置”中切换到“选项”标签页选择“共享文件夹”。选择“总是启用”然后点击“添加”按钮按照向导选择一个主机上的文件夹例如D:\ShareWithVM并指定一个在虚拟机中显示的名称。启动Ubuntu后共享文件夹通常会自动挂载在/mnt/hgfs/目录下。你可以通过ls /mnt/hgfs命令查看。如果没有可能需要安装VMware Tools对于Ubuntu通常通过open-vm-tools包实现可尝试运行sudo apt install open-vm-tools-desktop安装并重启。注意事项共享文件夹虽然方便但要注意文件权限问题。在Linux下从共享文件夹中解压的源码文件其执行权限x可能会丢失导致编译脚本无法运行。遇到这种情况需要在Linux终端内使用chmod x filename.sh命令为脚本重新添加执行权限。5. Ubuntu系统内初步检查与必备工具确认登录进Ubuntu桌面后我们不应立即开始开发而是先花几分钟时间对这个预配置环境做一次“体检”确认关键工具链和配置是否存在并做一些基础优化。5.1 验证交叉编译工具链这是整个环境的核心。针对龙芯LS2K0500处理器迅为应该已经配置好了对应的交叉编译工具链例如ls2k0500-linux-gcc。打开终端进行验证# 尝试查看交叉编译器的版本 ls2k0500-linux-gcc -v # 或者如果上述命令找不到尝试寻找工具链路径 find / -name *ls2k* -type f 2/dev/null | head -20如果成功输出版本信息说明工具链已正确安装并配置了环境变量。如果提示“命令未找到”则需要根据资料文档找到工具链的实际安装路径可能在/opt或用户目录下并手动将其bin目录添加到系统的PATH环境变量中。具体方法是在用户主目录下的.bashrc文件末尾添加一行export PATH$PATH:/path/to/your/toolchain/bin然后执行source ~/.bashrc使其生效。5.2 检查基础开发工具除了交叉编译器一些通用的开发工具也应该被预装。我们可以快速检查一下# 检查代码编辑器如Vim和版本控制工具Git which vim git make # 检查文件传输工具用于与开发板通信 which ssh scp # 检查网络工具 which ping ifconfig netstat如果某些命令没有找到可以使用Ubuntu的包管理器apt进行安装。首先更新软件源列表然后安装sudo apt update sudo apt install vim git net-tools openssh-server -y安装openssh-server后可以通过sudo systemctl start ssh启动SSH服务这样你就可以从主机使用SSH客户端如PuTTY、MobaXterm远程登录到这台虚拟机操作起来会更方便。5.3 配置软件源加速国内用户预装的系统可能配置的是Ubuntu官方软件源国内访问速度可能较慢。我们可以将其替换为国内镜像源以大幅提升软件包下载速度。这里以阿里云镜像源为例备份原有源列表sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak编辑源列表文件sudo vim /etc/apt/sources.list将文件内容全部替换为阿里云20.04的源内容可从阿里云镜像站获取或者使用sed命令一键替换。更新缓存sudo apt update完成此操作后后续安装任何软件都会快很多。5.4 确认磁盘空间编译大型项目如Linux内核会占用大量磁盘空间。在终端中输入df -h查看根目录/的可用空间。如果剩余空间小于10GB建议考虑通过VMware的“虚拟机设置”-“硬盘”-“扩展”功能来增加虚拟硬盘的容量需在虚拟机系统内再用gparted等工具扩展分区或者清理不必要的缓存和安装包sudo apt clean。6. 常见问题与排查技巧实录即便按照步骤操作在实际搭建过程中也可能遇到一些“坑”。下面我整理了几个常见问题及其解决方法希望能帮你快速排雷。6.1 虚拟机启动报错“Intel VT-x 被禁用”问题现象启动虚拟机时VMware弹出错误提示“此主机支持 Intel VT-x但 Intel VT-x 处于禁用状态”。原因分析这是主机的BIOS/UEFI设置中CPU的虚拟化技术Intel VT-x 或 AMD-V没有开启。该技术是虚拟机软件高效运行的基础。解决方案重启电脑在开机自检时按下特定按键通常是F2、F10、Del、Esc等具体看主板或电脑品牌提示进入BIOS/UEFI设置界面。在高级Advanced或处理器CPU Configuration设置菜单中找到“Intel Virtualization Technology”、“Intel VT-x”、“AMD-V”或“SVM Mode”等选项。将其状态从“Disabled”改为“Enabled”。保存设置并退出通常按F10电脑会自动重启。重启后再次尝试启动虚拟机。6.2 Ubuntu系统启动后无法连接网络问题现象Ubuntu虚拟机启动后右上角网络图标显示断开或者有图标但无法ping通外网。排查步骤检查VMware网络服务在Windows主机上按Win R输入services.msc打开服务管理器。找到所有以“VMware”开头的服务确保它们的状态都是“正在运行”。特别是“VMware NAT Service”和“VMware DHCP Service”。检查虚拟机网络适配器设置确认虚拟机设置中网络适配器已连接选择“已连接”和“启动时连接”。尝试在NAT和桥接模式之间切换一下保存后重启虚拟机。在Ubuntu内检查打开终端运行ifconfig -a或ip addr show查看是否有ens33、eth0之类的网络接口并且是否分配到了IP地址inet字段。如果没有IP尝试重启网络服务sudo systemctl restart networking或sudo netplan apply取决于Ubuntu版本。检查防火墙虽然Ubuntu桌面版默认防火墙ufw通常是关闭的但可以确认一下sudo ufw status。如果显示激活active可以暂时禁用sudo ufw disable测试网络是否恢复。6.3 登录密码正确但无法进入图形桌面问题现象输入用户名topeet和密码topeet后屏幕闪动一下又回到了登录界面循环往复。原因分析这可能是用户主目录下的某些配置文件如.Xauthority权限损坏或者磁盘空间已满导致无法创建会话文件。解决方案尝试进入文本模式在登录界面按Ctrl Alt F3或F2-F6中的一个切换到文本控制台。用topeet用户名和密码登录。检查磁盘空间运行df -h查看根目录和/home分区是否已满。如果满了需要清理文件。修复文件权限在文本控制台下运行以下命令# 删除可能损坏的X会话权限文件 sudo rm /home/topeet/.Xauthority* # 修复用户目录权限谨慎操作确保当前在/home/topeet目录外 sudo chown -R topeet:topeet /home/topeet按Ctrl Alt F1或F7不同系统可能不同切回图形登录界面再次尝试登录。6.4 共享文件夹不显示问题现象在VMware中设置了共享文件夹但在Ubuntu的/mnt/hgfs目录下看不到。解决方案首先确保虚拟机设置中共享文件夹已启用并指向正确的主机路径。在Ubuntu终端中安装或重新安装VMware Tools的开源替代品sudo apt update sudo apt install open-vm-tools-desktop -y安装完成后必须重启虚拟机sudo reboot。重启后再检查/mnt/hgfs目录。如果还没有可以手动挂载sudo vmhgfs-fuse .host:/ /mnt/hgfs -o allow_other -o uid1000 -o gid1000注意uid和gid可以通过id topeet命令查看确保是当前用户的ID。6.5 编译时提示“权限不够”或“命令未找到”问题现象在终端中执行编译脚本或某些命令时系统报错。排查与解决权限不够使用ls -l filename.sh查看文件权限。如果缺少执行权限x使用chmod x filename.sh添加。如果是对系统目录操作需要root权限在命令前加sudo。命令未找到确认命令是否真的安装which command_name。如果已安装但不在当前PATH中需要指定完整路径或将安装目录加入PATH如前文所述修改.bashrc文件。对于交叉编译工具链这是最常见的问题。务必确认工具链的bin目录已正确添加到topeet用户的PATH环境变量中并且通过source ~/.bashrc或重新登录终端使其生效。通过以上步骤你应该已经成功在VMware中加载并运行了迅为提供的Ubuntu 20.04开发环境并对其进行了初步的优化和问题排查。这个环境就像为你量身打造的工作台接下来就可以着手进行iTOP-LS2K0500开发板的uboot移植、内核编译、文件系统构建等真正的开发工作了。记住第一步把环境搭稳了后面的路会顺畅很多。如果在后续使用中遇到其他问题多利用终端命令查看日志如dmesg,journalctl -xe善用搜索引擎和社区大部分问题都能找到解决方案。
VMware虚拟机搭建国产龙芯LS2K0500开发板Ubuntu 20.04编译环境全攻略
1. 项目概述与核心价值最近在折腾一块国产化程度非常高的开发板——迅为电子的iTOP-LS2K0500。这块板子从CPU指令集到板上的每一个元器件都实现了100%的全国产化对于从事信创、嵌入式国产化替代或者单纯想了解龙芯生态的开发者来说是个非常不错的硬件平台。拿到开发板后第一道坎往往不是硬件本身而是搭建一个趁手、稳定的软件开发环境。官方资料里提供了一个已经搭建好编译环境的Ubuntu 20.04虚拟机镜像这能为我们省去大量配置依赖、安装交叉编译工具链的繁琐时间直接进入开发状态。今天这篇内容我就结合官方的指导文档和我自己实际操作的经历详细拆解一下如何从零开始在你的Windows电脑上把这个“开箱即用”的Ubuntu开发环境给跑起来。整个过程会涵盖虚拟机的安装、镜像的加载、以及初次登录后的基础确认目标是让你能无痛、高效地迈出使用iTOP-LS2K0500开发板的第一步。2. 环境准备虚拟机软件的选择与安装在加载官方Ubuntu镜像之前我们需要一个“容器”来运行它这就是虚拟机。虚拟机软件可以在你的Windows或macOS主机上模拟出一台完整的、独立的计算机我们在这台虚拟计算机里安装和运行Ubuntu系统从而与主机系统完全隔离避免环境冲突也方便随时备份和迁移。2.1 虚拟机软件选型为何是VMware Workstation市面上主流的虚拟机软件有VMware Workstation、VirtualBox等。官方资料推荐使用VMware我实测下来也倾向于这个选择原因有几个性能与兼容性VMware对硬件虚拟化的支持更成熟特别是对于需要直接调用CPU虚拟化指令如Intel VT-x/AMD-V的场景其性能损耗相对更小运行Ubuntu进行编译等重负载任务时更流畅。对于迅为提供的这个预配置镜像VMware的兼容性也经过了验证能确保所有预装工具和配置正常运作。快照与克隆功能这是开发者的“后悔药”和“复制机”。你可以在环境配置到完美状态时创建一个快照后续任何误操作导致环境崩溃都能一键回滚到这个干净状态。克隆功能则可以快速复制出多个相同的开发环境用于测试不同分支的代码非常高效。网络配置灵活VMware提供了NAT、桥接、仅主机等多种网络模式可以轻松配置虚拟机能上网、能与开发板通信、能与主机互访等复杂网络需求这对于嵌入式开发调试至关重要。当然VMware Workstation是商业软件需要许可证。官方提供了30天的试用期对于完成这个环境的搭建和初步探索是完全足够的。如果你有长期使用的需求可以考虑购买许可证或寻找其他合规的替代方案。2.2 VMware Workstation 15.5 安装实操详解官方资料包中提供了VMware 15.5的安装包你也可以从VMware官网下载更新版本如16.x。版本之间在基础功能上差异不大安装过程也大同小异。这里我以资料包中的VMware-workstation-full-15.5.0-14665864.exe为例一步步说明安装过程中的关键选择。步骤一启动安装与接受协议双击安装程序启动安装向导。第一个重要界面是“最终用户许可协议”。这里必须勾选“我接受许可协议中的条款”才能继续下一步。这是一个法律确认步骤务必阅读并理解。步骤二自定义安装路径接下来会让你选择安装位置。这里有一个非常重要的注意事项安装路径绝对不能包含中文或任何非ASCII字符如空格、特殊符号。最好保持默认路径通常是C:\Program Files (x86)\VMware\VMware Workstation\或者指定一个像D:\VMware这样的纯英文路径。路径中包含中文可能会导致虚拟机软件运行时出现各种难以排查的奇怪错误例如网络服务启动失败、虚拟机无法识别硬件等。步骤三用户体验设置这个界面通常会有两个复选框例如“启动时检查产品更新”和“加入VMware客户体验提升计划”。我的建议是取消勾选这两个选项。关闭自动更新可以避免在开发关键时期软件自动升级导致与现有虚拟机或工具的兼容性问题。客户体验计划则根据个人隐私偏好选择是否参与。步骤四创建快捷方式确保勾选“桌面”和“开始菜单程序文件夹”的复选框这样安装完成后你能方便地从桌面或开始菜单启动VMware提高日常使用效率。步骤五执行安装与完成确认上述设置后点击“安装”按钮。安装过程会自动进行期间可能会提示安装Windows相关的驱动和组件一律点击“是”或“允许”即可。安装完成后点击“完成”按钮退出向导。此时你的桌面上应该会出现“VMware Workstation Pro”的图标。步骤六首次运行与许可证首次双击桌面图标运行VMware时软件会提示你输入许可证密钥。如果你已经购买在此处输入即可激活。如果没有请务必选择“我希望试用VMware Workstation 15 30天”这个选项然后点击“继续”。这样你就可以获得30天的完整功能试用期。点击“完成”后你将看到VMware Workstation的主界面这意味着虚拟机平台已经准备就绪。注意安装过程中Windows Defender或第三方杀毒软件可能会弹出警告询问是否允许VMware相关驱动或服务进行更改。请务必选择“允许”或“添加信任”否则虚拟机网络功能可能无法正常使用。3. 加载与启动预配置的Ubuntu 20.04镜像虚拟机软件安装好后我们就要把主角——迅为提供的Ubuntu 20.04开发环境镜像——导入并运行起来。这个镜像文件通常是一个包含.vmx,.vmdk等文件的文件夹已经预装了针对iTOP-LS2K0500开发板所需的交叉编译工具链、库文件以及一些常用开发工具省去了我们数小时甚至数天的环境搭建时间。3.1 获取与解压镜像文件首先你需要从迅为官方提供的网盘资料中获取这个镜像。根据文档路径通常在iTOP-LS2K0500开发板资料\03_开发所需软件及驱动\06_搭建好编译环境的Ubuntu20.04系统。你会看到一个压缩包可能是.zip或.rar格式将其解压到一个路径不含中文和空格的目录下例如D:\VMware_Images\iTOP-LS2K0500_Ubuntu20。解压后你会看到里面有几个文件其中最关键的是扩展名为.vmx的文件它是虚拟机的配置文件。3.2 在VMware中打开虚拟机打开VMware Workstation在主页或“库”标签页点击“打开虚拟机”的选项或者直接按CtrlO。在弹出的文件浏览器中导航到你刚才解压镜像的文件夹选择那个.vmx配置文件然后点击“打开”。此时这个Ubuntu虚拟机就会出现在VMware左侧的库列表中。你可以选中它在右侧看到它的摘要信息包括操作系统类型、内存大小等。3.3 首次启动虚拟机的关键选择选中虚拟机点击工具栏上的“开启此虚拟机”按钮绿色三角图标。这时VMware会弹出一个非常重要的对话框询问你“我已移动该虚拟机(I moved it)” 或 “我已复制该虚拟机(I copied it)”这里必须选择“我已复制该虚拟机”。这个选择关系到虚拟机内部UUID通用唯一识别码的生成方式。如果你选择“我已移动它”VMware会保留原有的硬件标识符而选择“已复制”则会生成一套全新的标识符。由于我们是从官方镜像文件打开的这相当于复制了一份到你的电脑上选择“已复制”可以避免潜在的网卡MAC地址冲突等问题确保虚拟机网络能正常工作。点击“我已复制该虚拟机”后系统会开始启动。第一次启动时可能还会弹出一个关于“可移动设备”的提示框询问是否连接某些设备如虚拟光驱直接点击“否”或取消即可我们不需要从外部介质启动。3.4 系统登录与初始确认虚拟机启动后你会看到Ubuntu 20.04的GRUB引导界面如果设置了直接启动或者直接进入图形登录界面。根据文档这个预装系统的用户名和密码都是topeet。在登录界面点击用户“topeet”。在密码输入框输入密码“topeet”输入时密码不可见是正常的然后按回车键登录。成功登录后你将进入Ubuntu 20.04的桌面环境通常是GNOME。至此迅为提供的编译环境就已经成功加载并运行在你的虚拟机中了。实操心得首次启动后我建议先做两件事。第一立即为这个“干净”的状态创建一个VMware快照命名为“Initial_Clean_State”。这样以后任何时候环境被玩坏了都能瞬间恢复。第二打开终端快捷键CtrlAltT运行一下lsb_release -a和uname -a确认系统版本和内核信息再尝试运行一下资料中提到的交叉编译工具链命令例如ls2k0500-linux-gcc -v验证环境是否真的就绪。这能提前发现问题避免后续开发中卡在环境问题上。4. 虚拟机基础配置优化与资源分配成功启动Ubuntu只是第一步。为了让这个开发环境在后续的代码编译、文件传输等任务中更加流畅高效我们还需要根据自己主机的硬件情况对虚拟机进行一些基础配置的优化。这些设置在虚拟机处于“已关闭”状态下进行修改。4.1 内存与处理器分配这是影响虚拟机性能最直接的因素。点击VMware库中的虚拟机确保其已关闭然后选择“编辑虚拟机设置”。内存分配给虚拟机的内存大小。Ubuntu 20.04桌面版本身运行建议至少2GB。但我们要进行嵌入式开发经常需要同时打开IDE、浏览器、多个终端以及编译大型工程因此建议分配4GB4096 MB或以上。原则是在保证主机系统本身不卡顿的前提下通常主机内存应留有4-8GB余量尽可能多分配给虚拟机。例如如果你的主机是16GB内存分配6-8GB给虚拟机是比较理想的选择。处理器处理器数量这里指的是“处理器插槽”数通常保持默认的1即可。每个处理器的核心数量这才是分配CPU核心的关键。建议分配你主机物理核心数的一半或更多。例如你的CPU是4核8线程可以分配2个或4个核心给虚拟机。分配太多会影响主机性能分配太少则虚拟机编译速度会慢。对于开发编译分配2-4个核心是一个不错的起点。4.2 网络适配器设置网络配置决定了虚拟机如何与外界通信这对于下载软件包、与开发板进行网络调试至关重要。在“虚拟机设置”的“网络适配器”选项中最常用的模式是NAT模式虚拟机共享主机的IP地址上网。这是最简单方便的模式虚拟机可以无障碍访问外网主机也可以访问虚拟机。但局域网内的其他设备包括你的开发板默认无法直接访问到这台虚拟机。适合初期需要联网安装额外软件包的阶段。桥接模式虚拟机会在局域网中像一个独立的物理设备一样获取一个和主机同网段的IP地址。这样局域网内的所有设备包括开发板都能直接通过IP与虚拟机通信。这是后续进行网络调试如NFS挂载、TFTP下载、SSH登录开发板时推荐使用的模式。我建议在环境搭建初期先使用NAT模式确保虚拟机可以顺利更新软件源和安装工具。当需要与开发板联调时再关闭虚拟机将网络模式切换为桥接模式并记住虚拟机获取到的IP地址。4.3 共享文件夹设置可选但推荐为了方便在主机Windows和虚拟机Ubuntu之间传输文件可以设置共享文件夹。这样你可以在Windows下用熟悉的工具编辑代码然后在虚拟机中进行编译。在“虚拟机设置”中切换到“选项”标签页选择“共享文件夹”。选择“总是启用”然后点击“添加”按钮按照向导选择一个主机上的文件夹例如D:\ShareWithVM并指定一个在虚拟机中显示的名称。启动Ubuntu后共享文件夹通常会自动挂载在/mnt/hgfs/目录下。你可以通过ls /mnt/hgfs命令查看。如果没有可能需要安装VMware Tools对于Ubuntu通常通过open-vm-tools包实现可尝试运行sudo apt install open-vm-tools-desktop安装并重启。注意事项共享文件夹虽然方便但要注意文件权限问题。在Linux下从共享文件夹中解压的源码文件其执行权限x可能会丢失导致编译脚本无法运行。遇到这种情况需要在Linux终端内使用chmod x filename.sh命令为脚本重新添加执行权限。5. Ubuntu系统内初步检查与必备工具确认登录进Ubuntu桌面后我们不应立即开始开发而是先花几分钟时间对这个预配置环境做一次“体检”确认关键工具链和配置是否存在并做一些基础优化。5.1 验证交叉编译工具链这是整个环境的核心。针对龙芯LS2K0500处理器迅为应该已经配置好了对应的交叉编译工具链例如ls2k0500-linux-gcc。打开终端进行验证# 尝试查看交叉编译器的版本 ls2k0500-linux-gcc -v # 或者如果上述命令找不到尝试寻找工具链路径 find / -name *ls2k* -type f 2/dev/null | head -20如果成功输出版本信息说明工具链已正确安装并配置了环境变量。如果提示“命令未找到”则需要根据资料文档找到工具链的实际安装路径可能在/opt或用户目录下并手动将其bin目录添加到系统的PATH环境变量中。具体方法是在用户主目录下的.bashrc文件末尾添加一行export PATH$PATH:/path/to/your/toolchain/bin然后执行source ~/.bashrc使其生效。5.2 检查基础开发工具除了交叉编译器一些通用的开发工具也应该被预装。我们可以快速检查一下# 检查代码编辑器如Vim和版本控制工具Git which vim git make # 检查文件传输工具用于与开发板通信 which ssh scp # 检查网络工具 which ping ifconfig netstat如果某些命令没有找到可以使用Ubuntu的包管理器apt进行安装。首先更新软件源列表然后安装sudo apt update sudo apt install vim git net-tools openssh-server -y安装openssh-server后可以通过sudo systemctl start ssh启动SSH服务这样你就可以从主机使用SSH客户端如PuTTY、MobaXterm远程登录到这台虚拟机操作起来会更方便。5.3 配置软件源加速国内用户预装的系统可能配置的是Ubuntu官方软件源国内访问速度可能较慢。我们可以将其替换为国内镜像源以大幅提升软件包下载速度。这里以阿里云镜像源为例备份原有源列表sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak编辑源列表文件sudo vim /etc/apt/sources.list将文件内容全部替换为阿里云20.04的源内容可从阿里云镜像站获取或者使用sed命令一键替换。更新缓存sudo apt update完成此操作后后续安装任何软件都会快很多。5.4 确认磁盘空间编译大型项目如Linux内核会占用大量磁盘空间。在终端中输入df -h查看根目录/的可用空间。如果剩余空间小于10GB建议考虑通过VMware的“虚拟机设置”-“硬盘”-“扩展”功能来增加虚拟硬盘的容量需在虚拟机系统内再用gparted等工具扩展分区或者清理不必要的缓存和安装包sudo apt clean。6. 常见问题与排查技巧实录即便按照步骤操作在实际搭建过程中也可能遇到一些“坑”。下面我整理了几个常见问题及其解决方法希望能帮你快速排雷。6.1 虚拟机启动报错“Intel VT-x 被禁用”问题现象启动虚拟机时VMware弹出错误提示“此主机支持 Intel VT-x但 Intel VT-x 处于禁用状态”。原因分析这是主机的BIOS/UEFI设置中CPU的虚拟化技术Intel VT-x 或 AMD-V没有开启。该技术是虚拟机软件高效运行的基础。解决方案重启电脑在开机自检时按下特定按键通常是F2、F10、Del、Esc等具体看主板或电脑品牌提示进入BIOS/UEFI设置界面。在高级Advanced或处理器CPU Configuration设置菜单中找到“Intel Virtualization Technology”、“Intel VT-x”、“AMD-V”或“SVM Mode”等选项。将其状态从“Disabled”改为“Enabled”。保存设置并退出通常按F10电脑会自动重启。重启后再次尝试启动虚拟机。6.2 Ubuntu系统启动后无法连接网络问题现象Ubuntu虚拟机启动后右上角网络图标显示断开或者有图标但无法ping通外网。排查步骤检查VMware网络服务在Windows主机上按Win R输入services.msc打开服务管理器。找到所有以“VMware”开头的服务确保它们的状态都是“正在运行”。特别是“VMware NAT Service”和“VMware DHCP Service”。检查虚拟机网络适配器设置确认虚拟机设置中网络适配器已连接选择“已连接”和“启动时连接”。尝试在NAT和桥接模式之间切换一下保存后重启虚拟机。在Ubuntu内检查打开终端运行ifconfig -a或ip addr show查看是否有ens33、eth0之类的网络接口并且是否分配到了IP地址inet字段。如果没有IP尝试重启网络服务sudo systemctl restart networking或sudo netplan apply取决于Ubuntu版本。检查防火墙虽然Ubuntu桌面版默认防火墙ufw通常是关闭的但可以确认一下sudo ufw status。如果显示激活active可以暂时禁用sudo ufw disable测试网络是否恢复。6.3 登录密码正确但无法进入图形桌面问题现象输入用户名topeet和密码topeet后屏幕闪动一下又回到了登录界面循环往复。原因分析这可能是用户主目录下的某些配置文件如.Xauthority权限损坏或者磁盘空间已满导致无法创建会话文件。解决方案尝试进入文本模式在登录界面按Ctrl Alt F3或F2-F6中的一个切换到文本控制台。用topeet用户名和密码登录。检查磁盘空间运行df -h查看根目录和/home分区是否已满。如果满了需要清理文件。修复文件权限在文本控制台下运行以下命令# 删除可能损坏的X会话权限文件 sudo rm /home/topeet/.Xauthority* # 修复用户目录权限谨慎操作确保当前在/home/topeet目录外 sudo chown -R topeet:topeet /home/topeet按Ctrl Alt F1或F7不同系统可能不同切回图形登录界面再次尝试登录。6.4 共享文件夹不显示问题现象在VMware中设置了共享文件夹但在Ubuntu的/mnt/hgfs目录下看不到。解决方案首先确保虚拟机设置中共享文件夹已启用并指向正确的主机路径。在Ubuntu终端中安装或重新安装VMware Tools的开源替代品sudo apt update sudo apt install open-vm-tools-desktop -y安装完成后必须重启虚拟机sudo reboot。重启后再检查/mnt/hgfs目录。如果还没有可以手动挂载sudo vmhgfs-fuse .host:/ /mnt/hgfs -o allow_other -o uid1000 -o gid1000注意uid和gid可以通过id topeet命令查看确保是当前用户的ID。6.5 编译时提示“权限不够”或“命令未找到”问题现象在终端中执行编译脚本或某些命令时系统报错。排查与解决权限不够使用ls -l filename.sh查看文件权限。如果缺少执行权限x使用chmod x filename.sh添加。如果是对系统目录操作需要root权限在命令前加sudo。命令未找到确认命令是否真的安装which command_name。如果已安装但不在当前PATH中需要指定完整路径或将安装目录加入PATH如前文所述修改.bashrc文件。对于交叉编译工具链这是最常见的问题。务必确认工具链的bin目录已正确添加到topeet用户的PATH环境变量中并且通过source ~/.bashrc或重新登录终端使其生效。通过以上步骤你应该已经成功在VMware中加载并运行了迅为提供的Ubuntu 20.04开发环境并对其进行了初步的优化和问题排查。这个环境就像为你量身打造的工作台接下来就可以着手进行iTOP-LS2K0500开发板的uboot移植、内核编译、文件系统构建等真正的开发工作了。记住第一步把环境搭稳了后面的路会顺畅很多。如果在后续使用中遇到其他问题多利用终端命令查看日志如dmesg,journalctl -xe善用搜索引擎和社区大部分问题都能找到解决方案。
