A python terminal tool for configuring HC-05 bluetooth module with AT mode

• Installation
• Run
• Usage
• About HC-05 AT Mode
• Change Log
• Dependencies
• Licence

$ pip3 install HC-05-ConfigTool

$ git clone https://github.com/Doma1204/HC-05-ConfigTool.git
$ cd HC-05-ConfigTool
$ python3 setup.py install

To run the terminal tool, type the following command

$ python -m hc05config

If your computer have both Python2 and Python3, use python3

$ python3 -m hc05config

After typing the command above, you should see a panel and you are prompted to select one of the job.

Please select the following job:
1. Get basic Information of the HC-05
2. Config a HC-05
3. Set up a pair of master and slave HC-05
4. Manage preset
Please enter 1-4, or press enter to exit: 

The tool retrieves and displays all the basic information of the HC-05 module. The following is a sample output.

Information of the HC-05 bluetooth module
-----------------------------------------
Name: HC-05 Bluetooth
Baud rate: 9600
Stop bit: 0
Parity bit: 0
Password: 1234
Address: ABCD:2B:1234
Version: 3.0-20170601
Role: Slave(0)
Connection mode: 1
Bind address: 0:0:0
-----------------------------------------

If the HC-05 module has not entered AT mode, the following warning message will be recieved. You should set the module to AT mode before pressing enter.

The bluetooth module have not entered AT mode yet, please fix your module and then press enter

The tool retrieves all the basic information of the HC-05 module and asks for item(s) to configure. The following is a sample output.

Please select the item you want to change:
1. Name: HC-05 Bluetooth
2. Baud Rate: 9600
3. Stop Bit: 0
4. Parity Bit: 0
5. Password: 1234
6. Role: 0
7. Connection Mode: 1
8. Bind Address: 0:0:0
Please enter 1-8, or press enter to exit: 

Press enter to start writing changes to the module. The configuration can be saved to a preset for later use if multiple modules are needed to be configure with same or similar configuration.

The tool can help set up a pair of master and slave. It can be done by using one serial port or two serial ports. You need to plug and remove the master module and slave module multiple times during the set up process if you choose to set up with one serial port.

You are prompted to enter the name of the two modules, baud rate, stop bit and parity bit for setting the pair. Follow the instructions on the display to set up the pair. Presets can also be used in the mode.

There are serval features for managing presets.

Sample output:

Please select the following job:
1. View preset
2. Edit preset
3. Rename preset
4. Copy preset
5. Delete preset
6. Export preset
7. Import preset
Please enter 1-7, or press enter to exit: 

Follow the instructions after selecting the job to manage preset.

Sample Preset for configuring HC-05:

{
    "Name": "HC-05 Bluetooth",
    "Baud Rate": 9600,
    "Stop Bit": 0,
    "Parity Bit": 0,
    "Password": "1234",
    "Role": 0,
    "Connection Mode": 1,
    "Bind Address": "0:0:0"
}

Sample Preset for configuring master and slave pair:

{
    "Master Name": "Master",
    "Slave Name": "Slave",
    "Baud Rate": 9600,
    "Stop Bit": 0,
    "Parity Bit": 0
}

Presets are saved on the user home directory(~/.hc05config_preset). Note that uninstall the package by using pip uninstall HC-05_ConfigTool does not delete the preset file.

AT mode is the main way to config the HC-05 Bluetooth module. For the details of AT mode, please refer to the document that I found in the Internet.

This package does not fully support all HC-05 AT mode commands. The supported commands are listed below:

• AT+VERSION
• AT+ADDR
• AT+NAME
• AT+ROLE
• AT+PSWD
• AT+UART
• AT+CMODE
• AT+BIND

For the complete changelog, please refer to CHANGELOG.md.

• If preset is changed during HC-05 set up process, it first ask if you want to save changes to the preset.

• Fix Infinite loop when attempting to retrieve the name of HC-05 module with firmware version 2.x.
• Add notification about decoding error instead of fatal error. This error usually happen when the connection between the HC-05 module and computer is unstable.

The tool is built on top of pyserial.

MIT Licence