Utilisation

• The desktop Teradesk is organised around the aggregated disk "System" (U:/) and the user space "Home" (H:/) where all the apps and documents are stored. There is also in "Home" the shared network folder and the printing spool folder that we will see later on. Teradesk uses right click menu thanks to the integration with Taskbar. A right click on the desktop or a click on Atari icon in Taskbar will open the "Start" menu. If a file is selected when you open the "Start" menu, it will be passed to the opened application. 

Ex : to zip a folder, select the folder, right click and choose "Zip it".

• Thing can replace Teradesk. Open "Setup" menu and choose "Switch Desktop". In BeePi, Thing has a more classical organisation with disk drive on the desktop. The "Start" menu can only be accessed via the Atari icon of Taskbar, and all the items of the menu are placed into folders on the left side of the desktop. Adding an app to these folders will automatically update the "Start" menu and vice versa. 

• The apps included cover all kind of utilisation from word processing, spreadsheet, data base, pixel grafic, vector grafic, personal account, internet, development tools and games.

• Setup video resolution

Under Mint, select the resolution with "Options/Video options" in Teradesk or "Extra/Change resolution" in Thing. 

In single task, select and save the resolution with VI2 Conf, reboot, then change to the corresponding bit depth in EmuTos and save the desktop.

In BeePi, If your monitor is not properly recognised (black screen, wrong boot resolution, black bars ..) you can force a resolution in Raspi-config or edit config.txt.

Mount the SD card on your PC, Mac or Linux and open the file config.txt at the root. For Linux lovers, you can "Quit to Host" and edit directly /boot/config.txt.

Try first to uncomment hdmi_ignore_edid.

If you have black bars, uncomment disable_overscan.

If the previous modifications still don't work, uncomment hdmi_group and hdmi_mode to force a resolution. Google "Raspberry config.txt" for parameters explanation. For example 1080p is respectively 1 and 16, and 720p is 1 and 4.

Finally if you still have resolution issues, you can force a fixed resolution : open Aranym setup (AltGr+F12) and open "Video" option. Select "Fixed size" and modify the "Custom field". Save and Close (don't reboot with Aranym menu). Now warm reboot with the menu "Shutdown".

• Setup the Network interface

BeePi and BeeKey are configured automatically to work in most situation. 

If the default addresses don't work, open Aranym setup menu (AltGr+F12) and click on "Networking". Modify the addresses. They must be outside of the DHCP range and contiguous. Save and Close. Now cold reboot with the menu "Shutdown".

• Configure a samba shared drive

To install or edit a Samba share use menu "Setup" and select "Install Samba Share". Edit the parameters and click on install. The system will reboot.

The network shared drive will be mounted into H:/Network.

• Install a printer

It's important to understand how BeePi manages printing. On the Atari side, all printing must be done with a PCL driver (HP laserjet, HP Deskjet). After printing, the host converts it to PDF and store it into H:/spool. If you install a local printer (USB) or a remote printer it will be sent to this printer, otherwise only the PDF will be output.

To configure the printer open in an external browser (Mac, PC, Linux, tablet or smartphone) the address "https://beepi.local:631" or "https://beekey.local:631"  or "https://xxx.xxx.xxx.xxx:631" (you can find Beepi / BeeKey ip address in H:/Documents/host_ip). In BeeKey, CUPS configuration can be done with Netsurf.

Select "Administration" and "Add printer". Your printer (USB or network) will appear in the list. Select it and click on continue. Rename the printer into "printer" and click on continue. Select the proper driver, click on add printer and setup the default parameters.

• Keyboard : 

For Mint, open menu "Setup" and start "Keyboard Layout ». Click "Load Keytable" and choose the folder « Keyboard ». Select a language, load it, and click on « Use layout », « Permanent »

For Tos, use set clock.app in menu « Setup / Clocky ». Load clocky.prg, edit the keyboard and save. Consult Clokcy.hyp for more details.

• Floppy :  All floppies are stored into H:/Applications/floppy. They can be loaded from Aranym or Hatari Setup menu, or for Hatari press AltGr + D. To launch directly a game or demo disk with Hatari, double click on the file. Press AltGr +Q to quit Hatari and return to EasyAraMint.

• TOS

TOS images are stored into H:/.system/tos/ (/h/.system/tos/ on the host) and can be copied from the desktop.

• Audio:  In some cases, if audio files are read too fast, you will need to adjust the frequency of audio in Aranym 'config' file: [AUDIO] Frequency = 49170. If you ear cracks or glitches, you can increase Samples to 2048.

• Midi : connect your USB interface or expander, If it is class compliant, midi should be recognized after reboot of Hatari. 

• Joysticks and gamepads are recognized and must be setup in Hatari Main Menu/ Joysticks.

• Aranym and Hatari Setup menu key for BeePi and BeeKey  is set to Alt Gr + F12. If you want to edit manually the config files (at your own risk), you will find it in H:/.system folder together with system startup scripts.

• EasyAraMint Setup menu shortcuts

Windows, Linux MacOS

Aranym setup: Pause Left cmd+,

Ungrab Mouse Left shift + Menu Left cmd+left shift + m

• Switch to Hatari : starts "Hatari" in "Tools" menu. The selected emulator will become the default boot system. To switch back to Aranym, use Aranym app on the desktop.

• Switch Aranym to slow standard mode

By default Aranym runs in fast JIT mode. In very rare cases, some apps may need the standard emulation which is 50% slower. Use menu "Setup" and start "Speed switch" to choose between fast and slow emulation.

• Hatari emulation  can be changed in Hatari Main Menu/ Load config and then Reset machine.

• Update Hatari (BeePi only)

To update Hatari, start a shell in EasyAraMint and type :

ssh pi@beepi

Once logged in type :

sudo update-hatari

You can select to update hatari or to restore previous version. Once Hatari built, end ssh connection with : 

exit

• Shutdown : It's better to stop with the shutdown application in order to be sure not to corrupt disks: you have 5 ways to do it: from Thing Tools menu, TaskBar Menu, Right click on Desktop, Ctrl+Alt+H from any application, or Ctrl+Alt+L to use the task manager. Be careful, most applications won't save their files before shutdown. Warm boot will reboot the emulator only, Cold boot will reboot the host, Halt System does what it means.

• Console : By default the console is not activated. To open it, go to Toswin2, Windows, Open console. To activate it permanently, in Options, Console settings, tick “...at output”.

• TaskBar : You can add or modify applications in TaskBar Menu with « Setup/ Menu Setup". Any app in the Start menu will be auto started at boot.

A right click on the desktop will open a popup menu with shortcuts to applications. If you right click on a selected file, it will be passed to the application and opened.

The menu is divided in 4 areas :

• • • Common tools on top

    • Applications

    • Shutdown

    • Control panel, shell and search at the bottom

• Change wallpaper : open an image with zview, fullscreen F10, and press ctrl + alt + :  to change Mint Wallpaper. You can use Smurf to scale it to the right resolution.

• Uncompress and Zip files: To uncompress an archive double click on it. It accepts zip, lzh, rar, zoo, gz, bz2 and tar. To make a zip, select a file/folder, right click -> Zip it!

• Mount USB Drive : Insert a USB key and open u:/M/USBx to explore it. There is no eject option : wait for the led to stop blinking before removing the key.

• Contextual Help documentation is called by pressing F11 (shift + F11 in the case of TeraDesk). Extra documentation is included in c:/guides and can be read by a double click on it.

• Surf the web with Netsurf

Netsurf uses WebOne proxy to access https pages. When entering an URL, replace https:// by http://, WebOne will do the conversion. Keep in mind that Netsurf is slow and not compatible with many modern web pages.

• UNDO is set to F12.

• REBOOT : AltGr + R (warm reboot)

• QUIT : AltGr + Q (cold reboot)