====== Features ======

----
**Cuckoo Smart Wireless Hydrometer/Temperature Sensor** is designed for home brewing, capable of measuring specific gravity and temperature during beer fermentation, and automatically calculating alcohol content and fermentation progress. After adding yeast, simply immerse the hydrometer in the wort to monitor the entire fermentation process, minimizing the risk of contamination from opening the lid and avoiding the need to waste precious beer for sampling.

===== Firmware =====
  * This product is based on the open-source program GravityMon, providing a feature-rich and user-friendly application. You can also enter configuration mode to upgrade to other programs or update existing iSpindel devices to the GravityMon system.

===== Hydrometer Modes =====

=== Working Mode ===
  - **Data Transmission Frequency**: Default is every **900 seconds**.  
  - **Indicator Status**: Green LED flashes once with each data update.  
  <code>Tip: This is the default operating mode.</code>  

=== Light Sleep Mode ===
  - **Status Check Frequency**: Default is every **3600 seconds**.  
  - **Trigger Condition**: When the device is upright (angle ≤15°), it remains in light sleep mode.  
  <code>Note: This mode saves power and is suitable for long-term storage or transport.</code>  

=== WiFi Configuration Mode ===
  - **Activation Method**: Place the device flat and use a magnet to trigger the reed switch **3 times** (each trigger within ≤3 seconds).  
  - **Indicator Status**: Green LED slowly flashes, indicating WiFi configuration mode is active.  
  <code>Tip: In this mode, you can connect to the device hotspot and configure WiFi settings.</code>  

=== Advanced Settings Mode ===
  - **Trigger Condition**: Automatically activates when the device is fully charged (voltage ≥4.18V).  
  - **Indicator Status**: Green LED slowly flashes, indicating advanced settings mode is active.  
  <code>Note: This mode is used for advanced parameter adjustments or firmware updates.</code>  

=== Auto Power-On ===
  - **Activation Method**: When the device is immersed in liquid, it will switch to working mode within 1 hour.  
  <code>Tip: This feature is suitable for fermentation monitoring or automatic activation in liquid environments.</code>  

=== Other Tips ===
  - **Manual Activation**: Use a magnet to trigger the reed switch **once** to immediately send data and enter working mode.  
  <code>Tip: This feature is suitable for temporarily checking device status or data updates.</code>  

===== Wireless Charging =====
  * Built-in **wireless charging module**, allowing charging without opening the lid, avoiding specific gravity measurement deviations.  
  * Requires a **20W Type-C wireless charger**, with an **initial charging time of 5-8 hours**.  

Key Features:
  - **Convenience**: No need to open the fermenter, eliminating contamination risks.  
  - **Efficiency**: Supports 20W Type-C fast charging.  
  - **Initial Charge**: First-time use requires a full charge of 5-8 hours to activate the battery.  

Usage Example:
  * Place the hydrometer on a compatible wireless charging pad after removing it from the fermenter.  
  * Ensure the charger provides around 20W for optimal charging efficiency.  

Recommendations:
  * Use only compatible 20W Type-C wireless chargers.  
  * Fully charge the device before first use to optimize battery life.  

===== WiFi Configuration =====
  * Integrated **dual WiFi management module**, allowing configuration of **primary WiFi** and **backup WiFi1**.  
  * The software does not wait indefinitely for a connection. If the connection times out after **20 seconds**, it automatically attempts to connect to **WiFi1**. If it fails again, it enters deep **sleep mode for 300 seconds** before retrying, maximizing power efficiency.  

Key Features:
  - **Dual Network Redundancy**: Automatic switching between primary and backup networks ensures connectivity.  
  - **Smart Timeout**: Avoids unnecessary waiting to save power.  
  - **Deep Sleep**: Reduces power consumption during connection failures.  

Usage Example:
  * Set home **2.4G WiFi** as the primary network and a mobile hotspot as backup WiFi1.  
  * Automatically switches to the backup network when the primary network is unavailable.  

Recommendations:
  * Ensure the network device is placed above the fermenter.  
  * Ensure the backup network has a stable signal.  
  * Avoid placing the device in WiFi dead zones.  

===== Dashboard =====
  * **Auto Refresh**: Updates every minute for real-time monitoring.  

Key Features:
  - **Real-Time Data Stream**: Continuously monitors key parameters like specific gravity and temperature.  
  - **Visual Interface**: Presents multi-dimensional data charts for easy interpretation.  
  - **Customizable Views**: Allows highlighting of key parameters.  

Usage Example:
  * Track specific gravity changes in real-time during primary fermentation.  
  * Detect fermentation anomalies through temperature fluctuations.  

Recommendations:
  * Keep the dashboard open during critical fermentation phases.  
  * Use the auto-refresh feature to get the latest data.  

===== Update Time =====
  * Displays the **time since the last update** and the **device's upload frequency**.  

Key Features:
  - **Timeliness Monitoring**: Tracks data freshness.  
  - **Frequency Indicator**: Shows device operating status.  
  - **Anomaly Alert**: Detects communication interruptions promptly.  

Usage Example:
  * Confirm whether the device is uploading data normally.  

Recommendations:
  * Regularly check the update timestamp.  

===== Operation Status =====
  * **Mode Switch Log**: Records transitions between **working**, **light sleep**, and **configuration** modes.  
  * **Internal IP for Configuration**: Displays the **LAN IP** required to access the configuration page.  

Key Features:
  - **Status Tracking**: Fully records device mode changes.  
  - **Direct IP Access**: Quickly access the local configuration page.  
  - **Log Availability**: Facilitates troubleshooting and status confirmation.  

Usage Example:
  * Check when the device entered sleep mode.  
  * Access the device configuration interface via the internal IP.  

Recommendations:
  * Regularly review operation logs.  
  * Record fixed IP addresses for frequently used devices.  

===== Specific Gravity Unit Switching (SG/Plato) =====
  * The software always uses **SG (Specific Gravity)** for internal calculations but can switch to **Plato** for display.  

Key Features:
  - **Dual Unit Compatibility**: Meets different user preferences.  
  - **Lossless Conversion**: Ensures calculation accuracy.  
  - **Smart Display**: Switches units as needed.  

Usage Example:
  * Switch to Plato when referencing recipes.  
  * Maintain SG mode for precise monitoring.  

Recommendations:
  * Choose the display unit based on recipe requirements.  
  * Use SG values for critical calculations.  

===== Temperature Calibration =====
  * Enter the **temperature offset** (not the target temperature).  
  * Example: If the current reading is 1°C higher, enter **-1**.  
  * Calibration Notes:
    * **Offset Calibration**: Directly input the correction value (e.g., +2/-1).  
    * **Delayed Application**: New calibration values take effect after the next data update.  
    * **Not Absolute Values**: Do not input target temperatures.  
    * If the sensor reads 22°C but should be 21°C, input **-1** to calibrate.  

===== WiFi Signal Strength (RSSI) =====
  * **Below -70**: Good signal.  
  * **-70 to -80**: Moderate signal.  
  * **Above -80**: Poor signal.  

Factors Affecting Signal:
  - **Metal Shielding**: Stainless steel tanks or walls can significantly weaken signals.  
  - **Yeast Foam**: Foam during early fermentation may envelop the device, affecting signals.  

Optimization Tips:
  * Place the router and fermenter in the same space.  
  * Avoid metal obstructions between the device and router.  

Note: Signal strength directly impacts data transmission stability.  

===== Third-Party Platform Push =====
  * Supports forwarding data to mainstream brewing platforms through simple configuration.  

=== Supported Platforms & Configuration ===
  - Ainiang (znp9)
    * Operation: Add platform API key.  
  - BrewSpy
    * Operation: Add platform API key.  
  - BrewFather
    * Operation: Create a new device name and add the platform Path/URL.  
  - GrainFater
    * Operation: Configure via custom options.  

=== Notes ===
  * Data synchronization frequency matches the device's upload cycle.  
  * API keys must be securely stored.  
  * Parameter formats must comply with platform requirements.  

===== Battery/Voltage =====
  * **Battery Range**: 3.3V-4.15V (corresponding to 0%-100%).  
  * **Power-Saving Mode**: Sends data once per hour when battery is below 25%.  
  * **Battery Life**: Can send **10,000 data points** when fully charged.  
  * **Battery Maintenance**: 18650 lithium batteries may become deeply discharged if left at 0% for extended periods, reducing lifespan.  

Key Tips:
  - Regularly check voltage levels.  
  - Automatically activates power-saving mode when battery is below 25%.  
  - Avoid over-discharging the battery.  

Recommendations:
  * Charge promptly when battery is below 25%.  
  * Replace the battery if it frequently becomes deeply discharged.  

===== Batch Start =====
  * When placing the hydrometer into the initial wort to start fermentation, create a new batch to fully record the process.  

=== Batch Pause ===
  * Pause the batch when fermentation is complete and you are ready to remove the device, ensuring complete data preservation.  

Key Notes:
  - **Full-Cycle Recording**: Tracks the entire fermentation process from start to finish.  
  - **Data Integrity**: Prevents data gaps when removing the device.  

Usage Example:
  * Start a new batch when placing the hydrometer into the wort for fermentation.  
  * Pause the batch before cleaning the device.  

Recommendations:
  * Always create a new batch for each fermentation.  
  * Pause the batch before removing the device.  

===== Batch Information =====
  * Click the 🖊️ icon next to the batch name to edit batch details.  

Key Features:
  - **Information Archiving**: Records key details like recipes and yeast.  
  - **Multi-Dimensional Labels**: Supports classification by style, alcohol content, etc.  
  - **Easy Editing**: Click to modify details.  

Recommended Records:
  * Batch Name: "IPA-2025 Spring Brew"  
  * Beer Style: "21C. Hazy IPA"  
  * Yeast Type: "Safale US-05"  
  * Brewing Notes: "Fermented at 20°C, OG:1.060, FG:1.012"  

Notes:
  * Update batch status promptly.  
  * Use clear naming conventions.  

===== Batch Sharing =====
  * Click the **Share Button** 🔗 to share fermentation curves and batch information, supporting both **completed batches** and **ongoing batches**.  

Core Features:
  - **Data Visualization Sharing**: Includes complete fermentation curves and parameters.  
  - **Real-Time Sharing**: Ongoing batches can also be shared.  
  - **Multi-Platform Support**: Compatible with mainstream social and collaboration platforms.  

Workflow:
  - Open the batch to be shared.  
  - Click the share button to generate a link.  

Typical Scenarios:
  * Share successful batch curves with the brewing community.  
  * Share real-time data during remote collaboration.  

===== Data Viewing =====
  * **Without Batch**: Can download the **latest 500 data points**.  
  * **With Batch**: Can download **complete batch data**.  

Error Handling:
  * When **abnormal data points** are detected in the curve, they can be marked as **invalid**.  
  * Supports **restoration** of mistakenly marked data.  

Core Value:
  - **Data Traceability**: Preserves complete fermentation history.  
  - **Error Correction**: Ensures data accuracy.  
  - **Flexible Export**: Supports xlsx format.  

Usage Example:
  * Export data for brewing reports.  
  * Mark abnormal values caused by device disturbances.  

===== Specific Gravity Change (48/24/12H) =====
  * Automatically calculates **48-hour specific gravity changes** after creating a batch, aiding in observing fermentation trends.  
  * Current fermentation degree - fermentation degree in the previous 48 hours=48 hour specific gravity change value

Core Value:
  - **Trend Prediction**: Determines fermentation activity through change rates.  
  - **Multi-Timeframe Comparison**: Analyzes data across 48/24/12-hour intervals.  
  - **Smart Alerts**: Detects stalled fermentation promptly.  

Usage Example:
  * Confirm primary fermentation completion through 48-hour changes.  
  * Detect abnormal fluctuations by comparing 12-hour changes.  

Recommendations:
  * Combine with temperature changes for comprehensive analysis.  
  * Increase monitoring frequency during significant changes.