地瓜机器人是近年来国内兴起的一款面向智能机器人开发的嵌入式平台，它基于高性能AMR处理器和自研的机器人操作系统，为开发者提供了丰富的硬件接口和软件库，极大地降低了机器人产品的研发门槛。本文将从零开始，介绍如何搭建地瓜机器人的开发环境，并运行第一个示例程序，帮助初学者快速上手。
一、地瓜机器人简介
地瓜机器人核心是一块集成了CPU、GPU和NPU的SoC，支持linux和RTOS双系统，能够同时处理复杂的视觉算法和实时控制任务。其官方提供的SDK包含了机器人常用功能模块，如SLAM导航，目标检测，语音交互等，开发者可以直接调用，无需从底层写起。此外，地瓜社区还开源大量示例项目与工具链，方便学习与二次开发。
二、硬件准备
要开始地瓜机器人开发，需要准备以下硬件：
-
一块地瓜机器人开发板（如DIGUA R1）
-
一张至少16GB的Micro SD卡（用于烧录系统）
-
一条USB Type-C数据线（供电和调试）
-
一个摄像头（用于视觉应用）
-
电机驱动模块和轮子（如果做移动机器人）
三、软件环境搭建
1.下载系统镜像
访问地瓜开发者社区论坛（forum.digua.com），在“资源下载”板块找到最新的系统镜像文件（通常是.img格式）。建议选择包含桌面环境的版本，方便调试。
2.烧录系统到SD卡
使用工具，如Rufus将镜像写入SD卡。插入SD卡到电脑，打开烧录软件，选择镜像和目标SD卡，点击开始即可。等待烧录完成，安全弹出SD卡。
3.启动开发板
将SD卡接入地瓜开发板，连接USB线到电脑，开发板会以USB网卡模式出现，或者通过HDMI连接显示器。上电后，开发板自动启动，第一次启动可能需要几分钟初始化。默认用户名和密码通常为digua/digua。可在论坛文档中查询。
4.安装开发工具
进入系统后，建议先更新软件源并安装必要的开发包：
sudo apt update
sudo apt install build-essential cmake git python3-pip
地瓜SDK通常预装在系统中，位于/opt/digua目录下，如果没有，可以手动从论坛下载SDK安装包并解压。
四、第一个案例
地瓜开发板通常带有板载led，我们可以通过gpio控制它闪烁，验证环境是否正常。
1.创建一个工作目录
mkdir ~/digua_test && cd ~/digua_test
2.编写c程序blink.c
#include <stdio.h>
#include <unistd.h>
#include "dg_gpio.h" // 地瓜GPIO库
int main() {
dg_gpio_init();
dg_gpio_set_mode(18, DG_GPIO_OUTPUT); // 假设LED接在GPIO18
while (1) {
dg_gpio_write(18, 1);
sleep(1);
dg_gpio_write(18, 0);
sleep(1);
}
return 0;
}
3.编译需要链接地瓜SDK的库，可以使用提供的cmake模板。在目录下创建CMakeLists.txt
cmake_minimum_required(VERSION 3.10)
project(blink)
set(CMAKE_C_STANDARD 11)
include_directories(/opt/digua/include)
link_directories(/opt/digua/lib)
add_executable(blink blink.c)
target_link_libraries(blink dg_gpio)
4.编译
mkdir build && cd build
cmake ..
make
5.运行
sudo ./blink
如果LED闪烁，说明环境配置成功！
五、进行视觉识别示例
地瓜SDK内置了轻量级神经网络推理引擎，可以运行目标检测模型。以官方的人脸检测为例：
cd /opt/digua/examples/face_detection
mkdir build && cd build
cmake ..
make
./face_detection /dev/video0 # 使用摄像头
如果连接了显示器，会看到实时视频流中的人脸框。
六、总结
通过以上步骤，我们成功搭建了地瓜机器人的开发环境，并运行了基础GPIO和视觉示例，地瓜平台有时在于软硬件高度整合，开发者可以快速验证想法。