🚀 CellularLab v2.2 – Smarter Stops, Faster Cleanups!

This release focuses on making the test experience smoother, especially when stopping mid-run. Say goodbye to delays after hitting “Stop”!

---

⚡ What’s New in v2.2

✅ 🧹 Faster iPerf Cleanup

• iPerf tests now terminate faster and more reliably when you tap “Stop”.
• Removed unnecessary delays and improved job cancellation flow.
• JNI and coroutines shut down gracefully without hanging.

✅ 🛑 Smarter Stop Test Logic

• Stop works even during delay periods (like between test iterations).
• Introduced interruptible delay to ensure user actions are respected in real time.
• Fixed edge case where Stop didn't respond if test wasn’t actively running (e.g., in wait mode or after an error).

---

🔧 Technical Improvements

• Refactored test loop to check for stop conditions more frequently.
• Replaced hard delay(...) calls with a custom safeDelay(...) function.
• Optimized coroutine management to reduce memory usage during long test runs.

---

📘 How to Use

1. Start any iPerf test
2. Tap “Stop” at any time — even during waiting intervals
3. Observe faster test abortion and return to control screen

---

📦 Compare v2.1 → v2.2 »

---

🙌 Thank you for supporting CellularLab! Your feedback shapes every release. If you enjoy the app, consider giving the repo a ⭐ or sharing it with others.

🚀 CellularLab v2.1 – Smarter Gemini AI Controls + Bug Fixes!

🎯 This release brings dynamic AI configuration and improved usability for Gemini-powered iPerf3 log analysis.

---

✨ New in v2.1

✅ 🔧 Dynamic Gemini Model & API Key Configuration

• No more hardcoded models or keys!
• You can now edit your Gemini API key and model name directly in the app.
• Supports models like gemini-pro, gemma-*, and future variants.

💡 The option to update appears automatically when:

• You trigger 'AI Analysis' without a saved API key
• Or the AI request fails due to an invalid/expired key/API error

---

🐞 Bug Fixes & Improvements

• Fixed: "Save" and "Cancel" buttons now show proper text color in dark mode.
• Improved: Alert dialog UI now supports dynamic title and consistent styling.
• Enhanced: Better error handling for failed AI requests with retry/update options.

---

🧪 AI Analysis Compatibility

• Supports UDP, TCP, bidirectional, and reverse mode logs.
• Optimized for logs up to ~20,000 characters (~7,000 tokens) to fit Gemini's limits.

---

🔐 Secure by Design

• Your API key is stored only on your device (not bundled in the app).

---

📘 Using Gemini AI

1. Open any log in History
2. Tap “AI Analysis”
3. Instantly receive a clean, structured Markdown report:
   • ✅ Test summary
   • 📉 Packet loss, jitter, retransmissions
   • 💡 Insights & recommendations
   • ⭐ Quality rating

---

📦 Compare v2.0 → v2.1 »

🙌 Thanks for using CellularLab! If you like the app, ⭐ the repo or share your feedback.

✨ What’s New in v2.0 – Introducing Gemini AI

#🎉 Meet Gemini AI, your intelligent assistant for network analysis!

✅ 🤖 Automatic AI-Powered Log Analysis

• Upload or run any iPerf3 test
• Tap “AI Analysis” from history
• 💡 Instantly get a beautifully formatted markdown summary:
  • Test overview (IPs, ports, direction, bandwidth)
  • Packet loss, jitter, and retransmission analysis
  • Intelligent performance insights
  • Actionable recommendations
  • A clear quality rating (Excellent, Good, Fair, Poor)

---

✅ 📄 View Results in Beautiful Markdown

• Auto-rendered with headlines, bullets, and bold text
• Powered by Markwon
• Clear, clean, and perfect for reporting

---

✅ 🔐 Safe AI Integration

• Your API key is stored securely (not bundled with the app)

---

🧪 Tested with UDP, TCP, bidirectional, and reverse mode logs — Gemini AI makes sense of all of them.

---

📦 Upgrade Notes
To use Gemini AI:

1. Open local.properties

2. Add your API key:

   GEMINI_API_KEY=your_key_here

📄 Full Changelog

📲 CellularLab v1.9 – Ultimate Command Mode

🚀 What’s New in v1.9

✅ 💻 Command Mode — Run iPerf3 with Your Own Parameters

Take full control of your network testing with our powerful new Command Mode:

• 🔧 Enter your own custom iperf3 command
• ⚡️ Run any combination of options (TCP/UDP, client, ports, threads, etc.)
• 📈 See live test results directly in the app

No more limitations — engineers and power users can now execute exactly what they need.

---

✅ 🧠 Smarter Interface

• New validation for command input
• Friendly error messages and smooth execution flow

Whether you're testing a local loop or a cross-continent link, this update turns your device into a professional-grade network probe.

---

📦 Upgrade Notes
You can still use the regular GUI mode — Command Mode is optional and built for advanced scenarios.

📄 Full Changelog

📲 CellularLab v1.8

🛠 What’s New in v1.8

✅ 🐞 Hybrid Test Bug Fix

We've resolved a key issue affecting Hybrid Test execution.
This fix ensures more reliable bandwidth estimation and stable argument updates during TCP/UDP combo runs.

Hybrid Test now works as intended:

🔄 Automatically estimates bandwidth using a TCP bidirectional test

🎯 Correctly applies the estimated bandwidth for subsequent UDP testing

🧪 Ensures consistent and accurate hybrid performance analysis

🔗 Full Changelog: Compare v1.7...v1.8

📲 CellularLab v1.7 – Smart Tabs, Test History & UX Enhancements

🚀 What’s New in v1.7

✅ 🧭 Brand-New Tab Layout for Seamless Navigation

We've redesigned the main UI with a sleek tab layout to improve usability and clarity:

• Run Test – Launch and monitor live iPerf3 tests
• History – View past results with pass/fail indicators

Enjoy a faster, more intuitive experience tailored for both field testing and lab use.

---

✅ 📊 All-New History Tab for Test Logs

Now every test result is automatically saved and accessible from the new History tab:

• ✅ View previous test runs
• 🔄 Pull-to-refresh to update results
• 📄 Tap to open logs in your favorite text editor
• 🔗 Share logs via apps (email, WhatsApp, Drive, etc.)
• 🗑️ Delete logs with a confirmation prompt

Perfect for engineers needing persistent logs and easy report sharing.

---

✅ 🧠 Enhanced UX & Performance

• Smooth tab transitions
• Polished icons and responsive layouts

---

📦 Upgrade Notes
No action required — your existing test data and preferences remain intact.

🛠 Developers: See the README’s updated UI preview and log handling notes.

📄 Full Changelog: v1.6...v1.7

📲 CellularLab v1.6 – iPerf 3.19

🚀 What’s New in v1.6

✅ Upgraded iPerf Core to v3.19

The app now ships with the latest iPerf3 engine (May 2025 release), offering better stability and protocol improvements from upstream.

✅ Internal Build Configuration Improvements

• Clean integration of iperf_config.h and version.h using CMake auto-generation.
• Easier upgrades: Simply update one version string, and you're ready to go.
• Uses PACKAGE_VERSION for consistent version propagation.

✅ 📚 Developer Documentation Added

New markdown doc: docs/updating-iperf.md
Clear, step-by-step guide for upgrading iPerf3 versions in this app.

Perfect for contributors and power users.

✅ Minor Cleanup & Maintenance

• FD macro experiment reverted to original iPerf usage
• Project structure cleaned
• Git ignores now respect generated config headers

---

📦 Upgrade Notes
No action needed. Your upgrade brings the latest iPerf3 features automatically.

🛠 Want to build from source? See the README’s "Getting Started" section.

📄 Full Changelog: v1.5...v1.6

📲 CellularLab v1.5 – Guided Onboarding & Developer Info Enhancements

🚀 What’s New in v1.5

✅ Interactive Intro Guide
A step-by-step TapTargetSequence now introduces key features and controls when launching the app for the first time. Helps new users get started faster and with more confidence.

✅ Developer Info & Sharing Panel
Tapping the version badge now opens a beautiful dialog showing your GitHub and LinkedIn profiles — complete with icons and links. Also includes a quick-share option so users can recommend the app on WhatsApp, LinkedIn, etc.

✅ UX & UI Polish

📦 Upgrade Notes:
If you're upgrading from v1.4, no extra steps needed. Just enjoy the improved onboarding and discoverability!

Full Changelog: v1.4...v1.5

CellularLab v1.4 – Native iPerf 3 Integration & Optimizations

🚀 What's New in v1.4

✅ Integrated iPerf 3 (with minimal native dependencies)
✅ Custom JNI bridge for streamlined Android-native testing
✅ Optimized build setup using CMake + Gradle with NDK r28
✅ Cleaned and organized required iPerf source files only
✅ Improved .gitignore and build scripts
✅ Enhanced build reproducibility and debug logging

📂 Source now includes only the required C/C headers from iPerf, reducing size and complexity.

📢 Note: Please clear your previous build cache if upgrading from earlier versions.