Samantha FCS Readme

    In the Samantha Field Control System directory, there are three .exe files (programs):

    • SamoCfg.exe
    • SamoDbLg.exe
    • samofcs.exe
    • The SamoCfg.exe program is for creating a configuration file to setup the secondary network configuration in the Samantha Module. When completed, the configuration file is saved to a USB memory stick ready to be loaded to the Samantha module.
    • The SamoDbLg.exe program initiates a debug log to be created and maintained while the FCS is running a match session. This program is run prior to starting the FCS and the debug log is available for viewing after the FCS is closed.
    • The samofcs.exe program is the Field Control System (FCS) for the Samantha module.

     

    Other files of interest are located in folders within the Samantha Field Control System directory. They include:

    • The images directory contains the various images used by the FCS
    • The files for updating the bootloader are stored in the Samantha Field Control System/newboot directory. Unless there is an update to these files, there is no reason to reinstall these files on the Samantha. WARNING: installing a bootloader file has certain risks associated with the process. If the power is interrupted during the process, the file will not be loaded correctly, BE CAREFUL while performing this process.
    • In the LabVIEW directory, there are two LabVIEW files (Vis). These are simple tools for Wi-Fi/communication checks. These file must be opened, compiled, and loaded to the NXT in order to operate.
      • Samostat.vi > you would run this on the NXT while powering up the Samantha module. It reports the IP address and availability of the network based on the two SSIDs setup in the Samantha module.
      • Comm_Status.vi > you would run this on the NXT while running test matches.
        It live reports the number of packets received, the packet-to-packet time (non averaged), and the additional packet-to-packet time relative to the expected 20 messages per second time slice for every 5 seconds of operation.
    • In the RobotC directory, there are two RobotC programs. These are simple tools for Wi-Fi / communication checks. These file must be opened, compiled, and loaded to the NXT in order to operate.
      • Samostat.c > you would run this on the NXT while powering up the Samantha module. It reports the IP address and availability of the network based on the two SSIDs setup in the Samantha module.
      • Comm_Status.vi > you would run this on the NXT while running test matches.
        It live reports the number of packets received, the packet-to-packet time (non averaged), and the additional packet-to-packet time relative to the expected 20 messages per second time slice for every 5 seconds of operation.
    • The files for updating the Samantha firmware and Samantha firmware with bootloader are located in the Samantha directory. WARNING: installing a firmware file has certain risks associated with the process If the power is interrupted during the process, the file will not be loaded correctly, BE CAREFUL while performing this process.
    • The Sound directory contains the sound effect files used in the FCS.
    • The teamlogo directory is where the team logo image loaded from the NXT is stored for use by the FCS. The image file for the team logo must be named team.png and in the .png format with an image size of 64x64 pixels @ 72x72 pixels per inch. This image will be downloaded from the NXT and, if approved by field operator, may be displayed with the team number at the bottom of the Audience Display Timer.

     

    One feature of the FCS is the creation and maintenance of a Match Log file. The match log (FTCMatch.csv) is created in the c:/My Documents/.../Samantha FCS/matchlog directory. This file is created at the start of the first match run by the FCS and will store the stats for the match / robots participating in the match. This is a continuously updating feature that continues to append match data to the file from one match session to another. This file is a .csv file (comma delimited) and may be viewed in a typical spreadsheet program such as Microsoft Excel.

     

    Another set of features are the message displays in the Status text box and Icon use in the Choose window.
    These features are outlined below.

    The first time a Samantha module is connected to an installation of the FCS or an installation of the FCS whose password has been changed, the following message is displayed.  An additional message may be displayed for a short time prior to this message. To make the connection, the button on the Samantha module must be pressed and released.

    When you first select a Samantha module to connect in the FCS, the status box will display three text messages resembling the messages below. The first two messages may be replaced by each subsequent image too quickly to be read. The third message will remain for approximately six seconds.

     

    With good battery voltage levels, when the connection is established, a message resembling one of the messages below will be displayed.

     

    If battery voltage levels are low when the connection is established, a message resembling one or a combination of two of the messages (not on the same line) below will be displayed

     

     

     

     

     

     

     


    The message Key for the status messages above is:

    No Program Running:There is not a program running on the NXT.

    No Teleop set:A TeleOp program has not been chosen for the NXT or the FTCConfig.txt file on the
    NXT has become corrupt. Use your platform specific method for choosing your
    Teleop program on the NXT. This will create / recreate the FTCConfig.txt file on the NXT.

    A LOW NXT battery voltage is any voltage less than 7.5 volts.
    A BAD  NXT battery voltage is any voltage less than 7.0 volts.
    A LOW main battery (Batt) voltage is any voltage that dips below 10.0 volts.
    A BAD  main battery (Batt) voltage is any voltage that drops below 9.0 volts.

     

    The Details window displays what Samantha module / NXT pairs are visible to the network and their status.


    AvailableAlready Connected to FCS
    Of In Use IP address

     


    Samantha is OnWas connectedWas visible
    NXT is Off or not connectedSamantha is OffMay be switching

    NOTE: When the NXT is Off or disconnected there is no NXT number / name to display. The values displayed in this case are the last three hexadecimal values of the Samantha modules MAC address. [In this case 01:0A:5D]

     

    During an attempt to connect with a Samantha module, other messages may be displayed. The set of messages below occur when the Samantha module is connected to a FCS on another computer.

     

     

    This message would cause the Connect to change to Force.
    Selecting this button would cause the following pop-up window to appear.

     

     

    Selecting OK here will close the connection between the Samantha module and the other FCS then connect the Samantha module to this FCS.

     

    The set of messages below occur when an attempt is made to connect to a Samantha module from a FCS and the Samantha module is already connected to that FCS.

     

    The message below will be displayed if the NXT number us manually typed into the Connect text box and:

    • The Samantha module is turned Off.
    • The computer is not connected to the network or the Samantha module has the wrong encryption key.
    • The number typed in does not exist.

     

    The message below will be displayed if a re-connect to the same Samantha module does not properly execute.

     

    The set of messages below occur when the connection to the Samantha module is lost, once it is connected to the FCS, due to low voltage from the main battery. The time between messages can vary greatly.

     

    The set of messages below occur when the connection to the NXT is lost, once it is connected to the FCS, due to low voltage or a disconnected USB cable. It may take some time before the second message is displayed.