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

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. 10
$reboot

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. 11
Erase Flash and Upgrade Firmware
If your system installed correct CP2012 driver, when MiniHub Pro connects to the host Linux through USB, Li
nux should automatically generate the corresponding /dev/ttyUSB? character-device. You can use the following
command to verify:
$lsusb
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
Bus 002 Device 002: ID 10c4:ea60 Cygnal Integrated Products, Inc. CP210x UART Bridge / myAVR mySm
artUSB light
^^^^^^
Bus 002 Device 001: ID 1d6b:0001 Linux Foundation 1.1 root hub
$ls -l /dev/ttyUSB*
crw-rw---- 1 root dialout 188, 0 Jan 21 09:03 /dev/ttyUSB0
You can use browan_esptool.sh to do flash erasing and programming operations. Please note that before executi
ng an erase or program, you need to power off the device, then hold down the SETUP button and reconnect the
USB power supply. The device will switch to flash download mode before executing browan_esptool.sh

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. 12
Erase flash
1. Remove the USB power cable.
2. Press and hold the SETUP button and then reconnect the USB power cable.
3. Execute ./browan_esptool.sh and pass in the ttyUSB path and operation command "erase" as parameter
s.
4. Power recycle after finish step 3.
Here is the output of browan_esptool.sh:
$./browan_esptool.sh /dev/ttyUSB0 erase
esptool.py v2.8-dev
Serial port /dev/ttyUSB0
Connecting........
Detecting chip type... ESP32
Chip is ESP32D0WDQ5 (revision 1)
Features: WiFi, BT, Dual Core, 240MHz, VRef calibration in efuse, Coding Scheme None
Crystal is 40MHz
MAC: 24:6f:28:3f:2e:18
Uploading stub...
Running stub...
Stub running...
Changing baud rate to 460800
Changed.
Erasing flash (this may take a while)...
Chip erase completed successfully in 8.2s
Hard resetting via RTS pin...
$

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. 13
Firmware Upgrade
1. Remove the USB power cable.
2. Press and hold the SETUP button and then reconnect the USB power cable.
3. Execute ./browan_esptool.sh and pass in the ttyUSB path and operation command "flash" as parameter
s.
4. Power recycle after finish the step 3.
Here is the output of browan_esptool.sh:
$./browan_esptool.sh /dev/ttyUSB0 flash
esptool.py v2.8-dev
Serial port /dev/ttyUSB0
Connecting.....
Detecting chip type... ESP32
Chip is ESP32D0WDQ5 (revision 1)
Features: WiFi, BT, Dual Core, 240MHz, VRef calibration in efuse, Coding Scheme None
Crystal is 40MHz
MAC: 24:6f:28:3f:2e:18
Uploading stub...
Running stub...
Stub running...
Changing baud rate to 460800
Changed.
Configuring flash size...
Compressed 28224 bytes to 16081...
Wrote 28224 bytes (16081 compressed) at 0x00001000 in 0.4 seconds (effective 618.0 kbit/s)...
Hash of data verified.
Compressed 3072 bytes to 132...
Wrote 3072 bytes (132 compressed) at 0x00008000 in 0.0 seconds (effective 2176.0 kbit/s)...
Hash of data verified.
Compressed 8192 bytes to 31...
Wrote 8192 bytes (31 compressed) at 0x00016000 in 0.0 seconds (effective 14256.4 kbit/s)...
Hash of data verified.
Compressed 1336640 bytes to 807124...
Wrote 1336640 bytes (807124 compressed) at 0x00020000 in 19.0 seconds (effective 563.3 kbit/s)...
Hash of data verified.

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. 14
Leaving...
Hard resetting via RTS pin...
$
Monitor
1. Power recycle.
2. Execute ./browan_esptool.sh and pass in the ttyUSB path and operation command "monitor" as paramet
ers.
Here is the output of browan_esptool.sh:
$./browan_esptool.sh /dev/ttyUSB0 monitor
--- idf_monitor on /dev/ttyUSB0 115200 ---
--- Quit: Ctrl+] | Menu: Ctrl+T | Help: Ctrl+T followed by Ctrl+H ---
esp32>
If you don't want to use the monitor command provided by esptool. You can use any terminal tool such as mini
com, screen, picocom on Linux, or use putty on Windows.
The UART connection settings is: 115200-8-N-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. 15
Web Provision
Connect to Web GUI
The device can run as WiFi AP mode or WiFi Station mode. When the device in the initial state, such as first b
oot-up time or after reset-to-default. It will run with the WiFi AP mode. That means it accepts any WiFi client t
o connect to it.
You can find the SSID MiniHubPro-XXXXXX in the WiFi site-survey list. The suffix 6 characters are the last
6 hex string of WiFi MAC address. The password is in the back label.

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. 16
After connected to MiniHubPro-XXXXXX AP, it will open the setup page. If web page doesn't open automatic
ally, please using Firefox or Chrome to open 192.168.4.1 manually.

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. 17
AWS & LoRa Setting
Click "Configure AWS & LoRa Setting" to open setting page.

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. 18
There are two parts, one is for AWS, and another one is for LoRa. Please configure your setting and click the "
Save" button at the bottom. If you don't want to change any setting, please click the "Cancel" button at the bott
om.

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. 19
WiFi Setting
Choose one of the WiFi AP which you prefer to connect to the internet. You also can add SSID manually by yo
urself at this page. After that, the MiniHub Pro will store the connection information and switch to the WiFi St
ation mode.