Management of YANG model defined test instruments

This walk-through is under construction.

In this walk-through we will demonstrate a programming language independent interchangeable virtual instrument interface for management of test instruments based on YANG models for 2 of the 13 Interchangeable Virtual Instrument classes:

* the IVI-4.1: IviScope Class Specification

* the IVI-4.3: IviFgen Class Specification

and demonstrate how to write testcases in Python and LabView.

Start by cloning the repositories containing the YANG model of the function generator class and its implementation:

git clone -b lsi-ivi-function-generator https://github.com/lightside-instruments/yuma123-netconfd-module.git lsi-ivi-function-generator

Before using the model interface you should confirm your implementation specific scripts are working. Here a 1KHz to 10KHz 10 second sine sweep is configured:

apt install git python3-pyvisa-py ca-certificates python3-standard-xdrlib python3-mda-xdrlib python3-setuptools

#If your instrument is network connected you need the vxi11 python3 package
git clone https://github.com/python-ivi/python-vxi11.git
cd python-vxi11
python3 setup.py install
cd ..

git clone -b lsi-ivi-function-generator https://github.com/vlvassilev/yuma123-netconfd-module.git lsi-ivi-function-generator
cd lsi-ivi-function-generator

#edit your resource handle
root@xps:/lsi-ivi-function-generator# git diff 
diff --git a/lsi-ivi-function-generator-set-hp-33120a b/lsi-ivi-function-generator-set-hp-33120a
index b995ada..8676f26 100755
--- a/lsi-ivi-function-generator-set-hp-33120a
+++ b/lsi-ivi-function-generator-set-hp-33120a
@@ -13,7 +13,7 @@ import vxi11
 
 print("Starting: %s" %(sys.argv))
 
-instr = vxi11.vxi11.Instrument("TCPIP::localhost::gpib,4::INSTR")
+instr = vxi11.vxi11.Instrument("TCPIP::10.13.37.28::gpib,4::INSTR")
 
 
 channel_num = sys.argv[1]

root@xps:/lsi-ivi-function-generator# ./lsi-ivi-function-generator-set-hp-33120a 1 on sine 10634.45 5 2.5 - 100800.00 10.00

# this should have configured your generator

... To be continued

Install the yuma123 toolchain

Follow the YANG/NETCONF on a Raspberry Pi with yuma123 walk-trough in order to install the relevant client and server applications with the necessary development packages.

YANG automated transactional network test interface for Python

curl -sS https://lightside-instruments.com/repos/lightside-instruments.gpg.key | sudo gpg --dearmor --yes -o /etc/apt/trusted.gpg.d/lightside-instruments.gpg
echo "deb https://lightside-instruments.com/repos/apt/debian bullseye main" | sudo tee /etc/apt/sources.list.d/lightside-instruments.list
apt-get update
apt-get -y install python3-tntapi

or follow this section to build and install from source.

IVI DC Power model

https://github.com/lightside-instruments/yuma123-netconfd-module/tree/lsi-ivi-dc-power

git clone https://github.com/lightside-instruments/yuma123-netconfd-module -b lsi-ivi-dc-power yuma123-netconfd-module-lsi-ivi-dc-power
cd yuma123-netconfd-module-lsi-ivi-dc-power

IVI Switch model

Now that we have a running NETCONF server we need to add a YANG module for management of the Switch/Relay actuator. We also need an implementation of the module written in C. If we do not have one the configuration changes will not have corresponding effect on the GPIO pins controlling the relays.

There is a template we can use as starting point:

git clone -b lsi-ivi-switch https://github.com/vlvassilev/yuma123-netconfd-module.git lsi-ivi-switch
autoreconf -i -f
./configure CFLAGS="-g -O0"  CXXFLAGS="-g -O0" --prefix=/usr
make
make install

Now we can start netconfd with the new module:

netconfd --module=lsi-ivi-switch  --no-startup --superuser=$USER

Programming the device

Here is a program in python that connects to the relay actuator and turns the switch connecting C1 and A1 channels on and off. Usage:

python switch-loop-netconf.py --config=networks.xml --loops=10

switch-loop-netconf.py:

#!/usr/bin/python

from lxml import etree
import time
import sys, os
import argparse
import tntapi
import yangrpc
from yangcli import yangcli


namespaces={"nc":"urn:ietf:params:xml:ns:netconf:base:1.0",
	"nd":"urn:ietf:params:xml:ns:yang:ietf-network",
	"nt":"urn:ietf:params:xml:ns:yang:ietf-network-topology"}

args=None

global args
parser = argparse.ArgumentParser()
parser.add_argument("--config", help="Path to the netconf configuration *.xml file defining the configuration according to ietf-networks, ietf-networks-topology and netconf-node models e.g. ../networks.xml")
parser.add_argument('--loops', default=[],help="Loop count.")
args = parser.parse_args()

tree=etree.parse(args.config)
network = tree.xpath('/nc:config/nd:networks/nd:network', namespaces=namespaces)[0]

conns = tntapi.network_connect(network)
yconns = tntapi.network_connect_yangrpc(network)

for node_name in yconns.keys():
	ok=yangcli(yconns[node_name],"""delete /channels""").xpath('./ok')
	tntapi.network_commit(conns)

for i in range(1,int(args.loops)):
	for node_name in yconns.keys():
		ok=yangcli(yconns[node_name],"""create /channels/channel[name='a1']/connections -- connection='c1'""").xpath('./ok')
		assert(len(ok)==1)
		ok=yangcli(yconns[node_name],"""create /channels/channel[name='c1']""").xpath('./ok')
		assert(len(ok)==1)
	tntapi.network_commit(conns)
	for node_name in yconns.keys():
		ok=yangcli(yconns[node_name],"""delete /channels""").xpath('./ok')
		assert(len(ok)==1)
	tntapi.network_commit(conns)