******************************************************************************
This file contains the instructions how to install the executable under
Android. Note that there is no GUI included because the engine is intended to
be used with chess GUIs like "Droidfish".

The CT800 engine supports the UCI protocol only.
******************************************************************************

System requirements:
- 300 kB of internal storage, depending on the CPU architecture.
- During runtime, at least 2 MB of free RAM.
- Android version: 32 bit: 4.1 or higher (API level 16, Jelly Bean).
                   64 bit: 5.0 or higher (API level 21, Lollipop).
- CPU: for 32 bit ARM binary: ARMv7-A or higher.
       for 64 bit ARM binary: ARM64-v8A or higher.

There are two different binaries that you can choose from. They are not
bundled together into a single binary as not to waste space on your phone,
plus that you may want to test which version gives best results.

Note: if you are not sure which version to use:

      1) In 95% of the cases, the 64 bit version will be the best choice.
         Usually, Android devices have an ARM-64 CPU.

      2) If the device is very old, it may instead need the 32 bit version.

******************************************************************************

An example using the "Droidfish" GUI from the F-Droid store:

- Install the "Droidfish" GUI, see
  https://f-droid.org/packages/org.petero.droidfish/
- Copy the CT800 engine executable to the internal shared storage under:
  Droidfish/uci
- In "Droidfish", swipe from the left screen border.
- Tap "Manage Chess Engines", then "Select Engine".
- Select the CT800 engine executable.

******************************************************************************

For other GUIs:

- Follow the instructions of your chess GUI how to register the engine with
  your chess GUI.
- Choose the CT800 engine version that matches your device (32 bit / 64 bit).
- The CT800 engine supports the UCI protocol only. You should select "use
  engine book" because the opening book is tuned to the engine's style.

******************************************************************************

Note: The opening book is contained in the executable, as well as the endgame
      bitbase for KPK, so there are no additional paths to configure. All of
      the engine options are available through the "engine options" section
      of the GUI.

Note: The engine uses 8 MB as default size for the hash tables. For better
      performance, 256 MB are recommended, which you can control through your
      GUI. (The system requirements state 2 MB minimum RAM because the engine
      will automatically fall back to 1 MB hash tables if it cannot get 8 MB.)

Note: The CT800 engine does not need special rights since it does not access
      your personal data, camera, microphone, GPS, network, or whatever.

******************************************************************************
