jlpoole/LilyGo-LoRa-Series
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1

feature/sx1302_hal.sh: Script to automatically deploy

Browse source 
packet_forwarder

Signed-off-by: lbuque <1102390310@qq.com>
This commit is contained in:
lbuque 2022-11-29 11:14:52 +08:00
commit 7a5a218c85
4 changed files with 832 additions and 727 deletions
Download patch file Download diff file Expand all files Collapse all files

395
docs/zh/LilyGo_LoRa_Series_Quick_Start_On_TTN_zh.md
View file

@ -5,13 +5,11 @@
## 目录
- [测试环境](#测试环境)
- [在TTN上创建网关](#在ttn上创建网关)
- [在树莓派上运行sx1302_hal](#在树莓派上运行sx1302_hal)
- [使能树莓派的SPI接口](#使能树莓派的spi接口)
- [下载sx1302_hal源码并编译](#下载sx1302_hal源码并编译)
- [修改配置文件](#修改配置文件)
- [运行sx1302_hal](#运行sx1302_hal)
- [检查网关连接状态](#检查网关连接状态)
- [部署sx1302_hal](#部署sx1302_hal)
- [获取相关信息](#获取相关信息)
- [在TTN上创建网关](#在TTN上创建网关)
- [检查网关连接状态](#检查网关连接状态)
- [在TTN上创建终端设备模型](#在ttn上创建终端设备模型)
- [进入创建APP页面](#进入创建app页面)
- [创建终端设备模型](#创建终端设备模型)
@ -33,389 +31,57 @@
>
> TTN Version: v3.15.1
## 在TTN上创建网关
1. 登录到 https://console.cloud.thethings.network/
2. 根据网关支持频段选择对应的集群
![cluster_picker](../static/cluster_picker.png)
`T-SX1302`对应的频段为 `868MHZ`, 这里需要选择 `Europe1` 集群
> ! Warning
>
> 其中 `Legacy V2 Console`为TTN V2版本的服务器, 它将在2021年12月份关闭, 不建议使用
3. 创建一个网关
![create_gateways](../static/create_gateways.png)
4. 配置网关信息
其中需要填入一个唯一的`Gateway EUI`, 如果没有更好的选择，可以使用树莓派的MAC地址
![config_gateway_info](../static/config_gateway_info.png)
5. 选择频率
![slelct_frequenry](../static/slelct_frequenry.png)
## 在树莓派上运行sx1302_hal
> NOTE
>
> 已有其他的也接入到TTN的LoRaWAN网关, 可以忽略该小节
### 使能树莓派的SPI接口
### 部署sx1302_hal
Open the `/boot/config.txt` file and write the following at the end of the file:
```
dtoverlay=spi0-1cs
```
### 下载sx1302_hal源码并编译
1. 下载源码:
在树莓派执行[sx1302_hal.sh](../../tools/sx1302_hal.sh)，自动部署sx1302_hal。
```shell
cd ~
git clone https://github.com/Lora-net/sx1302_hal.git
cd sx1302_hal
git checkout V2.1.0
sudo ./sx1302_hal.sh -f eu868
sudo reboot
```
2. 修改源码
因为 `sx1302_hal` 无法读取到 `T-SX1302` 的温度, 需要将 `libloragw/src/loragw_hal.c` 中的部分代码注释:
```diff
diff --git a/libloragw/src/loragw_hal.c b/libloragw/src/loragw_hal.c
index ffc8ec0..504bb42 100644
--- a/libloragw/src/loragw_hal.c
+++ b/libloragw/src/loragw_hal.c
@@ -1093,6 +1093,7 @@ int lgw_start(void) {
dbg_init_random();
if (CONTEXT_COM_TYPE == LGW_COM_SPI) {
+#if 0
/* Find the temperature sensor on the known supported ports */
for (i = 0; i < (int)(sizeof I2C_PORT_TEMP_SENSOR); i++) {
ts_addr = I2C_PORT_TEMP_SENSOR[i];
@@ -1116,7 +1117,7 @@ int lgw_start(void) {
printf("ERROR: no temperature sensor found.\n");
return LGW_HAL_ERROR;
}
-
+#endif
/* Configure ADC AD338R for full duplex (CN490 reference design) */
if (CONTEXT_BOARD.full_duplex == true) {
err = i2c_linuxdev_open(I2C_DEVICE, I2C_PORT_DAC_AD5338R, &ad_fd);
@@ -1285,14 +1286,14 @@ int lgw_receive(uint8_t max_pkt, struct lgw_pkt_rx_s *pkt_data) {
nb_pkt_left = nb_pkt_fetched - max_pkt;
printf("WARNING: not enough space allocated, fetched %d packet(s), %d will be left in RX buffer\n", nb_pkt_fetched, nb_pkt_left);
}
-
+#if 0
/* Apply RSSI temperature compensation */
res = lgw_get_temperature(&current_temperature);
if (res != LGW_I2C_SUCCESS) {
printf("ERROR: failed to get current temperature\n");
return LGW_HAL_ERROR;
}
-
+#endif
/* Iterate on the RX buffer to get parsed packets */
for (nb_pkt_found = 0; nb_pkt_found < ((nb_pkt_fetched <= max_pkt) ? nb_pkt_fetched : max_pkt); nb_pkt_found++) {
/* Get packet and move to next one */
```
将 `T-SX1302` 的复位引脚修改为 `GPIO7`:
```diff
diff --git a/tools/reset_lgw.sh b/tools/reset_lgw.sh
index b58f0e9..56ff943 100755
--- a/tools/reset_lgw.sh
+++ b/tools/reset_lgw.sh
@@ -12,7 +12,7 @@
# GPIO mapping has to be adapted with HW
#
-SX1302_RESET_PIN=23 # SX1302 reset
+SX1302_RESET_PIN=7 # SX1302 reset
SX1302_POWER_EN_PIN=18 # SX1302 power enable
SX1261_RESET_PIN=22 # SX1261 reset (LBT / Spectral Scan)
AD5338R_RESET_PIN=13 # AD5338R reset (full-duplex CN490 reference design)
@@ -90,4 +90,4 @@ case "$1" in
;;
esac
```
3. 编译
### 获取相关信息
```shell
make clean all
make install
make install_conf
pi@raspberrypi:~ $ cat .sx1302_hal/.output
Gateway EUI: B827EBFFFEFC7AF0
Gateway Server address: eu1.cloud.thethings.network
Gateway Server port: 1700
```
### 修改配置文件
## 在TTN上创建网关
```shell
cd ~/sx1302_hal/bin
touch global_conf.json.sx1250.T-SX1302
```
1. 登录到 https://console.cloud.thethings.network/
添加以下内容到 `global_conf.json.sx1250.T-SX1302`:
2. 根据网关支持频段选择对应的集群，`T-SX1302`对应的频段为 `868MHZ`, 这里需要选择 `Europe1` 集群
```json
{
"SX130x_conf": {
"com_type": "SPI",
"com_path": "/dev/spidev0.0",
"lorawan_public": true,
"clksrc": 0,
"antenna_gain": 0, /* antenna gain, in dBi */
"full_duplex": false,
"precision_timestamp": {
"enable": false,
"max_ts_metrics": 255,
"nb_symbols": 1
},
"radio_0": {
"enable": true,
"type": "SX1250",
"freq": 867500000,
"rssi_offset": -215.4,
"rssi_tcomp": {
"coeff_a": 0,
"coeff_b": 0,
"coeff_c": 20.41,
"coeff_d": 2162.56,
"coeff_e": 0
},
"tx_enable": true,
"tx_freq_min": 863000000,
"tx_freq_max": 870000000,
"tx_gain_lut": [
{
"rf_power": 12,
"pa_gain": 0,
"pwr_idx": 15
},
{
"rf_power": 13,
"pa_gain": 0,
"pwr_idx": 16
},
{
"rf_power": 14,
"pa_gain": 0,
"pwr_idx": 17
},
{
"rf_power": 15,
"pa_gain": 0,
"pwr_idx": 19
},
{
"rf_power": 16,
"pa_gain": 0,
"pwr_idx": 20
},
{
"rf_power": 17,
"pa_gain": 0,
"pwr_idx": 22
},
{
"rf_power": 18,
"pa_gain": 1,
"pwr_idx": 1
},
{
"rf_power": 19,
"pa_gain": 1,
"pwr_idx": 2
},
{
"rf_power": 20,
"pa_gain": 1,
"pwr_idx": 3
},
{
"rf_power": 21,
"pa_gain": 1,
"pwr_idx": 4
},
{
"rf_power": 22,
"pa_gain": 1,
"pwr_idx": 5
},
{
"rf_power": 23,
"pa_gain": 1,
"pwr_idx": 6
},
{
"rf_power": 24,
"pa_gain": 1,
"pwr_idx": 7
},
{
"rf_power": 25,
"pa_gain": 1,
"pwr_idx": 9
},
{
"rf_power": 26,
"pa_gain": 1,
"pwr_idx": 11
},
{
"rf_power": 27,
"pa_gain": 1,
"pwr_idx": 14
}
]
},
"radio_1": {
"enable": true,
"type": "SX1250",
"freq": 868500000,
"rssi_offset": -215.4,
"rssi_tcomp": {
"coeff_a": 0,
"coeff_b": 0,
"coeff_c": 20.41,
"coeff_d": 2162.56,
"coeff_e": 0
},
"tx_enable": true
},
"chan_multiSF_0": {
"enable": true,
"radio": 1,
"if": -400000
},
"chan_multiSF_1": {
"enable": true,
"radio": 1,
"if": -200000
},
"chan_multiSF_2": {
"enable": true,
"radio": 1,
"if": 0
},
"chan_multiSF_3": {
"enable": true,
"radio": 0,
"if": -400000
},
"chan_multiSF_4": {
"enable": true,
"radio": 0,
"if": -200000
},
"chan_multiSF_5": {
"enable": true,
"radio": 0,
"if": 0
},
"chan_multiSF_6": {
"enable": true,
"radio": 0,
"if": 200000
},
"chan_multiSF_7": {
"enable": true,
"radio": 0,
"if": 400000
},
"chan_Lora_std": {
"enable": true,
"radio": 1,
"if": -200000,
"bandwidth": 250000,
"spread_factor": 7,
"implicit_hdr": false,
"implicit_payload_length": 17,
"implicit_crc_en": false,
"implicit_coderate": 1
},
"chan_FSK": {
"enable": true,
"radio": 1,
"if": 300000,
"bandwidth": 125000,
"datarate": 50000
}
},
"gateway_conf": {
"gateway_ID": "b827ebFFFEfc7af0",
/* change with default server address/ports */
"server_address": "eu1.cloud.thethings.network",
"serv_port_up": 1700,
"serv_port_down": 1700,
/* adjust the following parameters for your network */
"keepalive_interval": 10,
"stat_interval": 30,
"push_timeout_ms": 100,
/* forward only valid packets */
"forward_crc_valid": true,
"forward_crc_error": false,
"forward_crc_disabled": false,
/* GPS configuration */
//"gps_tty_path": "/dev/ttyS0",
/* GPS reference coordinates */
// "ref_latitude": 0.0,
//"ref_longitude": 0.0,
//"ref_altitude": 0,
/* Beaconing parameters */
"beacon_period": 0,
"beacon_freq_hz": 869525000,
"beacon_datarate": 9,
"beacon_bw_hz": 125000,
"beacon_power": 14,
"beacon_infodesc": 0
},
"debug_conf": {
"ref_payload": [
{
"id": "0xCAFE1234"
},
{
"id": "0xCAFE2345"
}
],
"log_file": "loragw_hal.log"
}
}
```
![cluster_picker](../static/cluster_picker.png)
其中, `gateway_ID` 修改为 `Gateway EUI`
> ! Warning
>
> 其中 `Legacy V2 Console`为TTN V2版本的服务器, 它将在2021年12月份关闭, 不建议使用
`server_address` 修改为 `eu1.cloud.thethings.network`
3. 创建一个网关
这些信息，要和 `TTN` 上创建的Gateway信息一致
![create_gateways](../static/create_gateways.png)
![lilygo_gateway_overview](../static/lilygo_gateway_overview.png)
4. 配置网关信息
> NOTE
>
> `TTN` 的 `serv_port_up` 和 `serv_port_down` 为 `1700`
填入部署sx1302_hal后获得的 [Gateway EUI](#获取相关信息)
### 运行sx1302_hal
![config_gateway_info](../static/config_gateway_info.png)
```shell
cd ~/sx1302_hal/bin
./lora_pkt_fwd -c global_conf.json.sx1250.T-SX1302
```
5. 选择频率，需要部署 sx1302_hal 的频段参数保持一致
### 检查网关连接状态
![slelct_frequenry](../static/slelct_frequenry.png)
## 检查网关连接状态
在TTN上检查网关是否连接成功
@ -437,7 +103,7 @@ cd ~/sx1302_hal/bin
![register_end_device](../static/register_end_device.png)
> NOTE
> NOTE
>
> `DevEUI`、`AppEUI`、`AppKey`选择自动生成即可
@ -557,3 +223,4 @@ index 896be89..6b39f54 100644
| 版本 | 主要改动 | 日期 | 作者 |
| ----- | -------- | ---------- | ------- |
| 1.0.0 | 初始版本 | 2021/10/22 | liangyy |
| 1.1.0 | | 2022/11/29 | liangyy |