@database HamConnect.guide
@master MAIN
@$VER: HamConnect.guide 0.6.6 (31.07.2026)

@node MAIN "HamConnect-Amiga"
                        HAMCONNECT-AMIGA 0.6.6

Everything an Amiga needs to get online and use HamNet and HamChat.

  @{"Quick Start" link QUICKSTART}
  @{"Network Setup" link NETWORK}
  @{"Wi-Fi Networks" link WIFI}
  @{"Network Status and Doctor" link DIAGNOSTICS}
  @{"Reinstall, Modify, Repair, Roll Back, Uninstall" link MAINTENANCE}
  @{"Automatic Updates" link UPDATES}
  @{"Supported Network Hardware" link HARDWARE}
  @{"HamNet, HamChat and HamNet+" link APPLICATIONS}
  @{"AmiSSL" link AMISSL}
  @{"Support Reports" link SUPPORT}
@endnode

@node QUICKSTART "Quick Start"
1. Open the HamConnect-Amiga drawer and double-click Install.
2. Choose Novice, Intermediate, or Expert.
3. Review the detected Amiga, memory, socket stack, and network hardware.
4. Choose Networking Package, HamNet, and HamChat.
5. Choose the destination. SYS:Internet/HamNet is recommended.
6. Enter Wi-Fi details only when a supported wireless device is selected.
7. Select Install, wait for the standard progress page, then select Finish.
8. Open Network Setup before starting HamNet or HamChat.

Minimum target: AmigaOS 3.0, 68020, 1 MB Chip RAM, and 4 MB Fast RAM.
The networking engine is the GPL AmiTCP 3.0b2 runtime with HamConnect
configuration, DHCP, clock, monitoring, repair, and update services.

@{"Main" link MAIN}
@endnode

@node NETWORK "Network Setup"
Open SYS:Internet/HamNet/Network Setup.

Use Automatic (DHCP) for normal routers. HamDHCP acquires an address, route,
DNS servers, lease time, and DHCP server. HamNetworkGuard renews the lease.

Use Manual when DHCP is unavailable. Enter:
  - IP address
  - subnet mask
  - gateway
  - primary and secondary DNS servers

Network Setup can preserve an existing socket stack when Networking Package
was unchecked. Network Doctor can test that existing setup without replacing
it.

@{"Main" link MAIN}
@endnode

@node WIFI "Wi-Fi Networks"
Open Wi-Fi Networks, or select the Wi-Fi name in Network Status.

Choose a saved profile or enter an SSID. Choose WPA2, WPA, or Open and set the
radio country. WPA passwords are converted to a derived key; the original
plain password is not written to disk.

WiFiPi and Prism2 use WirelessManager profiles. PicoWyfy is recognized as an
importable driver, but switching depends on the driver's control interface.
The tool never invents signal levels when a driver cannot report them.

@{"Main" link MAIN}
@endnode

@node DIAGNOSTICS "Network Status and Doctor"
Network Status is a small floating widget. Green means online. Select More for
address, route, DNS, traffic, connection controls, and setup.

Network Doctor tests, in order:
  1. SANA-II device
  2. wired link or Wi-Fi association
  3. local IP address
  4. default gateway
  5. DNS lookup
  6. clock
  7. HTTP Internet access
  8. optional AmiSSL HTTPS
  9. HamNet service origin
 10. HamChat service origin

Select Repair to run the repair matched to the first failure. Select Export to
write SYS:Internet/HamNet/Support/HamConnect-Support.txt. The report excludes
Wi-Fi passwords and account credentials.

@{"Main" link MAIN}
@endnode

@node MAINTENANCE "Maintenance"
Run the installed Install icon again.

Reinstall replaces all selected HamConnect components while keeping user data.
Modify adds or removes Networking Package, HamNet, and HamChat.
Repair reinstalls selected program files and rebuilds network configuration.
Update checks a signed Stable or Beta manifest and applies verified payloads.
Roll Back swaps the selected component with the last preserved version.
Uninstall removes HamConnect and restores the displaced network setup.

An interrupted installation is detected at the next launch and rolled back
before the installer continues.

@{"Main" link MAIN}
@endnode

@node UPDATES "Automatic Updates"
HamNetworkGuard checks once per day when the machine is online. It never
installs an update without the user.

HamUpdate verifies an EdDSA-signed manifest and the exact size and BLAKE2b-256
hash of every payload. Stable and Beta are separate channels. Downloaded files
are staged first; the normal transactional installer performs the change and
keeps the previous version for Roll Back.

The signing private key is not included in the Amiga distribution.

@{"Main" link MAIN}
@endnode

@node HARDWARE "Supported Network Hardware"
Bundled and automatically installable:
  - PiStorm/Emu68 WiFiPi
  - Prism2 PCMCIA Wi-Fi
  - cnet.device PCMCIA Ethernet
  - 3c589.device PCMCIA Ethernet
  - UAE virtual Ethernet

Recognized when already installed or supplied in the media Drivers drawer:
  - X-Surf and X-Surf-100
  - Ariadne and Ariadne II
  - A2065
  - Plipbox
  - ZZ9000
  - Hydra
  - ENC624J600
  - PiStorm SANA-II and PicoWyfy

Recognition is not physical proof. Each real card/driver combination must pass
the hardware test matrix before it is advertised as validated.

@{"Main" link MAIN}
@endnode

@node APPLICATIONS "HamNet, HamChat and HamNet+"
HamNet Browser and HamChat are installed directly inside SYS:Internet/HamNet.
Their preferences,
history, favorites, and shared Mean Hamster identity are preserved across
reinstall, update, and repair.

Create or confirm the free Mean Hamster identity on a modern computer at:
https://meanhamster.com/account

HamNet+ entitlement is separate from the free identity. HamNet detects the
NetworkReady signal from HamNetworkGuard before opening an online session.

@{"Main" link MAIN}
@endnode

@node AMISSL "AmiSSL"
HamConnect, HamNet, and HamChat do not require AmiSSL. It is not bundled or
installed by default. If AmiSSL is already present, Network Doctor can include
an HTTPS test after the clock is correct. Existing AmiSSL libraries,
certificates, private keys, and user certificates are left untouched.

@{"Main" link MAIN}
@endnode

@node SUPPORT "Support Reports"
Run Network Doctor and select Export. Send the resulting file:

SYS:Internet/HamNet/Support/HamConnect-Support.txt

The report includes version, hardware profile, driver, interface, address,
gateway, DNS and the diagnostic ladder. It does not include Wi-Fi passwords,
Mean Hamster passwords, tokens, cookies, or private keys.

@{"Main" link MAIN}
@endnode
