driver/rawnetworkinterfacedriver: ethtool get/change EEE settings

Add interface Energy Efficient Ethernet (EEE) configuration
(`ethtool --set-eee`) support to the RawNetworkInterfaceDriver. This
allows configuring the EEE parameters eee, tx-lpi, tx-timer and advertise
on the bound interface.

Also add a `get_eee_settings()` method to query those settings. Note
that ethtool gained the required --json support for this sub command in
v6.10.

Signed-off-by: Bastian Krause <[email protected]>

Author: Bastian-Krause

helpers/labgrid-raw-interface

@@ -99,6 +99,15 @@ def main(program, options):
             args.append(options.ifname)
             args.extend(options.ethtool_change_args)
 
+        elif options.subcommand == "set-eee":
+            for arg in options.ethtool_set_eee_args:
+                if arg.startswith("-") or not allowed_chars.issuperset(arg):
+                    raise ValueError(f"ethtool --set-eee arg '{arg}' contains invalid characters")
+
+            args.append("--set-eee")
+            args.append(options.ifname)
+            args.extend(options.ethtool_set_eee_args)
+
     try:
         os.execvp(args[0], args)
     except FileNotFoundError as e:
@@ -138,6 +147,13 @@ if __name__ == "__main__":
         "ethtool_change_args", metavar="ARG", nargs=argparse.REMAINDER, help="ethtool --change args"
     )
 
+    # ethtool: set-eee
+    ethtool_change_parser = ethtool_subparsers.add_parser("set-eee")
+    ethtool_change_parser.add_argument("ifname", type=str, help="interface name")
+    ethtool_change_parser.add_argument(
+        "ethtool_set_eee_args", metavar="ARG", nargs=argparse.REMAINDER, help="ethtool --set-eee args"
+    )
+
     args = parser.parse_args()
     try:
         main(args.program, args)

labgrid/driver/rawnetworkinterfacedriver.py

@@ -119,6 +119,30 @@ def ethtool_configure(self, **settings):
         cmd = self._wrap_command(cmd)
         subprocess.check_call(cmd)
 
+    @Driver.check_active
+    def get_ethtool_eee_settings(self):
+        """
+        Returns Energy-Efficient Ethernet settings via ethtool of the bound network interface
+        resource.
+        """
+        cmd = self.iface.command_prefix + ["ethtool", "--show-eee", "--json", self.iface.ifname]
+        output = subprocess.check_output(cmd, encoding="utf-8")
+        return json.loads(output)[0]
+
+    @Driver.check_active
+    @step(args=["settings"])
+    def ethtool_configure_eee(self, **settings):
+        """
+        Change Energy-Efficient Ethernet settings via ethtool of the bound network interface
+        resource.
+
+        Supported settings are described in ethtool(8) --set-eee (use "_" instead of "-").
+        """
+        cmd = ["ethtool", "set-eee", self.iface.ifname]
+        cmd += [item.replace("_", "-") for pair in settings.items() for item in pair]
+        cmd = self._wrap_command(cmd)
+        subprocess.check_call(cmd)
+
     def _stop(self, proc, *, timeout=None):
         assert proc is not None