Eclipse IDE 用于 RePhone Kit

RePhone 可以作为一个学习工具，帮助您开始有趣的项目。目前，RePhone 支持多种开发环境和开发语言，您可以基于 Eclipse IDE 或 Arduino IDE 使用 C/C++ 构建应用程序，也可以使用 Lua 和 JavaScript。

本 Wiki 是一个用户指南，旨在帮助您使用 Eclipse IDE 开始您的 RePhone 项目。

产品版本	购买链接
RePhone core 2G-Atmel32u4 v1.0	立即购买
RePhone core 2G-AtmelSAMD21	立即购买

下载 Eclipse IDE 用于 RePhone

在下载用于 RePhone 的 Arduino IDE 之前，请确保您的电脑满足以下要求：

操作系统：Microsoft Windows XP、Vista、7 或 8
Eclipse IDE：Indigo (3.7) 和 CDT 8.0.2。

现在请点击以下图标，从 Eclipse 官方网站下载并安装 Eclipse IDE for C/C++ Developers。安装 IDE 可能需要在您的电脑上安装适当的 JAVA SE Development Kit 8。

安装 Eclipse 插件：LinkIt Assist 2502 SDK 2.0.46

为了使用 RePhone 和 Eclipse IDE，您需要将 LinkIt Assist 2502 Eclipse 插件安装到与 Eclipse IDE 相同的文件夹中，即存放‘eclipse.exe’的文件夹。

安装 LinkIt Assist 2502 SDK 2.0.46 的步骤如下：

步骤 1. 下载 LinkIt Assist 2502 SDK 2.0.46 压缩文件。

步骤 2. 解压 LinkIt Assist 2502 SDK 2.0.46 压缩文件的内容。SDK 中除了 Eclipse 插件外还包含其他工具，因此建议将内容解压到永久位置。如果您将内容解压到临时位置，安装程序会提供将其移动到永久位置的选项。

步骤 3. 确保 Eclipse IDE 未运行。

步骤 4. 运行 LinkIt Assist 2502 SDK 2.0.46 安装程序‘InstallPlugins.exe’，如下图所示：

步骤 5. 在欢迎页面，点击‘Next’

步骤 6. 您将被要求选择 Eclipse IDE 的安装位置。点击‘Browse’，找到您安装 Eclipse IDE 的文件夹（即安装‘Eclipse IDE for C/C++ Developer’的指定文件夹），点击‘OK’和‘Next’。

步骤 7. 在“移动 SDK 到永久位置”页面，如果您将压缩文件解压到临时位置，请勾选‘Move LinkIt Assist 2502 2.0 package to new folder’。点击‘Browse’，选择一个永久位置来存储 SDK，然后点击‘Next’进入下一步。

步骤 8. 在“准备安装 SDK”页面，检查所选位置是否正确，如果正确，点击‘Install’。

步骤 9. 在安装的最后一步，如果这是您第一次安装 LinkIt SDK，请勾选‘Install the MediaTek USB Driver’，然后点击‘Finish’完成安装。

步骤 10. 插件安装完成后，在您安装 Eclipse IDE 的位置会出现一个名为‘LINKIT_ASSIST_SDK’的文件夹。

打开“eclipse.exe”后，您还可以在 Eclipse 窗口中找到插件，请参阅以下部分“创建您的第一个项目：Hello World”中的步骤 8。

更新/刷写固件

注意：请注意，刷写固件会删除存储在 RePhone 中的所有设置和文件（如图片、音乐）。在刷写/更新固件之前，请确保您已经了解这一点。

我知道您对您的 RePhone 非常期待，迫不及待地想开始编程，但请稍等片刻。在开始之前，确保核心模块 Xadow GSM+BLE 的固件与您刚安装的 LinkIt Assist SDK 相对应是非常重要的。

这里我将介绍两种更新/刷写 RePhone 固件的方法。

LinkIt Assist SDK 内置固件更新工具

步骤 1. 首先，确保您的 Xadow GSM+BLE 已与电脑断开连接，然后从我们的 Github 下载最新的 RePhone SDK并解压。

步骤 2. 启动您刚安装的 SDK 文件夹中的 ‘FirmwareUpdater.exe’，路径为 ’eclipse\LINKIT_ASSIST_SDK\tools\FirmwareUpdater\FirmwareUpdater.exe’

步骤 3. 在 LinkIt 固件更新工具窗口中，从下拉列表中选择 ‘Others’ 作为平台。然后定位到 ...\SEEED02A_DEMO_PCB01_gprs_MT2502_S00.MAUI_11CW1418SP5_W15_29.bin\SEEED02A_DEMO_BB.cfg

步骤 4. 点击绿色更新按钮，并按照屏幕上的两步指示操作，**确保 Xadow GSM+BLE 已通电（连接到电池）**后再连接到电脑。

步骤 5. 等待下载完成。

步骤 6. 固件更新完成后，下载完成页面会确认更新成功，点击 ‘OK’ 并退出更新工具。

创建您的第一个项目：Hello World

步骤 1. 快完成了！现在启动 eclipse.exe。如果这是您第一次使用 Eclipse IDE，系统会要求您选择一个 Workspace 来存储您的 Eclipse 项目。在 Workspace Launcher 中，点击 Browse 找到一个合适的位置作为您的 Workspace。我建议您将 Workspace 设置在您安装 Eclipse IDE 的同一位置。

步骤 2. 要创建一个新的 RePhone 应用程序，在 Eclipse 的 File 菜单中，指向 new 并点击 Other。或者您可以简单地使用快捷键 CTRL+N。

步骤 3. 在新窗口中，展开 LinkIt Assist 2502 SDK 2.0 文件夹并选择 Application(*.vxp)

步骤 4. 现在您将进入 LinkIt Assist 2502 SDK 2.0 向导

输入新项目的名称，在本例中我们命名为 "hello_world"
在 Hardware Platform 的下拉菜单中选择 LinkIt Assist 2502
勾选 Empty Application
点击 Finish 完成设置

步骤 5. 恭喜！XD 您刚刚创建了您的第一个项目！现在从 C/C++ Projects 面板中打开项目并双击 "hello_world.c" 文件，如下图所示

步骤 6. 在上传应用程序之前，您需要：

通过将电池插入 Xadow GSM+BLE 的电池插座来为 RePhone 供电，按住电源键（PWR）2秒钟以打开设备（此时 LED 指示灯显示绿色）
然后使用 Micro USB 数据线将您的 RePhone 连接到电脑。

步骤 7. 打开 设备管理器 检查 COM 端口。会有两个 COM 端口（端口号可能因您的电脑而异）：

MTK USB Debug Port(COM4) 用于日志，例如在串行监视器中打印消息
MTK USB Modem Port(COM5) 用于上传代码

通过点击开始按钮，点击 控制面板，点击 系统和安全，然后在系统下点击 设备管理器 打开设备管理器。如果系统提示输入管理员密码或确认，请输入密码或提供确认。如下图所示：

步骤 8. 快完成了！将以下代码放入 "hello_world.c" 文件中：

#include "vmsystem.h"
#include "vmtype.h"
#include "vmlog.h"
#include "vmtimer.h"
#include "ResID.h"
#include "hello_world.h"

VM_TIMER_ID_PRECISE sys_timer_id = 0;

void sys_timer_callback(VM_TIMER_ID_PRECISE sys_timer_id, void* user_data)
{
    vm_log_info("Hello World!");
}

void handle_sysevt(VMINT message, VMINT param)
{
    switch (message)
    {
        case VM_EVENT_CREATE:

        sys_timer_id = vm_timer_create_non_precise(1000, sys_timer_callback, NULL);
        break;
        case VM_EVENT_PAINT:
        break;
        case VM_EVENT_QUIT:
        break;
    }
}

void vm_main(void)
{
    vm_pmng_register_system_event_callback(handle_sysevt);
}