upd

docs/airmail-install-bookworm.adoc

@@ -0,0 +1,170 @@
+= Install AirMail
+mgrouch <mgrouch@users.noreply.github.com>
+{docdate}, Install AirMail
+:imagesdir: images
+:doctype: book
+:description: Install AirMail on arm64
+:organization: Bareboat Necessities
+:keywords: openplotter, AirMail, PACTOR modem, arm64, rpi4, BBN OS
+:description: Install AirMail with wine on arm64 Bookworm Raspberry Pi BBN OS, PACTOR modem support, Openplotter
+:title-logo-image: image:bareboat-necessities-logo.svg[Bareboat Necessities Logo]
+ifdef::backend-pdf[]
+:source-highlighter: rouge
+:toc-placement!: manual
+:pdf-page-size: Letter
+:plantumlconfig: plantuml.cfg
+endif::[]
+ifndef::backend-pdf[]
+:toc-placement: left
+endif::[]
+:experimental:
+:reproducible:
+:toclevels: 4
+:sectnums:
+:sectnumlevels: 3
+:encoding: utf-8
+:lang: en
+:icons: font
+ifdef::env-github[]
+:tip-caption: :bulb:
+:note-caption: :information_source:
+:important-caption: :heavy_exclamation_mark:
+:caution-caption: :fire:
+:warning-caption: :warning:
+endif::[]
+:env-github:
+
+{zwsp} +
+
+== Install AirMail on Raspberry Pi Bookworm arm64
+
+AirMail is 32-bit Windows application. So we need to install box86 to emulate 32-bit Intel processor,
+and we would need to install wine86 to emulate Windows. box86 being 32-bit would need armhf (32-bit)
+runtime libraries.
+
+== Step 1. Box86
+
+[source, shell]
+----
+sudo apt-get -y install build-essential mono-runtime git cmake cabextract \
+  gcc-arm-linux-gnueabihf libc6-dev-armhf-cross zenity
+
+sudo dpkg --add-architecture armhf
+sudo apt-get -y install gcc-arm-linux-gnueabihf
+
+sudo apt update
+
+sudo apt-get -y install libegl-mesa0:armhf libgdm1:armhf libgl1-mesa-dri:armhf \
+  libglapi-mesa:armhf libgles2-mesa:armhf libglu1-mesa:armhf libglx-mesa0:armhf \
+  mesa-va-drivers:armhf mesa-vdpau-drivers:armhf mesa-vulkan-drivers:armhf \
+  libsdl1.2debian:armhf libsdl2-2.0-0:armhf libudev1:armhf libllvm11:armhf \
+  linux-libc-dev:armhf libncurses6:armhf libc6:armhf  libx11-6:armhf libgdk-pixbuf2.0-0:armhf \
+  libgtk2.0-0:armhf libstdc++6:armhf libsdl2-2.0-0:armhf mesa-va-drivers:armhf \
+  libsdl1.2-dev:armhf libsdl-mixer1.2:armhf libpng16-16:armhf libcal3d12v5:armhf \
+  libsdl2-net-2.0-0:armhf libopenal1:armhf libsdl2-image-2.0-0:armhf \
+  libvorbis-dev:armhf libcurl4:armhf libjpeg62:armhf  libudev1:armhf \
+  libgl1-mesa-dev:armhf  libx11-dev:armhf libsmpeg0:armhf libavcodec58:armhf \
+  libavformat58:armhf libswscale5:armhf libsdl2-image-2.0-0:armhf \
+  libsdl2-mixer-2.0-0:armhf gcc-arm-linux-gnueabihf
+
+sudo wget https://ryanfortner.github.io/box86-debs/box86.list \
+  -O /etc/apt/sources.list.d/box86.list
+wget -qO- https://ryanfortner.github.io/box86-debs/KEY.gpg | gpg --dearmor \
+  | sudo tee /usr/share/keyrings/box86-debs-archive-keyring.gpg
+sudo apt update && sudo apt-get -y install box86:armhf
+
+----
+
+
+== Step 2. Wine86
+
+[source, shell]
+----
+# Wine
+sudo apt-get -y install libasound2:armhf libc6:armhf libglib2.0-0:armhf \
+ libgphoto2-6:armhf libgphoto2-port12:armhf libgstreamer-plugins-base1.0-0:armhf \
+ libgstreamer1.0-0:armhf libldap-common:armhf libopenal1:armhf libpcap0.8:armhf \
+ libpulse0:armhf libsane1:armhf libudev1:armhf libunwind8:armhf libusb-1.0-0:armhf \
+ libvkd3d1:armhf libx11-6:armhf libxext6:armhf ocl-icd-libopencl1:armhf \
+ libasound2-plugins:armhf libncurses6:armhf libtinfo5:armhf libasound2:armhf \
+ libc6:armhf libglib2.0-0:armhf libgphoto2-6:armhf libgphoto2-port12:armhf \
+ libgstreamer-plugins-base1.0-0:armhf libgstreamer1.0-0:armhf libopenal1:armhf \
+ libpcap0.8:armhf libpulse0:armhf libsane1:armhf libudev1:armhf libunwind8:armhf \
+ libusb-1.0-0:armhf libvkd3d1:armhf libx11-6:armhf libxext6:armhf ocl-icd-libopencl1:armhf \
+ libasound2-plugins:armhf libncurses6:armhf libmpeg2-4:armhf libmpeg2encpp-2.1-0:armhf \
+ libtinfo6:armhf libmpg123-0:armhf libtinfo5:armhf libxslt1.1:armhf
+
+cd ~/Downloads
+
+wget https://dl.winehq.org/wine-builds/debian/dists/bookworm/main/binary-i386/wine-stable-i386_9.0.0.0~bookworm-1_i386.deb
+wget https://dl.winehq.org/wine-builds/debian/dists/bookworm/main/binary-i386/wine-stable_9.0.0.0~bookworm-1_i386.deb
+dpkg-deb -xv wine-stable-i386_9.0.0.0~bookworm-1_i386.deb wine-installer
+dpkg-deb -xv wine-stable_9.0.0.0~bookworm-1_i386.deb wine-installer
+
+rm -rf ~/wine
+mv ~/Downloads/wine-installer/opt/wine* ~/wine
+rm -rf wine-installer
+cd ~
+
+sudo ln -s ~/wine/bin/wine /usr/local/bin/wine
+sudo ln -s ~/wine/bin/wineboot /usr/local/bin/wineboot
+sudo ln -s ~/wine/bin/winecfg /usr/local/bin/winecfg
+sudo ln -s ~/wine/bin/wineserver /usr/local/bin/wineserver
+sudo chmod +x /usr/local/bin/wine /usr/local/bin/wineboot /usr/local/bin/winecfg /usr/local/bin/wineserver
+
+# Wine tricks are optional
+wget https://raw.githubusercontent.com/Winetricks/winetricks/master/src/winetricks
+sudo mv winetricks /usr/local/bin/
+sudo chmod +x /usr/local/bin/winetricks
+
+sudo apt-get -y install winbind
+
+----
+
+
+== Step 3. Wine86 config
+
+
+[source, shell]
+----
+# wait for it to complete. It takes a while and opens and closes some windows
+wineboot --init
+
+# Optional step. Where you can choose windows version, font sizes, etc in GUI window
+winecfg
+----
+
+You can increase your font size if it is too small under 'Graphics' menu.
+
+== Step 4. Download AirMail
+
+
+[source, shell]
+----
+cd ~
+wget http://siriuscyber.net/sailmail/amsm35054b.exe
+----
+
+
+== Step 5. Install AirMail
+
+[source, shell]
+----
+cd ~
+wine amsm35054b.exe
+----
+
+
+== Step 6. Run AirMail
+
+[source, shell]
+----
+
+# To run AirMail
+cd ~/.wine/drive_c/Program\ Files/Airmail
+wine Airmail3.exe
+
+----
+
+Go into Tools->Options->Spellcheck and uncheck all boxes.
+(This reportedly fixes some typing re-draw issues).