最近报名了古月居的【 高校合作计划 】活动,拿到了一个旭日 X3 派来开发。由于最近换了台 Macbook ARM 芯片,官网的用户手册都是基于 Windows 环境,在 MacOS 中或多或少会有写问题。那么用这篇博客记录一下使用旭日 X3 派开发中的记录和遇到的一些问题(持续更新)。

环境搭建

开发前必不可少的是东西要全,活动赠送的只有单个主板,所以需要购入一些硬件设备。

硬件条件

  1. 开发板
    不需要多说,没有开发板玩什么。
  2. USB 转 TTL
    这个有很多种,个人使用的是 CH340,tb 上有很多,自己甄别。
  3. SD 卡
    开发板需要采用 TF 存储卡作为系统启动介质,推荐使用容量8G、速率 C10 以上的。个人推荐大一点比较好,方便后续使用。
  4. RJ45 网线
    如果使用以太网连接开发板则需要购买。
  5. 电源线
    开发板需要进行供电,需要满足5V 2A,可以直接使用电脑的雷电口进行供电,测试功率足够。
  6. 4pin PH 2.0mm 转杜邦线
    搭配 2 连接电脑与开发板。
  7. 其他你项目所需的
    如果需要使用摄像头等需要购买对应的硬件。

之后按照用户手册第一章的内容进行镜像的制作,以及与开发板的连接。

由于个人工作环境的经常变化,所以连接局域网之后使用 SSH 登陆不太方便,于是选择使用 serial terminal 进行开发。如果直接使用 CH340 进行连接后会发现能够接到串口的数据但是显示是一堆乱码,这是因为还需要安装 CH340 的驱动。

安装 CH340 驱动

下载链接 CH341SER_MAC,下载后安装即可。此时查看设备列表会发现多了一个 tty.wch 开头的设备。
serial device
使用任意 Serial Terminal 连接这个串口,设置波特率为 921600。可以发现能够登陆进去了。
terminal

图形化界面

如果想要使用图形化界面,烧录的镜像需要时桌面版,之后在电脑上下在 VNC Viewer 或其他远程桌面软件进行连接,连接前需要将你的电脑与开发板处于同一局域网下或者通过以太网连接。

开发板默认的 IP 为 192.168.1.108
vnc viewer
连接该地址,连接前可以先试试能不能 ping 通。
ping

图形界面显示
desktop
这样就进去了,可以使用图形化界面进行开发。

单片机开发环境搭建

由于之后做的项目还需要使用 ESP32 进行开发,所以还需要在电脑上搭建 ESP32 的开发环境,这里使用 PlatformIO 进行 ESP32 的开发。需要在电脑上下载 VS Code,这个大家应该都有,之后就是在扩展中下载 PlatformIO IDE 插件,之后会发先左边栏出现一个蚂蚁头图标。
vscode

之后新建一个工程,给工程命名,第二行搜索开发板的类型并选择,我这里用的是 esp32 的开发板,具体说明可以上官网去查看详细信息。第三行为开发框架,看个人开发习惯选择,我这里选择 Arduino 框架进行开发。
new project

第一次创建项目会非常慢,因为系统会下载开发所需要的工具和框架,所以需要等待许久,有条件可以开一个代理,或者按照网上教程更换 pip 源,这里就不仔细说了。

project structure
创建完是这个样子,之后就可以在项目中开发自己的项目了,之后在底栏点击便衣或上传按键就可以编译和烧录代码。项目的配置可以在 platformio.ini 中进行更改,配置选项可以在官网中查看说明。