check version before release

.claude/CLAUDE.md

@@ -1,350 +0,0 @@
-# VictronBLE Project Context
-
-## Project Overview
-Portable Arduino library for reading Victron Energy devices via Bluetooth Low Energy (BLE). Runs on ESP32 (Bluedroid) and nRF52840 (Bluefruit); BLE scanning is the only platform-specific code (src/esp32, src/nrf52), while decoding and AES-128-CTR crypto are common.
-
-## Key Files
-- `src/` - Main library source code
-- `examples/` - Example sketches
-- `experiment/` - Experimental code
-- `library.json` / `library.properties` - PlatformIO/Arduino library config
-
-## Build & Test
-- This is an Arduino/PlatformIO library
-- Test with PlatformIO: `pio run`
-
-## Session Notes
-<!-- Add learnings from each session below -->
-
-
-### Session: 2026-01-29 18:41
-**Modified files:**
-- TODO
-
-
-### Session: 2026-02-11 13:51
-**Modified files:**
-- .claude/CLAUDE.md
-- .claude/scripts/update-claude-md.sh
-- TODO
-- examples/MultiDevice/src/main.cpp
-
-
-### Session: 2026-02-11 15:57
-**Modified files:**
-- .claude/CLAUDE.md
-- .claude/scripts/update-claude-md.sh
-- TODO
-- examples/MultiDevice/src/main.cpp
-
-
-### Session: 2026-02-12 18:02
-**Modified files:**
-- .claude/CLAUDE.md
-- .claude/scripts/update-claude-md.sh
-- TODO
-- examples/MultiDevice/src/main.cpp
-
-
-### Session: 2026-02-12 18:02
-**Modified files:**
-- .claude/CLAUDE.md
-- .claude/scripts/update-claude-md.sh
-- TODO
-- examples/MultiDevice/src/main.cpp
-- library.json
-
-
-### Session: 2026-02-12 18:06
-**Commits:**
-```
-5a210fb Experimenting with a claude file and created new logging example
-```
-**Modified files:**
-- .claude/CLAUDE.md
-- TODO
-- examples/Logger/platformio.ini
-- examples/Logger/src/main.cpp
-- examples/MultiDevice/src/main.cpp
-- library.json
-
-
-### Session: 2026-02-12 18:08
-**Commits:**
-```
-5a210fb Experimenting with a claude file and created new logging example
-```
-**Modified files:**
-- .claude/CLAUDE.md
-- README.md
-- TODO
-- VERSIONS
-- examples/Logger/platformio.ini
-- examples/Logger/src/main.cpp
-- examples/MultiDevice/src/main.cpp
-- library.json
-- library.properties
-
-
-### Session: 2026-02-12 18:10
-**Commits:**
-```
-5a210fb Experimenting with a claude file and created new logging example
-```
-**Modified files:**
-- .claude/CLAUDE.md
-- README.md
-- TODO
-- VERSIONS
-- examples/Logger/platformio.ini
-- examples/Logger/src/main.cpp
-- examples/MultiDevice/src/main.cpp
-- library.json
-- library.properties
-
-
-### Session: 2026-02-12 18:23
-**Commits:**
-```
-a843eb9 Keep v0.3.1
-5a210fb Experimenting with a claude file and created new logging example
-```
-**Modified files:**
-- .claude/CLAUDE.md
-- README.md
-- VERSIONS
-- library.json
-- library.properties
-- src/VictronBLE.cpp
-- src/VictronBLE.h
-
-
-### Session: 2026-02-12 18:35
-**Commits:**
-```
-a64fef8 New version with smaller memory footprint etc
-a843eb9 Keep v0.3.1
-5a210fb Experimenting with a claude file and created new logging example
-```
-**Modified files:**
-- .claude/CLAUDE.md
-- src/VictronBLE.cpp
-- src/VictronBLE.h
-
-
-### Session: 2026-02-13 11:02
-**Modified files:**
-- .claude/CLAUDE.md
-- src/VictronBLE.cpp
-- src/VictronBLE.h
-
-
-### Session: 2026-02-15 18:59
-**Modified files:**
-- .claude/CLAUDE.md
-- library.json
-- src/VictronBLE.cpp
-- src/VictronBLE.h
-
-
-### Session: 2026-02-15 19:06
-**Modified files:**
-- .claude/CLAUDE.md
-- library.json
-- src/VictronBLE.cpp
-- src/VictronBLE.h
-
-
-### Session: 2026-02-15 19:10
-**Modified files:**
-- .claude/CLAUDE.md
-- library.json
-- src/VictronBLE.cpp
-- src/VictronBLE.h
-
-
-### Session: 2026-02-15 19:18
-**Commits:**
-```
-8a2402c Repeater and Test code for ESP Now
-```
-**Modified files:**
-- .claude/CLAUDE.md
-- examples/FakeRepeater/platformio.ini
-- examples/FakeRepeater/src/main.cpp
-- examples/Receiver/platformio.ini
-- examples/Receiver/src/main.cpp
-- examples/Repeater/platformio.ini
-- examples/Repeater/src/main.cpp
-- library.json
-
-
-### Session: 2026-02-15 19:20
-**Commits:**
-```
-24712c2 Work on receiver and sender
-8a2402c Repeater and Test code for ESP Now
-```
-**Modified files:**
-- .claude/CLAUDE.md
-- examples/Receiver/platformio.ini
-- examples/Receiver/src/main.cpp
-- examples/Repeater/src/main.cpp
-
-
-### Session: 2026-02-28 12:26
-**Modified files:**
-- .claude/CLAUDE.md
-- examples/Receiver/src/main.cpp
-- examples/Repeater/src/main.cpp
-
-
-### Session: 2026-02-28 14:32
-**Commits:**
-```
-4944757 Fix to be non blocking without tasks
-31765c7 Update notes
-84d153c Single callback version - vastly simplified.
-```
-**Modified files:**
-- examples/Logger/src/main.cpp
-- examples/MultiDevice/src/main.cpp
-- examples/Repeater/src/main.cpp
-- library.json
-- library.properties
-- src/VictronBLE.cpp
-- src/VictronBLE.h
-
-
-### Session: 2026-02-28 14:33
-**Commits:**
-```
-4944757 Fix to be non blocking without tasks
-31765c7 Update notes
-84d153c Single callback version - vastly simplified.
-```
-**Modified files:**
-- .claude/CLAUDE.md
-- VERSIONS
-- examples/Logger/src/main.cpp
-- examples/MultiDevice/src/main.cpp
-- examples/Repeater/src/main.cpp
-- library.json
-- library.properties
-- src/VictronBLE.cpp
-- src/VictronBLE.h
-
-
-### Session: 2026-02-28 14:36
-**Commits:**
-```
-4944757 Fix to be non blocking without tasks
-31765c7 Update notes
-```
-**Modified files:**
-- .claude/CLAUDE.md
-- VERSIONS
-- examples/Logger/src/main.cpp
-- examples/MultiDevice/src/main.cpp
-- examples/Repeater/src/main.cpp
-- library.json
-- library.properties
-- src/VictronBLE.cpp
-- src/VictronBLE.h
-
-
-### Session: 2026-02-28 14:40
-**Commits:**
-```
-39a89c8 Versions v0.4 ready for release
-4944757 Fix to be non blocking without tasks
-31765c7 Update notes
-```
-**Modified files:**
-- .claude/CLAUDE.md
-- README.md
-- VERSIONS
-- library.json
-- library.properties
-
-
-### Session: 2026-02-28 14:48
-**Commits:**
-```
-261cc0d Improve readme ready for v0.4 release
-39a89c8 Versions v0.4 ready for release
-4944757 Fix to be non blocking without tasks
-31765c7 Update notes
-```
-**Modified files:**
-- .claude/CLAUDE.md
-- README.md
-- REVIEW.md
-
-
-### Session: 2026-06-04 21:23
-**Commits:**
-```
-cd3b462 ignore local
-7706f88 Bug fixes for reported issues
-```
-**Modified files:**
-- .gitignore
-- README.md
-
-
-### Session: 2026-06-04 22:59
-**Commits:**
-```
-105d66b Update info
-```
-**Modified files:**
-- .claude/CLAUDE.md
-- README.md
-
-
-### Session: 2026-06-04 23:46
-**Commits:**
-```
-105d66b Update info
-```
-**Modified files:**
-- .claude/CLAUDE.md
-- README.md
-- VERSIONS
-- examples/MultiDevice/platformio.ini
-- examples/MultiDevice/src/main.cpp
-- library.json
-- library.properties
-- src/VictronBLE.cpp
-- src/VictronBLE.h
-- src/crypto/vble_aes.c
-
-
-### Session: 2026-06-04 23:58
-**Commits:**
-```
-53fa6fa ignore pka file
-de6607d Branch version ready for testing with nRF52
-```
-**Modified files:**
-- .gitignore
-- README.md
-- UPGRADE_V0.4.md
-- VERSIONS
-- library.json
-- library.properties
-
-
-### Session: 2026-06-05 00:00
-**Commits:**
-```
-53fa6fa ignore pka file
-de6607d Branch version ready for testing with nRF52
-```
-**Modified files:**
-- .claude/CLAUDE.md
-- .gitignore
-- README.md
-- UPGRADE_V0.4.md
-

.claude/scripts/update-claude-md.sh

@@ -1,31 +0,0 @@
-#!/bin/bash
-# Auto-update CLAUDE.md at end of session
-
-CLAUDE_MD="$(git rev-parse --show-toplevel)/.claude/CLAUDE.md"
-TIMESTAMP=$(date '+%Y-%m-%d %H:%M')
-
-# Get recent git activity from this session (last hour)
-RECENT_COMMITS=$(git log --oneline --since="1 hour ago" 2>/dev/null | head -5)
-MODIFIED_FILES=$(git diff --name-only HEAD~1 2>/dev/null | head -10)
-
-# Append session summary
-{
-  echo ""
-  echo "### Session: $TIMESTAMP"
-
-  if [ -n "$RECENT_COMMITS" ]; then
-    echo "**Commits:**"
-    echo "\`\`\`"
-    echo "$RECENT_COMMITS"
-    echo "\`\`\`"
-  fi
-
-  if [ -n "$MODIFIED_FILES" ]; then
-    echo "**Modified files:**"
-    echo "$MODIFIED_FILES" | sed 's/^/- /'
-  fi
-
-  echo ""
-} >> "$CLAUDE_MD"
-
-echo "Updated CLAUDE.md with session summary"

check_version.sh

@@ -0,0 +1,34 @@
+#!/usr/bin/env bash
+#
+# check_version.sh -- verify the library version is consistent and released.
+#
+# Read-only: confirms the version matches in both manifests and that a matching
+# git tag (vX.Y.Z) exists. Run it before tagging a release. Non-zero exit if the
+# versions disagree or the tag is missing.
+#
+# SPDX-License-Identifier: MIT
+
+set -u
+cd "$(dirname "$0")" || exit 2
+
+json=$(sed -nE 's/.*"version"[[:space:]]*:[[:space:]]*"([^"]+)".*/\1/p' library.json | head -1)
+prop=$(sed -nE 's/^version=([^[:space:]]+).*/\1/p' library.properties | tr -d '\r' | head -1)
+
+echo "library.json       : ${json:-<none>}"
+echo "library.properties : ${prop:-<none>}"
+
+fail=0
+
+if [ -n "$json" ] && [ "$json" = "$prop" ]; then
+    echo "ok   versions match ($json)"
+else
+    echo "FAIL versions differ (json=$json properties=$prop)"; fail=1
+fi
+
+if git rev-parse -q --verify "refs/tags/v$json" >/dev/null 2>&1; then
+    echo "ok   git tag v$json exists"
+else
+    echo "FAIL no git tag v$json -- create one to release: git tag v$json"; fail=1
+fi
+
+exit "$fail"

examples/MultiDevice/boards/rak4631.json

@@ -0,0 +1,52 @@
+{
+  "build": {
+    "arduino": {
+      "ldscript": "nrf52840_s140_v6.ld"
+    },
+    "core": "nRF5",
+    "cpu": "cortex-m4",
+    "extra_flags": "-DARDUINO_WISCORE_RAK4631_BOARD -DNRF52840_XXAA",
+    "f_cpu": "64000000L",
+    "hwids": [
+      ["0x239A", "0x8029"],
+      ["0x239A", "0x0029"],
+      ["0x239A", "0x002A"],
+      ["0x239A", "0x802A"]
+    ],
+    "usb_product": "WisCore RAK4631 Board",
+    "mcu": "nrf52840",
+    "variant": "wiscore_rak4631",
+    "bsp": {
+      "name": "adafruit"
+    },
+    "softdevice": {
+      "sd_flags": "-DS140",
+      "sd_name": "s140",
+      "sd_version": "6.1.1",
+      "sd_fwid": "0x00B6"
+    },
+    "bootloader": {
+      "settings_addr": "0xFF000"
+    }
+  },
+  "connectivity": ["bluetooth"],
+  "debug": {
+    "jlink_device": "nRF52840_xxAA",
+    "svd_path": "nrf52840.svd",
+    "openocd_target": "nrf52.cfg"
+  },
+  "frameworks": ["arduino"],
+  "name": "WisCore RAK4631 Board",
+  "upload": {
+    "maximum_ram_size": 235520,
+    "maximum_size": 815104,
+    "speed": 115200,
+    "protocol": "nrfutil",
+    "protocols": ["jlink", "nrfjprog", "nrfutil", "stlink"],
+    "use_1200bps_touch": true,
+    "require_upload_port": true,
+    "wait_for_upload_port": true
+  },
+  "url": "https://www.rakwireless.com",
+  "vendor": "RAKwireless"
+}

examples/MultiDevice/platformio.ini

@@ -1,3 +1,7 @@
+[platformio]
+src_dir = src
+boards_dir = boards
+
 [env]
 lib_extra_dirs = ../..
 
@@ -20,6 +24,17 @@ framework = arduino
 monitor_speed = 115200
 build_flags = -DCFG_DEBUG=0
 
+; RAKwireless RAK4630 (WisBlock) — nRF52840 with Bluefruit backend.
+; Board definition lives in boards/rak4631.json (always available).
+[env:rak4630]
+platform = nordicnrf52
+platform_packages = framework-arduinoadafruitnrf52 @ 1.10700.0
+framework = arduino
+board = rak4631
+monitor_speed = 115200
+upload_protocol = nrfutil
+build_flags = -DCFG_DEBUG=0
+
 [env:esp32dev]
 platform = espressif32
 board = esp32dev

library.json

@@ -1,8 +1,8 @@
 {
   "name": "victronble",
-  "version": "0.6.0",
+  "version": "0.6.1",
-  "description": "Portable Arduino library for reading Victron Energy device data via Bluetooth Low Energy (BLE) advertisements. Runs on ESP32 and nRF52840. Supports SmartSolar MPPT, SmartShunt, BMV, MultiPlus, Orion, Blue Smart AC chargers and other Victron devices. No external crypto dependency.",
+  "description": "Portable Arduino library for reading Victron Energy device data via Bluetooth Low Energy (BLE) advertisements. Runs on ESP32, ESP32-S3, ESP32-C3 and nRF52 (nRF52840, nRF52832). Supports SmartSolar MPPT, SmartShunt, BMV, MultiPlus, Orion, Blue Smart AC chargers and other Victron devices. No external crypto dependency.",
-  "keywords": "victron, ble, bluetooth, solar, mppt, battery, smartshunt, smartsolar, bmv, inverter, multiplus, esp32, nrf52, nrf52840, xiao, iot, energy, monitoring",
+  "keywords": "victron, ble, bluetooth, solar, mppt, battery, smartshunt, smartsolar, bmv, inverter, multiplus, esp32, esp32-s3, esp32-c3, nrf52, nrf52840, nrf52832, xiao, iot, energy, monitoring",
   "repository": {
     "type": "git",
     "url": "https://gitea.sh3d.com.au/Sh3d/VictronBLE.git"

library.properties

@@ -1,11 +1,11 @@
 name=VictronBLE
-version=0.6.0
+version=0.6.1
 author=Scott Penrose
 maintainer=Scott Penrose <scottp@dd.com.au>
-sentence=Portable library for reading Victron Energy device data via BLE on ESP32 and nRF52840
+sentence=Portable library for reading Victron Energy device data via BLE on ESP32/S3/C3 and nRF52 (nRF52840/nRF52832)
-paragraph=Read data from Victron SmartSolar, SmartShunt, BMV, inverters, Blue Smart AC chargers and other devices using Bluetooth Low Energy advertisements. Runs on ESP32 and nRF52840 (Bluefruit) with no external crypto dependency. Supports multiple devices simultaneously with no pairing required.
+paragraph=Read data from Victron SmartSolar, SmartShunt, BMV, inverters, Blue Smart AC chargers and other devices using Bluetooth Low Energy advertisements. Runs on ESP32, ESP32-S3, ESP32-C3 and nRF52 (nRF52840, nRF52832 — Bluefruit or Seeed cores) with no external crypto dependency. Supports multiple devices simultaneously with no pairing required.
 category=Communication
-url=https://gitea.sh3d.com.au/Sh3d/VictronBLE
+url=https://github.com/SH3D/VictronBLE
 architectures=esp32,nrf52
 depends=
 includes=VictronBLE.h