MXCHIP EMC3090-P Manuale utente

IoT system Solution Provider

MXCHIP Inc. 1/ 21 www.mxchip.com

2.4GHz Wi-Fi/BLE Wireless Module

EMC3090-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-3090

MXKit series Development kit consists of two parts:

⚫MXKit-Base: Development Base Board.

⚫MXKit-Core-3090: Development core board of wireless module; 3090 is for EMC3090-P

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.11.13.

Initial Version

2Overview

- Device: MXCHIP IoT development kit MXKit-3090.

- 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

EMC3090-P Datasheet:

https://cdn.mxchip.com/mxchip_official_website/pdf/DS0169EN_EMC3090_V1.6.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-3090 *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-3090

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 emc3090

9Build the demo

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

> mdev build -c app emc3090

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 emc3090 -f APP

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

Indice

Altri manuali MXCHIP Modulo wireless

MXCHIP

MXCHIP EMC3080-P Manuale utente

Manuali Modulo wireless popolari di altre marche

Laird

Laird RM024 Manuale utente

Laird

Laird BT830-SA Guida rapida alla configurazione

Ebyte

Ebyte E49-400T20S Manuale utente

Fibocom

Fibocom FM101-NA-20 Istruzioni per l'installazione

Waldmann

Waldmann EnOcean TALK MODUL G2 Manuale utente

Smartech

Smartech LBT-1.DO4 Manuale utente

Cooper Wiring Devices

Cooper Wiring Devices ESPIRE RF RFAPM Manuale utente

Yuga

Yuga CLM920 Manuale utente

Waldmann

Waldmann TALK Bluetooth Manuale utente

Telit Wireless Solutions

Telit Wireless Solutions UC864-G Manuale di installazione

Ebyte

Ebyte E07-900M10S Manuale utente

Quectel

Quectel SC690A Series Supplemento

Panasonic

Panasonic INDUSTRY PAN9028 Guida rapida alla configurazione

Ebyte

Ebyte E70-433NW30S Manuale utente

LongSung Technology

LongSung Technology U9507E Manuale utente

Wistron NeWeb

Wistron NeWeb DNUR-S2 Manuale utente

Ebyte

Ebyte E49-400M20S4 Manuale utente

RF-Star

RF-Star SimpleLink RF-BM-2652P1 CC2652P Manuale utente