BeeKey 

Hardware

• PC (& Mac ?)

It should work on most 64 bits PC as far as it can boot Ubuntu 16.04 from an USB Key. Laptops and especially the recent ones may not be compatible due to exotic hardware. 

Compatibility for Mac is very hardware dependent too (it won't work on M1, M2 CPU) and may vary from one generation to another. Also it has not been tested as the freeware version of MAC Linux USB Loader is no longer compatible with recent versions of Mac OS . 

• USB Key

A USB3 key above 8GB is needed ( The Sandisk Extreme USB 3 range is an excellent option). A USB2 key will boot too but will be very slow. The key must be formatted clean to FAT32 and the boot flag activated ( MBR scheme on a Mac). 

• USB mouse and keyboard

        Any mouse or keyboard USB wired or wireless with an USB dongle. Trackpads, bluetooth mouse and keyboard are not supported.

• Monitor

The biggest screen made by Atari had a resolution of 1280x960. Don't expect usable results with today's 4K or Retina displays. It's usable up to 1920x1200 (which is by the way ST high X3) but depending on the size of your screen be prepared to change your glasses and move your mouse kilometers. So for a 25 years old system try to stay close to a 25 years old resolution for a better experience. A 19" 1280x1024 screen is perfect for Mint.

Installation

Default User is : root

Default Password is : beekey

Installation to boot on a standard PC with 4GB persistent storage

• • • Download UNetbootin from: unetbootin.github.io

    • Unzip

    • Start UNetbootin

    • Choose Diskimage and select Beekey  iso file

    • Select the USB key to install to.

    • Set persistent storage to 4300MB max

    • Install

    • Copy the supplied syslinux.cfg to the root of the key.

    • Set your BIOS settings to Legacy boot / MBR boot and not EFI boot.

    • Reboot and jump to 1stboot

Installation to boot on a Mac with 4GB persistent storage (Not tested)

Part 1

• Download MAC LINUX USB LOADER from :

  • • • www.sevenbits.io/mlul/ for the commercial version and for the freeware version sourceforge.net/projects/mlul/

• Unzip & install into the /Applications folder as normal

• Load it up and double click “Create Live USB”

• Locate the ISO file in the file selector (or drag and drop the ISO onto this window) and press RETURN

• Insert USB Key and then click the REFRESH button

• “Include with application” is already selected. Press the NEXT button.

• Select Ubuntu from the “Distribution Family” dropdown

• Click and activate “This ISO lacks an EFI-enabled kernel”

• Click and deactivate “This ISO has code older than Ubuntu 14.10”

• Click on the “Begin installation” button

• Wait a few minutes and close the window when completed

Part 2

• Now press SHIFT COMMAND 1 to display the main menu again

• Double click “Setup USB Device”

• Click once on your USB drive which will be listed on the left of the window

• Now click on the button called “Edit Enterprise Configuration File”, this loads up the config file in Text Editor application

• Add after 'kernel /casper/vmlinuz' the text “persistent”.

• Press COMMAND S to save and quit the Text Editor

• Quit

To boot up the new Atari computer :

• Reboot your Mac

• Once you hear the chime of your Mac rebooting, press AND hold the ALT key

• Wait a second or two and once a boot menu appears, release the ALT key

• Choose the EFI option by clicking on it

• When the boot menu appears, press 1 and then 1

• Your Atari computer will boot up

1st boot

• • The first time you boot the key, files will be copied to the persistent drive. It will take a very long time: more than 5 min for USB2 and at least 1 min for USB3. Check that the light of your USB key is still flashing during the boot progress to be sure that everything is going on well and wait for the boot process to complete even though the screen will remain static meanwhile. Subsequent boots will be much faster.

  • Configure the host system

    • Keyboard Layout

    • Time zone

    • Root password

    • Wifi

2nd Boot

• • • After 40 sec you'll reach The Green Desktop to complete Beekey setup :

• • • Follow the guided setup for keyboard, screen resolution and samba share mount.

    • Beekey will restart again.

BeePi

Hardware

• • RaspBerry Pi 3 / 4 / 400

BeePi works only  on RPi 3 / 4 / 400. 

• • micro SD card

Fast Class 10 micro SDHC I 16 GB or above.

• • USB mouse and keyboard

        Any mouse or keyboard USB wired or wireless with an USB dongle. Trackpads, bluetooth mouse and keyboard are not supported.

• • Monitor

Remember that the biggest screen made by Atari had a resolution of 1280x960. Don't expect good results with today's 4K or Retina displays. It's usable up to 1920x1200 but depending on the size of your screen be prepared to change your glasses and move your mouse for kilometers. So for a 25 years old system try to stay close to a 25 years old resolution for a better experience. A 19" 1280x1024 screen is perfect for Mint.

Installation

• • Installation is fairly simple but it can destroy all your data if not properly done. PLEASE TRIPLE CHECK THAT THE DESTINATION DISK (your SD card) IS CORRECT BEFORE WRITING THE IMAGE ON IT. ALL PREVIOUS DATA WILL BE ERASED !!!

  • Install the image with Raspberry Pi Imager

Default User is : pi
Default Password is : beepi

1st Boot

• • • Insert the microSD in your RPi, switch it on. 20 sec later you'll reach linux login.

    • Enter login and password.

    • Configure Raspi-config.

Option 6 - Advanced Options.
A1 - Expand Filsystem.

Option 5 - Localisation Options.
L2 - Change timezone.
L3 - Change keyboard layout.
L4 - Change WiFi country

Option 1 - System Options
S1 - Wireless LAN
S3 - Change user password

• 4. Choose finish and the system will reboot.

2nd Boot

• • • After 40 sec you'll reach The Green Desktop to complete BeePi setup :

• • • Follow the guided setup for keyboard, screen resolution and samba share mount.

    • BeePi will restart again.

EasyAraMint

Installation

• Download and install Aranym : https://github.com/aranym/

There is an optimized version for MacOS here : https://donzé.ch/atari/

• Unpack and copy EasyAraMiNT archive content to:

MacOS ~/Documents/Aranym_files/

Windows C:\users\”My account”\aranym\

Linux ~/.aranym/

• Copy into your main folder the config file and the keymap file if it exists:

MacOS from ./Config_Mac to ~/Documents/Aranym_files/

Windows from ./Config_Win to C:\users\”My account”\Aranym\

Linux from ./Config_Linux to ~/.aranym/

• Launch Aranym to test it and jump to step 6. Quit with shutdown menu.

• How to install EasyAraMint in an other folder ?

Edit 'config' file following lines to setup your directories:

Floppy - path of floppy disk image folder

EmuTOS - path of emutos-aranym.img

IDE0 - Path of aranym-ide-1.57G.img

HOSTFS - path of your host system file you want to access.

Type to launch it from the shell:

aranym-jit -c ~/installation_folder/config

Tip : To access a network drive, make a permanent link on your host system to a folder and declare it in Aranym as a host drive.

Network setup

MacOS

• Open Aranym Setup with cmd+,

• Select Networking and modify ETHO setup.

ETH0 = en0 for ethernet and en1 for Wifi

Mode : Bridge

Host IP = Address of your router connected to the Net

Atari IP = a free address on your network

• Save the config and close Aranym Setup menu.

• Reboot Aranym. At startup MacOS will ask your system password.

Windows

This is an excerpt of Mikro's post on Atari-Forum. https://www.atari-forum.com/viewtopic.php?f=8&t=26447

• Go to https://openvpn.net/community-downloads and download the windows installer. Run & install it with default options

• Click on the start/windows button and type "View network connections" + press enter to see your network adapters

Verify presence of a TAP interface described as "TAP-Windows Adapter V9" and rename it to "tap0"

• CTRL+Click on "tap0" and your active network connection. Using the right mouse button click on either of them and choose the only option "Bridge Connections"

• Verify presence of a bridge called "Network bridge"

• Using the right mouse button click on it and choose "Properties" - verify that its settings match your former active network connection (i.e. if you were using a static IP, you must set it again here)

• Verify that that you can still access internet

• Click on the start/windows button and type "cmd" + press enter to open the command line and type "ipconfig" + press enter. Look for a network bridge record. In my case I see:

Ethernet adapter Network Bridge:

Connection-specific DNS Suffix . :

Link-local IPv6 Address . : fe80::1543:4e57:7749:4e64%29

IPv4 Address. . . . . . . . . . . : 192.168.130.12

Subnet Mask . . . . . . . . . . . : 255.255.255.0

Default Gateway . . . . . . . . . : 192.168.130.1

• Start aranym and open setup menu. In Network settings, look for "[ETH0]" section, by default it looks like this:

ETH0 = tap0

Type = bridge

Host IP = 192.168.99.50

Atari IP = 192.168.99.51

• Change "AtariIP" into a free IP address on your network. For me this would be 192.168.130.254 for instance.

Change "HostIP" into your gateway IP address. For me this would be "192.168.130.1" from above.

Change "Type" to « ptp"

• Save it and restart aranym.

Windows troubleshooting

After activating "eth0" interface from FreeMiNT, ARAnyM console is flooded with "ETHERNETDriver::readPacket() - length -1 > 9000"

In "Network connections", click on "tap0" properties, « Configure..." button, "Advanced" tab and change "Media Status" to « Always connected". Needed for both Windows 7 and Windows 10.

Bridging doesn't work

The old tutorial mentions another old Microsoft article about needing to force the TAP NIC into compatibility mode. I didn't have to do it.

Linux

• Edit ~ /.aranym/Config_Linux/atarinet.sh file and modify YOUR_LOGIN.

• Type from the shell:

cd ~ /.aranym/Config_Linux

chmod +x setupnet.sh

sudo ./setupnet.sh

• By default host gateway address is 192.168.99.50 and Aranym address is 192.168.99.51 ; they should work in most of the cases.

If you want to change these addresses, edit /usr/bin/atarinet.sh, modify “ifconfig” and “iptables” addresses, and change in Aranym Setup / Networking these addresses :

Host IP = host gateway address

Atari IP = Aranym address

Save and restart Aranym.