Skip to content

Commit

Permalink
2802 fix
Browse files Browse the repository at this point in the history
  • Loading branch information
RichardHeltec committed Jan 26, 2024
1 parent e590e21 commit 2d71e04
Show file tree
Hide file tree
Showing 18 changed files with 77 additions and 111 deletions.
1 change: 0 additions & 1 deletion doc/_ext/_static/js/custom.js
Original file line number Diff line number Diff line change
Expand Up @@ -34,7 +34,6 @@ var prod_obj = {
{text:"HRU-1000", value: "hru-1000"},
{text:"HRI-3621", value: "hri-3621"},
{text:"HRI-3622", value: "hri-3622"},
{text:"Wireless Bridge", value: "wireless_bridge"},
],
}

Expand Down
Binary file modified doc/gateway/ht-m00s/source/img/quick_start/rgb.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 2 additions & 2 deletions doc/gateway/ht-m00s/source/quick_start.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@
- `WiFi-MAC` MAC address of HT-M00S;
- `WiFi-SSID` The WiFi account connected to the network;
- `WiFi-PASS` The WiFi password connected to the network;
- `SF` Spreading factor;
- `SF` Spreading factor, match with a node;
- `Freq` Transmitting frequency of gateway LoRa, it must be a frequency point, such as 470300000, which means 470MHz band / 0 channel;
- `Gateway ID` The ID of the HT-M00S, used for server registration;
- `Server Addr` HT-M00S needs to connect to the server address;
Expand All @@ -43,7 +43,7 @@ After configuration, click `submit`, and the gateway will restart automatically,

- Question: Nodes are always "Joining".

Solution: Common reasons are mismatches between node and gateway Settings, such as frequency band, channel, DR, SF, etc.
Solution: Common reasons are mismatches between node and gateway settings, such as frequency band, channel, SF, etc. Please note that this gateway only supports 125K bandwidth.

- Question: Nodes no longer work after changing servers or gateways.

Expand Down
74 changes: 24 additions & 50 deletions doc/gateway/ht-m02_v2/source/connect_to_server.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,20 +14,25 @@ Before all operation, make sure the HT-M02 is runing well . If not, please refer
[Connect to SnapEmu](connect-to-snapemu)

 
(connect-to-ttn)=

## Connect to TTN/TTS

### Configure Gateway

Configure your gateway and fill in the server address as the server you want to connect to, please refer to the [HT-M2802 Quick Start](https://docs.heltec.org/en/gateway/ht-m2802/quick_start.html) document.

### Register a LoRa gateway in TTN/TTS

Select a cluster in the [TTN console](https://console.thethingsnetwork.org/) page to start adding devices and gateways. Or start adding devices and gateways in [TTS console](https://lora.heltec.org/console).
*Select a cluster in the [TTN console](https://console.thethingsnetwork.org/) page to start adding devices and gateways. Or start adding devices and gateways in [TTS console](https://lora.heltec.org/console).*

![](img/connect_to_server/10.png)

Create a new gateway.
*Create a new gateway.*

![](img/connect_to_server/11.jpg)

Fill in the HT-M02_V2 information as shown below and complete the addition.
*Fill in the HT-M02_V2 information as shown below and complete the addition.*

![](img/connect_to_server/12.jpg)

Expand All @@ -36,7 +41,11 @@ Fill in the HT-M02_V2 information as shown below and complete the addition.
- **Gateway name** -- Filled in by the user, can be filled in arbitrarily.
- **Frequency Plan** -- Matches the LoRa band configuration in HT-M01S.

 
*View gateway status, it is runing:*

![](img/connect_to_server/13.png)

(connect-to-chirpstack)=

## Connect to ChirpStack server

Expand All @@ -55,47 +64,13 @@ Install ChirpStack Gateway Bridge: [https://www.chirpstack.io/gateway-bridge/ins

### Register LoRa Gateway in ChirpStack

Fill in the HT-M02 information as shown below and complete the addition.
*Fill in the HT-M02 information as shown below and complete the addition.*

![](img/connect_to_server/07.png)

- **Gateway ID** -- The unique ID of the HT-M02 gateway.

### Connect to ChirpStack server

In the HT-M02 gateway, only the server address and port need to be configured.

config the `server address` and `port` in `global_conf.json`:

```shell
sudo nano lora/packet_forwarder/lora_pkt_fwd/global_conf.json
```

At the end of this file, make suitable changes:

```json
"server_address": "router.eu.thethings.network", /*The server IP address or domain*/
"serv_port_up": 1700,
"serv_port_down": 1700,
```

![](img/connect_to_server/01.png)

`ctrl + O` to save and `ctrl + X` to exit, and restart the service:

```shell
sudo systemctl restart lrgateway
```

Check whether the system running normally:

```shell
sudo systemctl status lrgateway
```

![](img/connect_to_server/02.png)

View gateway status, it is runing:
*View gateway status, it is runing:*

![](img/connect_to_server/08.png)

Expand All @@ -105,27 +80,25 @@ View gateway status, it is runing:
## Connect to SnapEmu

### Register through SnapEmu APP
Search the **App Store** for `SnapEmu`, download and install it.
*Search the **App Store** for `SnapEmu`, download and install it.*

![](img/connect_to_server/installapp.jpg)


Open the `Scan` option to scan the Heltec device QR code.
*Open the `Scan` option to scan the Heltec device QR code.*

``` {Tip} If the device does not have a QR code, click 'Input' for manual registration. For product information you can refer to the corresponding 'Quick Start'.
```

![](img/connect_to_server/scanapp.jpg)


Fill in the group and add the device.
*Fill in the group and add the device.*

![](img/connect_to_server/addapp.jpg)



Registration is completed and the device display is activated.
*Registration is completed and the device display is activated.*

![](img/connect_to_server/appcheck.jpg)

Expand All @@ -134,19 +107,19 @@ Registration is completed and the device display is activated.
### Manual registration through the SnapEmu IoT Platform webpage
Register and log in to SnapEmu: [SnapEmu Web Page link](platform.snapemu.com).

Click where shown below.
*Click where shown below.*

![](img/connect_to_server/platformlog.png)



Click `CREATE A NEW DEVICE`.
*Click `CREATE A NEW DEVICE`.*

![](img/connect_to_server/platformcreate.png)



Go to the device registration page.
*Go to the device registration page.*

![](img/connect_to_server/platformregister.png)

Expand All @@ -158,9 +131,10 @@ Go to the device registration page.



After filling in the information, click Submit and refresh the page to see the device.
*After filling in the information, click Submit and refresh the page to see the device.*

![](img/connect_to_server/platformcreategate.png)

``` {Tips} If the device shows "unactiveted", it means that the device was not successfully connected. Don't worry, it usually takes some time for the server to respond, please wait a minute and refresh the web page again.
```
14 changes: 12 additions & 2 deletions doc/gateway/ht-m02_v2/source/frequently_asked_questions.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,11 @@

This page contains the most frequently questions from user. If this page's detail can't solve your problem, you can also talk in our forum: [community.heltec.cn](http://community.heltec.cn/)

- [View LoRa logs for the gateway](View-LoRa-logs-for-the-gateway)
- [Set a fixed IP address](Set-a-fixed-IP-address)
 

(View-LoRa-logs-for-the-gateway)=
## View LoRa logs for the gateway

There are two way can read LoRa logs.
Expand All @@ -31,8 +34,15 @@ cat /var/log/syslog |grep lora_pkt_fwd -a| grep "JSON"
rm -rf update_M02* && wget http://minerback.heltec.cn/download/update_M02.sh && chmod +x update_M02.sh && ./update_M02.sh
```



2.2 After the update is completed, restart and enter the webpage to see real-time logs.

![](img/frequently_asked_questions/01.png)



(Set-a-fixed-IP-address)=
## Set a fixed IP address

In the configuration page click `Net Mode`, then click `IP model` and select `STATIC`.

![](img/frequently_asked_questions/02.jpg)
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
70 changes: 23 additions & 47 deletions doc/gateway/ht-m2802/source/connect_to_server.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,7 @@
# Connect HT-M2802 to a LoRa Server
# Connect HT-M2802 to LoRa Server
{ht_translation}`[简体中文]:[English]`

## Summary

This article aims to describe how to connect [HT-M2802 Gateway](https://heltec.org/project/ht-m2802/) to a LoRa server, such as [TTN](https://www.thethingsnetwork.org/), [ChirpStack](https://www.chirpstack.io/), which facilitates secondary development and rapid deployment of LoRa devices.

Before all operation, make sure the HT-M2802 is runing well . If not, please refer to this [HT-M2802 Quick Start](https://docs.heltec.org/en/gateway/ht-m2802/quick_start.html) document.

[Connect to TTN/TTS](connect-to-ttn)
Expand All @@ -16,39 +13,46 @@ Before all operation, make sure the HT-M2802 is runing well . If not, please ref
 

## Connect to TTN/TTS
### Configure Gateway
Configure your gateway and fill in the server address as the server you want to connect to, please refer to the [HT-M2802 Quick Start](https://docs.heltec.org/en/gateway/ht-m2802/quick_start.html) document.

### Register a LoRa gateway in TTN/TTS

Select a cluster in the [TTN console](https://console.thethingsnetwork.org/) page to start adding devices and gateways. Or start adding devices and gateways in [TTS console](https://lora.heltec.org/console).
*Select a cluster in the [TTN console](https://console.thethingsnetwork.org/) page to start adding devices and gateways. Or start adding devices and gateways in [TTS console](https://lora.heltec.org/console).*

![](img/connect_to_server/01.png)

Create a new gateway.
*Create a new gateway.*

![](img/connect_to_server/02.png)

Fill in the HT-M2802 information as shown below and complete the addition.
*Fill in the HT-M2802 information as shown below and complete the addition.*

![](img/connect_to_server/01.png)
![](img/connect_to_server/10.png)

- **Gateway EUI** -- The unique ID of HT-M2802 gateway, view from the display screen of the HT-M2802 or view through the serial port (the gateway ID will be printed through the serial port when the HT-M2802starts).
- **Gateway ID** -- Generated by default.
- **Gateway name** -- Filled in by the user, can be filled in arbitrarily.
- **Frequency Plan** -- Matches the LoRa band configuration in HT-2802.

*View gateway status, it is runing:*

![](img/connect_to_server/13.png)

### Configure the Gateway

 

## Connect to ChirpStack server
(connect-to-chirpstack)=

## Connect to ChirpStack Server

[ChirpStack](https://www.chirpstack.io/) is the most popular LoRa server open source project, widely used in many fields, and also the best choise for a private LoRa server.

- ChirpStack Installation guide: [https://www.chirpstack.io/overview/](https://www.chirpstack.io/overview/)
- ChirpStack support forum: [https://forum.chirpstack.io/](https://forum.chirpstack.io/)

### Configure Gateway
Configure your gateway and fill in the server address as the server you want to connect to, please refer to the [HT-M2802 Quick Start](https://docs.heltec.org/en/gateway/ht-m2802/quick_start.html) document.

### ChirpStack Gateway Bridge

**One thing need attention!** the ChirpStack need a special service named `Gateway Bridge`, which converts LoRa® Packet Forwarder protocols into a ChirpStack Network Server common data-format(JSON and Protobuf).
Expand All @@ -59,49 +63,20 @@ Install ChirpStack Gateway Bridge: [https://www.chirpstack.io/gateway-bridge/ins

### Register LoRa Gateway in ChirpStack

Fill in the HT-M2802 information as shown below and complete the addition.
*Fill in the HT-M2802 information as shown below and complete the addition.*

![](img/connect_to_server/07.png)

- **Gateway ID** -- The unique ID of the HT-M2802 gateway.

### Connect to ChirpStack server
- **Gateway name**--Freely fill in as the remark name of the device on the server.
- **Gateway description**--Free to fill in, as equipment notes.
- **Gateway ID** -- The unique ID of HT-M2802 gateway, view from the display screen of the HT-M2802 or view through the serial port (the gateway ID will be printed through the serial port when the HT-M2802 starts).
- **Network server**--LoRaWAN frequency band, matched to the device.

In the HT-M2802 gateway, only the server address and port need to be configured.

config the `server address` and `port` in `global_conf.json`:

```shell
sudo nano lora/packet_forwarder/lora_pkt_fwd/global_conf.json
```

At the end of this file, make suitable changes:

```json
"server_address": "router.eu.thethings.network", /*The server IP address or domain*/
"serv_port_up": 1700,
"serv_port_down": 1700,
```
*View gateway status, it is runing:*

![](img/connect_to_server/01.png)

`ctrl + O` to save and `ctrl + X` to exit, and restart the service:

```shell
sudo systemctl restart lrgateway
```

Check whether the system running normally:

```shell
sudo systemctl status lrgateway
```

![](img/connect_to_server/02.png)
![](img/connect_to_server/08.png)

View gateway status, it is runing:

![](img/connect_to_server/08.png)

 

Expand Down Expand Up @@ -167,4 +142,5 @@ After filling in the information, click Submit and refresh the page to see the d
![](img/connect_to_server/platformcreategate.png)

``` {Tips} If the device shows "unactiveted", it means that the device was not successfully connected. Don't worry, it usually takes some time for the server to respond, please wait a minute and refresh the web page again.
```
14 changes: 10 additions & 4 deletions doc/gateway/ht-m2802/source/frequently_asked_questions.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,11 @@

This page contains the most frequently questions from user. If this page's detail can't solve your problem, you can also talk in our forum: [community.heltec.cn](http://community.heltec.cn/)

- [View LoRa logs for the gateway](View-LoRa-logs-for-the-gateway)
- [Set a fixed IP address](Set-a-fixed-IP-address)
 

(View-LoRa-logs-for-the-gateway)=
## View LoRa logs for the gateway

There are two way can read LoRa logs.
Expand All @@ -17,12 +20,8 @@ After entering the shell interface, execute the following statement to view the
cat /var/log/syslog |grep lora_pkt_fwd -a| grep "JSON"
```



> Note: The historical logs of the gateway are not updated in real-time.


### 2. View real-time logs

2.1 After entering the shell interface, execute the following command to upgrade the firmware to the latest version.
Expand All @@ -36,3 +35,10 @@ rm -rf update_M02* && wget http://minerback.heltec.cn/download/update_M02.sh &&
2.2 After the update is completed, restart and enter the webpage to see real-time logs.

![](img/frequently_asked_questions/01.png)

(Set-a-fixed-IP-address)=
## Set a fixed IP address

In the configuration page click `Net Mode`, then click `IP model` and select `STATIC`.

![](img/frequently_asked_questions/02.jpg)
Binary file modified doc/gateway/ht-m2802/source/img/connect_to_server/01.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified doc/gateway/ht-m2802/source/img/connect_to_server/02.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified doc/gateway/ht-m2802/source/img/quick_start/01.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified doc/gateway/ht-m2802/source/img/quick_start/05.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 2d71e04

Please sign in to comment.