Browan MiniHub Pro Quick Installation Manual

Browan MiniHub Pro Quick Installation Manual

With basic station & aws iot core for lorawan
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.003
MiniHub Pro
Quick Installation Guide
-with Basic Station & AWS IoT Core for LoRaWAN
Version 1.11
Copyright 2020 Browan Co., Ltd.
Browan Highly Confidential – Controlled Access
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 relating to products of Browan Communications. Browan may make changes to specifications and descriptions at any time, without
notice.

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the MiniHub Pro and is the answer not in the manual?

Questions and answers

Subscribe to Our Youtube Channel

Summary of Contents for Browan MiniHub Pro

  • Page 1 Browan Highly Confidential – Controlled Access 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 relating to products of Browan Communications. Browan may make changes to specifications and descriptions at any time, without...
  • Page 2: Table Of Contents

    To add the required Amazon S3 permissions to your OTA service role Create an OTA user policy To create an OTA user policy To attach the OTA user policy to your IAM user Create a FreeRTOS OTA update job Copyright 2022 Browan Co., Ltd.
  • Page 3: Release History

    2020/06/22 ● Add OTA flow. Joey ● Correct some wording 2020/06/30 Jason ● Browan Official Release, add Document Number Jason ● Modify OTA Flow. User no needs to power off and 2020/07/15 Andrew Shiu power on to trigger the OTA.
  • Page 4: About This Document

    Hukou, Hsinchu, Taiwan, R.O.C. 30352 Tel: +886-3-6006899 Fax: +886-3-5972970 About this Document This document explains the configuration after powering up. The Web GUI usage for AWS IoT provision and Basic Station provision. Required Equipment ● MiniHub Pro Copyright 2022 Browan Co., Ltd.
  • Page 5: Onboard Lorawan Gateways

    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 Onboard LoRaWAN Gateways ● Step1. Click “Add gateway” Copyright 2022 Browan Co., Ltd.
  • Page 6 No.15-1, Zhonghua Rd., Hsinchu Industrial Park, Hukou, Hsinchu, Taiwan, R.O.C. 30352 Tel: +886-3-6006899 Fax: +886-3-5972970 ● Step2. Select “Gateway provided by AWS IoT Core Qualified Partners”. Input GatewayEUI, Radio Frequency, Gateway name(Optional), Gateway description(Optional) and click “Continue” Copyright 2022 Browan Co., Ltd.
  • Page 7 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 ● Step3. Configure Gateway. Please refer to the next chapter. Click “Continue” Copyright 2022 Browan Co., Ltd.
  • Page 8: Configure The Gateway(Web Provision)

    WiFi client to connect to it. You can find the SSID in the WiFi site-survey list. The suffix 6 characters MiniHubPro-XXXXXX are the last 6 hex string of WiFi MAC address. The password is in the back label. Copyright 2022 Browan Co., Ltd.
  • Page 9 Hukou, Hsinchu, Taiwan, R.O.C. 30352 Tel: +886-3-6006899 Fax: +886-3-5972970 After connecting to AP, it will open the setup page. If web page doesn't MiniHubPro-XXXXXX open automatically, please use Firefox or Chrome to open 192.168.4.1 manually. Copyright 2022 Browan Co., Ltd.
  • Page 10: Aws & Lora Setting

    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 the setting page. Copyright 2022 Browan Co., Ltd.
  • Page 11 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 bottom. Copyright 2022 Browan Co., Ltd.
  • Page 12: Wifi Setting

    Choose one of the WiFi AP which you prefer to connect to the internet. You also can add SSID manually by yourself on this page. After that, the MiniHub Pro will store the connection information and switch to the WiFi Station mode.
  • Page 13: Led Behavior

    ❊Note: Do not unplug device in this state Scanning WiFi networks, setting up configuration Orange Blinking 1/4 sec CONFIG Orange Blinking 1 sec CONFIG Configuration AP active ❊Note: WIFI_STA is WiFi Station Mode CONFIG is Configuration Mode Copyright 2022 Browan Co., Ltd.
  • Page 14: Onboard Lorawan Devices

    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 Onboard LoRaWAN Devices ● Step 1. Click “Add device” Copyright 2022 Browan Co., Ltd.
  • Page 15 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 Step 2. Register device - Select device specification. Click“Continue” Copyright 2022 Browan Co., Ltd.
  • Page 16 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 Step 3. Register device - Input DevEUI, AppEUI, Appkwy, Device name(Optional) and Device description(Optional). Click“Continue”. Copyright 2022 Browan Co., Ltd.
  • Page 17 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 Step 4. Configure devices - Select device profile. Click“Continue” Copyright 2022 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 Step 5. Set up destination- Select IAM role and input rule name. Click“Finish” Copyright 2022 Browan Co., Ltd.
  • Page 19: Reset To Default

    Hukou, Hsinchu, Taiwan, R.O.C. 30352 Tel: +886-3-6006899 Fax: +886-3-5972970 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. Copyright 2022 Browan Co., Ltd.
  • Page 20: Ota

    No.15-1, Zhonghua Rd., Hsinchu Industrial Park, Hukou, Hsinchu, Taiwan, R.O.C. 30352 Tel: +886-3-6006899 Fax: +886-3-5972970 Get Firmware 1. Please visit Browan's website and click release note for MiniHub Pro. https://www.browan.com/news/9V 2. Download the latest MiniHub Pro's firmware. Copyright 2022 Browan Co., Ltd.
  • Page 21: Configure Minihub Pro

    Fax: +886-3-5972970 Configure MiniHub Pro Please register things for MiniHub Pro on the AWS IoT and configure the AWS & LNS Setting. Create an Amazon S3 bucket to store your update 1. Sign in to the Amazon S3 console at https://console.aws.amazon.com/s3/.
  • Page 22 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 2022 Browan Co., Ltd.
  • Page 23 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 4. Under Bucket Versioning, select Enable to keep all versions in the same bucket. Copyright 2022 Browan Co., Ltd.
  • Page 24 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 5. Under Bucket settings for Block Public Access keep Block all public access selected to accept the default permissions. Copyright 2022 Browan Co., Ltd.
  • Page 25 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 6. Choose Create bucket. Copyright 2022 Browan Co., Ltd.
  • Page 26: Create An Ota Update Service Role

    No.15-1, Zhonghua Rd., Hsinchu Industrial Park, Hukou, Hsinchu, Taiwan, R.O.C. 30352 Tel: +886-3-6006899 Fax: +886-3-5972970 Create an OTA Update service role To create an OTA service role 1. Sign in to the https://console.aws.amazon.com/iam/. 2. From the navigation pane, choose Roles. Copyright 2022 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 3. Choose Create role. 4. Under Select type of trusted entity, choose AWS Service. Copyright 2022 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 5. Choose IoT from the list of AWS services. 6. Under Select your use case, choose IoT. Copyright 2022 Browan Co., Ltd.
  • Page 29 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 7. Choose Next: Tags. 8. Choose Next: Review. Copyright 2022 Browan Co., Ltd.
  • Page 30 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 9. Enter a role name and description, and then choose Create role. Copyright 2022 Browan Co., Ltd.
  • Page 31: 5To Add Ota Update Permissions To Your Ota Service Role

    Fax: +886-3-5972970 5To add OTA update permissions to your OTA service role 1. In the search box on the IAM console page, enter the name of your role, and then choose it from the list. Copyright 2022 Browan Co., Ltd.
  • Page 32 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 2. Choose Attach policies. Copyright 2022 Browan Co., Ltd.
  • Page 33 Hukou, Hsinchu, Taiwan, R.O.C. 30352 Tel: +886-3-6006899 Fax: +886-3-5972970 3. In the Search box, enter "AmazonFreeRTOSOTAUpdate", select AmazonFreeRTOSOTAUpdate from the list of filtered policies, and then choose Attach policy to attach the policy to your service role. Copyright 2022 Browan Co., Ltd.
  • Page 34: To Add The Required Iam Permissions To Your Ota Service Role

    To add the required IAM permissions to your OTA service role 1. In the search box on the IAM console page, enter the name of your role, and then choose it from the list. 2. Choose Add inline policy. Copyright 2022 Browan Co., Ltd.
  • Page 35 Hukou, Hsinchu, Taiwan, R.O.C. 30352 Tel: +886-3-6006899 Fax: +886-3-5972970 3. Choose the JSON tab. 4. Copy and paste the following policy document into the text box: "Version": "2012-10-17", "Statement": [ "Effect": "Allow", "Action": [ "iam:GetRole", "iam:PassRole" "Resource": "arn:aws:iam::your_account_id:role/your_role_name" Copyright 2022 Browan Co., Ltd.
  • Page 36 No.15-1, Zhonghua Rd., Hsinchu Industrial Park, Hukou, Hsinchu, Taiwan, R.O.C. 30352 Tel: +886-3-6006899 Fax: +886-3-5972970 Make sure that you replace with your AWS account ID, and your_account_id with the name of the OTA service role. your_role_name Copyright 2022 Browan Co., Ltd.
  • Page 37 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 5. Choose Review policy. 6. Enter a name for the policy, and then choose Create policy. Copyright 2022 Browan Co., Ltd.
  • Page 38: To Add The Required Amazon S3 Permissions To Your Ota Service Role

    To add the required Amazon S3 permissions to your OTA service role 1. In the search box on the IAM console page, enter the name of your role, and then choose it from the list. 2. Choose Add inline policy. Copyright 2022 Browan Co., Ltd.
  • Page 39 Hukou, Hsinchu, Taiwan, R.O.C. 30352 Tel: +886-3-6006899 Fax: +886-3-5972970 3. Choose the JSON tab. 4. Copy and paste the following policy document into the box. "Version": "2012-10-17", "Statement": [ "Effect": "Allow", "Action": [ "s3:GetObjectVersion", "s3:GetObject", "s3:PutObject" "Resource": [ "arn:aws:s3:::example-bucket/*" Copyright 2022 Browan Co., Ltd.
  • Page 40 No.15-1, Zhonghua Rd., Hsinchu Industrial Park, Hukou, Hsinchu, Taiwan, R.O.C. 30352 Tel: +886-3-6006899 Fax: +886-3-5972970 This policy grants your OTA service role permission to read Amazon S3 objects. Make sure that you replace example-bucket with the name of your bucket. Copyright 2022 Browan Co., Ltd.
  • Page 41 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 5. Choose Review policy. Copyright 2022 Browan Co., Ltd.
  • Page 42 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 6. Enter a name for the policy, and then choose Create policy. Copyright 2022 Browan Co., Ltd.
  • Page 43: Create An Ota User Policy

    Hukou, Hsinchu, Taiwan, R.O.C. 30352 Tel: +886-3-6006899 Fax: +886-3-5972970 Create an OTA user policy *If you use the "Administrator” user, you can skip this step To create an OTA user policy 1. Open the https://console.aws.amazon.com/iam/ console. Copyright 2022 Browan Co., Ltd.
  • Page 44 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 2. In the navigation pane, choose Users. Copyright 2022 Browan Co., Ltd.
  • Page 45 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 3. Choose your IAM user from the list. 4. Choose Add permissions. Copyright 2022 Browan Co., Ltd.
  • Page 46 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 5. Choose Attach existing policies directly. Copyright 2022 Browan Co., Ltd.
  • Page 47 7. Choose the JSON tab, and copy and paste the following policy document into the policy editor: "Version":"2012-10-17", "Statement": [ "Effect": "Allow", "Action": [ "s3:ListBucket", "s3:ListAllMyBuckets", "s3:CreateBucket", "s3:PutBucketVersioning", "s3:GetBucketLocation", "s3:GetObjectVersion", "acm:ImportCertificate", "acm:ListCertificates", "iot:*", "iam:ListRoles", "freertos:ListHardwarePlatforms", "freertos:DescribeHardwarePlatform" Copyright 2022 Browan Co., Ltd.
  • Page 48 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 "Resource": "*" "Effect": "Allow", "Action": [ "s3:GetObject", "s3:PutObject" "Resource": "arn:aws:s3:::example-bucket/*" "Effect": "Allow", "Action": "iam:PassRole", "Resource": "arn:aws:iam::your-account-id:role/role-name" Copyright 2022 Browan Co., Ltd.
  • Page 49 You can find your AWS account ID in the upper right of the console. When you enter your account ID, remove any dashes (-). Replace with the name of the IAM role-name service role you just created. Copyright 2022 Browan Co., Ltd.
  • Page 50 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 8. Choose Review policy. Copyright 2022 Browan Co., Ltd.
  • Page 51 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 9. Enter a name for your new OTA user policy, and then choose Create policy. Copyright 2022 Browan Co., Ltd.
  • Page 52: To Attach The Ota User Policy To Your Iam User

    Hukou, Hsinchu, Taiwan, R.O.C. 30352 Tel: +886-3-6006899 Fax: +886-3-5972970 To attach the OTA user policy to your IAM user 1. In the IAM console, in the navigation pane, choose Users, and then choose your user. Copyright 2022 Browan Co., Ltd.
  • Page 53 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 2. Choose Add permissions. Copyright 2022 Browan Co., Ltd.
  • Page 54 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 3. Choose Attach existing policies directly. Copyright 2022 Browan Co., Ltd.
  • Page 55 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 4. Search for the OTA user policy you just created and select the check box next to it. Copyright 2022 Browan Co., Ltd.
  • Page 56 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 5. Choose Next: Review. Copyright 2022 Browan Co., Ltd.
  • Page 57 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 6. Choose Add permissions. Copyright 2022 Browan Co., Ltd.
  • Page 58: Create A Freertos Ota Update Job

    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 Create a FreeRTOS OTA update job 1. Go to "IoT Core" service. Copyright 2022 Browan Co., Ltd.
  • Page 59 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 2. Go to "Manage Jobs" and click the "Create" button. Copyright 2022 Browan Co., Ltd.
  • Page 60 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 3. Select "Create OTA update job" Copyright 2022 Browan Co., Ltd.
  • Page 61 Hukou, Hsinchu, Taiwan, R.O.C. 30352 Tel: +886-3-6006899 Fax: +886-3-5972970 4. Select the things name which configured to MiniHub Pro. And click "Next". 5. Select the "MQTT" protocol 6. Select the "Sign a new firmware image for me." 7. Create a new Code signing profile Click "Create"...
  • Page 62 Select "IAM role for OTA update job" (Created at step.2) Input the OTA job unique ID and click the "Create" button. You can find the successfully created job message. The OTA job status is "Queued" Copyright 2022 Browan Co., Ltd.
  • Page 63 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. Go to AWS IoT to check the status. The status is "Succeeded" Copyright 2022 Browan Co., Ltd.
  • Page 64 Hukou, Hsinchu, Taiwan, R.O.C. 30352 Tel: +886-3-6006899 Fax: +886-3-5972970 ❊Note: OTA polling feature will be supported from the firmware AWS APP Version 0.9.20 or latest so MiniHub Pro doesn't need power on again to trigger the OTA job process. Copyright 2022 Browan Co., Ltd.

Table of Contents