搜档网
当前位置:搜档网 › LinkIt ONE 开发指南 中文版v1_3

LinkIt ONE 开发指南 中文版v1_3

联发科技LinkIt ONE 开发指南版本:1.3

发布日期:2015年6月1日

本指南内容及产品规范如有变更,恕不另行通知。

文档修改历史

目录

1.介绍 (1)

1.1.什么是 LinkIt? (1)

1.2.联发科技 LinkIt ONE 开发平台 (2)

1.3.LinkIt ONE 软件开发工具包 (SDK) (3)

1.4.硬件 (5)

1.5.加入我们的生态系统 (8)

2.开始使用 (9)

2.1.环境 (9)

2.2.安装联发科技LinkIt ONE SDK (针对Arduino)Windows 版本 (9)

2.3.安装联发科技LinkIt ONE SDK (针对Arduino)苹果Mac版本 (13)

2.4.设计第一个项目 (16)

2.5.在Arduino软件连接串口监视 (18)

3.故障排除 (20)

3.1.固件更新请求 (20)

3.2.Sketch不能上传到LinkIt ONE (22)

3.3.开发板没有回应 (23)

3.4.Mac OS X 10.10 COM 端口认别 (23)

3.5.既有的问题与限制 (26)

4.LinkIt ONE API 指南 (27)

4.1.数字 I/O (27)

4.2.高级I/O (27)

4.3.模拟I/O (28)

4.4.串行 (28)

4.5.时间 (29)

4.6.中断 (29)

4.7.数学 (29)

4.8.伺服 (30)

4.9.SPI (30)

4.10.总线Wire (I2C) (31)

4.11.步进 (31)

4.12.GSM/GPRS (32)

4.13.存储器(SD/Flash) (32)

4.14.蓝牙 (33)

4.15.GPS (34)

4.16.Wi-Fi (34)

4.17.音频 (36)

4.18.电池 (36)

4.19.日期时间 (36)

4.20.EEPROM (36)

4.21.数据类型的大小 (37)

5.使用LinkIt ONE的API (38)

5.1.传送短信(SMS) (38)

5.2.接收短信(SMS) (41)

5.3.使用Wi-Fi连网 (44)

5.4.安卓手机蓝牙连接至LinkIt ONE (47)

5.5.使用蓝牙GATT协议 (52)

5.6.使用GPS (57)

5.7.使用GPRS连网 (61)

图表列表

表 1 LinkIt ONE SDK的可用模块表 (4)

表 2 LinkIt ONE 开发板规格 (6)

图1 LinkIt ONE开发平台组件 (2)

图 2 LinkIt ONE开发平台的架构 (3)

图 3 开发与测试过程 (4)

图 4 LinkIt ONE开发板的引出脚配置 (6)

图 5 Arduino安装文件夹包含了Arduino.exe (10)

图 6 在结束前请框选install the MediaTek USB driver (11)

图 7 设置LinkIt ONE开发板选项 (11)

图 8 Micro USB 连接器在LinkIt ONE 开发板上 (12)

图 9 列在装置管理的LinkIt ONE开发板 (12)

图 10 在Arduino IDE指定到LinkIt ONE开发板串口号码 (13)

图11 Arduino.app文件夹内容显示LinkIt ONE SDK 插件 (14)

图12Normal bootup (UART)切换模式 (15)

图13 Mac OSX 的LinkIt ONE 开发板配置菜单选择 (15)

图14 在Arduino与不同Mac OS X 版本中配置LinkIt ONE 开发板的接口 (16)

图 15 在Arduino IDE工具栏的上传按钮 (17)

图 16 LinkItONE 板 LED (17)

图17 装置管理内的MTKUSB Modem 口(COMxx) (18)

图18 设置串口监视的接口 (18)

图19 在Mac OSX 选串口监视COM 接口 (19)

图 20 LinkIt ONE 大容量存储模式 (20)

图 21 在Arduino IDE文件夹内LinkIt Firmware Updater的位置 (20)

图22Arduino Package Content (21)

图 23 按下下载按钮来开始固件更新程序 (21)

图 24 更新开发板固件的说明 (21)

图 25 正在下载开发板的固件 (22)

图 26 固件更新已经完成 (22)

Medi aTe k Co

图27 安装BROM USB 驱动程序失败信息 (24)

图28 BROM USB 驱动程序安装许可配置 (25)

图29 安全与隐私设定和修改确认 (25)

图 30 SPI/SD 开关 (31)

图 31 LinkIt的耳机插孔 (36)

图 32 插入SIM卡并连接GSM天线的LinkIt ONE开发板 (38)

图 33插入SIM卡并连接GSM天线的LinkIt ONE开发板 Software setup (41)

图 34 接上Wi-Fi天线的LinkIt ONE开发板 (44)

图 35 接上天线的Wi-Fi/蓝牙天线的LinkIt ONE开发板 (47)

图 36 连接至LinkIt ONE蓝牙服务器 (51)

图 37 成功连接至LinkIt ONE蓝牙服务器 (51)

图 38 数入的文字会由LinkIt ONE回显 (52)

图 39 接上GPS天线的LinkIt ONE开发板 (57)

图 40 插入SIM卡并接上GSM天线的LinkIt ONE开发板 (61)

1.介绍

1.1.什么是 LinkIt?

MediaTek LinkIt?是为穿戴式与物联网 (IoT)所量身打造的开发平台收集,该开发平台收集分别于两个不同的家族系列:

?LinkIt Assist, 针对简单的应用适合可穿戴与物联网设备,例如智能腕带,智能手表和智能安全和跟踪设备。这些设备提供用户设备上的反馈和控制选项,还可以使用GSM短信,GPRS,Wi-Fi或蓝牙连接来与用户,其它智能设备和云应用来交换数据和控制消息。

?LinkIt Connect,针对单一应用适合物联网设备,例如智能灯泡以及智能家电并通过Wi-Fi或蓝牙连接,使用云服务和智能手机来做远端控制。

而每个开发平台又将提供一个或更多芯片组和个别的API,以满足客制式开发和设备的要求。因此,为了启动您创建原型器的创意,我们提供个别不同的开发平台工具包含:

?一个或更多HDK让您创建原型器。

?一个SDK让您为装置编程固件或软件。

?一个或更多硬件参考设计作为最终产品的电路板布局的基础。

?全面的文件例如 API 参考,开发指南,芯片组说明和引脚图。

?支持论坛。

1.2.联发科技 LinkIt ONE 开发平台

联发科技的LinkIt ONE开发平台(如图1)它替穿戴式与物联网装置提供既稳固又富弹性开发平台。此平台包含:

?联发科技 Aster (MT2502) 世界上最小的系统级芯片 (SoC) 和搭配低功耗的Wi-Fi和GPS芯片组。

?LinkIt ONE API。

?LinkIt ONE 硬件开发工具包(HDK)。

?LinkIt ONE 软件开发工具包(SDK)。

图1 LinkIt ONE开发平台组件

LinkIt ONE HDK包含了LinkIt ONE开发板,它与市面上功能最丰富的Arudino UNO的引脚相似。这块充满特色的开发板是联发科技与Seeed Studio(知名的创新平台先驱厂商)同设计的技术结晶。与UNO不同的是:开发板内置了所有LinkIt ONE API, GPS与Wi-Fi功能,并提供多样的接口来连接传感器与其他周边设备。

LinkIt ONE SDK以Arduino IDE插件呈现,是创客们软件开发工具的首选。安装此插件后,您能够容易的移植既有的Arduino代码到LinkIt ONE,并使用各种LinkIt ONE的通讯API:2G 移动式网络(GSM和GPRS)、蓝牙与Wi-Fi。

有了LinkIt ONE SDK与LinkIt ONE开发板,等同于具备了开发创新原型产品的一切工具。

如果您不熟悉Arduino,请参阅Arduino Playground wiki ,或访问https://www.sodocs.net/doc/d113571825.html, 以取得更多资讯。

1.3.LinkIt ONE 软件开发工具包 (SDK)

LinkIt ONE 软件开发工具包是以Arudino IDE插件方式发布。在SDK的API除了具备Arduino的核

心功能,并兼具LinkIt ONE开发平台独特的功能包括控制数字引脚与解析模拟传感器的输入,让您快

速的打造穿戴式与物联网原型产品。

如图 2所示,用LinkIt ONE SDK可以写出利用LinkIt ONE API的Arduino应用程序(Sketch)。这些API运行在 Run-time操作系统之上,来让你使用LinkIt ONE开发板上的功能。

图 2 LinkIt ONE开发平台的架构

如果您开发过Arduino,请点击联发科技LinkIt ONE API reference,可以发现大部分的模块是对应Arduino API风格所设计的,便于使用。

1.3.1.描绘你的构想

使用LinkIt ONE SDK编程就跟写Arduino Sketch一样简单。一个Arduino Sketch是一个源代码文件,代表了LinkIt ONE的核心控制逻辑。它包含了:

?setup()负责初始化资源,如Wi-Fi模块。

?loop()连续监听并处理由硬件传感器或软件模块(如蓝牙)产生的事件。loop()会不断的运行,直到开发板关机才会停止。

1.3.

2.运行Arduino Sketch

如图3所示,LinkIt ONE SDK首先将Sketch编译成LinkIt ONE执行文件(VXP文件)。IDE插件接下来会将VXP文件读入LinkIt ONE开发板的文件系统中。开机后,LinkIt ONE会自动执行加载的VXP 文件。VXP可执行文件是由run-time运行时环境加载的。

图 3 开发与测试过程

虽然Sketch是个单线程循环,Run-time的运行环境则是多线程的软实时环境。VXP是以一个独立的线程在运行。 Arduino插件的包装层则是负责传送请求到,在其他线程上运行的,服务模块。

1.3.3.LinkIt ONE API

LinkIt ONE SDK包含所有LinkIt ONE板可用的LinkIt ONE API,如表 1:

表 1 LinkIt ONE SDK的可用模块表

更多API的细节请参阅第 4章:LinkIt ONE API 指南;完整的API文档MediaTek LinkIt ONE API reference则在MediaTek 创意实验室网站上。

1.3.4.延伸你的Sketch

Sketch文件都是用C++编写,而LinkItAssist 2502执行环境的底层接口为C,编译工具链为GNU gcc 。这可能开创了使用C与C++开源库做为LinkIt ONE的可能性。然而SDK仅支持单线程的编程模式—以提供简单易用的硬件模型开发环境 —所以将依赖于多线程的程序库移植到LinkIt ONE不是一件容易的事。另一个加入外部程序库的考虑是:您的Sketch占用的RAM的大小,在LinkIt ONE开发板的4MB中仅有2MB可用。

1.4.硬件

LinkIt ONE是开源且高效能的开发板。核心为世界领先的穿戴式联发科Aster (MT2502) 系统芯片(SoC),合并了高效能Wi-Fi (MT5931)与GPS (MT3332) 芯片组,提供了功能丰富的开发板。也与Arduino UNO有着相似的连线引脚,以连接各种传感器与周边设备。

LinkIt ONE开发板是Seeed Studio与联发科技共同设计的产品。结合了双方对开源硬体与领先同行业的参考设计知识。

1.4.1.LinkIt ONE 接脚图

LinkIt ONE开发板提供与Arduino UNO相似的引脚设置,如图 4所示:

图 4 LinkIt ONE开发板的引出脚配置1.4.2.LinkIt ONE 开发板规格

表 2为LinkIt ONE开发板的详细规格

表 2 LinkIt ONE 开发板规格

1.5.加入我们的生态系统

下一波电子产品革新的浪潮已到来- 可穿戴与物联网设备。在此领域一直扮演关键角色的联发科技将两个领域的精华合并—联发科技的手机制造商、电子装置制造商与电信商的既有生态环境,同开放式、充满活力的Arduino创客社区相结合。不论您是个创客、设备制造商、学生、DIY爱好者,或是程序设计师,都可以用这个强大且易用的平台来做出创新的设计。欢迎前往https://www.sodocs.net/doc/d113571825.html,并加入联发科技创意实验室,我们期待您的加入并一同做出好产品。

2.开始使用

这章节提供开始LinkIt ONE开发平台的准备,包含了:

?支持的开发环境。

?安装Arduino IDE。

?安装与设置LinkIt ONE SDK。

?创建第一个项目。

2.1.环境

目前支持的环境为微软Windows XP、Vista, 7, 8与MacOS X10.09 或10.10。

2.2.安装联发科技LinkIt ONE SDK (针对Arduino)Windows 版本

本章节说明如何安装联发科技LinkIt ONE SDK(针对Arduino)在使用微软Windows 操作系统的电脑。

2.2.1.安装Arduino IDE

LinkIt ONE SDK以Arduino IDE 1.5.6-r2 BETA 和1.5.7 BETA 插件的形式发布。如果您已经安装一个支

持的Arduino ,您可以忽略这个步骤。如果您还没有安装,请依照:

1)从Arduino 网站下载Arduino软件

2)安装Arduino 。

3)安装结束后,请记下您安装Aruino 的文件夹,这也是arduino.exe(如图 5)所在的文件夹。

您将安装LinkIt ONE SDK到此文件夹。

图 5 Arduino安装文件夹包含了Arduino.exe

2.2.2.安装LinkIt ONE SDK

如何安装LinkIt ONE SDK:

1)由此下载Windows 版本的LinkIt ONE SDK (针对) ZIP文件。

2)解压LinkIt ONE SDK ZIP文件的内容。

3)确认Arduino IDE没有在运行。

4)执行LinkIt ONE SDK安装程序。

5)在Select Destination Location按下Browse并指定您安装Arduino IDE的文件夹(之前所提

到的)并点击Next。

6)SDK安装完成后的对话框如图 6所示。如果您是首次安装SDK,在按下Finish之前请确保框

选Install the MediaTek USB Driver。

图 6 在结束前请框选install the MediaTek USB driver

下一次更新SDK时就不用再安装联发科技USB驱动程序。

2.2.

3.设置Arduino IDE以使用LinkIt ONE开发板

现在您已经安装好LinkIt ONE SDK了,再设置好Arduino IDE即可使用您的LinkIt ONE开发板:

1)执行Arudino IDE。

2)在Arduino IDE的Tools选单指向Board然后点击LinkIt ONE,如图 7所示。

图 7 设置LinkIt ONE开发板选项

3)打开微软控制面板在点击系统:

o在Windows 7 and 8,点击装置管理。

o在Windows XP,点击硬件再选择装置管理。

4)在装置管理内,浏览Ports (COM & LPT),如图 9。

5)用Mirco-USB电缆线将LinkIt ONE开发板与电脑连接,如图 8。

图 8 Micro USB 连接器在LinkIt ONE 开发板上

6)一个新的COM装置会在装置管理的Ports (COM & LPT)底下出现,如图 9。请记下MTK USB

Debug Port,的COMx串口号码,会在下一步用到。

图 9 列在装置管理的LinkIt ONE开发板

7)在Arduino IDE的Tools选单上,指向Port再选择刚刚所记下的LinkIt ONE开发板串口号,

如图 10所示。

图 10 在Arduino IDE指定到LinkIt ONE开发板串口号码

您的Arduino IDE现在已经设置好LinkIt ONE SDK与LinkIt ONE开发板,您可以开始第一个项目了!

2.3.安装联发科技LinkIt ONE SDK (针对Arduino)苹果Mac版本

苹果Mac OS X 只有在联发科技LinkIt ONE SDK (针对Arduino) 1.1.08 (beta)版本支持。

本章节解释如何安装Mac 版本的联发科技LinkIt ONE SDK (Arduino 适用)在Mac OSX 10.09 或10.10 的电脑上。

2.3.1.安装Arduino软件

LinkIt ONE SDK 是个 Arduino1.5.6 或1.5.7BETA的插件。如果您已经安装了该Arduino软件,请直接看下一个章节,否则请按照以下步骤安装Arduino:

1)下载Java SE Runtime 环境7并安装在电脑上。

2)下载Arduino软件于Arduino网站。

3)安装Arduino软件至/Applications文件夹,并确认Arduino安装路径是

/Applications/Arduino.app.

2.3.2.安装LinkIt ONE SDK

请依照以下步骤安装LinkIt ONE SDK:

1)由此下载苹果Mac 版本的LinkIt ONE SDK ZIP 文件。

2)解压LinkIt ONE SDK ZIP文件的内容至您的Applications文件夹。

3)确认Arduino IDE没有在运行。

4)在Applications文件夹里打开Utilities,打开Terminal然后:

a)切换文件夹(用cd命令)至LinkIt ONE SDK ZIP文件, 例如

mediatek_linkit_sdk(for arduino)macosx-xxxx文件夹。

b)在LinkIt ONE SDK 文件夹里之后请执行以下命令:

# ./install_linkIt_sdk -i 您的_arduino_app 路径

您的arduino路径是指您的arduino app 文件夹,它通常是

/applications/arduino.app.

安装好之后,arduino.app文件夹内构造将与下图11相似:

图11 Arduino.app文件夹内容显示LinkIt ONE SDK 插件

2.3.3.配置Arduino软件准备使用LinkIt ONE 开发板

注:第一次使用LinkIt ONE 开发板时,建议您更新固件,请参考3.1 “固件更新请求“。

LinkIt ONE SDK 安装好之后您需要配置Arduino IDE 来使用LinkIt ONE 开发板。请依以下步骤配置动作:

1)请断开您的LinkIt ONE 开发板于您的Mac。

相关主题