MXCHIP EMC3080-P Manuel utilisateur

IoT system Solution Provider

MXCHIP Inc. 1/ 21 www.mxchip.com

2.4GHz Wi-Fi/BLE Wireless Module

EMC3080-P

Getting Started Guide for AWS IoT Core

 
 IoT system Solution Provider 
MXCHIP Inc. 2/ 21 www.mxchip.com 
 
 
 
Table of Contents 
1Document Information .......................................................................................................... 3 
2Overview ................................................................................................................................. 3 
3Hardware Description............................................................................................................ 3 
4Set up your Development Environment ................................................................................ 4 
5Set up your hardware............................................................................................................. 6 
6Setup your AWS account and Permissions........................................................................... 7 
7Create Resources in AWS IoT............................................................................................... 7 
8Provision the Device with credentials ................................................................................... 7 
9Build the demo ..................................................................................................................... 10 
10 Run the demo ....................................................................................................................... 10 
11 Debugging ............................................................................................................................ 19 
12 Troubleshooting ................................................................................................................... 19 
 
 
 

IoT system Solution Provider

MXCHIP Inc. 3/ 21 www.mxchip.com

1Document Information

1.1 Naming Conventions

Development Kit Model：MXKit-3080/3280

MXKit series Development kit consists of two parts:

⚫MXKit-Base: Development Base Board.

⚫MXKit-Core-3080/3180: Development core board of wireless module; 3080 is for

EMC3080-P serial module model ; 3280 is for EMC3280 serial module model.

More detail, please refer to MXKit Datasheet, product introduction page is:

https://docs.mxchip.com/en/nr6ggk/hetuodp9yyb3l8u3.html

Download link is:

https://docs.mxchip.com/attach/en/UM0010EN_MXKit_Development_Kit_Datasheet_V1.2.pdf

1.2 Glossary

Name

Description

Link

MXOS

A microcontroller-based Internet access

operating system, an ideal software

platform for developing IoT devices.

https://docs.mxchip.com/en/xgk73y/anum

5d.html

mdev tool

MXCHIP MXOS developing management

tool including toolchain installation, project

importing, firmware build, flash.

https://docs.mxchip.com/en/xgk73y/fq9v4

g/yaqqcr2oa1za0xs3.html

1.3 Revision History (Version, Date, Description of change)

Revision

Date

Revision

Description

2023.1.18.

Initial Version

2Overview

- Device: MXCHIP IoT development kit MXKit-3080.

- Product family: MXCHIP Wi-Fi && BLE wireless module based on IoT chip RTL8720CF.

- Target applications:

Appliances, Home Automation, Lighting, Building Automation, Data Logging, Diagnostics,

HVAC, Industrial Automation, Medical Devices, Robotics, Solar and so on.

3Hardware Description

3.1 Datasheet

EMC3080-P Datasheet:

https://cdn.mxchip.com/mxchip_official_website/pdf/DS0156EN_EMC3080_V1.1.pdf

IoT system Solution Provider

MXCHIP Inc. 4/ 21 www.mxchip.com

3.2 Standard Kit Contents

Kit includes:

⚫MXKit-Base V2.1 *1

⚫MXKit-Core-3080/3280 *1

Debug hardware:

⚫JLink V9

Cables:

⚫MicroUSB cable

About Kit information:

MXKit Datasheet:

https://docs.mxchip.com/attach/en/UM0010EN_MXKit_Development_Kit_Datasheet_V1.2.pdf

⚫

3.3 User Provided items

⚫In order to develop and debug

，

you need buy Jlink Debugger.

3.4 3rd Party purchasable items

1. USB cable: typeA to microB

2. Debugger/programmer:

JLink base V9 or later, purchase link：

https://www.segger.com/products/debug-probes/j-link/models/j-link-base

3.5 Additional Hardware References

None.

4Set up your Development Environment

4.1 Tools Installation (IDEs, Toolchains, SDKs)

⚫IDE

OS: MacOS V10.15.7 or later (recommended), Windows10/11-x64

IDE: Visual Studio Code V1.73.1 or later.

i. Download and install the visual studio code from:

https://code.visualstudio.com/Download

ii. Open terminal from the visual studio code:

- Click menu: Terminal -> New terminal

- Or press shortcut key: Control + ~

Install SDK(mdev tool) from terminal:

IoT system Solution Provider

MXCHIP Inc. 5/ 21 www.mxchip.com

> pip3 install mdev

> mdev --version

⚫mdev tool commands:

- help: mdev -h

- build: mdev build -c <target> <board> -D<macro>=<value>

- flash: mdev build <target> <board> -f <image_type>

⚫Serial port driver and terminal GUI tool, such as

- secureCRT:

https://www.vandyke.com/cgi-bin/releases.php?product=securecrt

⚫Serial port setup:

- baudrate: 115200 bps

- data bits: 8

- stop bit: 1

- parity: none

- flow control: none

⚫Get SDK and learn

- Download the SDK and demo source code from command lines:

git clone --recursive [email protected]:mxchip/mxos/cloud-aws/aws-iot-core-

demo.git

- SDK structure:

➜aws-demo git:(master) ✗tree -L 1

├── CMakeLists.txt # build script

├── Kconfig

├── README.md

├── app # application/demo code

├── build # build output files

├── lib_aws_iot_core # AWS IoT component

└── mxos # MXOS core component

4.2 Other software required to develop and debug applications for the device

None.

4.3 Other pre-requisites

1. Python3 installed on your PC.

Python3 V3.7.x or later: https://www.python.org/downloads/

2. Git installed on your PC.

git V2.33.0 or later: https://git-scm.com/downloads

IoT system Solution Provider

MXCHIP Inc. 6/ 21 www.mxchip.com

4.4 Additional Software References

About install mdev tool：

https://docs.mxchip.com/en/xgk73y/fq9v4g/yaqqcr2oa1za0xs3.html

5Set up your hardware

MXKit-3080

Connection:

- MXKit VCP dirver: https://www.silabs.com/developers/usb-to-uart-bridge-vcp-

drivers?tab=downloads

- JLink driver: https://www.segger.com/downloads/jlink/

IoT system Solution Provider

MXCHIP Inc. 7/ 21 www.mxchip.com

6Setup your AWS account and Permissions

Refer to the online AWS documentation at Set up your AWS Account. Follow the steps outlined

in the sections below to create your account and a user and get started:

•Sign up for an AWS account

•Create a user and grant permissions

•Open the AWS IoT console

Pay special attention to the Notes.

No special for MXCHIP.

7Create Resources in AWS IoT

Refer to the online AWS documentation at Create AWS IoT Resources. Follow the steps

outlined in these sections to provision resources for your device:

•Create an AWS IoT Policy

•Create a thing object

Pay special attention to the Notes.

Create your own thing for test and download device certificates(see next section 8 “Provision the

Device with credentials”).

8Provision the Device with credentials

Create AWS signed certificates device for testing, download and activate them:

IoT system Solution Provider

MXCHIP Inc. 8/ 21 www.mxchip.com

IoT system Solution Provider

MXCHIP Inc. 9/ 21 www.mxchip.com

Note: [Optional] This policy is not needed for the qualification test suite.

You can create your policy before thing creating if needed. Refer to section 7 “Create an

AWS IoT Policy”.

IoT system Solution Provider

MXCHIP Inc. 10 / 21 www.mxchip.com

1. Update macro defines in file

aws_demo/lib_aws_iot_core/demos/mqtt/mqtt_demo_basic_tls/demo_config.h:

// get from thing certificate files:

AWS_ROOT_CA

AWS_CLIENT_CERT

AWS_CLIENT_KEY

// get when creating the qualification test suite

BROKER_ENDPOINT

CLIENT_IDENTIFIER

MQTT_EXAMPLE_TOPIC

2. Rebuild the target executable firmware for testing.

> mdev build -c app emc3080 -DAWS_IOT_CORE_DQP=1

9Build the demo

Build in the termial of the visual studio code from the SDK root directory:

> mdev build -c app emc3080 -DAWS_IOT_CORE_DQP=1

10 Run the demo

1. Connect the borad and debugger to your PC(see the connection picture in sectino 5 “Set up

your hardware”);

2. Flash the demo firmware in the terminal of the visual studio code from the SDK directory:

> mdev build -c app emc3080 -f APP -DAWS_IOT_CORE_DQP=1

3. Open serial port in the secureCRT to see the device serial log:

Table des matières

Autres manuels MXCHIP Module sans fil

MXCHIP

MXCHIP EMC3090-P Manuel utilisateur

Manuels Module sans fil populaires d'autres marques

Laird

Laird RM024 Manuel utilisateur

Laird

Laird BT830-SA Guide de configuration rapide

Ebyte

Ebyte E49-400T20S Manuel utilisateur

Fibocom

Fibocom FM101-NA-20 Instructions d'installation

Waldmann

Waldmann EnOcean TALK MODUL G2 Manuel utilisateur

Smartech

Smartech LBT-1.DO4 Manuel utilisateur

Cooper Wiring Devices

Cooper Wiring Devices ESPIRE RF RFAPM Manuel utilisateur

Yuga

Yuga CLM920 Manuel utilisateur

Waldmann

Waldmann TALK Bluetooth Manuel utilisateur

Telit Wireless Solutions

Telit Wireless Solutions UC864-G Manuel d'installation

Ebyte

Ebyte E07-900M10S Manuel utilisateur

Quectel

Quectel SC690A Series Supplément

Panasonic

Panasonic INDUSTRY PAN9028 Guide de configuration rapide

Ebyte

Ebyte E70-433NW30S Manuel utilisateur

LongSung Technology

LongSung Technology U9507E Manuel utilisateur

Wistron NeWeb

Wistron NeWeb DNUR-S2 Manuel utilisateur

Ebyte

Ebyte E49-400M20S4 Manuel utilisateur

RF-Star

RF-Star SimpleLink RF-BM-2652P1 CC2652P Manuel utilisateur