Minor modifications on the texts of the welcome message and the explanations of the protocol.
Welcome to the TCP/IP Virtual Joystick for Android application!
The TCP/IP Virtual Joystick for Android application converts your device into a virtual joystick able to send its action events via TCP/IP protocol, port 8081, to a given IP of your local network.
This application is ideal for developers that want a simple TCP/IP client side virtual joystick to control its server side application.
The application will ask you for an IP address of your local network where there must be an application (not provided by us!) already listening to the 8081 port to negotiate a TCP connection with this virtual joystick.
The first time that the TCP/IP Virtual Joystick for Android application is started, a base IP is asked. This base IP is
a) the device (computer, etc.) where your server side application is waiting for a virtual joystick at TCP port 8081 connection, or
b) if you do not know exactly which IP address has the server application, an IP from where the virtual joystick will start looking for a server side application. E.g. If the virtual joystick can not make a TCP connection to the base IP 192,168.1.1 port 8081, then it will look in the next IP 192,168.1.2, then the next one... until it is able to connect to a TCP server at port 8081.
This is useful when you do not know the server side app. IP (e.g. a local DHCP network using dynamic IPs). As this application is intended for simple local networks (usually WiFi at home, etc.) even if the IP of the server side application is dynamic, usually it does not change very often.
The TCP/IP Virtual Joystick for Android application sends the following verbose messages through the TCP port 8081 connection:
LEFT, RIGHT, UP, DOWN, UPLEFT, LEFTDOWN, DOWNRIGHT, RIGHTUP, plus the same words and BUTTON1 or BUTTON2, e.g. UPLEFTBUTTON1, DOWNRIGHTBUTTON2...
We are using this application for retrocomputing: this application for instance has been tested with the Fuse ZX Spectrum emulator (the ZX Spectrum was/is a popular personal computer of the 80's in Europe) configured with the Spectranet peripheral.
Check detailed information about the protocol and testing examples in the information button included inside the application.
