Browan MiniHub Pro User manual

Browan Communications Inc.
No.15-1, Zhonghua Rd., Hsinchu Industrial Park,
Hukou, Hsinchu, Taiwan, R.O.C. 30352
Tel: [phone]
Fax: [phone]
2020 ⒸBrowan Communications Inc., All Rights Reserved. This document is for planning purposes only, and is not intended to modify or supplement any specifications or warranties rel
ating to products of Browan Communications. Browan may make changes to specifications and descriptions at any time, without notice.
Document Number BQW_02_0020.001
MiniHub Pro
User Guide
Version 1.6

Browan Communications Inc.
No.15-1, Zhonghua Rd., Hsinchu Industrial Park,
Hukou, Hsinchu, Taiwan, R.O.C. 30352
Tel: [phone]
Fax: [phone]
Copyright 2020 Browan Co., Ltd. 1

Browan Communications Inc.
No.15-1, Zhonghua Rd., Hsinchu Industrial Park,
Hukou, Hsinchu, Taiwan, R.O.C. 30352
Tel: [phone]
Fax: [phone]
Copyright 2020 Browan Co., Ltd. 2
Index
Index 2
Release History 3
About this Document 4
Required Equipment 4
Wiring Diagram 5
Software Package Requirement 6
Erase Flash and Upgrade Firmware 11
Erase flash 12
Firmware Upgrade 13
Monitor 14
Web Provision 15
Connect to Web GUI 15
AWS & LoRa Setting 17
WiFi Setting 19
Station EUI Writing 20
LED Behavior 21
Reset to Default 22
OTA 23
Q&A 31

Browan Communications Inc.
No.15-1, Zhonghua Rd., Hsinchu Industrial Park,
Hukou, Hsinchu, Taiwan, R.O.C. 30352
Tel: [phone]
Fax: [phone]
Copyright 2020 Browan Co., Ltd. 3
Release History
Date
Version
Author
Comment
2020/01/21 1.1
Jason
Andrew Lin
Andrew Shiu
Crux
●First release.
2020/04/16 1.2
Jason
Andrew Lin
Andrew Shiu
Crux
●
Add Web GUI for AWS IoT provision.
●Add Web GUI for Basic Station provision.
●Add writing station EUI command.
●Add LED behavior.
2020/04/16 1.3
Jason
Andrew Lin
Andrew Shiu
Crux
●Fix some typos.
2020/05/27 1.4
Jason
Andrew Lin
Andrew Shiu
Crux
●Add Q&A.
2020/06/22 1.5 Jason
Joey
●Add OTA flow.
2020/06/30 1.6 Jason
●
Correct some wording
●Browan Official Release, add Document Number

Browan Communications Inc.
No.15-1, Zhonghua Rd., Hsinchu Industrial Park,
Hukou, Hsinchu, Taiwan, R.O.C. 30352
Tel: [phone]
Fax: [phone]
Copyright 2020 Browan Co., Ltd. 4
About this Document
This document explains how to erase the MiniHub Pro flash (Model Name: TBMH110), how to upgrade new fi
rmware, and the WiFi behaviors after powering up. The Web GUI usage for AWS IoT provision and Basic Stat
ion provision.
Required Equipment
●MiniHub Pro
●USB Type C Breakout Board
●USB Type C Cable
●Linux machine (We use Ubuntu 14.04 LTS in the document)

Browan Communications Inc.
No.15-1, Zhonghua Rd., Hsinchu Industrial Park,
Hukou, Hsinchu, Taiwan, R.O.C. 30352
Tel: [phone]
Fax: [phone]
Copyright 2020 Browan Co., Ltd. 5
Wiring Diagram
You must use the Type-C breakout-board provided by Browan to erase the flash or upgrade the firmware.
Please pay attention to the direction. The label of the Type-C breakout board is aligned with the word “RESE
T”.

Browan Communications Inc.
No.15-1, Zhonghua Rd., Hsinchu Industrial Park,
Hukou, Hsinchu, Taiwan, R.O.C. 30352
Tel: [phone]
Fax: [phone]
Copyright 2020 Browan Co., Ltd. 6
Software Package Requirement
The original development tools are from Amazon FreeRTOS GitHub. To make it easier for non-developers to u
pdate the firmware, Browan extracts the required parts and repackages them into browan_esptool.
Please refer to browan_esptool-v [X]. [Y] .tar.gz which attached in this document and copy it to your Linux ma
chine.
$ls -l
-rw-rw-r-- 1 vagrant vagrant 8896515 Jan 21 08:23 browan_esptool-v2.0.tar.gz
Extract the tarball using the following command:
$tar -zxvf browan_esptool-v2.0.tar.gz
$ls -l
drwxrwxr-x 4 vagrant vagrant 4096 Jan 21 08:21 browan_esptool-v2.0
-rw-rw-r-- 1 vagrant vagrant 8896515 Jan 21 08:23 browan_esptool-v2.0.tar.gz
The folders/files in browan_esptool/:
browan_esptool-v2.0/
|-- browan_esptool.sh
|-- esptool
| |-- CONTRIBUTING.md
| |-- LICENSE
| |-- MANIFEST.in
| |-- README.md
| |-- ecdsa
| |-- espefuse.py
| |-- espsecure.py
| |-- esptool.py
| |-- flasher_stub
| |-- idf_monitor.py
| |-- pyaes
| |-- setup.cfg
| |-- setup.py

Browan Communications Inc.
No.15-1, Zhonghua Rd., Hsinchu Industrial Park,
Hukou, Hsinchu, Taiwan, R.O.C. 30352
Tel: [phone]
Fax: [phone]
Copyright 2020 Browan Co., Ltd. 7
| `-- test
|-- images
| |-- aws_demos
| |-- aws_demos.bin
| |-- bootloader.bin
| |-- ecdsasigner.crt
| |-- ecdsasigner.key
| |-- ota_data_initial.bin
| |-- partition-table.bin
| `-- storage.bin
|-- install_pkg.sh
`-- requirements.txt
●browan_esptool.sh is a script to invoke esptool commands
●esptool/ provided by Amazon FreeRTOS
●images/ includes the firmware images released by Browan. New firmware updates only need to update t
his folder.
●install_pkg.sh is a script to install the required packages
●requirements.txt is the python module require list for esptool
In Ubuntu 14.04 LTS, you need to install the following packages:
* libssl-dev
* libffi-dev
* python
* python-pip
* python-setuptools
* python-serial
* python-pyparsing
And install the following packages using pip:
* testresources
* setuptools
* pyserial>=3.0
* future>=0.15.2

Browan Communications Inc.
No.15-1, Zhonghua Rd., Hsinchu Industrial Park,
Hukou, Hsinchu, Taiwan, R.O.C. 30352
Tel: [phone]
Fax: [phone]
Copyright 2020 Browan Co., Ltd. 8
* cryptography>=2.1.4
* pyparsing>=2.0.3,<2.4.0

Browan Communications Inc.
No.15-1, Zhonghua Rd., Hsinchu Industrial Park,
Hukou, Hsinchu, Taiwan, R.O.C. 30352
Tel: [phone]
Fax: [phone]
Copyright 2020 Browan Co., Ltd. 9
MiniHub Pro uses the CP2102 chip as a USB-to-serial interface. Your system needs a correct driver.
Connect the MiniHub to the type-C breakout board and then connect it to your host Linux. Use the following c
ommands to check whether the system automatically mounts the CP2012 driver.
$lsmod | grep cp210x
cp210x 28672 0
usbserial 49152 2 pl2303,cp210x
If UART does not work well, download the "CP210x USB to UART Bridge VCP Drivers" from Silicon Labs o
fficial website, and install the device driver following the guideline.
●https://www.silabs.com/products/development-tools/software/usb-to-uart-bridge-vcp-drivers
If not, you need to install the following packages:
* linux-modules-extra-`uname -r`
If you need to monitor the MiniHub Pro terminal screen on Linux, you would need to add the user to the `dialo
ut` group.
$sudo usermod -a -G dialout $USER
The above installation and settings operations can be completed automatically using the install_pkg.sh provided
by Browan. To apply the installed drivers, please restart the system after executing install_pkg.sh.
$cd browan_esptool-v2.0/
$ls -l
total 20
-rwxrwxr-x 1 andrew andrew 1081 Jan 21 16:21 browan_esptool.sh
drwxrwxr-x 6 andrew andrew 4096 Jan 21 16:19 esptool
drwxrwxr-x 2 andrew andrew 4096 Apr 16 11:44 images
-rwxrwxr-x 1 andrew andrew 620 Jan 21 15:59 install_pkg.sh
-rw-rw-r-- 1 andrew andrew 434 Jan 21 14:37 requirements.txt
$./install_pkg.sh