FAQ

On this page you can find answers to many of the questions developers frequently ask about MediaTek LinkIt ONE development platform for IoT and wearable devices. Discover answers in the following categories:

About the development platform

What is LinkIt ONE?

LinkIt ONE is a development platform designed to enable the creation of Wearables and IoT devices, with rich connectivity, small footprint, and optimized power consumption.

What is the definition of Mobile IoT?

Devices that can be always-connected to the network through a 2G modem (GSM/GPRS) but aren’t able to connect permanently to a Wi-Fi network. Examples include: car trackers, remote monitors, and similar devices.

What can I create using the LinkIt ONE development platform?

Using the LinkIt ONE development platform you can create:

  • Software to control Wearables and IoT devices
  • Prototype devices using a LinkIt ONE development board

Why should I be developing for the LinkIt ONE development platform?

The market for Wearables and IoT devices is expected to grow rapidly over the next few years, creating new opportunities for software and hardware developers, makers, and manufacturers. By starting to develop with the LinkIt ONE development platform today, you have the opportunity to be among the first entrepreneurs in this exciting space.

Can you show me any examples of what other makers/manufacturers have created with LinkIt ONE?

You can find commercial products and example projects and based on LinkIt development boards in our Showcase page. 

Hardware features

What is Aster?

Aster is the code name for the MediaTek MT2502, MediaTek’s a System-on-Chip (SOC) for Wearables and IoT devices, which is the smallest such product on the market (Sept 2014).

What chipsets are used in the LinkIt ONE developer platform?

The core chipset used is MT2502 (Aster), which is ideal for Wearables and IoT devices. The LinkIt ONE development platform also provides Wi-Fi and GNSS support using the optional companion Wi-Fi (MT5931) and GNSS (MT3332) chipsets.

Does the LinkIt ONE development platform support Bluetooth?

Yes, MT2502 (Aster) has built-in Bluetooth 2.1 and 4.0, with Dual Mode support.

Does the LinkIt ONE development platform support Wi-Fi?

Yes. By adding the MediaTek Wi-Fi companion chipset (MT5931) to a hardware design, LinkIt ONE devices can provide Wi-Fi connections (802.11 b/g/n).

Does the LinkIt ONE development platform support Global Navigation Satellite System (GNSS) technology?

Yes. By adding the MediaTek GNSS companion chipset (MT3332) to a hardware design, LinkIt ONE devices can include GNSS functionality (GPS/GLONASS/BeiDou).

What mobile (cellular) network technologies does the LinkIt ONE development platform support?

The MT2502 (Aster) chipset provides the LinkIt ONE development platform with support for GSM and GPRS cellular network technologies. These enable LinkIt ONE devices to send and receive SMS messages, and transmit and receive packet data over a 2G network.

It seems MediaTek provides different versions of the MT2502 (Aster) chipset. What is the difference between MT2502D and MT2502A?

The Aster chipset comes in two versions:

  • The MT2502A that offers 2G modem support, contains built-in 32Mb RAM, and uses external Flash.
  • The MT2502D that contains 32Mb RAM and 32Mb ROM built-in (but has no 2G modem).

Software development

What is the software development environment for the LinkIt ONE development platform?

Software for the LinkIt ONE development platform is created with the LinkIt ONE SDK (for Arduino) (get started here).

What can I do with the LinkIt ONE SDK (for Arduino)?

The LinkIt ONE SDK (for Arduino) provides a plug-in for the Arduino software (IDE). This plug-in provides an API that enables you to get existing Arduino sketches up and running on LinkIt ONE devices with little or no modification. The API also includes support for the unique features of the LinkIt ONE development platform, such as GNSS and GSM support. As such the SDK enables you to create demonstrations and rapidly prototype (conceptualize in the pre-production phase) new Wearables and IoT devices.

Can I create user apps with the LinkIt ONE development platform?

The LinkIt ONE API doesn’t include a UI library, nor does the LinkIt ONE development board include a screen. However, you’ve a number of options for facilitating user interaction with a LinkIt ONE prototype:

  • Adding a display peripheral by using the SPI or I2C interfaces and coding a simple UI.
  • Creating companion apps and/or cloud-services and using the extensive communication options: USB, Bluetooth, Wi-Fi, GPRS, and SMS.

What computers does the LinkIt ONE SDK (for Arduino) run on?

The LinkIt ONE SDK is currently supported on computers running Microsoft Windows XP, Vista, 7, 8 and 10 and Apple Mac OSX 10.9, 10.10 and 10.11.

Hardware development

What is the hardware development environment for the LinkIt ONE development platform?

The LinkIt ONE development board (designed and produced by Seeed Studio), based on MediaTek's hardware reference design, is used to create hardware prototypes.

What MediaTek chipset does the LinkIt ONE development board use?

LinkIt ONE development board uses MediaTek MT2502A as its main processor, together with Wi-Fi (MT5931) and GNSS (MT3332) chipsets to provide complete communication and positioning features.

Can I design my own hardware based on the LinkIt ONE development board?

Yes, the schematic, layout design, and Bill of Material (BOM) are available for download as part of the Hardware Reference Design package. You can also find technical briefs for the chipsets on the LinkIt ONE Documentation page.

The LinkIt ONE development platform doesn’t seem to include the sensors/controllers I need for my device, what can I do?

The LinkIt ONE development board is able to interface with a wide variety of analog and digital sensors and controllers. You should be able to add the hardware you need for your device.

Purchasing the LinkIt ONE development board

Where do I purchase the LinkIt ONE development board?

The LinkIt ONE development board is available from Seeed Bazaar, selected Seeed distributors and TMALL.

Going to market with a LinkIt ONE- based wearable or IoT device

How can I buy the MT2502A, MT5931 and MT3332 chipsets to make my own products?

MediaTek only sells chipsets directly to licensed customers and partners. Many of our partners (for example Seeed Studio) or other OEMs/ODMs will be happy to work with you to prototype and manufacture your hardware design.

Can I buy modules (similar to that available for the LinkIt Connect 7681 development platform) for the MT2502A, MT5931 and MT3332 chipsets?

Modules containing the MT2502A, MT5931 or MT3332 chipsets aren’t provided in the development platform.

Do I have to create every aspect of my LinkIt ONE device from scratch?

No, MediaTek provides the LinkIt ONE hardware reference design and, through partner Seeed Studio, the LinkIt ONE development board. This board provides the core elements of any hardware design enabling you to focus on designing and prototyping the unique aspects of your device.

How do I get my LinkIt ONE devices to market?

The MT2502 (Aster) SOC, development boards, and SDK from the LinkIt ONE development platform, make it possible for anyone with an idea to turn it into reality. However, we recognize that for the Maker Community taking a prototype to production can be a difficult step.

So as part of the MediaTek Labs program we’ll also help you connect with prototype houses (such as Seeed Studio) as well as ODMs and device manufacturers, so that you can take the necessary steps towards commercializing your Wearables and IoT ideas. If you need help making those connections, please contact us.

Can you show me any examples of what other makers/manufacturers have created with the LinkIt ONE development platform?

We expect to be showcasing examples of products based on the platform shortly.

LinkIt ONE development board troubleshooting

Windows cannot detect the USB COM port of my LinkIt ONE development board, what could be wrong?

Make sure the Windows USB COM port driver is installed. To do this, open Control Panel then Programs and Features (Uninstall a program) and check that MediaTek inbox_COM_Driver x.xx.xx.x is present. Then, check that the Mass Storage Bootup (MS)/Normal Bootup (UART) switch is in the Normal Bootup (UART) position. Lastly, plug in the LinkIt ONE development board.

If you see an Alcatel RNDIS device appearing and disappearing in Device Manager when connecting and disconnecting the LinkIt ONE development board, return to Programs and Features (Uninstall a program) and uninstall the COM port driver. Once the driver is uninstalled in Control Panel, open System and then click Advanced system settings. In the System Properties window click Hardware then Device Installation Settings and ensure Never install driver software from Windows update is selected, as shown below. For Windows 8 and 10, also ensure that Automatically get the device application and information provided by your device manufacturer isn’t selected.

Windows 7 Device Installation Settings


Windows 8 and 10 Device Installations Settings

Now re-install the COM port driver, using the download from here. When installation is complete, plug in the LinkIt ONE development board. Your board’s COM port should now be correctly identified.

The COM port appears and disappears when connecting or resetting the board, why is that?

The USB COM ports on the LinkIt ONE development board are emulated by the MT2502 SOC. So when the chip is reset, such as after uploading sketches, the COM ports will disappear.

LinkIt ONE firmware updater fails to install and detect the board, what can I do?

Make sure you have installed the LinkIt ONE development board’s Windows USB COM port driver . Before starting a firmware update, make sure the Mass Storage Bootup (MS)/Normal Bootup (UART) switch is in the Mass Storage Bootup (MS) position. If the switch is in the Normal Bootup (UART) position, the firmware updater will report a timeout error. For more details see Get Started, Update Your Board’s Firmware for Windows or Mac.

My Apple Mac cannot detect the USB COM port of the LinkIt ONE development board, what might be wrong?

Make sure you are running the LinkIt ONE SDK (for Arduino) version 1.1.09 or later and that you have installed the OS X COM port driver.  Update the board’s firmware, for more details see the Get Started, Update Your Board’s Firmware for Mac and, if you are running OS X 10.10, section 3.4.1, “A Solution to Enable USB COM Port Access on Mac OS X 10.10” in the LinkIt ONE Developer’s Guide. Apple OS X should detect the COM port when the board is connected to your computer. 

My SIM card doesn’t work, what could the problem be?

The LinkIt ONE development board supports GSM and GPRS (2.5G) only. 3G-only SIM cards are not supported. To connect to GPRS, make sure the values of APN, user name and password from your SIM card’s network carrier settings are correct in the attachGPRS () function of your sketch. For more information, see LGPRSClass::attachGPRS Method in the LinkIt ONE API Reference.

The board keeps resetting itself, why is that?

If there is no battery connected, make sure the USB Power Source (USB)/Li-Battery Power Source (BAT) switch is in the USB Power Source (USB) position. If you switch to Li-Battery Power Source (BAT) mode without attaching a battery, the board will keep resetting itself.

When I try to upload my sketch to the LinkIt ONE development board, I’m constantly getting the message "Please upgrade your firmware" — what can I do?

There is a utility included in the LinkIt ONE SDK (for Arduino) to update the firmware of your board. Run this and you should resolve the issues. For details, please see the LinkIt ONE Developer’s Guide.

My Sketches no longer seem to be uploading to my board, what could be wrong?

Please check the troubleshooting guide provided in the LinkIt ONE Developer’s Guide, section 3.2, “Sketches no longer uploading to LinkIt ONE” that should help you resolve the issue. If it doesn’t help, you may find useful information in the Arduino Troubleshooting Guide or by searching the discussion forum (and adding a new discussion if the issue hasn’t been discussed yet).

My board seems to have stopped working, what do I do?

If you haven’t been able to get your board working by following the troubleshooting guide in the LinkIt ONE Developer’s Guide or on the Arduino website, following any advice in the discussion forums and resetting the firmware by performing an upgrade, there may be a fault with your board’s hardware. In this case please contact technical support at Seeed Studio.

How do I connect my peripherals to the LinkIt ONE development board?

The LinkIt ONE development board provides a variety of analog and digital pins for connecting peripherals. If the information provided with your peripheral doesn’t seem to have the necessary details you need to do this, consider contacting the peripheral supplier or posting a query in the discussion boards.

My peripheral doesn’t seem to work with my LinkIt ONE development board, what might I be doing wrong?

Some peripherals are known to have limitations when used in conjunction with the LinkIt ONE development board; details are provided in the LinkIt ONE Developer’s Guide. If your peripheral isn’t on this list, please search the discussion forum (and add a new discussion if the issue hasn’t been discussed yet).

I’m developing for AWS IoT cloud and my sketch upload fails, how do I fix it?

If your sketch fails to upload to the LinkIt ONE development board, giving an error message indicating, among other things, that ‘macro "connect" requires 3 arguments, but only 1 given‘ disable the connect function in vmsock.h library as follows:

  1. Navigate to Arduino\hardware\arduino\mtk\system\libmtk\include folder.
  2. Open the file vmsock.h and comment the line 1332, as shown below.

    //#define connect(s, addr, len)
    vm_connect(s, addr, len)
  3. Save the file.

Retry the sketch upload and it should now work.