Ehong EH-MC17 Manuale utente

EH-MC17

Command Interface User Guide

17 April 2019 Version 1.0

Professional Bluetooth Solution Provider

©Ehong Technology Co.,Ltd 2014-2019. 2-15

VERSION HISTORY

Version

Release Date

Comments

V1.0

2019-04-17

Release

Contact information

Sales [email protected].cn

Technical support support@ehlink.com.cn

Website http://www.ehonglink.com

Phone +86 21 64769993

Fax +86 21 64765833

Address Rm1505,1st,No.833 South Hongmei Rd, MinHang Dis, Shanghai, China

©Ehong Technology Co.,Ltd 2014-2019. 3-15

TABLE OF CONNECTENTS

1. Introduction............................................................................................................................................. 4

1.1. Default UART Configuration .................................................................................................................... 4

Command and Indicator Syntax

............................................................................................................... 4

2.2. General Syntax .......................................................................................................................................... 4

2.2. Description of each field............................................................................................................................ 4

2.3. Description of each field............................................................................................................................ 4

3. Command List........................................................................................................................................ 5

4. Indicator List........................................................................................................................................... 5

5.General Information Commands............................................................................................................. 5

5.1. RESET—The module is reset.................................................................................................................... 5

5.2. VERSION—Query firmware version........................................................................................................ 6

5.3. NAME—Query or Configure Module’s Name ......................................................................................... 6

5.4. LADDR —Query or Configure Advertise Type....................................................................................... 6

5.5. PIN—Query the module pairing code....................................................................................................... 7

5.6. BAUD—Query or Configure UART’s Baud Rate .................................................................................... 7

5.7. ADVMOD—Query or configure the Broadcasting mode......................................................................... 8

5.8. POWER—Query or Configure the TX Power level.................................................................................. 8

5.9. ADVDAT—Query or Configure Module’s Broadcast data (Beacon) ....................................................... 9

5.10. SCANRSP—Query or Configure Module’s response data (Beacon)...................................................... 9

5.11. ROLE —Query or Configure Module’s master/slave mode................................................................. 10

5.12. PHY2M—Query or Configure Module’s 2M schema.......................................................................... 10

5.13. SLEEP—Enter into DLPS..................................................................................................................... 10

5.14. PAIR—Query or Configure Module’s pairing mode..............................................................................11

5.15.FC—Query or Configure UART flow control........................................................................................11

5.16. BTFC—Query or Configure BTFC flow control................................................................................. 12

5.17. DEFAULT—Oftware reset(Restore the default Settings and restart after 500ms)................................ 12

5.18. INQ—Search for bluetooth devices (Master commands)...................................................................... 13

5.19. SINQ—Stop searching for bluetooth devices........................................................................................ 13

5.20. SCANRLT—Search the bluetooth address according to the number query.......................................... 13

5.21. CONN—Connect the remote device ..................................................................................................... 14

5.22. RF—Radio freqency test ....................................................................................................................... 14

6. Description of ASCII Commands.................................................................................................................... 15

6.1. OK—Command is Adopted by the Bluetooth Module............................................................................ 15

6.2. ER—Error................................................................................................................................................ 15

©Ehong Technology Co.,Ltd 2014-2019. 4-15

1. Introduction

The command interface is a set of ASCII commands and indicators with which the user can send command to

the Bluetooth module via UART interface from host (PC, MCU, etc.).

The commands are used to send to Bluetooth module from host. The indicators are output from the Bluetooth

module to the host for indicating the status of the module.

In addition, there are some IO indicators available when the UART is used to transfer raw data. As a

complement of ASCII commands and indicators, the IO indicators are also a part of AT COMMAND.

1.1. Default UART Configuration

The default configuration of UART is given below:

baud rate: 9600

Data bits: 8

Stop bits: 1 parity: None

Flow command: None

The default UUID of service is given below:

Service UUID : 11223344-5566-7788-99AA-BBCCDDEEFF00

Command and Indicator Syntax

2.2. General Syntax

The general syntax of AT command is shown as below:

→AT+CMD[=Para1][,Para2][, RawData] <CR><LF>

The general syntax of AT indicator is shown as below:

←IDC[=Para1]<CR><LF>

Note: 1. For the examples in this document, the command sent to the Bluetooth module will be shown with “→” at the beginning

of the line, while the indicator output by Bluetooth module will be shown with “←” at the beginning of the line.

2.2. Description of each field

“AT+” ：command line prefix.

“CMD”：command. All of the commands are listed in section 5.

“IDC” ：indicator. All of the indicators are listed in section 4.

“= ”：separator between command/indicator and parameter. It’s only needed if a

parameter is presented. Para1 is the first parameter. Not all of the commands have a parameter.

“,” ：separator between parameters. It’s only needed if subsequent parameter is presented. Para2 is

the second parameter if available. RawData is the raw data which will be sent by the command. Only parts of

the commands have this field.

<CR><LF>：terminator of the command, hex: 0x0d 0x0a

Notes:

All of the parameters are composed of ASCII characters while the RawData field can composed of any data contents.

In indicators, the module prints hex values in low case. For other places in the document we always use upper case

characters for hex values.

2.3. Description of each field

Here is some examples show how to use the AT commands and indicators.

→AT+NM=EH-LINK<CR><LF> configure the GAP device name characteristic. The newname is “EH-LINK”.

←OK<CR><LF> response from the module to indicate the command is adopted.

Notes:

For the examples in this document, the command sent to the Bluetooth Module will be shown with “→” at the beginning of the

line, while the indicator output by Bluetooth Module will be shown with “←” at the beginning of the line. “→”and“←” not

send with the ascii data.

EH-MC17 Command Interface User Guide

©Ehong Technology Co.,Ltd 2014-2019. 5-15

3. Command List

All the available AT commands are listed and briefly described in the tables below. The detailed description

of each command is given in chapter 5.

description of each command is given in chapter 5.

Command

Short Description

RESET

The module is reset.

VERSION

Query firmware version.

NAME

Query or configure the module name.

LADDR

Query module address.

Query or configure the Pairing code.

BAUD

Query or configure the baud.

ADVMOD

Query or configure the Broadcasting mode.

ADVEN

Turn the broadcast on or off.

ADVINT

Query or configure the Broadcast interval.

POWER

Query or configure the transmitted power.

ADVDAT

Query or configure the Broadcast data.

SCANRSP

Query or configure the SCAN Response data.

ROLE

Query or configure the master/slave mode .

PHY2M

Query or configure the 2M.

SLEEP

In DLPS.

PAIR

Query or configure the pairable mode.

INQ

Search for bluetooth devices.

SINQ

Stop searching for bluetooth devices.

SCANRLT

Search for bluetooth address by number.

CONN

Connect the remote device.

Query or configure the UART control current.

BTFC

Query or configure the BT control current.

DEFAULT

Software reset.

4. Indicator List

All the available AT command indicators are listed and briefly described in the tables below. The detailed

description of each indicator is given in chapter 5 and chapter 6.

Indicator

Short Description

Indicate successful after command was adopted.

Indicates error after give a command.

Reports current UART baud rate.

5.General Information Commands

5.1. RESET—The module is reset

5.1.1.Description:

This command resets the bluetooth module.

5.1.2. Syntax:

Synopsis:

→AT+RESET<CR><LF>

←OK<CR><LF>

5.1.3. Parameter Description:

None

EH-MC17 Command Interface User Guide

©Ehong Technology Co.,Ltd 2014-2019. 6-15

5.1.4. Examples:

Ex. 1. Reset bluetooth module:

→AT+ RESET <CR><LF> Reset bluetooth module.

←OK<CR><LF> Reset the success.

5.2. VERSION—Query firmware version.

5.2.1. Description:

This command retrieves the bluetooth firmware version

5.2.2. Syntax:

Synopsis:

→AT+VERSION<CR><LF>

←+VERSION =<Param><CR><LF>

5.2.3. Parameter Description:

Parameter

Description

Nvram

Comments

Param：patch Version (8

characters)+app Version (8

characters)

Both Patch and app version are 32-

bit, and the response of version is in

the form of string.

5.2.4. Examples:

Ex. Query the firmware version of the module:

→AT+ VERSION <CR><LF> Query the firmware version of the module.

←+VERSION =<Param><CR><LF> Response from the module to indicate the command is adopted.

5.3. NAME—Query or Configure Module’s Name

5.3.1. Description:

This command can query or configure the BLE Module’s name. It will take effect next power on.

5.3.2. Syntax:

Synopsis:

→AT+NAME[=Name]<CR><LF>

←+NAME=Name<CR><LF>

5.3.3. Parameter Description:

Parameter

Description

Nvram

Comments

[Name] will display

in advertising data.

Query or configure the BLEModule’s name.

YES

The length of the name

can’t over 18 bytes.

5.3.4. Examples:

Ex.a. To query the name of module:

→AT+NAME<CR><LF> Query the name of module.

←+NAME=EH-MC17<CR><LF> Response the name of the module.

Ex.b. Configure the name of the module:

→AT+NAME=TEST123<CR><LF> Configure the name of module as “TEST123”.

←OK<CR><LF> Response from the module to indicate the command is adopted.

5.4. LADDR —Query or Configure Advertise Type

5.4.1. Description:

This command gets the bluetooth module address.

EH-MC17 Command Interface User Guide

©Ehong Technology Co.,Ltd 2014-2019. 7-15

5.4.2. Syntax:

Synopsis:

→AT+LADDR[=Type]<CR><LF>

←+LADDR=<Param><CR><LF>

5.4.3. Parameter Description:

Parameter

Description

vram

Comments

[address]

module’s local mac address

The address format is: UAP,NAP,LAP

5.4.4. Examples:

Ex. To query the module’s address:

→AT+ LADDR <CR><LF> Query the module advertising type.

←+LADDR =<Param><CR><LF> Response the module’s address.

5.5. PIN—Query the module pairing code

5.5.1. Description:

This command queries the module pairing code.

5.5.2. Syntax:

Synopsis:

→AT+PIN<CR><LF>

←+PIN=<Param><CR><LF>

5.5.3. Parameter Description:

Parameter

Description

vram

Comments

The pairing code for

the module

Module’s pairing code

6 digit pairing code(Windows:123456)

5.5.4. Examples:

Ex. To reset the module:

→AT+PIN <CR><LF> Query the module’s address.

←+PIN=<Param><CR><LF> Response from the module to indicate the command is adopted.

5.6. BAUD—Query or Configure UART’s Baud Rate

5.6.1. Description:

This command can query or configure the UART baud rate of Bluetooth Module.Once changed, the new

baud rate willtake effect next power on. The Bluetooth module stores the value in its non-volatile memory so

the value won’t changeuntil be set again.If the command without parameter, the Bluetooth Module will report

current baud rate by indicator BD.

5.6.2. Syntax:

Synopsis:

→AT+ BAUD <CR><LF>

←+BAUD =<Param><CR><LF>

5.6.3. Parameter Description:

Parameter

Description

Nvram

Comments

[baudrate]

Range: 2400-921600

Module’s baudrate of UART speed.

2400 bps

9600 bps

19200 bps

38400 bps

Default: 115200

EH-MC17 Command Interface User Guide

©Ehong Technology Co.,Ltd 2014-2019. 8-15

57600 bps

115200 bps

230400 bps

460800 bps

921600 bps

5.6.4. Examples:

Ex.a. To query the baud rate of Bluetooth Module:

→AT+BAUD<CR><LF> Query the baud rate.

←+BAUD=9600<CR><LF> Report the baud rate, it’s 9600.

Ex.b. To change the baud rate of Bluetooth Module:

→AT+BAUD=115200<CR><LF> Change the baud rate to 115200.

←OK Response from the module to indicate the command is adopted.

5.7. ADVMOD—Query or configure the Broadcasting mode

5.7.1. Description:

This command can query and set broadcast mode.

5.7.2. Syntax:

Synopsis:

→AT+ ADVMOD <CR><LF>

←+ADVMOD =<Param><CR><LF>

→AT+ ADVMOD=<Param> <CR><LF>

←OK<CR><LF>

5.1.7.3. Parameter Description:

Parameter

Description

Nvram

Comments

Param（0，1）

0: Manual radio

1: Automatic radio

YES

Default: 1

5.7.4. Examples:

Ex.Query module broadcast mode:

→AT+ ADVMOD <CR><LF> Query module broadcast mode.

←+ADVMOD =<Param><CR><LF> Response from the module to indicate the command is adopted.

Ex. Configure module broadcast mode:

→AT+ ADVMOD =0<CR><LF> Configure module broadcast mode.

←OK<CR><LF> Response from the module to indicate the command is adopted.

5.8. POWER—Query or Configure the TX Power level

5.8.1. Description:

This command can query or configure the TX power value.

5.8.2. Syntax:

Synopsis:

→AT+POWER[=Power]<CR><LF>

←+POWER=Power<CR><LF>

5.8.3. Parameter Description:

Parameter

Description

Nvram

Comments

[Power]

Range: -20,0,3,4,8

Param（-20,0,3,4,8）：

-20：-20dBm

0：0dBm

3：3dBm

YES

Default: 0

EH-MC17 Command Interface User Guide

©Ehong Technology Co.,Ltd 2014-2019. 9-15

4：4dBm

8：8dBm

1：Automatic radio

5.8.4. Examples:

Ex. To query the module’s TX power level:

AT+POWER<CR><LF> Query the module’s power value.

+POWER=04<CR><LF> Response the module’s TX power value, level: 4.

AT+POWER=01<CR><LF> Configure the module’s TX power value.

OK<CR><LF>Response from the module to indicate the command is adopted.

he module to indicate the command is adopted.

5.9. ADVDAT—Query or Configure Module’s Broadcast data (Beacon)

5.9.1. Description:

This command can query or set the broadcast data of the module.

5.9.2. Syntax:

Synopsis:

→AT+ ADVDAT <CR><LF>

←+ADVDAT = <Param> <CR><LF>

5.9.3. Examples:

Parameter

Description

Nvram

Comments

Query or configure Module’s

broadcast data

<Param>less than or equal to31*2

Only valid in beacon mode

5.9.4. Examples:

Ex. a.To Query the module’ broadcast data:

→AT+ ADVDAT <CR><LF> Query the module’s broadcast data.

←+ADVDAT = <Param><CR><LF> Response the module’s state is fast advertising.

Ex. b.To Configure the module’ broadcast data:

→AT+ ADVDAT =<Param><CR><LF> Configure the module’s broadcast data.

←OK<CR><LF> Response the module’s state is fast advertising.

5.10. SCANRSP—Query or Configure Module’s response data (Beacon)

5.10.1. Description:

This command can query or set the response data of the module.

5.10.2. Syntax:

Synopsis:

→AT+ SCANRSP <CR><LF>

←+SCANRSP =<Param><CR><LF>

5.10.3. Examples:

Parameter

Description

Nvram

Comments

Query or Configure

Module’s response

data

<Param>less than or equal to31*2

Only valid in beacon

mode

5.10.4. Examples:

Ex. To query the module’ response data:

→AT+ SCANRSP <CR><LF> Query the module’s response data.

←+SCANRSP = <Param><CR><LF> Response the module’s state is fast advertising.

Ex. To Configure the module’ response data:

EH-MC17 Command Interface User Guide

→AT+ SCANRSP =<Param><CR><LF> Configure the module’s response data.

←OK<CR><LF> Response the module’s state is fast advertising.

5.11. ROLE —Query or Configure Module’s master/slave mode

5.11.1. Description:

This command can query or configure the module’s master/slave mode.

5.11.2. Syntax:

Synopsis:

→AT+ ROLE<CR><LF>

←+ROLE =<Param><CR><LF>

5.11.3. Parameter Description:

Parameter

Description

Nvram

Comments

Param（0，1）：

0：slave

1：master

2：beacon

Default: 0

5.11.4. Examples:

Ex. Query or configure the module’s master/slave mode:

→AT+ ROLE <CR><LF> Query the module’s master/slave mode:.

←+ROLE =<Param><CR><LF> Response from the module to indicate the command is adopted.

5.12. PHY2M—Query or Configure Module’s 2M schema

5.12.1. Description:

This command can query or configure Module’s 2M schema.

5.12.2. Syntax:

Synopsis:

→AT+ PHY2M <CR><LF>

←+PHY2M =<Param><CR><LF>

5.12.3. Parameter Description:

Parameter

Description

Nvram

Comments

Param（0，1）：

0：1M

1：2M

Default: 0

5.12.4. Examples:

Ex. Query the module’s 2M schema:

→AT+ PHY2M <CR><LF> Query the module’s 2M schema.

←+PHY2M =<Param><CR><LF> Response the module’s connection parameter.

Ex. Configure the module’s connection parameter:

→AT+ PHY2M =1<CR><LF> Configure the Module’s 2M schema.

←OK<CR><LF> Response from the module to indicate the command is adopted.

5.13. SLEEP—Enter into DLPS

5.13.1. Description:

This command can enter disconnected mode.

EH-MC17 Command Interface User Guide

Indice

Altri manuali Ehong Unità di controllo

Ehong

Ehong EH-MB05 Manuale utente

Ehong

Ehong EH-MC10 Manuale utente

Ehong

Ehong EH-MA41 Manuale utente

Manuali Unità di controllo popolari di altre marche

Festo

Festo Compact Performance CP-FB6-E Manuale elenco delle parti

Elo TouchSystems

Elo TouchSystems DMS-SA19P-EXTME Manuale utente

JS Automation

JS Automation MPC3034A Manuale utente

JAUDT

JAUDT SW GII 6406 Series Guida rapida

Spektrum

Spektrum Air Module System Manuale utente

BOC Edwards

BOC Edwards Q Series Manuale utente

KHADAS

KHADAS BT Magic Manuale utente

Etherma

Etherma eNEXHO-IL Manuale utente

PMFoundations

PMFoundations Attenuverter Manuale utente

GEA

GEA VARIVENT Manuale utente

Walther Systemtechnik

Walther Systemtechnik VMS-05 Manuale utente

Altronix

Altronix LINQ8PD Istruzioni per il montaggio

Eaton

Eaton Powerware Series Manuale utente

WAGO

WAGO 750-407/040-000 Manuale utente

Sony

Sony CCU-590 Manuale utente

Graco

Graco 25D614 Manuale utente

Task Force Tips

Task Force Tips YE-RF-900 Manuale di programmazione

Shini

Shini SPV-U Series Manuale utente