Last modification: 23-Jan-2008
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.
The following files form part of the application software. For firmware version ≥ 4.0:
For firmware versions ≤ 3.5:
The following files form part of the operating system RTOS:
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:
telnet 192.0.2.3 Username: esd
There will be no prompt for a password but an immediate login. The output on the screen at login will look like this:
WD=/R1/HOME XD=/ /R1/HOME/PROFILE--: wrong command
CXD /R4The output on the screen will look like this:
WD=/R1/HOME XD=/R4/-
REBOOT NOAPPLWait about 15 seconds for the dtb controller to reboot, then telnet again into the dtb as described above (sections 1 and 2) using username "esd" with no password. In the telnet session, on the command prompt, type command:
CXD /R4 memadd
cd APPL (i.e. go to subdir. APPL of this distribution)
ftp 192.0.2.3
Username: esd_ftp
Password: <RETURN> (i.e. no password)
passive (SuSE only) (i.e. toggle use of passive transfer mode)
epsv4 (SuSE only) (i.e. toggle use of EPSV/EPRT commands)
cd /ED (i.e. go to directory /RF/BIN)
binary (i.e. use binary transfer mode)
prompt (i.e. turn off prompting)
put DTB4xx (i.e. copy file DTB4xx from directory APPL into /ED)
('xx' denotes the version number)
CXD /R4 APPUPD /ED/DTB4xxBEWARE:
REBOOT FULL
editapplThe output on the screen will look like this:
EDITAPPL: start >> #SRAM : NO_BAD BLOCK(S) >> DISCMOVE/0084: (terminate) EDITAPPL: done.Keep this session open.
cd APPL (i.e. go to subdir. APPL of this distribution)
ftp 192.0.2.3
Username: esd_ftp
Password: <RETURN> (i.e. no password)
passive (Linux only) (i.e. toggle use of passive transfer mode)
epsv4 (Linux only) (i.e. toggle use of EPSV/EPRT commands)
cd /RF/BIN (i.e. go to directory /RF/BIN)
binary (i.e. use binary transfer mode)
prompt (i.e. turn off prompting)
mput * (i.e. copy all files from directory APPL into /RF/BIN)
BEWARE:
Make sure that all files are transferred in uppercase! If you are getting
errors while transferring files into the controller the most likely reason
is that the storage area inside the controller is full due to multiple
versions of the desired files. By giving the "DIR" command in the
FTP session you may want to check that there is only one version of file
APPLLOAD (and not another one named "applload" ). In
that case, the safest thing to do is to power cycle the controller and
start all over again!
saveapplBEWARE:
The output on the screen will look like this:
SAVEAPPL: Please wait until "all done" appears. SAVEAPPL: Clearing Bank 1...9 and saving /R2... SAVEAPPL: Clearing Bank 1...9 >> CLEARFLASH/0086: (terminate) SAVEAPPL: Clearing Bank 1...9 done. SAVEAPPL: SAVING /R2 ... >> MOVETOFLASH/0087: (terminate) SAVEAPPL: SAVING /R2 ...done SAVEAPPL: all done.
system_reset
PARA_DEFAULT 0There will be no feedback for this command. Afterwards, reboot again.
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:
cd RTOS (i.e. go to subdir. RTOS of this distribution)
ftp 192.0.2.3
Username: esd_ftp
Password: <RETURN> (i.e. no password)
passive (Linux only) (i.e. toggle use of passive transfer mode)
epsv4 (Linux only) (i.e. toggle use of EPSV/EPRT commands)
cd /ED (i.e. go to directory /ED)
binary (i.e. use binary transfer mode)
prompt (i.e. turn off prompting)
mput * (i.e. copy all files from directory RTOS into /ED)
In your terminal window, you should see something similar to:
binary 200 TYPE Command ok, Type set to IMAGE. dtb:/R3> dtb:/R3> dtb:/R3> cd /ED 250 Requested fileaction okay, completed. dtb:/ED> mput * local: sys36v10.fld remote: sys36v10.fld 200 PORT Command ok. 150 Opening data connection for sys36v10.fld (192.0.2.2,30682). 100% |*************************************| 497 KB 111.49 KB/s 00:00 ETA 226 Closing data connection. Successful. 509870 bytes sent in 00:04 (107.40 KB/s)After file transfer, check contents of directory /ED by typing "DIR" in the FTP session. You should see something similar to:
dtb:/ED> dir 200 PORT Command ok. 150 File status ok; about to open data connection (192.0.2.2,30681). -rwxrwxrwx 1 esd rtos 1 -- 00:09 tmp03 -rwxrwxrwx 1 esd rtos 509870 -- 00:09 sys36v10.fld lrwxrwxrwx 1 esd rtos 0 : LIB 226 Closing data connection. Successful.
telnet 192.0.2.3 Username: esdThere will be no prompt for a password but an immediate login. The output on the screen at login will look like this:
WD=/R1/HOME XD=/ /R1/HOME/PROFILE--: wrong command
CXD /R4The output on the screen will look like this:
WD=/R1/HOME XD=/R4/-
sysupd /ED/sys36v10.fld USER-RTOSBEWARE:
The output on the screen will look like this:
/ED/->sysupd /ED/sys36v10.fld USER-RTOS USER-RTOS booted. SYSUPD: USER-RTOS booted. SYSUPD: Flash USER-RTOS. >> LOAD/0025: (terminate) SYSUPD: FLLOAD loaded. SYSUPD: Please wait until "all done" appears. SYSUPD: REWIND /ED/sys36v10.fld OK. SYSUPD: Clearing Bank 101 ... and flashing rtos-image... SYSUPD: Clearing Bank 101 ... >> CLEARFLASH/0026: (terminate) SYSUPD: Clearing Bank 101 ... done. SYSUPD: Flashing rtos-image (bank 101 ...) /ED/sys36v10.fld (wait 2 min) FLLOAD: File loaded: /ED/sys36v10.fld Addr 00000000 > 00042840 SYSUPD: Flashing image done. Ok. SYSUPD: all done.
telnet 192.0.2.3 Username: esdThere will be no prompt for a password but an immediate login. On the command prompt (/R1/HOME>) type:
versionIn 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>
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 |
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:
telnet 192.0.2.3 Username: esd
There will be no prompt for a password but an immediate login. The output on the screen at login will look like this:
WD=/R1/HOME XD=/ /R1/HOME/PROFILE--: wrong command
CXD /R4The output on the screen will look like this:
WD=/R1/HOME XD=/R4/-
editconfThe output on the screen will look like this:
/R1/HOME>editconf EDITCONF: start >> #SRAM : NO_BAD BLOCK(S) >> DISCMOVE/007F: (terminate) EDITCONF: done.: (terminate)
ftp 192.0.2.3
Username: esd_ftp
Password: <RETURN> (i.e. no password)
passive (SuSE only) (i.e. toggle use of passive transfer mode)
epsv4 (SuSE only) (i.e. toggle use of EPSV/EPRT commands)
cd /RF (i.e. go to directory /RF/BIN)
binary (i.e. use binary transfer mode)
put STATP.033 (i.e. copy file STATP.033 from current dir. into /RF)
quit
saveconfThe output on the screen will look like this:
/RF/->saveconf RTOS-DIRECTORY DEVICE /RF/ **FREE** 115 BC_CONF.TLP 2 BC_CONF.033 2 CONF/ 1 IO_CONF 1 PARA/ 1 RC/ 1 STATP.TLP 3 STATP.033 2 Temp. RAM-Disk /RF found. Continue! SAVECONF: Please wait until "all done" appears. SAVECONF: Clearing Bank 6...9 and saving /R3... SAVECONF: Clearing Bank 6...9 >> CLEARFLASH/0083: (terminate) SAVECONF: Clearing Bank 6...9 done. SAVECONF: SAVING /R3 ... >> MOVETOFLASH/0084: (terminate) SAVECONF: SAVING /R3 ...done SAVECONF: UNMOUNT temp. RAM-Disk /RF SAVECONF: all done.BEWARE:
In any case, the dtb-controller needs to know which motor to talk to before the buttons can be used. By default, no motor is assigned to the CRYO button. To use the CRYO button to drive either BEAMSTOP or PHI, add a corresponding line to the configuration file (see chapter 7.2.1.2 (keywords for dtb) . Before starting program mar345dtb, you must set a couple of parameters with the help of program dtbcmd that allows to send single hardware commands to the dtb-controller.
In order to use motor BEAMSTOP, please do the following:
| Command | Description |
|---|---|
| dtbcmd 103,1,41,5 | Assign BEAMSTOP motor to CRYO button |
| dtbcmd 103,1,40,100 | Set speed for BEAMSTOP motor to 100 steps/sec. |
| dtbcmd 103,1,39,500 | Set acceleration for BEAMSTOP motor to 500 steps/sec*sec. |
| dtbcmd 103,1,38,-300 | Set position 2 for BEAMSTOP motor to 45 mm |
| dtbcmd 103,1,37,-120 | Set position 1 for BEAMSTOP motor to 18 mm |
In order to use motor PHI, please do the following:
| Command | Description |
|---|---|
| dtbcmd 103,1,41,6 | Assign PHI motor to CRYO button |
| dtbcmd 103,1,40,10000 | Set speed for PHI motor to 10000 steps/sec. |
| dtbcmd 103,1,39,20000 | Set acceleration for PHI motor to 20000 steps/sec*sec. |
| dtbcmd 103,1,38,-144000 | Set position 2 for PHI motor to 180.00 deg. |
| dtbcmd 103,1,37,0 | Set position 1 for PHI motor to 0.0 deg. |
If you don't have a CHI axis you may also reassign the CHI button to either BEAMSTOP or PHI. To do so, use the same sequence of commands as described above. The only difference will be the third argument (41 to 37) which will have to be replaced by the given value -5, i.e. 36 to 32.