OSA for Arena
aus Schachcomputer.info Wiki, der freien Schachcomputer-Wissensdatenbank
OSA for Arena - © 2009 A. Pietig
In 1986 SciSys announced the chess computer Leonardo. After changing the company name to Saitek, the computer was relaunched as Galileo in 1988. In 1989 the last model of this series appeared as Renaissance.
| Leonardo | Galileo | Renaissance |
|---|---|---|
 |  |  |
All this chess computers have a tournament size wooden chess board, a built-in program, the capability to add modules with different chess programs and a serial communication interface to computers, called OSA Link.
From 1988 to 1993 the following program modules were launched, some with different software versions: Maestro, Analyst, Bute Force and Sparc. Special opening and endgame ROMs were available also.
The serial computer interface was able to handle a printer and a home computer or PC with a standard terminal program. The DOS software INCHECK was sold a short time, but then Saitek stopped the development in this direction.
The serial interface was placed under the board as 5-pin-connector:
Several versions of communication cables were available for different computers, like the IBM PC:
Special information can be found in the manual 'Connection Cable for Leonardo Chess Computer', published from Saitek in 1987. It is available as download at www.zanchetta.net/echecs, look under Documentations and Saitek. The pictures above are taken from this specification.
The PC cable has an inbuilt electronic to convert the signals from the Saitek TTL-interface (5V) to the PCs RS232 (9V).
To use all of this boards and the available modules under the well known software 'Arena' (www.playwitharena.com), I developed the free software
OSA2UCI and OSA-Board.
OSA2UCI
This is a software UCI-engine for Arena, that establish a connection to the chess board and uses the chess program of the board or the module as engine in Arena. The board itself and the chess pieces are out of function and you will play on the PC monitor. You can launch tournaments of the board chess software against other Arena chess engines and protocol and save all moves It is also possible to setup any chess position with Arena and start the calculation from this point.
OSA-Board
If you use this software as engine in Arena, you can use the chess board and the chess pieces to input your moves into Arena. The chess software of the board or module is out of function and you can play with the board against other Arena chess engines. You do not need keyboard, mouse and monitor any longer and can play chess match against a modern chess engine on a sophisticated wooden chess board.
OSA-Book
A stand-alone software to load your own opening book lines into a board.
OSA-Save
A stand-alone software to save the actual game in the board to a PGN file.
OSA-Load
A stand-alone software to reload saved PGN files with OSA format into the board.
Installation
To use the OSA software for Arena extract all files from the archive file OSA4Arena.ZIP to a directory of your choice under Arena\Engines:
In this example all software is placed in Arena\Engines\OSA.
That's all...
OSA2UCI as engine
To use OSA2UCI as chess engine under Arena it must be configured as engine in the Engine Management.
A good idea is to name the chess board, module and game level as Arena name. So it can be used for all savings and reports. You can make entries for OSA2UCI several times with different values, e.g. several game levels that you use often.
Add the relevant COM interface of the OSA cable connection into 'Command Line Parameters'. If omitted, COM1: is used as default.
OSA2UCI supports the following optional command line parameters:
COM-Port baud-rate (divided by spaces). Syntax: COMx: number Baud-rate is always 2nd parameter, but can be omitted (then 1200 is used).
e.g. (valid for OSA-Board too) OSA2UCI COM2: 9600 OSA2UCI COM3:
Command Line Parameters can be omitted, if an osa.ini file is used.
To use a specific game level (e.g. 5 sec/move) you can enter it in the section 'Special':
A level is set as 'Init string' with the OSA command 'setlevel' and the corresponding value.
The sections 'Books' and 'Information' should be left empty:
OSA2UCI with playing module
Adding an entry for a playing module in the board is simple. First make a new engine entry with remarkable information:
Then add a game level as 'Init string' with a level from the module:
General Arena settings
To use the values from the examples mark 'Engine names replace player names' and disable 'Use internal name' (this will show the name and the version of the OSA software) in the section 'Options' of the Engine Management.
For the first steps it is useful to mark 'Start engines with debug-window', then you can see the communication between the board and Arena. If everything works fine, it can be disabled later.
In the 'UCI' section please mark 'Common 'own book' setting' and ' Engines use their own book'. Other values are not relevant for the OSA board. To give full control to the chess engine of the board disable 'Resign Settings'.
OSA-Board as engine
To use OSA-Board under Arena it must be configured as engine in the Engine Management.
You can add 'Command line parameters' as in OSA2UCI, if needed. There is a special command 'flip' as 'Init string', if you want to reverse the board while playing with Black. If left empty, the white pieces are always in front of you.
Using OSA engines
After configuring the new engines you can simply use them as new Arena engines. To start an engine tournament between a board engine and an Arena engine load both engines and start them. If the debug window is available, you can see the established connection. Be sure that the board is switched on before starting the engine.
After starting the game (press Demo) you see the pieces moving...
To play with the board against an Arena engine, simply use OSA-Board as opponent and start the game. Now you can make your moves on the board.
That's all...
OSA-Board specifics
After starting OSA-Board as White, Arena waits for your first move on the board. Move a piece and the movement is done on the monitor automatically.
If you are playing with Black, the Arena engine makes a move and you have to move the corresponding piece on the chess board, the LED of the piece lits orange. After lifting up the LED of the new field lits and you can push the piece down. It's like playing against the board without Arena. All further moves are done in the same matter.
Normally the white pieces are in front of you and the black pieces in opposition, even if you play Black. If you use the 'flip' command for OSA-Board, then the black pieces are in front of you, if you play black. Be sure to place all pieces correct before starting the engine.
Some moves have a special behaviour:
Castling: First the LED of a rock or king lits on. After lifting up the piece, the corresponding piece of the castling (king or rock) lits and you should remove this piece also. Now you can set down both pieces on the correct fields.
Capture moves: The LED of the piece that will do a capture lits on. After lifting off, the destination will NOT lit. Now you know that this is a capture move and you have to guess what pieces will be captured (it's logical in most cases). After lifting off the correct piece, the destination (same field) will lit and you can put the first piece down.
All GOOD moves lit in the colour orange, if you make a mistake, the wrong field lits in red colour and you can correct the move.
Special commands OSA2UCI accepts some special (not UCI) commands in the debug window or as parameter in an 'Init string': board – shows the positions of all pieces in OSA notation. setlevel – shows the current game level (without parameter) or set a new value (with parameter)
OSA-Board accepts the following commands: board – shows the positions of all pieces in OSA notation. flip – reverses the board (black and white) if you play with black
Both programs (engines) can be start in a console window and you can type in any of this or UCI commands. You can start the programs with the parameter /? or /h also and will get a simple help.
osa.ini
The latest versions of the OSA software support an osa.ini file. It shall reside in the same folder than the OSA-EXE-files. All command line parameters can be set in the INI-file, the following groups and parameters are defined (parameters shown are examples):
[COM] This group holds the communication parameters com=COM1: Sets the actual COM port baud=1200 Sets the actual baud rate
[BOARD] Here are parameters related to the board and/or modules name=Leonardo Sets the name of the board (shown in Arena) modul=Analyst Sets the name of a module (shown in Arena)
[GAME] Parameters related to a game ; comment Any lines with a “;” at the beginning are ignored level=e1 Sets the starting level of the board/module flip=1 Flips sides (black from line 1, white from line 8)
It is still possible to use command line parameters as before, they have higher priority than parameters in osa.ini. The OSA software first sets default parameters, if no command line parameters are given and no osa.ini is found. Then an osa.ini is evaluated, at last the command line parameters will be used if present.
OSA-Book
OSA-Book is not designed for Arena, but is a useful stand-alone tool for the command line. With OSA-Book you can download your own opening books into the board and they will be used now with the other programs or during games against the board without OSA connection.
OSA-Book is started like the other programs, but the first parameter is a file name. Other parameters are optional, e.g. OSA-Book mybook.txt COM2: 9600
If no parameters are given, OSA book starts with a file dialog. There you can choose your book file. This works best with an osa.ini file, especially the connection parameters (COM port, baud rate) are taken from it.
Runtime can be several minutes, each move of a line is send separate and the board needs a a time gap of about 750 ms between the moves. Loading of a full book (383 lines) needs about 45 minutes on a Leonardo with Analyst module. Attention: All existing openings or positions in the boards will be deleted and overwritten. It is possible to store up to 383 opening lines with a maximum of 4000 moves.
The file announced in the command call or within the file dialog contains the opening lines. It is a simple ASCII file (e.g. can be edited with Notepad under Windows).
Every line contains an opening line in the format: e2e4 e7e5 g1f3 b8c6 etc. (always 4 characters per move). Castling shall be written as e1g1 or e8c8, O-O is not accepted. Promotion is not defined (Queen is chosen automatically), but this should be no problem for openings. Blanks between the moves are optional, also empty lines and lines with comments. All lines that do not start with the letters 'a-h' are treated as comments and will be skipped. Look into the example books for more information.
The last line of a file may contain the word 'delete', then all following memory banks in the board will be deleted. This is useful, if your board has a battery and you won't use older entries in the remaining memory banks. On the screen you see the move lines in progression and a status (OK or Error). After loading all openings the program announces “DONE”.
OSA-Save
OSA-Save is designed to store the actual game in the board into a PGN-file. After playing a game against the board/module or setting up move lines in Analyst mode you can call OSA-Save and store the whole game into a file. Later the game can be restored with OSA-Load or you can load the PGN-file into Arena.
The PGN format is specific for the OSA interface and in some cases not fully compatible with the PGN specification, however Arena accepts the file without problems. But other PGN programs may reject the file.
After starting OSA-save you see the following screen with the actual game lines:
On the right side you see the content of the PGN header lines, only “Date” (current) and “Result” are filled. If you want to edit the content of the header lines press “E” on the keyboard. Then you can type in new content for each line (press ENTER to go to the next line). Pressing ENTER without typing retains the old content.
If all is sufficient you can press “S” to save the file, a file dialog will appear. You can exit the program without saving by pressing the “A” key or closing the window.
OSA-Load
You can load PGN-files with OSA format into the board with OSA-Load. After starting the program (parameters in osa.ini or the command line) without a file name, a file dialog will appear and you can choose the PGN-file to load. You can control the received moves on the screen, after finishing the word “DONE” appears.
Download
- OSA4Arena_100410.zip - © 2009 A. Pietig
Contact
Please report any bugs or wishes to achim@pietig.com
© 2009 A. Pietig, Detmold, Germany
