--- zzzz-none-000/linux-4.4.271/Documentation/devicetree/bindings/phy/qcom-ipq806x-sata-phy.txt	2021-06-03 06:22:09.000000000 +0000
+++ maple-fsgw-759/linux-4.4.271/Documentation/devicetree/bindings/phy/qcom-ipq806x-sata-phy.txt	2023-12-20 10:36:58.000000000 +0000
@@ -11,6 +11,18 @@
 - clocks: must be exactly one entry
 - clock-names: must be "cfg"
 
+Optional properties:
+
+All of the HSIO properties below should be present for a certain
+characterization requirement.
+If any one of property is missed, all others are ignored and default HSIO
+characterization settings will be used by the driver.
+- tx_preemph_gen3: Tx driver de-emphasis value in the case where the PHY is
+  running at the gen3 rate
+- rx_eq: Fixed value of the RX equalizer
+- mpll: mpll settings in MPLL_LOOP_CTL register
+- term_off: Termination offset in TX_OVRD_DRV_HI register
+
 Example:
 	sata_phy: sata-phy@1b400000 {
 		compatible = "qcom,ipq806x-sata-phy";
@@ -20,4 +32,9 @@
 		clock-names = "cfg";
 
 		#phy-cells = <0>;
+
+		tx_preemph_gen3 = <0x0F>;
+		rx_eq = <0x03>;
+		mpll = <0x0>;
+		term_off = <0x0>;
 	};