Add get_last_error mechanism to IVI init methods.

examples/nidcpower/measure-record.py

@@ -68,6 +68,14 @@ def check_for_error(vi, status):
         raise Exception(error_message_response.error_message)
 
 
+def check_for_initialization_error(response):
+    """Raise an exception if an error was returned from Initialize."""
+    if response.status < 0:
+        raise RuntimeError(f"Error: {response.error_message or response.status}")
+    if response.status > 0:
+        sys.stderr.write(f"Warning: {response.error_message or response.status}\n")
+
+
 # Create the communication channel for the remote host and create connections to the NI-DCPower and
 # session services.
 channel = grpc.insecure_channel(f"{SERVER_ADDRESS}:{SERVER_PORT}")
@@ -85,7 +93,7 @@ def check_for_error(vi, status):
         )
     )
     vi = initialize_with_channels_response.vi
-    check_for_error(vi, initialize_with_channels_response.status)
+    check_for_initialization_error(initialize_with_channels_response)
 
     # Specify when the measure unit should acquire measurements.
     configure_measure_when = client.SetAttributeViInt32(

examples/nidigitalpattern/configure-voltage-levels-and-termination-voltage.py

@@ -107,6 +107,14 @@ def check_for_error(vi, status):
         raise Exception(error_message_response.error_message)
 
 
+def check_for_initialization_error(response):
+    """Raise an exception if an error was returned from Initialize."""
+    if response.status < 0:
+        raise RuntimeError(f"Error: {response.error_message or response.status}")
+    if response.status > 0:
+        sys.stderr.write(f"Warning: {response.error_message or response.status}\n")
+
+
 try:
     # Open session to NI-Digital Pattern Driver with options
     init_with_options_response = nidigital_client.InitWithOptions(
@@ -119,7 +127,7 @@ def check_for_error(vi, status):
         )
     )
     vi = init_with_options_response.vi
-    check_for_error(vi, init_with_options_response.status)
+    check_for_initialization_error(init_with_options_response)
 
     load_pin_map_response = nidigital_client.LoadPinMap(
         nidigital_types.LoadPinMapRequest(

examples/nidmm/continuous-acquire-graph-multiple-points.py

@@ -72,6 +72,14 @@ def check_for_error(vi, status):
         raise Exception(error_message_response.error_message)
 
 
+def check_for_initialization_error(response):
+    """Raise an exception if an error was returned from Initialize."""
+    if response.status < 0:
+        raise RuntimeError(f"Error: {response.error_message or response.status}")
+    if response.status > 0:
+        sys.stderr.write(f"Warning: {response.error_message or response.status}\n")
+
+
 try:
     # Open session to NI-DMM with options
     init_with_options_response = nidmm_client.InitWithOptions(
@@ -80,7 +88,7 @@ def check_for_error(vi, status):
         )
     )
     vi = init_with_options_response.vi
-    check_for_error(vi, init_with_options_response.status)
+    check_for_initialization_error(init_with_options_response)
 
     # Configure measurement
     config_measurement_response = nidmm_client.ConfigureMeasurementDigits(

examples/nifgen/basic-arbitrary-waveform.py

@@ -71,6 +71,14 @@ def check_for_error(vi, status):
         raise Exception(error_message_response.error_message)
 
 
+def check_for_initialization_error(response):
+    """Raise an exception if an error was returned from Initialize."""
+    if response.status < 0:
+        raise RuntimeError(f"Error: {response.error_message or response.status}")
+    if response.status > 0:
+        sys.stderr.write(f"Warning: {response.error_message or response.status}\n")
+
+
 try:
     # Initalize NI-FGEN session
     init_with_options_resp = nifgen_client.InitWithOptions(
@@ -79,7 +87,7 @@ def check_for_error(vi, status):
         )
     )
     vi = init_with_options_resp.vi
-    check_for_error(vi, init_with_options_resp.status)
+    check_for_initialization_error(init_with_options_resp)
 
     # Configure channels
     config_channels_resp = nifgen_client.ConfigureChannels(

examples/nirfsa/getting-started-iq.py

@@ -71,8 +71,17 @@ def raise_if_error(response):
     return response
 
 
+def raise_if_initialization_error(response):
+    """Raise an exception if an error was returned from Initialize."""
+    if response.status < 0:
+        raise RuntimeError(f"Error: {response.error_message or response.status}")
+    if response.status > 0:
+        sys.stderr.write(f"Warning: {response.error_message or response.status}\n")
+    return response
+
+
 try:
-    init_response = raise_if_error(
+    init_response = raise_if_initialization_error(
         client.InitWithOptions(
             nirfsa_types.InitWithOptionsRequest(
                 session_name=SESSION_NAME, resource_name=RESOURCE, option_string=OPTIONS

examples/nirfsa/getting-started-spectrum.py

@@ -75,8 +75,17 @@ def raise_if_error(response):
     return response
 
 
+def raise_if_initialization_error(response):
+    """Raise an exception if an error was returned from Initialize."""
+    if response.status < 0:
+        raise RuntimeError(f"Error: {response.error_message or response.status}")
+    if response.status > 0:
+        sys.stderr.write(f"Warning: {response.error_message or response.status}\n")
+    return response
+
+
 try:
-    init_response = raise_if_error(
+    init_response = raise_if_initialization_error(
         client.InitWithOptions(
             nirfsa_types.InitWithOptionsRequest(
                 session_name=SESSION_NAME, resource_name=RESOURCE, option_string=OPTIONS

examples/nirfsg/getting-started-single-tone-generation.py

@@ -63,13 +63,22 @@ def raise_if_error(response):
         raise Exception(f"Error: {response.error_string}")
 
 
+def raise_if_initialization_error(response):
+    """Raise an exception if an error was returned from Initialize."""
+    if response.status < 0:
+        raise RuntimeError(f"Error: {response.error_message or response.status}")
+    if response.status > 0:
+        sys.stderr.write(f"Warning: {response.error_message or response.status}\n")
+    return response
+
+
 try:
     response = client.InitWithOptions(
         nirfsg_types.InitWithOptionsRequest(
             session_name=SESSION_NAME, resource_name=RESOURCE, option_string=OPTIONS
         )
     )
-    raise_if_error(response)
+    raise_if_initialization_error(response)
     vi = response.vi
     raise_if_error(
         client.ConfigureRF(nirfsg_types.ConfigureRFRequest(vi=vi, frequency=1e9, power_level=-5))

examples/nirfsg/reference-clock.py

@@ -61,13 +61,22 @@ def raise_if_error(response):
         raise Exception(f"Error: {response.error_string}")
 
 
+def raise_if_initialization_error(response):
+    """Raise an exception if an error was returned from Initialize."""
+    if response.status < 0:
+        raise RuntimeError(f"Error: {response.error_message or response.status}")
+    if response.status > 0:
+        sys.stderr.write(f"Warning: {response.error_message or response.status}\n")
+    return response
+
+
 try:
     response = client.InitWithOptions(
         nirfsg_types.InitWithOptionsRequest(
             session_name=SESSION_NAME, resource_name=RESOURCE, option_string=OPTIONS
         )
     )
-    raise_if_error(response)
+    raise_if_initialization_error(response)
     vi = response.vi
     raise_if_error(
         client.ConfigureRF(nirfsg_types.ConfigureRFRequest(vi=vi, frequency=1e9, power_level=-5))

examples/niscope/fetch-continuous.py

@@ -71,6 +71,14 @@ def check_for_error(vi, status):
         raise Exception(error_message_response.error_message)
 
 
+def check_for_initialization_error(response):
+    """Raise an exception if an error was returned from Initialize."""
+    if response.status < 0:
+        raise RuntimeError(f"Error: {response.error_message or response.status}")
+    if response.status > 0:
+        sys.stderr.write(f"Warning: {response.error_message or response.status}\n")
+
+
 try:
     # Open session to NI-SCOPE module with options.
     init_with_options_response = client.InitWithOptions(
@@ -79,7 +87,7 @@ def check_for_error(vi, status):
         )
     )
     vi = init_with_options_response.vi
-    check_for_error(vi, init_with_options_response.status)
+    check_for_initialization_error(init_with_options_response)
 
     # Configure vertical.
     voltage = 10.0

examples/niscope/fetch.py

@@ -68,6 +68,14 @@ def check_for_error(vi, status):
         raise Exception(error_message_response.error_message)
 
 
+def check_for_initialization_error(response):
+    """Raise an exception if an error was returned from Initialize."""
+    if response.status < 0:
+        raise RuntimeError(f"Error: {response.error_message or response.status}")
+    if response.status > 0:
+        sys.stderr.write(f"Warning: {response.error_message or response.status}\n")
+
+
 try:
     # Open session to NI-SCOPE module with options.
     init_with_options_response = client.InitWithOptions(
@@ -76,7 +84,7 @@ def check_for_error(vi, status):
         )
     )
     vi = init_with_options_response.vi
-    check_for_error(vi, init_with_options_response.status)
+    check_for_initialization_error(init_with_options_response)
 
     # Configure vertical.
     voltage = 10.0

examples/niscope/graph-measurement.py

@@ -67,6 +67,14 @@ def check_for_error(vi, status):
         raise Exception(error_message_response.error_message)
 
 
+def check_for_initialization_error(response):
+    """Raise an exception if an error was returned from Initialize."""
+    if response.status < 0:
+        raise RuntimeError(f"Error: {response.error_message or response.status}")
+    if response.status > 0:
+        sys.stderr.write(f"Warning: {response.error_message or response.status}\n")
+
+
 # Create the communication channel for the remote host (in this case we are connecting to a local
 # server) and create a connection to the NI-SCOPE service
 channel = grpc.insecure_channel(f"{SERVER_ADDRESS}:{SERVER_PORT}")
@@ -80,7 +88,7 @@ def check_for_error(vi, status):
         )
     )
     vi = init_result.vi
-    check_for_error(vi, init_result.status)
+    check_for_initialization_error(init_result)
 
     # Configure Vertical
     vertical_result = niscope_client.ConfigureVertical(

examples/niscope/plot-read-waveform.py

@@ -63,6 +63,14 @@ def check_for_error(vi, status):
         raise Exception(error_message_response.error_message)
 
 
+def check_for_initialization_error(response):
+    """Raise an exception if an error was returned from Initialize."""
+    if response.status < 0:
+        raise RuntimeError(f"Error: {response.error_message or response.status}")
+    if response.status > 0:
+        sys.stderr.write(f"Warning: {response.error_message or response.status}\n")
+
+
 # Create the communcation channel for the remote host (in this case we are connecting to a local
 # server) and create a connection to the niScope service
 channel = grpc.insecure_channel(f"{SERVER_ADDRESS}:{SERVER_PORT}")
@@ -76,7 +84,7 @@ def check_for_error(vi, status):
         )
     )
     vi = init_result.vi
-    check_for_error(vi, init_result.status)
+    check_for_initialization_error(init_result)
 
     # Configure horizontal timing
     config_result = niscope_client.ConfigureHorizontalTiming(

examples/niswitch/controlling-an-individual-relay.py

@@ -70,6 +70,14 @@ def check_for_error(vi, status):
         raise Exception(error_message_response.error_message)
 
 
+def check_for_initialization_error(response):
+    """Raise an exception if an error was returned from Initialize."""
+    if response.status < 0:
+        raise RuntimeError(f"Error: {response.error_message or response.status}")
+    if response.status > 0:
+        sys.stderr.write(f"Warning: {response.error_message or response.status}\n")
+
+
 try:
     # Open session to NI-SWITCH and set topology.
     init_with_topology_response = niswitch_client.InitWithTopology(
@@ -82,7 +90,7 @@ def check_for_error(vi, status):
         )
     )
     vi = init_with_topology_response.vi
-    check_for_error(vi, init_with_topology_response.status)
+    check_for_initialization_error(init_with_topology_response)
     print("Topology set to : ", TOPOLOGY_STRING)
 
     # Close the relay. Use values that are valid for the model being used.

examples/niswitch/software-scanning.py

@@ -71,6 +71,14 @@ def check_for_error(vi, status):
         raise Exception(error_message_response.error_message)
 
 
+def check_for_initialization_error(response):
+    """Raise an exception if an error was returned from Initialize."""
+    if response.status < 0:
+        raise RuntimeError(f"Error: {response.error_message or response.status}")
+    if response.status > 0:
+        sys.stderr.write(f"Warning: {response.error_message or response.status}\n")
+
+
 try:
     # Open session to NI-SWITCH and set topology.
     init_with_topology_response = niswitch_client.InitWithTopology(
@@ -83,7 +91,7 @@ def check_for_error(vi, status):
         )
     )
     vi = init_with_topology_response.vi
-    check_for_error(vi, init_with_topology_response.status)
+    check_for_initialization_error(init_with_topology_response)
     print("Topology set to : ", TOPOLOGY_STRING)
 
     # Configure the scan list.

generated/nidcpower/nidcpower.proto

@@ -771,6 +771,7 @@ message InitializeWithIndependentChannelsRequest {
 message InitializeWithIndependentChannelsResponse {
   int32 status = 1;
   nidevice_grpc.Session vi = 2;
+  string error_message = 3;
 }
 
 message InitiateWithChannelsRequest {
@@ -1592,6 +1593,7 @@ message InitializeWithChannelsRequest {
 message InitializeWithChannelsResponse {
   int32 status = 1;
   nidevice_grpc.Session vi = 2;
+  string error_message = 3;
 }
 
 message InitiateRequest {

generated/nidcpower/nidcpower_service.cpp

@@ -11,6 +11,7 @@
 #include <iostream>
 #include <atomic>
 #include <vector>
+#include "custom/ivi_errors.h"
 #include <server/converters.h>
 
 namespace nidcpower_grpc {
@@ -781,6 +782,10 @@ namespace nidcpower_grpc {
       if (status_ok(status)) {
         response->mutable_vi()->set_id(session_id);
       }
+      else {
+        const auto error_message = get_last_error_message(library_);
+        response->set_error_message(error_message);
+      }
       return ::grpc::Status::OK;
     }
     catch (nidevice_grpc::LibraryLoadException& ex) {
@@ -2866,6 +2871,10 @@ namespace nidcpower_grpc {
       if (status_ok(status)) {
         response->mutable_vi()->set_id(session_id);
       }
+      else {
+        const auto error_message = get_last_error_message(library_);
+        response->set_error_message(error_message);
+      }
       return ::grpc::Status::OK;
     }
     catch (nidevice_grpc::LibraryLoadException& ex) {

generated/nidigitalpattern/nidigitalpattern.proto

@@ -1324,6 +1324,7 @@ message InitRequest {
 message InitResponse {
   int32 status = 1;
   nidevice_grpc.Session vi = 2;
+  string error_message = 3;
 }
 
 message InitWithOptionsRequest {
@@ -1337,6 +1338,7 @@ message InitWithOptionsRequest {
 message InitWithOptionsResponse {
   int32 status = 1;
   nidevice_grpc.Session vi = 2;
+  string error_message = 3;
 }
 
 message InitiateRequest {