⚙️ Morserino-32 Configuration Help

Complete guide to configuring and controlling your Morserino-32 device

Introduction

The Morserino-32 Configuration Tool provides a comprehensive web interface for configuring and controlling your Morserino-32 device. This guide will help you understand all the features and how to use them effectively.

The tool uses the M32 Protocol to communicate with your Morserino-32 device, allowing you to adjust settings, manage files, control speed and volume, navigate menus, and much more - all from your web browser.

Getting Started

Connecting Your Device

To use the Morserino-32 Configuration Tool, you need to:

  1. Connect your Morserino-32 to your computer using a USB cable
  2. Click the "Connect to Morserino" button in the Connection section
  3. Select the appropriate serial port when prompted by your browser
  4. After connecting, click "Enable M32 Protocol" to activate the configuration features

Note: The Web Serial API is only supported in Chrome, Edge, and other Chromium-based browsers. Firefox and Safari do not currently support this feature.

Interface Overview

The configuration tool is organized into several sections:

  • Connection: Connect to your device and enable the M32 Protocol
  • Quick Controls: Adjust speed and volume, stop active modes
  • Menu Navigation: Browse and activate Morserino-32 menu items
  • Configuration Parameters: View and modify all device parameters
  • Snapshots: Save and recall configuration snapshots
  • File Player: Edit text files for the file player
  • WiFi Configuration: Set up WiFi connections

Connection

Connecting to Morserino-32

The Connection section allows you to establish communication with your Morserino-32 device and enable the M32 Protocol.

After connecting, you'll see device information including:

  • Hardware version (1st or 2nd edition)
  • Firmware version
  • Protocol version

Important: You must enable the M32 Protocol after connecting to access all configuration features. This is done with the "Enable M32 Protocol" button.

Protocol Commands

The tool uses the following commands to establish communication:

PUT device/protocol/on - Enables the M32 Protocol
PUT device/protocol/off - Disables the M32 Protocol

When the protocol is enabled, the Morserino-32 will not go into sleep mode until the protocol is disabled or the connection is closed.

Quick Controls

Speed Control

Adjust the keyer speed (in words per minute) using the slider. Changes take effect immediately.

The speed control uses the command:

PUT control/speed/<value> - Sets the keyer speed to the specified value

Volume Control

Adjust the speaker volume using the slider. The volume range is 0 (silent) to 19 (maximum).

The volume control uses the command:

PUT control/volume/<value> - Sets the volume to the specified value

Stop Active Mode

The "Stop Active Mode" button returns the Morserino-32 to the main menu from any active mode.

This button uses the command:

PUT menu/stop - Stops the active mode and returns to the main menu

Menu Navigation

Browsing Menus

The Menu Navigation section displays the current menu and all available menu items. Click on any menu item to select it.

The tool retrieves menu information using:

GET menu - Gets the current menu
GET menus - Gets all available menu items

Starting Menu Items

After selecting a menu item, you can start it using one of two buttons:

  • Start Selected Menu: Starts the selected menu item normally
  • Start Now (CW Gen): Starts CW Generator modes immediately without waiting for paddle input

These buttons use the commands:

PUT menu/start/<menu number> - Starts the specified menu item
PUT menu/start now/<menu number> - Starts the specified menu item immediately

Configuration Parameters

Viewing Parameters

The Configuration Parameters section displays all available parameters with their current values. Click the "Edit" button next to a parameter to modify it.

The tool retrieves parameter information using:

GET configs - Gets all parameters with their current values
GET config/<parameter name> - Gets detailed information about a specific parameter

Editing Parameters

When editing a parameter, you'll see its description and current value. Depending on the parameter type, you'll get either:

  • A dropdown menu for parameters with predefined values (e.g., Keyer Mode)
  • A numeric input for parameters with numeric values (e.g., Tone Pitch)

After making changes, click "Save" to apply them. The tool uses the command:

PUT config/<parameter name>/<value> - Sets the parameter to the specified value

Common Parameters

Here are some of the most commonly used parameters:

Parameter Description Values
Keyer Mode Sets the keyer operation mode Iambic A, Iambic B, Ultimatic, Non-Squeeze, Straight Key
Tone Pitch Sets the audio tone frequency Numeric value (Hz)
External Pol. Sets the polarity for external key/paddle Normal, Reversed
Paddle Swap Swaps the dot and dash paddles Normal, Swapped
Encoder Click Enables/disables encoder click sound On, Off

Snapshots

Managing Snapshots

Snapshots allow you to save and recall different configurations. The Morserino-32 supports up to 8 snapshots.

The Snapshots section shows all currently stored snapshots and provides buttons to:

  • Store Current Settings: Saves the current configuration to the selected snapshot number
  • Recall Settings: Loads the configuration from the selected snapshot
  • Clear Snapshot: Deletes the selected snapshot

Snapshot Commands

The tool uses the following commands for snapshot management:

GET snapshots - Gets a list of all stored snapshots
PUT snapshot/store/<n> - Stores current settings in snapshot n (1-8)
PUT snapshot/recall/<n> - Recalls settings from snapshot n
PUT snapshot/clear/<n> - Clears (deletes) snapshot n

File Player

Managing Text Files

The File Player section allows you to edit text files for the Morserino-32 file player. You can create new files or modify existing ones.

The section shows:

  • The current file size and available storage space
  • A text editor for viewing and editing the file content
  • Buttons to load and save the file

Special File Syntax

When creating text files for the file player, you can use special syntax:

  • <p> - Inserts a pause
  • <c> or /c at the beginning of a line - Marks the line as a comment (not played)

Example:

<c> This is a comment line
This is the first line of text
This is the second line with a pause at the end <p>
This is the third line

File Commands

The tool uses the following commands for file management:

GET file/size - Gets the file size and available storage
GET file/text - Gets the complete file content
PUT file/new/<line of text> - Creates a new file with the specified line
PUT file/append/<line of text> - Appends a line to the existing file

WiFi Configuration

Managing WiFi Settings

The WiFi Configuration section allows you to configure up to 3 WiFi profiles with SSID, password, and TRX peer settings.

For each WiFi profile, you can set:

  • SSID: The WiFi network name
  • Password: The WiFi password
  • TRX Peer: The TRX peer address (e.g., cq.morserino.info)

You can also select which WiFi profile to use for connecting.

WiFi Commands

The tool uses the following commands for WiFi configuration:

GET wifi - Gets all WiFi settings
PUT wifi/ssid/<n>/<ssid> - Sets the SSID for WiFi profile n (1-3)
PUT wifi/password/<n>/<password> - Sets the password for WiFi profile n
PUT wifi/trxpeer/<n>/<trxpeer> - Sets the TRX peer for WiFi profile n
PUT wifi/select/<n> - Selects WiFi profile n for connection

Troubleshooting

Connection Issues

If you're having trouble connecting to your Morserino-32:

  • Make sure you're using a Chrome-based browser (Chrome, Edge, etc.)
  • Check that your USB cable is properly connected
  • Try a different USB port or cable
  • Restart your Morserino-32 device
  • Refresh the page and try connecting again

Protocol Issues

If you're connected but having trouble with the M32 Protocol:

  • Make sure you've clicked "Enable M32 Protocol" after connecting
  • Try disconnecting and reconnecting
  • Check that your Morserino-32 firmware is up to date
  • If all else fails, try resetting your Morserino-32 device

Parameter Changes Not Taking Effect

If parameter changes don't seem to be taking effect:

  • Make sure you've clicked "Save" after making changes
  • Try refreshing the parameters list
  • Check that you're using the correct value range for the parameter
  • Some parameters may require a restart of the active mode to take effect