M3 Retrofit

After M3 is disassembled for mirror coating and actuator profiling, mirrors tip tilt accuators have to be adjusted.

This consist of the following steps:

Establishing a connection from the SWG group laptop to UMAC running the OSS

The Dell laptop has Windows installed, with Virtual Box image of Centos. User to Windows is swg (no password), Centos 7 username is tcs, password written on the laptop. After starting Centos (and extending the Centos screen), click on OSS icon to launch OSS GUI. Click on M3 to access M3. Configuration for OSS is specified in tcs/oss/etc/oss.conf directory, contains tertiary IP address on the following line:

%CODE{lang="inf"}% oss.terc.ip map<int,string> 0: 1: # ip address of the M3 UMAC. %ENDCODE%

The laptop must be connected by an ethernet cable with the tertiary UMAC box.

The connection can be verified by pinging IP from the laptop terminal.

Calculating new home offset

A new home offset must be calculated. Engineering knows the procedure (includes driving encoders to limits, obtaining free of travel range, and dividing this range by 2 to get the home position in the middle of the range). After those offsets are calculated, 3 numbers corresponding to 3 legs will be provided.

Writing new home position to the OSS source code

The home offsets are recorded (hardcoded) in (tcs)/oss/TertiaryMirror.cpp file, about lines 150:

%CODE{lang="cpp" num="150"}% // make class variables 1-Sep-16 // measured in lab 2-Sep-16 leftSelHomeOffset = "-325520"; // measured in lab 14-Aug-17 leftLeg1HomeOffset = "-428160"; leftLeg2HomeOffset = "-478784"; leftLeg3HomeOffset = "-492816";

// measured in lab 25-Aug-15 rightSelHomeOffset = "-436540"; // measured in lab 20-Aug-15 rightLeg1HomeOffset = "-265160"; rightLeg2HomeOffset = "-376048"; rightLeg3HomeOffset = "-292320"; %ENDCODE%

After changing the limits (on aproprite side), compile and restart OSS by typing:

%CODE{lang="sh"}% make netconfig stop OSS netconfig start OSS %ENDCODE%

Updating M3 software limits

UMAC firmware has to be updated to reflect newly calculated software limits on actuator travel. Those are stored in (tcs)/oss/etc/terc/umac_m3s_config_[SIDE]_source.CFG. The file must be edited, lines with assignment to software limits registers identified, and updated:

%CODE{lang="inf" num="1001"}% END IF ;I113=8192 ;I114=-8192 ;I213=8192 ;I214=-8192 ;I313=8192 ;I314=-8192 I113=12288 I114=-12288 I213=12288 I214=-12288 I313=12288 I314=-12288 %ENDCODE%

After the I values are updated (only those, the code contains seconds assignments of 0 - leave those alone, those are to disable software limits during accuators initialization), load new firmware by typing:

%CODE{lang="sh"}% cd oss/etc/terc source [SIDE]terc %ENDCODE%

Where [SIDE] should be replaced with SX or DX.

Verifying values, versioning

After you changed the values, verify that new numbers are in effect. Commit changed files (both oss/TertiaryMirror.cpp and UMAC firmware) into git current branch (as this is one time small change, directly pushing them will work - no branch needed; please keep in mind only TCS admin has direct write access, so create branch and pull request or send git diff to TCS admins if you aren't in the group).

-- %USERSIG{PetrKubanek - 2018-07-24}%
Topic revision: r2 - 20 Aug 2018, PetrKubanek
This site is powered by FoswikiCopyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding Foswiki? Send feedback