reset - Reset Hardware

Description

The reset command resets the Accordion hardware system, returning it to its initial state. This includes resetting channels, clearing configurations, unloading modules, and unloading alias/configuration files.

Syntax

reset

Options

This command has no options.

Examples

reset

Output Format

Resetting..
Reset done, took 234.56 ms

Output Colors

• Default: "Resetting.." message
• Blue: Completion message with timing

Behavior

1. Sends reset command to hardware
2. Waits for reset to complete
3. Refreshes channel list
4. Reports completion time

What Gets Reset

• All channels return to default states
• Modules are unloaded
• Alias/configuration files are unloaded
• Custom channel configurations are cleared
• Connection remains active

Use Cases

Recovery from Error State

# Hardware in error state
reset
# System recovered

Start Fresh

# Clear all custom configurations
init --host 192.168.1.100
module --module "MyModule"
set --channel "CONFIG" --value "custom"
# ... testing ...
reset  # Return to defaults

Before Test Sequence

# Ensure clean state
reset
wait --channel "READY" --value "1" --timeout 5000
# Begin testing

Timing

Typical reset times:

• Simple systems: 100-200 ms
• Complex systems: 200-500 ms
• Systems with many modules: 500-1000 ms

Notes

• Requires an active connection (use init first)
• Does NOT disconnect from hardware
• Unloads all loaded modules
• Unloads alias/configuration files
• Blocking operation (waits for completion)

Warnings

⚠️ Important: Reset returns the system to its initial state. It:

• Clears custom channel configurations
• Unloads all loaded modules
• Unloads alias/configuration files
• Keeps the active connection

After a reset you must reload any modules and alias/config files (e.g. re-run module) before continuing.

Error Handling

Common errors:

• Not connected: Run init command first
• Timeout: Hardware not responding (may need power cycle)

Best Practices

1. Use before tests: Ensure clean starting state
2. Document timing: Note if reset times are abnormal
3. Wait after reset: Allow system to stabilize
4. Verify state: Check critical channels after reset

Recovery Procedures

If reset fails:

# 1. Try disconnecting and reconnecting
exit
# Restart AccordionShell
init --host 192.168.1.100

# 2. If still failing, contact hardware support

See Also

• init - Initialize connection
• exit - Disconnect and exit
• module - Manage modules