/+/cmd/relay` | `ON` または `1` でオン、それ以外はオフ |
publishはQoS 0です。プレフィックスは、先頭と末尾に `/` を付けず、`#` と `+` を含まず、 47文字以内にしてください。
### 設定方法: 設定ポータル (APモード)
Wi-FiとMQTTの設定はソースに埋め込まず、Gateway自身が提供するWebフォームから入力し、 NVSに保存。
**設定モードに入る条件**
| きっかけ | 動作 |
| --- | --- |
| 保存済みの設定がない（初回起動） | 設定モードで起動 |
| 起動時にWi-Fi接続が30秒失敗 | 次回の起動で設定モードに入るよう再起動 |
| 動作中にBOOTボタン（初期値GPIO9）を5秒長押し | 設定モードに入るよう再起動 |
動作中にWi-Fiが切れた場合は設定モードに入らず、そのまま再接続を繰り返す。
**ポータルの使い方**
1. スマホやPCでWi-Fi `LoRa-GW-XXXX` に接続します（`XXXX` はSoftAPのMACアドレス下位2バイト）。 パスワードは `CONFIG_GATEWAY_PROV_AP_PASSWORD`（初期値 `gateway-setup`。 **必ず変更してください** ）。
2. ブラウザで `http://192.168.4.1/` へアクセス。キャプティブポータル用のDNSは実装していないため、 アドレスは手入力してください。スマホが「インターネットに接続されていません」と表示したら、 接続を維持する側を選択。
3. フォームに入力して **保存して再起動** を押下。Gatewayが再起動し、STAモードで動作開始。
| 項目 | 備考 |
| --- | --- |
| SSID | 設定モード開始時にスキャンした周辺のSSIDが候補として表示 |
| Wi-Fiパスワード | 空欄で保存すると現在の値を維持。保存済みの値がなく空欄の場合はオープンネットワーク扱い |
| ブローカURI | `mqtts://` を指定。例: `mqtts://mqtt.example.com:8884` |
| MQTTユーザー名 / パスワード | パスワードを空欄にすると現在の値を維持 |
| トピックプレフィックス | 上記のトピックの規則を参照 |
設定ポータルに `CONFIG_GATEWAY_PROV_TIMEOUT_SEC`（初期値300秒）のあいだ操作がなければ、 Gatewayは再起動してSTAモードを試し直します（ルーターがまだ復旧していない停電復旧時でも、 自力で復帰できるようにするため）。
### ビルド時オプション (Kconfig)
```bash
$ cd project/esp32_gateway
$ pio run -t menuconfig
# "Gateway Configuration" メニュー
```
| オプション | 用途 |
| --- | --- |
| `GATEWAY_UART_PORT_NUM`, `GATEWAY_UART_TX_PIN`, `GATEWAY_UART_RX_PIN` | STM32とのUART接続 |
| `GATEWAY_MQTT_BROKER_URI` | 設定フォームに表示される初期値 |
| `GATEWAY_MQTT_TOPIC_PREFIX` | 設定フォームに表示されるプレフィックスの初期値 |
| `GATEWAY_NTP_SERVER` | 時刻同期に使うNTPサーバ（初期値 `ntp.nict.jp`） |
| `GATEWAY_MQTT_USE_CUSTOM_CA` | 公的CAバンドルの代わりに `ca_cert.pem` を埋め込む |
| `GATEWAY_PROV_AP_PASSWORD` | 設定用APのパスワード（8文字以上） |
| `GATEWAY_PROV_BUTTON_GPIO` | 5秒長押しに使うボタン（初期値9） |
| `GATEWAY_PROV_TIMEOUT_SEC` | 設定モードの無操作タイムアウト（初期値300） |
ESP32-C6のGPIO9はストラップピン。起動後に押す分には問題ありませんが、 リセット中にLowにしているとROMのダウンロードモードに入るので注意。
`sdkconfig.defaults`
```auto
CONFIG_MBEDTLS_CERTIFICATE_BUNDLE=y
CONFIG_MBEDTLS_CERTIFICATE_BUNDLE_DEFAULT_FULL=y
CONFIG_ESP_MAIN_TASK_STACK_SIZE=6144
```
最初の2行は、Let’s Encryptなど公的CAの証明書を検証するためのCAバンドルを有効にします。 スタックサイズについては、PlatformIOが「Default Value Mismatch」と通知しますが、 情報表示であり問題ありません。
`src/CMakeLists.txt`
```c
idf_component_register(
SRCS "main.cpp" "gw_prov.cpp"
INCLUDE_DIRS "."
REQUIRES nvs_flash esp_wifi esp_event esp_netif esp_timer
esp_http_server mqtt json driver mbedtls
)
```
自前CAを使う場合は、`esp32_gateway/platformio.ini` に `board_build.embed_txtfiles = src/ca_cert.pem` も追加すること。
### MQTTSとブローカーの設定
通信の保護とユーザー認証は、別の仕組み。
- **TLS** （サーバ証明書）: Gatewayがブローカーを確認し、通信を暗号化。 Let’s Encryptなどの公的CAなら、ESP32が内蔵のCAバンドルで証明書を検証するため、 デバイスに証明書ファイルを置く必要はなく、証明書の更新でファームウェアを書き換える必要もありません。
- **ユーザー認証** : GatewayがTLSの中でMQTTのユーザー名とパスワードを送信。 クライアント証明書は不要。
TLSのハンドシェイクでは証明書の有効期間を検証するため、GatewayはMQTT開始前にSNTPで時刻を合わせます。 URIのホスト名は、証明書のCN/SANと一致している必要があります（IPアドレスでは検証に失敗します）。
### 推奨構成: HAProxyでTLS終端
```auto
ESP32-C6 --TLS 8884--> HAProxy (TLS終端) --平文 1883--> Mosquitto (パスワード + ACL)
```
OpenRemote Proxyの既存の `listen mqtt` ブロックを参考にした例。自分用の `haproxy.cfg` にこのブロックを追加し、既存の `8883` のブロックはそのまま残してください。
haproxy
```auto
listen mosquitto_mqtts
bind *:8884 ssl crt /etc/haproxy/certs crt "${CERT_DIR}" crt "${CUSTOM_CERT_DIR}" no-tls-tickets
mode tcp
option clitcpka
timeout client 3h
timeout server 3h
option logasap
balance leastconn
server mosquitto mosquitto:1883 resolvers docker_resolver
```
yaml
```yaml
services:
proxy:
ports:
- "8884:8884"
volumes:
- ./haproxy.cfg:/data/proxy/haproxy.cfg
environment:
HAPROXY_CONFIG: '/data/proxy/haproxy.cfg'
```
Mosquittoの1883はホストに未公開。Dockerネットワーク内で、 プロキシからのみ到達。
### Mosquitto
`mosquitto.conf`
```ini
listener 1883 0.0.0.0
protocol mqtt
allow_anonymous false
password_file /mosquitto/config/passwd
acl_file /mosquitto/config/acl.conf
```
Gateway専用のユーザーを作成し（パスワードファイルが既にある場合は `-c` を付けない）、 ACLで権限を絞ります。`lora` はトピックプレフィックスに置き換えてください。
bash
```bash
$ docker compose exec mosquitto mosquitto_passwd -b /mosquitto/config/passwd gw01 'your-password'
```
conf
```auto
# /mosquitto/config/acl.conf
user gw01
topic write lora/+/data
topic write lora/+/status
topic read lora/+/cmd/relay
```
`acl_file` を有効にすると、ACLに書かれていないユーザーは何も読み書きできなくなります。 このブローカーを使う他のクライアントがあれば、そのエントリも追加してください。
PCからの接続テスト:
bash
```bash
$ mosquitto_pub -h mqtt.example.com -p 8884 --capath /etc/ssl/certs \
-u gw01 -P 'your-password' -t lora/1/cmd/relay -m ON
```
### Gatewayが接続できないとき
`MQTT_EVENT_ERROR` のときに、シリアルログへ原因が出力されます。
| ログ | 考えられる原因 |
| --- | --- |
| `TLS/TCP error: esp_tls_err=... tls_stack_err=...` | 証明書の検証失敗、時刻が未同期、ホスト名の不一致、または8884へ到達できない |
| `MQTT connection refused, return code=5` | ユーザー名/パスワードの誤り |
| 接続はできるがメッセージが届かない | ACLで拒否されている可能性（ACLの拒否はエラーにならず、publishは黙って捨てられる）。ACLのトピックとプレフィックスが一致しているか確認 |
| `Time synced` が出ない | SNTPの同期に失敗。時刻が合うまで、証明書が「まだ有効でない」と判定されることがある |
### ビルド (STM32)
bash
```bash
# CLIデバッグビルド（動作確認・RF調整用）
$ pio run -e bluepill_cli -t upload
# 本番メッシュファームウェア
$ pio run -e bluepill_mesh -t upload
```
### 配線表
| 信号 | STM32ピン | 接続先 |
| --- | --- | --- |
| SPI1 NSS/SCK/MISO/MOSI | PA4/PA5/PA6/PA7 | DX-LR30 |
| USART1 (デバッグ、CLIビルドのみ) | PA9/PA10 | USB-シリアル変換器 |
| USART3 (ESP32通信) | PB10(TX)/PB11(RX) | ESP32-C6 UART（ピンはKconfigで設定。TX(GPIO5)/RX(GPIO4)はクロス接続） |
| I2C1 (BMI160) | PB8(SCL)/PB9(SDA) | BMI160モジュール |
| BMI160 電源 | 3.3V直結ピン | BMI160モジュールの3.3Vピン（VINではなくLDOバイパス側） |
| BMI160 INT1 | PB1 | BMI160モジュールのINT1 |
| Repeater判定ジャンパー | PB0 | GND短絡でRepeater、オープンでNode/Gateway/Actuator側の判定 |
| Relay判定ジャンパー | PB1 | GND短絡でRelay、オープンでNode/Gateway/Repeater側の判定 |
| RELAY\_PIN | PB3 | ROLE\_ACTUATORのみ使用 |
| FEEDBACK\_PIN | PB4 | ROLE\_ACTUATORのみ使用（生のHIGH/LOWを送信） |
### 役割判定ロジック
1. ESP32がUARTのPING(0xF0)/PONG(0xF1)ハンドシェイクに応答 → **Gateway**
2. `PB0`がGNDに落ちている（ジャンパー装着） → **Repeater**
3. `PB1`がGNDに落ちている（ジャンパー装着） → **Relay Node**
4. どちらでもない → **Sensor Node** （省電力・BMI160センサーなど）
---
### Author:  [@tk-fuse](https://forum.ficusonline.com/u/tk-fuse)
#### Post date: [2026 年 10 月 7 日午前 12:16 UTC](https://forum.ficusonline.com/t/topic/568/8 "2026-10-07T00:16:10Z")
## STM32F103ピン配置
#### [STM32F103C8T6](https://www.st.com/en/microcontrollers-microprocessors/stm32f103c8.html)
ノード、リピータ、ゲートウェイのベースマイコンとして使用。ESP32とはUSART接続。
開発環境：Arduino IDE
| Manufacturer | ST-Microelectronics |
| --- | --- |
| Name | Blue Pill |
| Core | Arm Cortex-M3 |
| Max. Clock Speed | 72MHz |
| Package | LQFP 48 pins |
| FLASH | 64KiB |
| SRAM | 20KiB |
| HSI | 8MHz |
| LSI | 40kHz |
| HSE | 8MHz |
| LSE | 32.768kHz |
---
### Author:  [@tk-fuse](https://forum.ficusonline.com/u/tk-fuse)
#### Post date: [2026 年 10 月 9 日午前 6:45 UTC](https://forum.ficusonline.com/t/topic/568/9 "2026-10-09T06:45:02Z")
## 適正受信感度
> 注）法規制の注意
> 920MHz 帯は特定小電力無線として使えますが、次の点に注意。
>
> - 技適（工事設計認証）取得したモジュールを使う必要があります。SX1262 の素のチップではなく、 **DX-LR30 のような技適取得済みモジュール** で、取得時の構成（アンテナ含む）のまま使うことが前提です。
> - 920MHz 帯には送信時間制限（デューティ）、キャリアセンス（LBT）、チャンネル幅、出力の規定があります。[ARIB STD-T108](https://www.arib.or.jp/kikaku/kikaku_tushin/desc/std-t108.html) を確認してください。
ゲートウェイとノードを一対一接続した場合の目安
| 項目 | 値 |
| --- | --- |
| 周波数 | 920MHz帯 |
| SF | 9 |
| 帯域幅 | 125kHz |
| 送信出力 | 13dBm（約20mW） |
| 環境 | 到達距離の目安 |
| --- | --- |
| 見通しの良い屋外 | 2〜5km |
| 住宅街（屋外同士） | 300m〜1km |
| 住宅街（片方が屋内） | 100〜400m |
| 鉄筋コンクリート建物内（壁・階をまたぐ） | 数十m〜100m 程度 |
RSSI が -95dBm 程度まで
---
### Author:  [@tk-fuse](https://forum.ficusonline.com/u/tk-fuse)
#### Post date: [2026 年 10 月 14 日午後 12:45 UTC](https://forum.ficusonline.com/t/topic/568/10 "2026-10-14T12:45:12Z")
## トラブルシュート
onOff スイッチ: Type Boolean
バブリッシュされる値は`true/false`
トピックは`1/0`で反応するため変換。
> **[Write Value Converter: Convert Boolean Switch to 0/1 for MQTT](https://forum.openremote.io/t/write-value-converter-convert-boolean-switch-to-0-1-for-mqtt/3962)**
>
> Hi everyone, I’m trying to use the Write Value Converter in OpenRemote so that a UI switch sends 0 or 1 to an MQTT topic. Desired behavior: Switch ON (true) → publish "1" Switch OFF (false) → publish "0" My current attribute configuration: { ...
- **Write Value Converter** : パブリッシュする値に対して適用
- **Value Converter** : サブスクライブする値に対して適用
* * *
### STM32：リセットスイッチエラー
- CH340C の DTR#/RTS# が NRST/BOOT0 に繋がっていて、PC のシリアルポートが閉じた状態だと、リセット後の起動が不安定になる
- アダプタ給電では DTR/RTS が動かないため、通常どおり起動する
- 通常の電源ON/OFFでは問題ない
---
### Author:  [@tk-fuse](https://forum.ficusonline.com/u/tk-fuse)
#### Post date: [2026 年 10 月 16 日午前 2:49 UTC](https://forum.ficusonline.com/t/topic/568/11 "2026-10-16T02:49:29Z")
## アセットの設定
調光LED照明
Value Converter（サブスクライブに適用）
```auto
{
"ON": 1,
"OFF": 0
}
```
Value Filters（サブスクライブに適用。JSONフォーマットのデータの一部を抽出）
```auto
[
{
"type": "jsonPath",
"path": "$.POWER",
"returnFirst": false,
"returnLast": true
}
]
```
---
### Author:  [@tk-fuse](https://forum.ficusonline.com/u/tk-fuse)
#### Post date: [2026 年 10 月 17 日午前 8:02 UTC](https://forum.ficusonline.com/t/topic/568/12 "2026-10-17T08:02:06Z")
## マーカーのカスタマイズ
`Appearance ---> REALME STYLING ---> JSON`
アセットであるセンサやLEDなどのON/OFFによりマーカーの色を変更。
> **[Appearance Page | OpenRemote Documentation](https://docs.openremote.io/docs/user-guide/manager-ui/appearance/)**
>
> Configuring the Manager UI
```auto
"pages": {
"map": {
"markers": {
"LightAsset": {
"attributeName": "onOff",
"showLabel": true,
"showUnits": false,
"colours": {
"type": "boolean",
"true": "FFD700",
"false": "808080"
}
},
"PresenceSensorAsset": {
"attributeName": "presence",
"showLabel": true,
"showUnits": false,
"colours": {
"type": "boolean",
"true": "39B54A",
"false": "C1272D"
}
},
"WeatherAsset": {
"attributeName": "windSpeed",
"showLabel": true,
"showUnits": true,
"colours": {
"type": "range",
"ranges": [
{
"min": 0,
"colour": "39B54A"
},
{
"min": 10,
"colour": "F7931E"
},
{
"min": 20,
"colour": "C1272D"
}
]
}
}
```
* * *
Insights —\> ダッシュボードではウィジットのマップで色指定
---
### Author:  [@tk-fuse](https://forum.ficusonline.com/u/tk-fuse)
#### Post date: [2026 年 10 月 24 日午前 12:54 UTC](https://forum.ficusonline.com/t/topic/568/13 "2026-10-24T00:54:02Z")
### ソースコード: GitHub
> **[GitHub - capitalfuse/lora-project: lora network system with STM32F103C8 + DX-LR30...](https://github.com/capitalfuse/lora-project)**
>
> lora network system with STM32F103C8 + DX-LR30 (SX1262) + BMI160 (for Senser Node) + ESP32-C6 (for Gateway) + LED (Used for Actuator Node) . Managed this system by OpenRemote.
```auto
$ git config -l # 登録ユーザ名とメールアドレス確認
$ gh auth login # GitHub CLI
```
GitHubへプッシュ
```auto
$ cd lora-project
$ git init -b main
$ git add .
$ git commit -m "Initial commit"
$ gh repo create lora-project --public --source=. --remote=origin --push \
--description "LoRa (920 MHz) mesh for sensors and relay control: STM32F103 + SX1262 with an ESP32-C6 MQTTS gateway"
```
確認
```auto
$ git remote -v
$ git status -sb
$ gh repo view --web
```
タグ追加
```auto
$ git tag v0.1.0
$ git push origin v0.1.0
```