Browan MiniHub Pro User Manual

Browan MiniHub Pro User Manual

Hide thumbs Also See for MiniHub Pro:

Advertisement

Quick Links

Browan Communications Inc.
No.15-1, Zhonghua Rd., Hsinchu Industrial Park,
Hukou, Hsinchu, Taiwan, R.O.C. 30352
Tel: +886-3-6006899
Fax: +886-3-5972970
Document Number
BQW_02_0020.001
MiniHub Pro
User Guide
Version 1.6
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.

Advertisement

Table of Contents
loading

Summary of Contents for Browan MiniHub Pro

  • Page 1 Version 1.6 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.
  • Page 2 Browan Communications Inc. No.15-1, Zhonghua Rd., Hsinchu Industrial Park, Hukou, Hsinchu, Taiwan, R.O.C. 30352 Tel: +886-3-6006899 Fax: +886-3-5972970 Copyright 2020 Browan Co., Ltd.
  • Page 3 Wiring Diagram Software Package Requirement Erase Flash and Upgrade Firmware Erase flash Firmware Upgrade Monitor Web Provision Connect to Web GUI AWS & LoRa Setting WiFi Setting Station EUI Writing LED Behavior Reset to Default Q&A Copyright 2020 Browan Co., Ltd.
  • Page 4: Release History

    ● Fix some typos. 2020/04/16 Andrew Shiu Crux Jason Andrew Lin ● Add Q&A. 2020/05/27 Andrew Shiu Crux Jason ● Add OTA flow. 2020/06/22 Joey ● Correct some wording 2020/06/30 Jason ● Browan Official Release, add Document Number Copyright 2020 Browan Co., Ltd.
  • Page 5: About This Document

    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.
  • Page 6: Wiring Diagram

    Fax: +886-3-5972970 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”.
  • Page 7 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.
  • Page 8 |-- 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 ●...
  • Page 9 Browan Communications Inc. No.15-1, Zhonghua Rd., Hsinchu Industrial Park, Hukou, Hsinchu, Taiwan, R.O.C. 30352 Tel: +886-3-6006899 Fax: +886-3-5972970 * cryptography>=2.1.4 * pyparsing>=2.0.3,<2.4.0 Copyright 2020 Browan Co., Ltd.
  • Page 10 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...
  • Page 11 Browan Communications Inc. No.15-1, Zhonghua Rd., Hsinchu Industrial Park, Hukou, Hsinchu, Taiwan, R.O.C. 30352 Tel: +886-3-6006899 Fax: +886-3-5972970 reboot Copyright 2020 Browan Co., Ltd.
  • Page 12 Fax: +886-3-5972970 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...
  • Page 13 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... Copyright 2020 Browan Co., Ltd.
  • Page 14: Firmware Upgrade

    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. Copyright 2020 Browan Co., Ltd.
  • Page 15 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 Copyright 2020 Browan Co., Ltd.
  • Page 16 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. Copyright 2020 Browan Co., Ltd.
  • Page 17 Hukou, Hsinchu, Taiwan, R.O.C. 30352 Tel: +886-3-6006899 Fax: +886-3-5972970 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. Copyright 2020 Browan Co., Ltd.
  • Page 18 Browan Communications Inc. No.15-1, Zhonghua Rd., Hsinchu Industrial Park, Hukou, Hsinchu, Taiwan, R.O.C. 30352 Tel: +886-3-6006899 Fax: +886-3-5972970 AWS & LoRa Setting Click "Configure AWS & LoRa Setting" to open setting page. Copyright 2020 Browan Co., Ltd.
  • Page 19 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 Copyright 2020 Browan Co., Ltd.
  • Page 20: 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.
  • Page 21 You can write a Station EUI (6 bytes in HEX) in CLI prompt: esp32> lora_sync 80029cXXXXXX esp32> lora_sync loramac from nvs= 80029cXXXXXX After writing the EUI, you should restart the device to apply the setting. Copyright 2020 Browan Co., Ltd.
  • Page 22: Led Behavior

    ❊Note: Do not unplug device in this state Orange Blinking 1/4 sec CONFIG Scanning WiFi networks, setting up configuration AP Orange Blinking 1 sec CONFIG Configuration AP active ❊Note: WIFI_STA is WiFi Station Mode CONFIG is Configuration Mode Copyright 2020 Browan Co., Ltd.
  • Page 23: Reset To Default

    Press the reset button over 5 seconds to reset the system to default status. After reset to default, the orange LED will blink every 1 second. You can also use restore_default command to reset to default in CLI prompt: esp32> restore_default Restore to default... Restore to default finished. esp32> Copyright 2020 Browan Co., Ltd.
  • Page 24 No.15-1, Zhonghua Rd., Hsinchu Industrial Park, Hukou, Hsinchu, Taiwan, R.O.C. 30352 Tel: +886-3-6006899 Fax: +886-3-5972970 1. Please register things for MiniHub Pro on the AWS IoT and configure the AWS & LNS Setting. 2. Create an Amazon S3 bucket to store your update. REF: https://docs.aws.amazon.com/freertos/latest/userguide/dg-ota-bucket.html 3.
  • Page 25 Hukou, Hsinchu, Taiwan, R.O.C. 30352 Tel: +886-3-6006899 Fax: +886-3-5972970 d. Select the things name which configured to MiniHub Pro. And click "Next". e. Select the "MQTT" protocol f. Select the "Sign a new firmware image for me." g. Create a new Code signing profile Click "Create"...
  • Page 26 Select "IAM role for OTA update job" (Created at step.2) k. Input the OTA job unique ID and click the "Create" button. l. You can find the successfully created job message. m. The OTA job status is "Queued" Copyright 2020 Browan Co., Ltd.
  • Page 27 Browan Communications Inc. No.15-1, Zhonghua Rd., Hsinchu Industrial Park, Hukou, Hsinchu, Taiwan, R.O.C. 30352 Tel: +886-3-6006899 Fax: +886-3-5972970 Copyright 2020 Browan Co., Ltd.
  • Page 28 Browan Communications Inc. No.15-1, Zhonghua Rd., Hsinchu Industrial Park, Hukou, Hsinchu, Taiwan, R.O.C. 30352 Tel: +886-3-6006899 Fax: +886-3-5972970 Now please power on the MiniHub Pro. To trigger the OTA job process. Current App Version: 20200601_TB-300_release * Application information: * Project name: esp-idf...
  • Page 29 1188 3351 [OTA Agent Task] [prvIngestDataBlock] File receive complete and signature is valid. 1189 3351 [OTA Agent Task] [prvStopRequestTimer] Stopping request timer. 1190 3351 [OTA Agent Task] [prvUpdateJobStatus_Mqtt] Msg: {"status":"IN_PROGRESS","statusDetails": {"self_test":"ready","updatedBy":"0x90002"}} Upgraded App Version: 20200616_TB-300_release * Application information: Copyright 2020 Browan Co., Ltd.
  • Page 30 55 1305 [OTA Agent Task] [prvUpdateJobStatus_Mqtt] Msg: {"status":"IN_PROGRESS","statusDetails":{"s elf_test":"active","updatedBy":"0x90004"}} 56 1305 [OTA Agent Task] [INFO ][MQTT][13050] (MQTT connection 0x3fff979c) MQTT PUBLISH oper ation queued. 57 1306 [OTA Agent Task] [INFO ][MQTT][13060] (MQTT connection 0x3fff979c, PUBLISH operation 0x 3fffc000) Waiting for operation completion. Copyright 2020 Browan Co., Ltd.
  • Page 31 64 1314 [OTA Agent Task] Received eOTA_JobEvent_StartTest callback from OTA Agent. 65 1322 [OTA Agent Task] [prvStopSelfTestTimer] Stopping the self test timer. 66 1322 [OTA Agent Task] [prvUpdateJobStatus_Mqtt] Msg: {"status":"SUCCEEDED","statusDetails":{"rea son":"accepted v0.9.4"}} Go to AWS IoT to check the status. The status is "Succeeded" Copyright 2020 Browan Co., Ltd.
  • Page 32 $TOP_DIR/vendors/browan/boards/tb-300/components/esp32-wifi-manager Where is the entry point for LoRa Basic Station? LoRa Basic Station's entry point is browan_cmd_station(). You can find this function call at the end of lora_bas ic_station_demo.c. The path of lora_basic_station_demo.c is: $TOP_DIR/demos/lora_basic_station/lora_basic_station_demo.c Copyright 2020 Browan Co., Ltd.
  • Page 33: Federal Communication Commission Interference Statement

    20cm between the radiator & your body. This transmitter must not be co-located or operating in conjunction with any other antenna or transmitter. Country Code selection feature to be disabled for products marketed to the US/CANADA Copyright 2020 Browan Co., Ltd.

Table of Contents