Adding Sequence Registers and Flags Example in NI-Digital

CHANGELOG.md

@@ -558,6 +558,7 @@
 #### [nidigital] Unreleased
 - Added
   - (Common) Added `nitlsconfig[grpc]>=1.0.0a2` to the optional gRPC dependencies.
+  - Added the `nidigital_sequence_registers_and_flags.py` example.
 - Changed
 - Removed
 

docs/nidigital/examples.rst

@@ -30,3 +30,12 @@ nidigital_ppmu_source_and_measure.py
    :encoding: utf8
    :caption: `(nidigital_ppmu_source_and_measure.py) <https://github.com/ni/nimi-python/blob/master/src/nidigital/examples/ppmu_source_and_measure/nidigital_ppmu_source_and_measure.py>`_
 
+nidigital_sequence_registers_and_flags.py
+-----------------------------------------
+
+.. literalinclude:: ../../src/nidigital/examples/sequence_registers_and_flags/nidigital_sequence_registers_and_flags.py
+   :language: python
+   :linenos:
+   :encoding: utf8
+   :caption: `(nidigital_sequence_registers_and_flags.py) <https://github.com/ni/nimi-python/blob/master/src/nidigital/examples/sequence_registers_and_flags/nidigital_sequence_registers_and_flags.py>`_
+

src/nidigital/examples/sequence_registers_and_flags/PinLevels.digilevels

@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="utf-8"?>
+<PinLevelsFile xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" schemaVersion="1.0" xmlns="http://www.ni.com/Semiconductor/PinLevels">
+  <PinLevelsSheet>
+    <DigitalPinLevelSets>
+      <DigitalPinLevelSet pin="PinGroup1">
+        <Vil>0</Vil>
+        <Vih>3.3</Vih>
+        <Vol>0.8</Vol>
+        <Voh>2</Voh>
+        <Vterm>0</Vterm>
+        <TerminationMode>HighZ</TerminationMode>
+      </DigitalPinLevelSet>
+    </DigitalPinLevelSets>
+  </PinLevelsSheet>
+</PinLevelsFile>

src/nidigital/examples/sequence_registers_and_flags/PinMap.pinmap

@@ -0,0 +1,51 @@
+<?xml version="1.0" encoding="utf-8"?>
+<PinMap xmlns="http://www.ni.com/TestStand/SemiconductorModule/PinMap.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" schemaVersion="1.5">
+	<Instruments>
+		<NIDigitalPatternInstrument name="PXI1Slot2" numberOfChannels="32" group="Digital" />
+		<NIDigitalPatternInstrument name="PXI1Slot3" numberOfChannels="32" group="Digital" />
+	</Instruments>
+	<Pins>
+		<DUTPin name="DUTPin1" />
+		<DUTPin name="DUTPin2" />
+		<DUTPin name="DUTPin3" />
+		<DUTPin name="DUTPin4" />
+		<DUTPin name="DUTPin5" />
+		<DUTPin name="DUTPin6" />
+		<DUTPin name="DUTPin7" />
+		<DUTPin name="DUTPin8" />
+	</Pins>
+	<PinGroups>
+		<PinGroup name="PinGroup1">
+			<PinReference pin="DUTPin1" />
+			<PinReference pin="DUTPin2" />
+			<PinReference pin="DUTPin3" />
+			<PinReference pin="DUTPin4" />
+			<PinReference pin="DUTPin5" />
+			<PinReference pin="DUTPin6" />
+			<PinReference pin="DUTPin7" />
+			<PinReference pin="DUTPin8" />
+		</PinGroup>
+	</PinGroups>
+	<Sites>
+		<Site siteNumber="0" />
+		<Site siteNumber="1" />
+	</Sites>
+	<Connections>
+		<Connection pin="DUTPin1" siteNumber="0" instrument="PXI1Slot2" channel="0" />
+		<Connection pin="DUTPin1" siteNumber="1" instrument="PXI1Slot3" channel="0" />
+		<Connection pin="DUTPin2" siteNumber="0" instrument="PXI1Slot2" channel="1" />
+		<Connection pin="DUTPin2" siteNumber="1" instrument="PXI1Slot3" channel="1" />
+		<Connection pin="DUTPin3" siteNumber="0" instrument="PXI1Slot2" channel="2" />
+		<Connection pin="DUTPin3" siteNumber="1" instrument="PXI1Slot3" channel="2" />
+		<Connection pin="DUTPin4" siteNumber="0" instrument="PXI1Slot2" channel="3" />
+		<Connection pin="DUTPin4" siteNumber="1" instrument="PXI1Slot3" channel="3" />
+		<Connection pin="DUTPin5" siteNumber="0" instrument="PXI1Slot2" channel="4" />
+		<Connection pin="DUTPin5" siteNumber="1" instrument="PXI1Slot3" channel="4" />
+		<Connection pin="DUTPin6" siteNumber="0" instrument="PXI1Slot2" channel="5" />
+		<Connection pin="DUTPin6" siteNumber="1" instrument="PXI1Slot3" channel="5" />
+		<Connection pin="DUTPin7" siteNumber="0" instrument="PXI1Slot2" channel="6" />
+		<Connection pin="DUTPin7" siteNumber="1" instrument="PXI1Slot3" channel="6" />
+		<Connection pin="DUTPin8" siteNumber="0" instrument="PXI1Slot2" channel="7" />
+		<Connection pin="DUTPin8" siteNumber="1" instrument="PXI1Slot3" channel="7" />
+	</Connections>
+</PinMap>

src/nidigital/examples/sequence_registers_and_flags/Specifications.specs

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<Specifications xmlns:f="http://www.ni.com/schemas/Semiconductor/Formula.xsd" schemaVersion="1.0" xmlns="http://www.ni.com/schemas/Semiconductor/Specifications.xsd">
+  <Section name="timing">
+    <f:Formula symbol="period">
+      <f:Definition>1 µs</f:Definition>
+    </f:Formula>
+  </Section>
+  <Description />
+</Specifications>

src/nidigital/examples/sequence_registers_and_flags/Timing.digitiming

@@ -0,0 +1,23 @@
+<?xml version="1.0" encoding="utf-8"?>
+<TimingFile xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" schemaVersion="1.0" xmlns="http://www.ni.com/Semiconductor/Timing">
+  <TimingSheet>
+    <TimeSets>
+      <TimeSet name="tset0">
+        <Period>timing.period</Period>
+        <PinEdges>
+          <PinEdge pin="PinGroup1">
+            <DriveNonReturn>
+              <On>0 ns</On>
+              <Data>timing.period / 2</Data>
+              <Off>timing.period</Off>
+            </DriveNonReturn>
+            <CompareStrobe>
+              <Strobe>(3 * timing.period) / 4</Strobe>
+            </CompareStrobe>
+            <DataSource>Pattern</DataSource>
+          </PinEdge>
+        </PinEdges>
+      </TimeSet>
+    </TimeSets>
+  </TimingSheet>
+</TimingFile>

src/nidigital/examples/sequence_registers_and_flags/nidigital_sequence_registers_and_flags.py

@@ -0,0 +1,82 @@
+#!/usr/bin/python
+
+import argparse
+import nidigital
+import os
+import sys
+import time
+
+
+def example(resource_name, options):
+
+    with nidigital.Session(resource_name=resource_name, reset_device=True, options=options) as session:
+
+        example_dir = os.path.dirname(__file__)
+        pin_map_filename = os.path.join(example_dir, 'PinMap.pinmap')
+        session.load_pin_map(pin_map_filename)
+
+        spec_filename = os.path.join(example_dir, 'Specifications.specs')
+        levels_filename = os.path.join(example_dir, 'PinLevels.digilevels')
+        timing_filename = os.path.join(example_dir, 'Timing.digitiming')
+        session.load_specifications_levels_and_timing(spec_filename, levels_filename, timing_filename)
+        session.apply_levels_and_timing(levels_filename, timing_filename)
+
+        pattern_filename = os.path.join(example_dir, 'Pattern.digipat')
+        session.load_pattern(pattern_filename)
+
+        try:
+            session.write_sequencer_register(nidigital.SequencerRegister.REGISTER0, 100)
+
+            print('Start bursting pattern')
+            session.burst_pattern(start_label='new_pattern', wait_until_done=False)
+
+            session.write_sequencer_register(nidigital.SequencerRegister.REGISTER1, 50)
+            register_value = session.read_sequencer_register(nidigital.SequencerRegister.REGISTER1)
+
+            flag0_state = session.read_sequencer_flag(nidigital.SequencerFlag.FLAG0)
+            if session.simulate:
+                # Simulated hardware does not update sequencer flag states.
+                session.write_sequencer_flag(nidigital.SequencerFlag.FLAG1, True)
+            else:
+                while not flag0_state:
+                    time.sleep(0.01)
+                    flag0_state = session.read_sequencer_flag(nidigital.SequencerFlag.FLAG0)
+                input('Press Enter to write seqflag1 as True: ')
+                session.write_sequencer_flag(nidigital.SequencerFlag.FLAG1, True)
+
+            flag0_state = session.read_sequencer_flag(nidigital.SequencerFlag.FLAG0)
+            flag1_state = session.read_sequencer_flag(nidigital.SequencerFlag.FLAG1)
+            print(f'reg1 value: {register_value}, seqflag0 state: {flag0_state}, seqflag1 state: {flag1_state}')
+
+            session.wait_until_done()
+        finally:
+            session.selected_function = nidigital.SelectedFunction.DISCONNECT
+    print('Done bursting pattern')
+
+
+def _main(argsv):
+    parser = argparse.ArgumentParser(description='Demonstrates how to read and write sequencer registers and flags during a digital pattern.', formatter_class=argparse.ArgumentDefaultsHelpFormatter)
+    parser.add_argument('-n', '--resource-name', default='PXI1Slot2,PXI1Slot3', help='The specified resource name shown in Measurement & Automation Explorer (MAX) for a digital pattern instrument.')
+    parser.add_argument('-s', '--simulate', default='True', choices=['True', 'False'], help='Whether to run on simulated hardware or real hardware')
+    args = parser.parse_args(argsv)
+
+    options = 'Simulate=1, DriverSetup=Model:6570' if args.simulate == 'True' else ''
+    example(args.resource_name, options)
+
+
+def main():
+    _main(sys.argv[1:])
+
+
+def test_main():
+    _main([])
+
+
+def test_example():
+    resource_name = 'PXI1Slot2,PXI1Slot3'
+    options = {'simulate': True, 'driver_setup': {'Model': '6570'}, }
+    example(resource_name, options)
+
+
+if __name__ == '__main__':
+    main()

src/nidigital/examples/sequence_registers_and_flags/sequence_registers_and_flags.digiproj

@@ -0,0 +1,38 @@
+<?xml version="1.0" encoding="utf-8"?>
+<SourceFile Checksum="489B91C8C0B8DB62C090C7485CA12671" xmlns="http://www.ni.com/PlatformFramework">
+	<SourceModelFeatureSet>
+		<ParsableNamespace AssemblyFileVersion="5.3.1.50584" FeatureSetName="Digital Pattern Editor" Name="http://www.ni.com/PatternBasedDigital" OldestCompatibleVersion="4.5.0.0" Version="4.6.0.49152" />
+		<ParsableNamespace AssemblyFileVersion="5.3.1.50584" FeatureSetName="Editor" Name="http://www.ni.com/PlatformFramework" OldestCompatibleVersion="5.2.0.49153" Version="5.2.0.49153" />
+		<ApplicationVersionInfo Build="5.3.1.50584" Name="Digital Pattern Editor" Version="19.0.0" />
+	</SourceModelFeatureSet>
+	<Project xmlns="http://www.ni.com/PlatformFramework">
+		<ProjectSettings Id="1" ModelDefinitionType="ProjectSettings" Name="ZProjectSettings" />
+		<EmbeddedDefinitionReference Id="2" ModelDefinitionType="NationalInstruments.ProjectExplorer.Modeling.ProjectDataManager" Name="ProjectExplorer">
+			<ProjectExplorer />
+		</EmbeddedDefinitionReference>
+		<NameScopingEnvoy Id="3" ModelDefinitionType="DefaultTarget" Name="DefaultTarget">
+			<DefaultTarget />
+			<FileReference Id="15" ModelDefinitionType="DigitalPatternEditor.PatternDefinition" Name="Pattern\.digipat" StoragePath="Pattern.digipat" />
+			<FileReference Id="16" ModelDefinitionType="PinLevelsDefinition" Name="PinLevels\.digilevels" StoragePath="PinLevels.digilevels" p4:IsActive="True" xmlns:p4="http://www.ni.com/PatternBasedDigital" />
+			<FileReference Id="17" ModelDefinitionType="SpecificationsDefinition" Name="Specifications\.specs" StoragePath="Specifications.specs" />
+			<FileReference Id="18" ModelDefinitionType="PinMap" Name="PinMap\.pinmap" StoragePath="PinMap.pinmap" p4:IsActive="True" xmlns:p4="http://www.ni.com/PatternBasedDigital" />
+			<FileReference Id="19" ModelDefinitionType="TimingDefinition" Name="Timing\.digitiming" StoragePath="Timing.digitiming" p4:IsActive="True" xmlns:p4="http://www.ni.com/PatternBasedDigital" />
+			<EmbeddedDefinitionReference Id="20" ModelDefinitionType="{http://www.ni.com/PatternBasedDigital}CaptureResultsDefinition" Name="CaptureResults">
+				<CaptureResultsDefinition xmlns="http://www.ni.com/PatternBasedDigital" />
+			</EmbeddedDefinitionReference>
+			<EmbeddedDefinitionReference Id="22" ModelDefinitionType="{http://www.ni.com/PatternBasedDigital}BurstResultsDefinition" Name="BurstResults">
+				<BurstResultsDefinition xmlns="http://www.ni.com/PatternBasedDigital" />
+			</EmbeddedDefinitionReference>
+			<EmbeddedDefinitionReference Id="24" ModelDefinitionType="{http://www.ni.com/PatternBasedDigital}SystemInfoDefinition" Name="SystemInfo">
+				<SystemInfoDefinition xmlns="http://www.ni.com/PatternBasedDigital" />
+			</EmbeddedDefinitionReference>
+			<EmbeddedDefinitionReference Id="25" ModelDefinitionType="{http://www.ni.com/PatternBasedDigital}DigitalScopeDefinition" Name="DigitalScope">
+				<DigitalScopeDefinition xmlns="http://www.ni.com/PatternBasedDigital" />
+			</EmbeddedDefinitionReference>
+		</NameScopingEnvoy>
+		<EmbeddedDefinitionReference Id="7" ModelDefinitionType="DigitalPatternEditor.ProjectPropertiesDefinition" Name="ProjectProperties">
+			<ProjectPropertiesDefinition xmlns="http://www.ni.com/PatternBasedDigital" />
+		</EmbeddedDefinitionReference>
+	</Project>
+	<ProjectInformation xmlns="http://www.ni.com/PlatformFramework" />
+</SourceFile>