intial test version

QUICK_START.md

@@ -0,0 +1,92 @@
+# BluettiBLE — Quick Start
+
+Get a Bluetti power station reporting to an ESP32 in a few minutes.
+
+## 1. Find your device's BLE name
+
+Install a BLE scanner on your phone (nRF Connect or LightBlue) and scan. Your
+Bluetti advertises a name that starts with the model, for example:
+
+- `AC3001234567890`
+- `AC200M1234567890`
+- `EB3A1234567890`
+
+Copy the **full** advertised name — that string is how the library finds the unit
+(there is no pairing and no encryption key to enter).
+
+## 2. Install the library
+
+PlatformIO (`platformio.ini`):
+
+```ini
+[env:esp32dev]
+platform = espressif32
+board = esp32dev
+framework = arduino
+monitor_speed = 115200
+lib_deps =
+    https://gitea.sh3d.com.au/Sh3d/BluettiBLE.git
+```
+
+Or copy this folder into `lib/` (PlatformIO) or `libraries/` (Arduino IDE).
+
+## 3. Minimal sketch
+
+```cpp
+#include <Arduino.h>
+#include "BluettiBLE.h"
+
+BluettiBLE bluetti;
+
+void onData(const BluettiDevice* dev) {
+    Serial.printf("%s  SoC %u%%  AC out %u W  DC out %u W\n",
+                  dev->data.model, dev->data.totalBatteryPercent,
+                  dev->data.acOutputPower, dev->data.dcOutputPower);
+}
+
+void setup() {
+    Serial.begin(115200);
+    bluetti.begin();
+    bluetti.setCallback(onData);
+    bluetti.addDevice("My Bluetti", "AC3001234567890", BLUETTI_AC300);  // <- your name + model
+}
+
+void loop() {
+    bluetti.loop();
+}
+```
+
+Set the model to match your unit: `BLUETTI_AC300`, `BLUETTI_AC200M`,
+`BLUETTI_EB3A`, `BLUETTI_EP500P`, `BLUETTI_AC500`, `BLUETTI_EP500`,
+`BLUETTI_EP600`.
+
+## 4. Upload and watch
+
+Open the serial monitor at 115200. You should see the library scan, connect, and
+then print a line every poll cycle (default every 3 seconds). Turn on debug for
+the raw command/connection trace:
+
+```cpp
+bluetti.setDebug(true);
+```
+
+## 5. Control output (optional)
+
+Once connected you can toggle the outputs:
+
+```cpp
+if (bluetti.isConnected()) {
+    bluetti.setACOutput(true);   // turn AC output on
+    bluetti.setDCOutput(false);  // turn DC output off
+}
+```
+
+## Troubleshooting
+
+- **Never connects** — double-check the BLE name is exact (case sensitive), and
+  that the Bluetti app on your phone is closed (a Bluetti accepts one BLE client
+  at a time).
+- **Connects but no data** — make sure the model enum matches your hardware; the
+  register map is model-specific.
+- **Drops out** — keep `bluetti.loop()` running every iteration; the library
+  reconnects automatically after a disconnect.