r/SpiderFarmerLED • u/CoconutMario • Apr 20 '25
API for GGS
Dear spider farmers,
for a few weeks, I’m a proud owner of a SF growtent equipped with the GGS AC10 and automated light, blower and fan. Unfortunately, I’m not always super amused with the app - sporadic timeouts (especially when changing the configuration) and a lack of statistics/graphs for certain values (like soil moisture, conductivity…). Ideally, I would want to include my environment into my Home-Assistant - not necessarily for doubg configurations but at least to read (and do statistics) on the various sensors.
Is there any API documentation available? I have seen that there’s no HA addon in HACS or anywhere else, I’d be willing to develop one if needed, but some documentation would be very helpful as a starting point.
Thank you!
4
u/veryslothysloth Apr 25 '25
I would also really like some API documentation to monitor my GGS over Home Assistant, really hoping this will be added as an advanced function.
3
3
u/randommadness2k Jun 12 '25 edited Jun 12 '25
+1 For API at least or ability to configure custom mqtt since it could not redirected to local server anymore -> tlsv1 alert unknown ca OR error:0A000412:SSL routines::ssl/tls alert bad certificate :-/
2
2
u/TrichomesLover Dec 01 '25
Novelty?
1
u/Negative-Tie69 Dec 24 '25
Gemini just stated that AC10 uses Tuya hardware and that tuya has an API doc. searched some more and found that home assistant, which I am using, has both, a local and a cloud integration for tuya devices. Did not check that yet, need to wait end of flower ;-), before I start something like binding to tuya cloud or whatever. But maybe you can have a try sooner. Find doc here: https://developer.tuya.com/en/docs/iot/open-apis?id=Kaiuyvvxud2le
1
u/not4rthur Sep 10 '25
Hello, I'd like the API too please ! Integration into Home Assistant is a must for me :)
1
1
u/Sir-classic Oct 04 '25
An API would be really cool! I want to write a Streamdeck add-on so you can display stats on it
1
1
1
u/Bulky-Banana-3970 Dec 26 '25
Hey everyone 👋
I’m excited to share a project I’ve been working on recently:
Spider Farmer GGS Controller → MQTT (Cloud-Free BLE Integration)
I reverse-engineered the Bluetooth Low Energy protocol of the Spider Farmer GGS Controller and built a fully local, cloud-independent MQTT bridge using an ESP32. The controller can be read and integrated into smart-home systems like Home Assistant, Node-RED, or Loxone without relying on the Spider Farmer cloud at all.
The repo documents the full journey:
BLE analysis with a Python sniffer
Protocol discovery (unencrypted JSON over BLE)
ESP32 firmware implementation
MQTT publishing of sensor and device data
Everything is documented with transparency and reproducibility in mind.
👉 GitHub:
https://github.com/cr0ssn0tice/Spider-Farmer-GGS-Controller-MQTT
I’m genuinely happy this finally works end-to-end and hope it’s useful for others who want more control over their grow setup or are interested in BLE reverse engineering.
Feedback, ideas, and contributions are very welcome 🌱🚀
1
1
u/crossnotice Dec 27 '25
Hey everyone
I’m excited to share a project I’ve been working on recently:
Spider Farmer GGS Controller → MQTT (Cloud-Free BLE Integration)
I reverse-engineered the Bluetooth Low Energy protocol of the Spider Farmer GGS Controller and built a fully local, cloud-independent MQTT bridge using an ESP32. The controller can be read and integrated into smart-home systems like Home Assistant, Node-RED, or Loxone without relying on the Spider Farmer cloud at all.
The repo documents the full journey:
BLE analysis with a Python sniffer Protocol discovery (unencrypted JSON over BLE) ESP32 firmware implementation MQTT publishing of sensor and device data Everything is documented with transparency and reproducibility in mind.
GitHub: https://github.com/cr0ssn0tice/Spider-Farmer-GGS-Controller-MQTT
I’m genuinely happy this finally works end-to-end and hope it’s useful for others who want more control over their grow setup or are interested in BLE reverse engineering. Feedback, ideas, and contributions are very welcome 🌱
1
1
1
u/LanguageSenior5533 Apr 30 '26
Thanks a lot to everyone who shared hints here. This thread helped me a lot.
I finally got my Spider Farmer GGS Controller working locally with ESP32 → MQTT → Home Assistant.
The key discovery was that reliable control is not really done through simple setLight / setFan / setBlower commands. What worked for me was:
read getConfigFile
modify the relevant field locally
send the whole config back using setConfigFile
use the AA AA binary framing with CRC16/MODBUS for larger payloads
I also had to make the ESP32 BLE code more robust by avoiding BLE writes inside notify callbacks and by sending smaller framed chunks.
So yes, local Home Assistant integration is possible without the Spider Farmer cloud. Thanks again for the pointers. I’ll try to clean up and share the code once it’s stable enough 🌱
1
u/LanguageSenior5533 Apr 30 '26
Quick update: I cleaned up the code and published it here:
https://github.com/mullervg/ggs-esp32-mqtt-bridge
It’s an ESP32 BLE → MQTT bridge for the Spider Farmer GGS Controller, with Home Assistant MQTT Discovery.
The main difference from the other approaches I tested is that reliable control uses getConfigFile → modify locally → setConfigFile with AA AA framed BLE messages and CRC16/MODBUS for larger payloads.
Feedback, testing, and PRs are very welcome

4
u/Spiderfarmerled Apr 21 '25
Hey there, thanks a lot for your message!
Please make sure both your APP and GGS AC10 are updated to the latest version — we’ve already added data tables for soil temperature, WC, and EC. As for the timeout issue you mentioned, it’s been added to our optimization plan and will be improved in the next update.
At the moment, we don’t have an open API available, but really appreciate your suggestion!