Availability:
     Level 7    , 'U'

  Quick Help:
     Channel Temperature Adjust, U[TweakTemperature],[Partition],[Hd],[Zone],[Opts],[Preht],[WrtHt],[RdHt]

  Description:
    This command tweaks the write power and fly height values based on the specified
    temperature value.

  Input Parameters:

    0 - Tweak Temperature in degrees Celsius.
    
        This parameter specifies the temperature (in degrees Celsius) with which the
        write power and fly height are to be tweaked.
    
          Type:    Signed 8 bit value
    
          Range:   0 to 0xFF
    
          Default: None.  If this parameter is not entered, the current thermistor
                   temperature will be used.
    
    1 - Partition
    
        This parameter specifies the media partition on which the write power and
        fly height will be tweaked with the temperature.
    
             0x00 = User Partition
             0x01 = System Partition
             0x10 = User Partition
             0x20 = System Partition
    
          Type:    Unsigned 8-bit value
    
          Range:   0, 1, 10 hex or 20 hex
    
          Default: 0
    
    2 - Head
    
        This parameter specifies the head or heads to tweak the write power and fly
        height.  If parameter 2 is 0xFF, the write current and fly heigth will be
        tweaked on all heads in the zone or zones specified by parameter 3.  If
        parameter 2 is not entered, the write current and fly height values will be
        tweaked on the current head in the zone or zones specified by parameter 3.
    
          Type:    Unsigned 8-bit value
    
          Range:   Defined by RAP.
    
          Default: None
    
    3 - Zone
    
        This parameter specifies the zone or zones to tweak the write power and fly
        height.  If parameter 3 is 0xFF, the write current and fly height will be
        tweaked in all zones on the head or heads specified by parameter 2.  If
        parameter 3 is not entered, the write current and fly height values will be
        tweaked in the current zone on the head or heads specified by parameter 2.
    
          Type:    Unsigned 8-bit value
    
          Range:   Defined by RAP.
    
          Default: None
    
    4 - Channel Temperature Adjustment Option.
    
        This parameter is a bit significant value that specifies how the channel
        temperature adjustment are to be applied.  The bits are defined as follows:
    
            Bits 15-2: not used
    
            Bit 1: Disable Heater Value Tweak.
    
                   If this bit is equal to 1, the read heat, write heat and preheat
                   will not be tweaked with the temperature.  However the heat values
                   in the working memory will be updated with the value from the RAP
                   in the memory.  If this bit is equal to 0, the heat values will be
                   tweaked with the tmeperature.
    
            Bit 0: Disable Write Power Tweak.
    
                   If this bit is equal to 1, the write current, write current damping
                   and write current damping duration will not be tweaked with the
                   temperature.  However the write power in the working memory will be
                   updated with the value from the RAP in the memory.  If this bit is
                   equal to 0, the write power will be tweaked with the tmeperature.
    
          Type:    Unsigned 16-bit value
    
          Range:   0 to 0xFFFF
    
          Default: 0 (Enable Write Power Tweak)
    
    5 - Preheat
    
        This parameter specifies the preheat to apply for temperature tweaking.
        This parameter is only valid if bit 1 of parameter 4 is entered.
        This parameter is only valid if parameters 5, 6, 7 are all entered.
    
          Type:    Unsigned 8-bit value
    
          Range:   Defined by RAP.
    
          Default: None
    
    6 - Write Heat
    
        This parameter specifies the write heat to apply for temperature tweaking.
        This parameter is only valid if bit 1 of parameter 4 is entered.
        This parameter is only valid if parameters 5, 6, 7 are all entered.
    
          Type:    Unsigned 8-bit value
    
          Range:   Defined by RAP.
    
          Default: None
    
    7 - Read Heat
    
        This parameter specifies the read heat to apply for temperature tweaking.
        This parameter is only valid if bit 1 of parameter 4 is entered.
        This parameter is only valid if parameters 5, 6, 7 are all entered.
    
          Type:    Unsigned 8-bit value
    
          Range:   Defined by RAP.
    
          Default: None
    
  Output Data:


    If an error occurred, the following information will be displayed.
    
          "DiagError aaaaaaaa"
    
       where
    
          aaaaaaaa is the Diagnostic Error Code
    
    If no error occurred, the write power values will be displayed as follows.
    
          "Write Current = a"
          "Write Damping = b"
          "Write Damping Duration = c"
    
       where
    
          a is the write current value in hex.
    
          b is the write damping value in hex.
    
          c is the write damping duation in hex.
    


    If an error occurred, the following information will be displayed.
    
          "DiagError aaaaaaaa"
    
       where
    
          aaaaaaaa is the Diagnostic Error Code
    
    If no error occurred, the following will be displayed
    
          "WL = a.bbbbbbsEscc"
          "dCT = d.ffffffsEsgg"
          "Read Fly Height = h.iiiiiisEsjj"
          "Write Fly Height = k.llllllsEsmm"
          "Preheat = hh, Write heat = hh, Read heat = hh"
    
       where
    
          a.bbbbbbsEscc is a floating point value for .write loss
    
          d.ffffffsEsgg is a floating point value for delta clearance due to temperature.
    
          h.iiiiiisEsjj is a floating point value for read fly height.
    
          k.llllllsEsmm is a floating point value for write fly height.
    
          hh are heater DAC values for preheat, write heat, and read heat.
    
  Revision History:

    0001.0000   Initial revision.
    0001.0001   Added option bit 1 to directly use heat values from RAP without
                any tweaking.
    0011.0000   Combined the PSG Diagnostic Error Codes (PSGDEC) and the Diagnostic External
                Test Service Error Codes (DETSEC) into a single set of Diagnostic Error Codes
                (DiagError).
    0011.0001   Added cylinder and frequency display for single head/zone tweak.
    0012.0000   If disable heater tweak desired, user must enter heat parameters.