Skip to content

Releases: bmjobmjo/HerculusEQ

HerculusEQ

16 Jun 12:35
@bmjobmjo bmjobmjo
1.0.20260616
679bdfb

Choose a tag to compare

View all tags
HerculusEQ Latest
Latest

HerculusEQ v1.0.20260616

Welcome to the HerculusEQ utility! This tool is a modern, multi-protocol distant equivalent of the classic Hercules SETUP utility, designed to streamline debugging across Serial, TCP, UDP, MQTT, and WebSockets.
HerculusEQ is a comprehensive, multi-protocol desktop testing utility designed specifically for developers, hardware engineers, and IoT integrators. Built entirely in Python using Tkinter, it serves as a modern, cross-protocol distant equivalent of the classic Hercules SETUP utility, bringing all your essential networking and serial debugging tools into one unified interface.

✨ What's New in This Release

  • Big Edit Box: A dedicated pop-up for drafting and reviewing large, multi-line payloads before sending.
  • Persistent Command History: Every tool tab automatically remembers your last 500 commands across restarts.
  • Interactive Listbox: Quickly click on historical commands to automatically populate your send box.
  • About Tab: Included an About section with the current version details.

🌟 Why HerculusEQ?

Testing IoT devices, embedded systems, and network services often requires jumping between multiple different terminal applications. HerculusEQ solves this by placing robust implementations of Serial, TCP, UDP, MQTT, and WebSockets side-by-side in a single, tabbed application.

🛠️ How to Install and Run

This release includes a standalone, pre-compiled .exe file for Windows users. You do not need to install Python or any dependencies!

  1. Download the HerculusEQ_claude.exe file attached below under Assets.
  2. Save it anywhere on your Windows machine (e.g., your Desktop).
  3. Double-click the file to run the application immediately.

🚀 Core Protocol Features

(Note: Windows Defender or SmartScreen might display a warning since the executable is newly created and unsigned. You can safely click "More info" -> "Run anyway").

📡 Serial Port Terminal

  • Dynamic Port Discovery: Instantly scan and list all available local COM ports.
  • Deep Configuration: Fully customize your baud rates, data bits, parity, and stop bits.
  • Bi-Directional Monitoring: Real-time logging of both outgoing transmissions and incoming data.
  • Data Formatting: Seamlessly view and interpret data in standard ASCII or raw Hexadecimal formats.
  • Local Logging: Instantly save incoming serial data streams directly to local files for offline analysis.

🌐 TCP Client & Server

  • TCP Client: Open direct socket connections to remote TCP servers, push custom payloads, and monitor raw byte responses.
  • TCP Server: Host a local TCP server on your machine, listen for incoming connections from embedded devices, and interact with connected clients natively.

🚀 UDP Terminal

  • Connectionless Communication: Send and receive raw UDP datagrams over the network.
  • Port Binding: Bind to local ports to actively listen for incoming UDP broadcasts or targeted traffic.

📨 MQTT Client

  • IoT Ready: Connect to public or private MQTT brokers with full support for authentication and custom client IDs.
  • Multi-Topic Subscriptions: Subscribe to multiple topics simultaneously and watch the payload stream in real-time.
  • Payload Publishing: Publish custom payloads to specific topics to trigger rules, test IoT infrastructure, or debug message passing.

🔗 WebSocket Client

  • Real-Time Web Sockets: Connect directly to modern WebSocket (ws:// and wss://) endpoints.
  • Frame Exchange: Exchange real-time text frames effortlessly, perfect for debugging web backends and modern IoT gateways.

✨ Advanced User Interface Features

This release introduces several major quality-of-life improvements designed specifically for power users:

  • The Big Edit Box: A dedicated pop-up, multi-line text editor that allows you to draft, format, and review large or complex payloads (like JSON objects or multi-line AT commands) before sending them over the wire.
  • Persistent Command History: Every single protocol tab remembers your last 500 commands! Your history is automatically saved locally to your disk (*_commands.json) across application restarts so you never lose your testing sequences.
  • Interactive Listbox: Say goodbye to retyping. Quickly click on historical commands in the new interactive dropdowns to instantly populate your main send box.
  • Auto-Scroll & Fast Clear: Manage chaotic terminal views with single-click clear buttons and automatic scrolling toggles.
  • Unified Settings Storage: All your connection parameters and broker settings are automatically preserved across sessions (*_settings.json).

🛠️ How to Install and Run

This release provides a fully compiled, standalone executable specifically built for Windows. The application includes all dependencies bundled natively.

Instructions:

  1. Scroll down to the Assets section at the bottom of these release notes.
  2. Download the HerculusEQ_claude.exe file.
  3. Save the executable anywhere on your Windows machine (e.g., your Desktop or a dedicated Tools folder).
  4. Double-click the file to launch the application immediately!
    (Note: Because this is a newly built, unsigned executable, Windows SmartScreen or Windows Defender might display a prompt warning you about an unrecognized app. You can safely bypass this by clicking "More info" followed by "Run anyway").

Enjoy simplified, cross-protocol debugging with HerculusEQ!

Assets 3
Loading