In 2017, Hurricane Maria, a category-5 storm, severely impacted Puerto Rico, demolishing homes and communication infrastructure. To address this issue, the ClusterDuck Protocol (CDP) was developed in 2018. It utilizes battery-powered Internet-of-Things devices to reestablish essential communication during emergencies, allowing civilians to request assistance, share their locations, and receive vital information from local governments and responders.
The ClusterDuck Protocol runs on a variety of IoT hardware, including many ESP32 Arduinos.
Here is a list of hardware we use, though there may be many others that work. We recommend the Heltec LoRa ESP32 and the TTGO T-Beam ESP32.
For a simple network you will want to make at least two Ducks. For bigger networks you will need more.
To start developing, you will need PlatformIO on your computer.
Download or git clone the CDP library from GitHub.
Follow the installation instructions here
Please Note: With the Release of the ClusterDuck Protocol Version 4 we have different instructions. If you are looking for older instructions please go here
Connect your board to platform IO
Follow the these updates instructions for loading up a Duck to get one running.
Use the pre-built examples or develop custom Ducks of your own.
Deploy!
: Navigate to C:\Program Files (x86)\LG Electronics\LGUP\model .
: Best performance on Windows 7, 10, or 11 with driver signature enforcement disabled. Installation and Directory Guide
: Usually signifies the DLL is missing from the common or 8994 folder. Ensure the folder name matches the chipset number exactly. lgup-8994-dll-ver-0-0-3-23
: Allows users to install official KDZ or TOT firmware files.
💡 : If LGUP still fails to recognize your phone, try installing the LG United Mobile Driver version 4.0 or higher to ensure the COM ports are correctly assigned. Ensure the folder name matches the chipset number exactly
: If the software asks for a different version, you may be trying to flash a device with a newer security patch that requires an updated library.
: Close and reopen LGUP for the software to register the new library. Troubleshooting Common Errors : If the software asks for a different
The LGUP 8994 DLL serves as the instruction set for the LGUP software to communicate with specific hardware architectures. Version 0.0.3.23 was specifically optimized for the 8994 chipset, which powered flagship devices like the LG G4 and LG V10.
Flashing firmware carries inherent risks. Always backup your data before using LGUP. Ensure your device has at least 50% battery to prevent a power failure during the write process, which can lead to a permanent "hard brick."
: Enables a clean install that wipes data to resolve deep software bugs.
A step-by-step guide on how to build your own ClusterDuck Protocol network on our GitHub repository
Go and check out this playlist with all the installation vidoes of the clusterduck Protocol
QuackPacks are plug-and-play add-ons that give Ducks new features, like sensors, hardware, or networking tools.
OWL Built the CDP to help improve global resilience through connectivity.
In March 2020, The Linux Foundation and OWL formed a partnership to open-source the ClusterDuck Protocol. Learn more about TLF.
The IBM Call for Code is a technology competition empowering developers worldwide. Stay tuned for latest competitions and updates.
View on Github
Join Our Community