Fetching Data from CDP

This plugin interfaces with the Cloud Droplet Probe (CDP) and collects data which is uploaded to beehive in a compressed base64 printable format.

Fetching and Decoding the CDP Data from Beehive

This tool helps download and decode CDP data into a human-readable CSV format.

Overview

The script beehive-data-decoder.py fetches and decodes CDP data for a specified date range. It produces a CSV file with decoded values for analysis or archival.

Usage

Run the script using Python 3:

python3 beehive-data-decoder.py

Before running, set the desired node id and date range in the script:

node_id = "W097"
start_date = "2025-03-18T00:00:00Z"
end_date = "2025-03-21T23:59:59Z"

The Script

Each run generates a new CSV file named:

decoded-data_<Node ID>_<start>_<end>.csv

For example:

decoded-data_W097_2025-02-18T000000_2025-02-21T235959.csv

Here is an example run:

$ python3 beehive-data-decoder.py 
ℹ Fetching data from 2025-02-18T00:00:00Z to 2025-02-18T23:59:59Z from beehive for node W097
✔ Data download completed. Now decoding and generating CSV file
ℹ The data is being written to decoded-data_W097_2025-02-18T000000_2025-02-18T235959.csv
✔ Data writeout completed

Output Format

The CSV file includes a header and 47 columns:

time-stamp, value_1, value_2, ..., value_46

• value_1 — U16 representing Laser Current / Housekeeping 1
• value_2 through value_15 — Housekeeping and ADC Overflow values
• value_16 through value_45 — U32 bin counts (BIN 1 to BIN 30)
• value_46 — U16 checksum (CRC)

These columns follow the structure defined in Table 6: CDP Response to Send Data Command – Data Packet in the CDP documentation.