mardtb 248x
Edited on 19-May-2023

Appendix


A. dtb Firmware Upgrade

This chapter describes the procedure for upgrading the application software and operating system RTOS within the dtb controller.

A.1 Firmware Distribution

The firmware distribution contains two components: the application software (APPL) and the operating system (RTOS). The operating system RTOS is likely to be a stable distribution and in the an update of the RTOS is going to happen with low frequency. The application software is the part of the controller firmware that handles the details and is likely to undergo more frequent updates.

A.1.1 Apllication Software (APPL)

The following files form part of the application software. For firmware version ≥ 4.0:

For firmware versions ≤ 3.5:

A.1.2 Operating System (RTOS)

The following files form part of the operating system RTOS:

The # denotes the version number. As by November 2002, the current version number is "40".



A.2 Application Software Update

In the following section, red text denotes user commands. Text printed in green is the expected output on the terminal screen. Please do the following and note that strings are case sensitive:



A.3 Operating System Update

In the following section, red text denotes user commands. Text printed in green is the expected output on the terminal screen. Please do the following and note that strings are case sensitive:



A.4 List Firmware Versions

In a terminal window, type:
		telnet 	192.0.2.3
		Username:	esd
There will be no prompt for a password but an immediate login. On the command prompt (/R1/HOME>) type:
		version
In the command ouput, the entry "SOFTWARE VERSION" (see below) corresponds to the current version of the application software (here 3.3) The line "RTOS-IMAGE-NO." gives the current version of the operating system (here 10). A typical output looks like this:
		/R1/HOME>version
		SOFTWARE-VERSION :      3.30
			 DTB-NO. :         0
		  CONTROLLER-NO. :        16
		  RTOS-IMAGE-NO. :        10
		  RTOS-IMAGE-NAME:P:\rtos\cmdfiles\base360\sys36v10.cmd
		       created at:Mon Nov 12 18:21:53 2001  
		/R1/HOME>




A.5 Update of Disks R2, R3 and R5

In certain situations it might become necessary or useful, to update user data on one of the internal disks of the controller. The following table summarizes the available partitions, their contents and the name of the command procedure to use for updating the information.

Partition Name Contents Update Commands
/R2 TEST Batch files, etc. edittest/savetest
/R3 CONF Configuration files, etc. editconf/saveconf
/R5 TOOL Some system tools edittool/savetool

The most likely thing to do is an update of partition /R3 that contains instrument specific configuration data for certain motors or hardware components like the barcode reader. In the following example we will assume that we want to update disk /R3. For updating disks /R2 or /R5, the commands editconf/saveconf must be replaced by edittest/savetest or edittool/savetool, respectively.

In the following section, red text denotes user commands. Text printed in green is the expected output on the terminal screen. Please do the following and note that strings are case sensitive: