Adding explanatory warnings to the backwards compatibility code instructing

users how to update existing configurations.

Author: dihm

labscript_devices/NI_DAQmx/blacs_tabs.py

@@ -17,6 +17,7 @@
 from blacs.device_base_class import DeviceTab
 from .utils import split_conn_AO, split_conn_DO
 from . import models
+import warnings
 
 
 class NI_DAQmxTab(DeviceTab):
@@ -44,8 +45,14 @@ def initialise_GUI(self):
         try:
             AI_chans = properties['AI_chans']
         except KeyError:
-            # assume legacy behavior
+            # new code being run on older model specification file
+            # assume legacy behavior, warn user to update
             AI_chans = [f'ai{i:d}' for i in range(num_AI)]
+            msg = """Connection table was compiled with old model specifications for {0}.
+                     Please recompile the connection table.
+                  """
+            warnings.warn(dedent(msg.format(properties['MAX_name'])), FutureWarning)
+
         ports = properties['ports']
         num_CI = properties['num_CI']
 

labscript_devices/NI_DAQmx/labscript_devices.py

@@ -30,6 +30,7 @@
 from labscript_utils import dedent
 from .utils import split_conn_DO, split_conn_AO, split_conn_AI
 import numpy as np
+import warnings
 
 _ints = {8: np.uint8, 16: np.uint16, 32: np.uint32, 64: np.uint64}
 
@@ -218,6 +219,12 @@ def __init__(
         if AI_term_cfg == None:
             # assume legacy configuration if none provided
             AI_term_cfg = {f'ai{i:d}': ['RSE'] for i in range(num_AI)}
+            # warn user to update their local model specs
+            msg = """Model specifications for {} needs to be updated.
+                  Please run the `get_capabilites.py` and `generate_subclasses.py`
+                  scripts or define the `AI_Term_Cfg` kwarg for your device.
+                  """
+            warnings.warn(dedent(msg.format(self.description)), FutureWarning)
         self.AI_chans = [key for key,val in AI_term_cfg.items() if self.AI_term in val]
         if not len(self.AI_chans):
             msg = """AI termination {0} not supported by this device."""