HC04/06 bluetooth module configuration tool - user manual

This is a copy of hc04conf man page/readme.txt included in downloadable package of Bluetooth module HC04/HC06 configuration tool

NAME

hc04conf - HC04/06 bluetooth module configuration tool

SYNOPSIS

hc04conf [options]

DESCRIPTION

hc04conf program configures HC04/HC06 aka "linvor" bluetooth modules connected to the serial port (or USB to serial converter) of your machine.

Using hc04conf, you can configure pairing PIN, bluetooth device name, and serial baud rate of the connected bluetooth module.

Another useful feature of the hc04conf program is ability to automatically detect serial baud rate of the connected module. It helps when dealing with unknown or misconfigured modules.

OPTIONS

-p, --port <PORT>

Serial port device. If omitted, the first available USB serial port (usually /dev/ttyUSB0 or /dev/ttyACM0) used.
To avoid confusion with other USB to serial devices it is allways recommended to specify the port.

-b, --baud <BAUD>

Serial port baud rate. Valid values are 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200, 230400, 460800, 921600, 1382400.
If omitted, hc04conf tries to determine correct speed automatically. Note that speed autodetection takes extra time (up to 20 seconds).

--set-name <NAME>

Sets new bluetooth device name. Name can contain spaces and special symbols. Unicode (UTF-8) symbols supported. Total length must not exceed 20 bytes (Note, some modules do not accept name longer than 15 or even 13 bytes).

--set-pin <PIN>

Sets new pairing PIN. PIN must contain exactly four decimal digits.

--set-baud <BAUD>

Sets new serial baud rate. Valid values are 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200, 230400, 460800, 921600, 1382400.

--detect-ports

Displays information about the serial ports available in the system and exits.

--version

Displays version information and exits.

-h, --help

Displays usage information and exits.

ENVIRONMENT

hc04conf uses no environment variables.

EXIT STATUS

The hc04conf utility exits 0 on success, and >0 if an error occurs.

EXAMPLES

1. Detect serial baud rate and print hardware version of the module connected to /dev/ttyUSB0.

hc04conf --port /dev/ttyUSB0

2. Set pairing PIN to 1234 of the module connected to /dev/ttyUSB0. Autodetect serial baud rate

hc04conf --port /dev/ttyUSB0 --set-pin 1234

3. Configure all parameters (name, PIN, baud rate) of the module connected to /dev/ttyUSB0 at 9600 baud.

hc04conf -p /dev/ttyUSB0 -b 9600 --set-pin 1234 --set-name "example name" --set-baud 115200

COPYRIGHT

Copyright (C) 2014-2015 smarpl.com

LICENSE

This software is freeware. Permission is granted to use this software for personal and commercial purposes.

DISCLAIMER

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

SEE ALSO

Visit hc04conf home page http://smarpl.com/hcconf for updates and bug reports.