Miscellaneous Parameters

`
ID Label Type #Val Min Max Attr Description

900

Operator's language

Uint8

 

0

1

 

Defines the language in which text that is built into the system is output. This includes error messages, database parameter labels and syntax help information. Strings that have not been translated are output in the default language, English. The possible values for this parameter are:

   0: English (default)
   1: German

901

Save PDB values to files

Uint32

 

 

 

 

Writing to this parameter saves the contents of the parameter database to a series of disk files and/or manages the parameter database disk files. To allow a single level of undo, there are two sets of database files. The active, working set have an extension of ".pac" and the backup, saved set have an extension of ".sav". The operations performed by writing various values into this parameter are as follows:

   0: No operation
   1: Write database values to disk, memory -> "*.pac" files
   2: Copy active database files to backup set, "*.pac" files -> "*.sav" files
       Then write the database values to disk, memory -> "*.pac" files
   3: Copy active database files to backup set, "*.pac" files -> "*.sav" files
   4: Copy backup set to active database files, "*.sav" files -> "*.pac" files
   5: Write DIO MotionBlocks data for all robots -> "diomotion*.pac" files
   6: Write robot calibration data for all robots -> "calib*.pac" files
   7: Write all user GPL String and Double database variables -> "gpl_vars.pac" file

   1001: (HIDDEN PARAMETER) Write parameter definitions to .pad files on ROMDISK.
   1002: (HIDDEN PARAMETER) Inhibit writing .pac files until reboot.


If action 4 is performed, the controller must be rebooted in order for the restored values in the .pac files to take effect.

902

PDB values modified

BOOL

 

 

 

RO

Set to TRUE if any value that is loaded from one of the parameter database disk files has been modified. This indicates that a "Save PDB values to files" operation (ID 901) must be performed in order for the current parameter database settings to be re-instated the next time the controller is restarted.

903

PDB file not found

BOOL

 

 

 

RO

Set to TRUE if any required parameter database disk file could not be found. This indicates that either the controller is being started for the first time and the parameter files have not yet been created in the flash or a significant error has occurred and one or more parameter data files have been corrupted or deleted.

904

PDB files creation date

String

 

 

 

RO

Returns the creation date string from the controller.pac file. This indicates when the active parameter database values were last saved to disk.

905

PDB save set creation date

String

 

 

 

RO

Returns the creation date string from the controller.sav file. This indicates when the backup set of saved parameter database values was created.

906

Set to copy update file to flash

Uint8

 

0

2

 

Setting this value invokes the flash updater that attempts to read a file and copy it permanently to a flash partition for use at system boot. Setting the value to 1 updates the FPGA firmware. Setting the value to 2 updates the GPL system software. The file name is read from "Update file name" (ID 907). If the file is not in the correct format, no update occurs and an error is generated. The update may take a minute to complete. When it is complete, the value of this parameter is set back to 0.

907

Update file name

String

 

0

60

 

The parameter holds the name of the file used by the flash updater invoked by "Set to copy update file to flash" (ID 906).

908

Load PDB disk files

Uint32

 

0

1

 

Writing to this parameter loads the contents of a specified parameter database disk file back into memory. Parameter database files are automatically loaded when the system restarts. In general, such files cannot be reloaded after the system is running since they contain key information including some data that alters the startup configuration of the system. So, only some of the PDB files can be loaded by writing to this DataID.

The operations performed by writing into this DataID are as follows:

    0: No operation
    1: Reload DIOmotion data files ("diomotion*.pac") for all robots

909

PDB file load error count

Uint16

 

 

 

RO

Returns the number of file access and data errors that have been detected while loading Parameter Database (PAC) files.  This count represents the total number of errors since the controller was restarted.  Normally, this count should be zero.

910

Disk busy

BOOL

 

 

 

RO

This value is TRUE whenever there is buffered data for the flash disk that has not been written. The controller must not be turned off when this value is TRUE or the flash disk may be corrupted.

911

Disk free, used, total

Uint32

3

 

 

RO

An array of usage statistics for the user flash drive partition. The byte counts are rounded to multiples of 1024. The array elements are as follows:

    1. Number of bytes free
    2. Number of bytes used
    3. Total number of bytes in user partition

912

Flash statistics

Uint32

8

 

 

RO

An array of statistics for the flash drive, which can also be accessed via the "show flash" console command. The array elements are as follows:

    1. Size of the flash in bytes, e.g., 67108864 for 64Mbytes.
    2. Frequency of the flash bus, in MHZ. Typically 48.
    3. Flash device manufacturer's ID code.
    4. Flash device type code.
    5. Number of flash blocks written since boot.
    6. Number of flash sectors erased since boot.
    7. Number of retries performed since boot. This number should be small or 0.
    8. The number of flash write failures since boot. This number should always be 0.

9. Number of file system errors since boot.

10. Time to mount filesystem (counts of 0.1 milliseconds)

913

Filesystem errors

Uint32

 

 

 

RO

First reported filesystem error

920 Disable i2c errors BOOL         If TRUE, any errors generated by the i2c device driver do not cause robot power to be turned off.  This parameter should only be set for systems where i2c operation is not critical.  This value defaults to FALSE and should only be set to TRUE with caution.

921

i2c: i2c: success, io err, bad mode, r tmo, w tmo, bad cmd, no ack, reset

Uint32

8

 

 

RO

The i2c communication statistics as an array of values. Shows the number of successful transactions or errors:

    1 = Messages successfully sent or received,
    2 = i2c bus I/O errors,
    3 = Bus mode errors,
    4 = Timeout reading data,
    5 = Timeout writing data,
    6 = Invalid i2c command,
    7 = Missing acknowledge,
    8 = Bus reset required.

922

Battery level %

Int8

 

 

 

RO

Indicates the level of the battery on the main controller board. Does not reflect the state of any encoder batteries. When the controller is powered on, the battery is continually recharged. If this level falls below 33%, the real-time clock value setting may be lost.

930

Send message event

Uint8

 

 

 

 

(Hidden Parameter) Send a numbered event to the message event link used by GDE. Values from 100 to 199 can be sent. Other values are ignored. Can be used to signal GDE from a web browser interface.

1700

Dialog box output

String

 

0

1000

 

These string values are utilized by the Controller.ShowDialog method to output the text that is displayed by the web interface and input any responses.  The output is HTML code that is overlaid on top of the standard contents of the Operator Control Panel.  Because the Operator Control Panel is continuously dynamically updated to display system status information, if the output text in this DataID is altered by a GPL program while ShowDialog is active, it is possible to create a dynamic data display using the ShowDialog method.

1701

Dialog box input

String

 

0

1000