Merge pull request #7942 from trlemon/trlemon/enable-4probe-measurement-on-keithley-2600

Add param to enable four-wire measurement on Keithley 2600 driver.

Author: jenshnielsen

docs/changes/newsfragments/7942.improved_driver

@@ -0,0 +1 @@
+Add parameter to Keithley2600 driver to enable/disable four-wire measurements.

docs/examples/driver_examples/Qcodes example with Keithley 2600.ipynb

@@ -10,12 +10,12 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 1,
+   "execution_count": null,
    "metadata": {},
    "outputs": [],
    "source": [
     "import qcodes as qc\n",
-    "from qcodes.dataset import do0d, initialise_database, new_experiment, plot_dataset\n",
+    "from qcodes.dataset import do0d, do1d, initialise_database, new_experiment, plot_dataset\n",
     "from qcodes.instrument_drivers.Keithley import Keithley2614B"
    ]
   },
@@ -182,6 +182,53 @@
     "print(f\"Measured one current value: {curr} A\")"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "## Four-probe measurement  \n",
+    "\n",
+    "Enabling four-probe measurements is simple."
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "# Select channel to work with\n",
+    "smub = keith.smub\n",
+    "\n",
+    "# Set up for four-probe measurement\n",
+    "smub.mode(\"current\")  # Source current, measure voltage\n",
+    "smub.nplc(1.0)\n",
+    "smub.limitv(20)\n",
+    "smub.source_autorange_i_enabled(True)\n",
+    "smub.measure_autorange_v_enabled(True)\n",
+    "\n",
+    "# Set sense mode\n",
+    "smub.four_wire_measurement(True)\n",
+    "\n",
+    "# Make sure output is enabled\n",
+    "smub.output(True)\n",
+    "\n",
+    "# Sweep parameters\n",
+    "i_start = 0  # A\n",
+    "i_stop = 0.1e-6  # A (0.1 µA)\n",
+    "n_points = 101\n",
+    "settle_delay = 0.001\n",
+    "\n",
+    "# Take measurements\n",
+    "data, _, _ = do1d(smub.curr, i_start, i_stop, n_points, settle_delay, smub.volt)\n",
+    "\n",
+    "# Set params to safe values\n",
+    "smub.curr(0)\n",
+    "smub.output(False)\n",
+    "\n",
+    "plot_dataset(data)"
+   ]
+  },
   {
    "cell_type": "markdown",
    "metadata": {},

src/qcodes/instrument_drivers/Keithley/_Keithley_2600.py

@@ -4,7 +4,7 @@
 import struct
 import warnings
 from enum import StrEnum
-from typing import TYPE_CHECKING, Any, Literal
+from typing import TYPE_CHECKING, Any, Literal, Self
 
 import numpy as np
 import numpy.typing as npt
@@ -433,6 +433,20 @@ def __init__(self, parent: Instrument, name: str, channel: str) -> None:
             vals=vals.Numbers(0.001, 25),
         )
         """Number of power line cycles, used to perform measurements"""
+
+        self.four_wire_measurement: Parameter[bool, Self] = self.add_parameter(
+            "four_wire_measurement",
+            label="Four-wire (remote) sense mode",
+            get_cmd=f"{channel}.sense",
+            get_parser=float,
+            set_cmd=f"{channel}.sense={{}}",
+            val_mapping=create_on_off_val_mapping(on_val=1, off_val=0),
+            docstring="Enables or disables four-wire (remote) sense mode. "
+            "When enabled, voltage is measured at the DUT using "
+            "separate sense leads, eliminating lead resistance errors.",
+        )
+        """Enable or disables four-wire (remote) sense mode."""
+
         # volt range
         # needs get after set (WilliamHPNielsen): why?
         self.sourcerange_v: Parameter = self.add_parameter(