| Dump Files | Index |
A dump file or "braindump" is a collection of batch files and compiled TEA programs. Batch files, which usually have a bag extension, are lists of commands used to configure the robot. Compiled TEA programs, which have the cup extension, are the binary executables that the robot understands. The dump file contains all the bag and cup files that make up the TEAware for the robot.
The "aGarcia" folder in the Garcia download contains all the source files for creating the dump file used in the latest build. A user can modify these files in order to make custom changes to the TEAware. If these files are changed, a user must make a new dump file.
Recompiling the Dump File
Copy the files in the "aGarcia" folder and paste them in the "aUser" folder. Once the files are in the "aUser" folder, modify them as desired. Run the Console application. Enter the following command:
This compiles all the Garcia TEA files. Then enter:
This assembles all the separate binaries into one big binary file. Close the Console. Go to the "aObject" folder and find the "garcia.dump" file. That is the file created by the makedump operation. Give it a unique name for your use, but keep the dump extension. Remove the EEPROM lock from the robot. Connect robot to computer, turn it on, then run the GarciaTool Application. Go to the "Config" pane. Hit the "Upgrade" button. Select the dump file you just created. This will load all the new files to the robot.
Once the download is completed, turn off the robot. Replace the EEPROM lock. See if your new changes have the desired effect.
Naming Convention
In the distribution for the Garcia API, there are a number of files named "garciaXX_Y.dump" where the XX_Y is a version number of the dump. The XX is the software release version number. The Y is a sub-version number for braindumps released between software builds. Old braindumps are included for backwards compatibility. We encourage the user to adhere to this convention when creating custom braindump files.