Using Android ScoreSheet

System requirements

ScoreSheet is available from Google Play or, on your Android device, go to Play Store and search for Soxoft ScoreSheet

Setting up the share.

ScoreSheet communicates with Duplicate Scorer via files in a shared folder on the scoring computer. Duplicate Scorer posts movement information, club membership data, board results and ranking data for ScoreSheet to read. ScoreSheet posts player identities and results entered at the table back to Duplicate Scorer.

Thus the Android devices need read/write access to the shared folder.

The shared folder must be the folder where Duplicate Scorer creates the wireless scoring database. To ascertain or set the location of this folder, click on Duplicate Scorer?s Scoring menu, choose Wireless Scoring then Set Up. The last item on the Wireless Scoring Settings screen is the "Folder for communications files". Make sure this is set to a valid folder on your computer. Then, using Windows Explorer, right click on this folder (or a parent folder) and select Properties. Make sure the folder is shared. On Windows 10, this is achieved by selecting the Sharing tab in the folder properties window, clicking on Advanced Sharing... then checking the Share this folder box.

It is strongly recommended that you then use a network-aware file manager app on your Android device to check the server settings and that your Android device can access the share, before attempting to set up and run ScoreSheet.

Initially, try leaving the Domain box blank and entering the server name and, if appropriate, Username and Password (username/password may not be required in the case of an open share). Check that you can now see files in your Windows shared folder. If you experience difficulties connecting to the Windows system, this can sometimes be fixed by copying the server name into the Domain box (ie. the same text for both Domain and Server).

You are now ready to configure your Android device(s).

The first time you run ScoreSheet on any Android device, you should be taken automatically into the network settings screen. If not, or to change the settings, click on the device with radiating arcs icon (in yellow on the blue caption bar).

In the ScoreSheet settings, enter the same Domain Name (if any), Server Name, User Name and Password as you used in your file manager app. The Share name / path should be set to the shared folder where the Duplicate Scorer communications files are located. If you shared the actual folder, then just enter the share name. If you shared a parent folder, you should enter the path starting with the share name. For example: DuplicateScorer/results/comms

There is a shortcut for registered clubs. If you have registered your club's scoring computer details with me, you can just type your club name into the Server Name box and click the Club button, then all the other details will be filled in for you. This can be especially useful if you are a large club with many tablets to set up. Please email me if you would like your club's details added to the list.

Do not check the box marked "Scan for server". This is reserved for a future enhancement.

Another item on the ScoreSheet settings screen is a checkbox marked "Fetch EBU member list from server?" If you want players to be able to sign-on using their EBU number, then you need to check this box. Note, though, that the EBU members file can be quite large and takes a fair while to download. This introduces an appreciable delay when you start up ScoreSheet for scoring. However, ScoreSheet never deletes the file so once you have scored a competition with this option set, you may prefer to unset the option for future competitions unless and until you believe the membership file may have changed significantly.

When you are satisfied with the settings, touch OK.

Scoring using Android ScoreSheet

When you have loaded the required movement into Duplicate Scorer, click on the Scoring menu and choose Wireless scoring, Start Wireless System.

The first wireless session options screen now offers three choices for the wireless scoring hardware in use. If you have Bridgemate version 1, select the first option. For other wireless scoring systems, such as Bridgemate 2 and BridgePad, choose the second option. If you don?t have special purpose bridge scoring hardware, ie. you are only using ScoreSheet for wireless scoring, select the third option.

In the next box, make sure Keith Sheppard?s Android ScoreSheet app is ticked.

In the third panel, choose your preferred options.

Click OK.

The next window is entitled Bridgemate 2 and ScoreSheet options. Select your preferred options and click OK. After a brief delay, you should see the message Wireless scoring started. Once this message has been displayed, Android ScoreSheet users can click the Start button in ScoreSheet. If all is well, the movement name will be displayed on the Android device along with a set of buttons to allow the user to select their table number. Note, though, that there can be a delay of several seconds, maybe half a minute, after touching Start before the table selection screen appears. This delay is due to Android making the necessary network connection and downloading the movement file.

Table locking

ScoreSheet's Select Table screen will only allow the user to select a table that remained unclaimed at the time the Start button was pressed. It is not possible to prevent two devices from attempting to select the same table at roughly the same time but when this does happen, the following mechanism will come into play.

The server will initially allocate the table to the device whose request message is first received and processed. Users of the second device will initially be unaware of the problem. The problem will be detected on the server (within 3-4 seconds). At this point, the server will inform the second device that the requested table allocation was unsuccessful. An error message will be displayed on the device informing them that the table they selected is unavailable.

If it was the second device that selected the wrong table then there's no need to involve the director or scorer. Players using the second device can simply select the correct table number.

If it's the first device that was in error, players using the second device need to call the director (or scorer). The director will need to use Duplicate Scorer (or the Score Sheet Interface program ssi) on the scoring computer to fix the problem. Both applications have a facility to force the log-off of a table. In the case of Duplicate Scorer, a table is unlocked by clicking on the Scoring menu, choosing Wireless Scoring and then Unlock Table. In the case of ssi, there's a Force Table Log-off button on the main screen.

When the director or scorer forces a device to log off, the server will inform that device that their table allocation has been rescinded. A message to that effect will be displayed on the device after which the device will return to the start, or table select, screen so that the user can select a correct table number.

Unfortunately, if the first device was using a different hardware (eg. BridgeMate) or software (eg. BridgeTab) then there is no way to inform its users that their table number has been rescinded. In this case, the director must ascertain which device is in error and manually reset that device.

Player Locking

The ScoreSheet app won't allow the same player to be specified in different seats at the same table. If the same player is specified at two different tables, it becomes a little more complicated.

When the server detects that the same player has been registered at two different tables, the server software will send a message to both tables (assuming both are running the ScoreSheet app). A message will be displayed on each device advising the user which player is duplicated and at which other table

It is a simple matter for the table that made the error to correct it. They simply accept the option to reset the player identity and enter the correct player's details. The on-screen message advises the user that if they haven't made a mistake then they should call the scorer. The scorer should check the message to see which other table has incorrectly entered the player's details then go to that table and make sure that they have rectified the error. Assuming they have, the scorer then returns to the table where the player is genuinely sat and dismisses the error message, allowing that table to continue.

Note that if the error was made at a table using a hardware scoring device rather than ScoreSheet, then the scorer will have to rectify the problem at the PC end, using Duplicate Scorer's Names button.