origen_std_lib 0.10.1 → 0.11.0

data/src/advantest/smt7/origen/origen/utils/version.cpp

@@ -0,0 +1,72 @@
+#include "version.hpp"
+using namespace std;
+
+#include <sstream>
+
+namespace Origen {
+namespace Utils {
+
+Version::Version(string ver) {
+  vector<int> v = parse(ver);
+  _major = v[0];
+  _minor = v[1];
+  _tiny = v[2];
+}
+
+int Version::major() { return _major; }
+int Version::minor() { return _minor; }
+int Version::tiny() { return _tiny; }
+
+string Version::str() {
+  ostringstream str;
+  str << _major;
+  str << ".";
+  str << _minor;
+  str << ".";
+  str << _tiny;
+  return str.str();
+}
+
+bool Version::operator==(string rhs) {
+  vector<int> v = parse(rhs);
+  return _major == v[0] && _minor == v[1] && _tiny == v[2];
+}
+
+bool Version::operator!=(string rhs) {
+  vector<int> v = parse(rhs);
+  return _major != v[0] || _minor != v[1] || _tiny != v[2];
+}
+
+bool Version::operator<(string rhs) {
+  vector<int> v = parse(rhs);
+  return _major < v[0] || (_major == v[0] && _minor < v[1]) ||
+         (_major == v[0] && _minor == v[1] && _tiny < v[2]);
+}
+
+bool Version::operator<=(string rhs) {
+  return operator==(rhs) || operator<(rhs);
+}
+
+bool Version::operator>(string rhs) {
+  vector<int> v = parse(rhs);
+  return _major > v[0] || (_major == v[0] && _minor > v[1]) ||
+         (_major == v[0] && _minor == v[1] && _tiny > v[2]);
+}
+
+bool Version::operator>=(string rhs) {
+  return operator==(rhs) || operator>(rhs);
+}
+
+vector<int> Version::parse(string ver) {
+  vector<int> v(3);
+
+  istringstream parser(ver);
+  parser >> v[0];
+  for (int i = 1; i < 3; i++) {
+    parser.get();  // Skip dot
+    parser >> v[i];
+  }
+  return v;
+}
+}
+}

data/{stdlib/v93k → src/advantest/smt7}/origen/origen/utils/version.hpp

@@ -3,7 +3,8 @@
 
 // GCC adds these macros by default, which clobbers our functions
 // of the same name
-#if (defined(__GNUC__) || defined(__GNUG__)) && !(defined(__clang__) || defined(__INTEL_COMPILER))
+#if (defined(__GNUC__) || defined(__GNUG__)) && \
+    !(defined(__clang__) || defined(__INTEL_COMPILER))
 // Not exactly sure the version that this becomes a problem, but for
 // now this fixes the build on the V93K production system
 #if (__GNUC_MINOR__ > 1)
@@ -37,27 +38,25 @@ namespace Utils {
 //     // Do something
 //   }
 class Version {
-
-private:
-    vector<int> parse(string ver);
-    int _major;
-    int _minor;
-    int _tiny;
-
-public:
-    int major();
-    int minor();
-    int tiny();
-    Version(string ver);
-    bool operator==(string rhs);
-    bool operator!=(string rhs);
-    bool operator<(string rhs);
-    bool operator<=(string rhs);
-    bool operator>(string rhs);
-    bool operator>=(string rhs);
-    string str();
+ private:
+  vector<int> parse(string ver);
+  int _major;
+  int _minor;
+  int _tiny;
+
+ public:
+  int major();
+  int minor();
+  int tiny();
+  Version(string ver);
+  bool operator==(string rhs);
+  bool operator!=(string rhs);
+  bool operator<(string rhs);
+  bool operator<=(string rhs);
+  bool operator>(string rhs);
+  bool operator>=(string rhs);
+  string str();
 };
-
 }
 }
 

data/src/advantest/smt7/origen/test_methods/ApplyBin.cpp

@@ -0,0 +1,37 @@
+#include "testmethod.hpp"
+
+// for test method API interfaces
+#include "mapi.hpp"
+using namespace std;
+#include "origen.hpp"
+
+/**
+ * Test method class.
+ *
+ * For each testsuite using this test method, one object of this
+ * class is created.
+ */
+class OrigenApplyBin : public testmethod::TestMethod {
+ protected:
+  /**
+   *Initialize the parameter interface to the testflow.
+   *This method is called just once after a testsuite is created.
+   */
+  virtual void initialize() {
+    // Add your initialization code here
+    // Note: Test Method API should not be used in this method!
+  }
+
+  /**
+   *This test is invoked per site.
+   */
+  virtual void run() {
+    if (Origen::site().bin() || Origen::site().softbin()) {
+      stringstream softbin;
+      softbin << Origen::site().softbin();
+      SET_MULTIBIN(softbin.str(), Origen::site().bin());
+      TESTSET().judgeAndLog_FunctionalTest(false);
+    }
+  }
+};
+REGISTER_TESTMETHOD("ApplyBin", OrigenApplyBin);

data/src/advantest/smt7/origen/test_methods/DCMeasurement.cpp

@@ -0,0 +1,90 @@
+#include "origen/test_method/dc_measurement.hpp"
+
+/**
+ * Test method class.
+ *
+ * For each testsuite using this test method, one object of this
+ * class is created.
+ */
+class OrigenDCMeasurement : public Origen::TestMethod::DCMeasurement {
+ protected:
+  int mApplyShutdown;
+  string mShutdownPattern;
+  string mMeasure;
+  double mSettlingTime;
+  string mPin;
+  string mPort;
+  double mForceValue;
+  double mIRange;
+  int mCheckShutdown;
+  int mBadc;
+
+ protected:
+  /**
+   *Initialize the parameter interface to the testflow.
+   *This method is called just once after a testsuite is created.
+   */
+  virtual void init() {
+    // Add your initialization code here
+    // Note: Test Method API should not be used in this method!
+    addParameter("applyShutdown", "int", &mApplyShutdown,
+                 testmethod::TM_PARAMETER_INPUT)
+        .setDefault("1")
+        .setComment("Apply a shutdown pattern after taking the measurement");
+    addParameter("shutdownPattern", "string", &mShutdownPattern,
+                 testmethod::TM_PARAMETER_INPUT)
+        .setComment(
+            "The name of the shutdown pattern, by default it will be the main "
+            "pattern name appended with '_part1'");
+    addParameter("checkShutdown", "int", &mCheckShutdown,
+                 testmethod::TM_PARAMETER_INPUT)
+        .setDefault("1")
+        .setComment("Check that the shutdown pattern passed (and fail if not)");
+    addParameter("measure", "string", &mMeasure, testmethod::TM_PARAMETER_INPUT)
+        .setDefault("VOLT")
+        .setComment("Measure 'CURR' or 'VOLT' (the default)");
+    addParameter("settlingTime", "double", &mSettlingTime,
+                 testmethod::TM_PARAMETER_INPUT)
+        .setDefault("0")
+        .setComment(
+            "Time to wait between running the pattern and taking the "
+            "measurement, expressed in ms");
+    addParameter("pin", "PinString", &mPin, testmethod::TM_PARAMETER_INPUT)
+        .setComment("Pin to be measured");
+    addParameter("port", "string", &mPort, testmethod::TM_PARAMETER_INPUT)
+        .setDefault("")
+        .setComment("Port the pattern is to be executed on");
+    addParameter("forceValue", "double", &mForceValue,
+                 testmethod::TM_PARAMETER_INPUT)
+        .setDefault("0")
+        .setComment("Value to be forced on the pin during the measurement");
+    addParameter("iRange", "double", &mIRange, testmethod::TM_PARAMETER_INPUT)
+        .setDefault("0")
+        .setComment(
+            "The current range to apply to the measurement (in A), will be "
+            "calculated if not supplied (set to 0)");
+    addParameter("badc", "int", &mBadc, testmethod::TM_PARAMETER_INPUT)
+        .setDefault("0")
+        .setComment(
+            "Perform the measurement using the Board ADC (rather than the "
+            "PPMU)");
+  }
+
+  /**
+   *This test is invoked per site.
+   */
+  virtual void body() {
+    origen.applyShutdown(mApplyShutdown)
+        .forceValue(mForceValue)
+        .shutdownPattern(mShutdownPattern)
+        .checkShutdown(mCheckShutdown)
+        .measure(mMeasure)
+        .settlingTime(mSettlingTime)
+        .pin(mPin)
+        .port(mPort)
+        .iRange(mIRange)
+        .badc(mBadc)
+        .execute();
+  }
+};
+REGISTER_TESTMETHOD("DCMeasurement", OrigenDCMeasurement);

data/src/advantest/smt7/origen/test_methods/FrequencyMeasurement.cpp

@@ -0,0 +1,50 @@
+#include "origen/test_method/frequency_measurement.hpp"
+
+class OrigenFrequencyMeasurement
+    : public Origen::TestMethod::FrequencyMeasurement {
+ protected:
+  int mPeriodBased;
+  string mPin;
+  string mPort;
+  int mSamples;
+  int mPeriodInNs;
+
+ protected:
+  /**
+   *Initialize the parameter interface to the testflow.
+   *This method is called just once after a testsuite is created.
+   */
+  virtual void init() {
+    addParameter("periodBased", "int", &mPeriodBased,
+                 testmethod::TM_PARAMETER_INPUT)
+        .setDefault("0")
+        .setComment(
+            "Set to 1 if the limits are expressed as a period instead of a "
+            "frequency (the default)");
+    addParameter("pin", "PinString", &mPin, testmethod::TM_PARAMETER_INPUT)
+        .setComment("Pin to be measured");
+    addParameter("port", "string", &mPort, testmethod::TM_PARAMETER_INPUT)
+        .setDefault("")
+        .setComment("Port the pattern is to be executed on");
+    addParameter("samples", "int", &mSamples, testmethod::TM_PARAMETER_INPUT)
+        .setDefault("2000")
+        .setComment(
+            "The number of captures made by the pattern, defaults to 2000");
+    addParameter("periodInNs", "int", &mPeriodInNs,
+                 testmethod::TM_PARAMETER_INPUT)
+        .setComment("The period of the capture vectors");
+  }
+
+  /**
+   *This test is invoked per site.
+   */
+  virtual void body() {
+    origen.periodBased(mPeriodBased)
+        .pin(mPin)
+        .port(mPort)
+        .samples(mSamples)
+        .periodInNs(mPeriodInNs)
+        .execute();
+  }
+};
+REGISTER_TESTMETHOD("FrequencyMeasurement", OrigenFrequencyMeasurement);

data/src/advantest/smt7/origen/test_methods/FunctionalTest.cpp

@@ -0,0 +1,24 @@
+#include "origen/test_method/functional_test.hpp"
+
+class OrigenFunctionalTest : public Origen::TestMethod::FunctionalTest {
+ protected:
+  string mPort;
+
+ protected:
+  /**
+   *Initialize the parameter interface to the testflow.
+   *This method is called just once after a testsuite is created.
+   */
+  virtual void init() {
+    // NOTE: The capture arguments are not listed here since it makes no sense
+    // to use them without
+    //       corresponding functions to handle the captured data
+
+    addParameter("port", "string", &mPort, testmethod::TM_PARAMETER_INPUT)
+        .setDefault("")
+        .setComment("Port the pattern is to be executed on");
+  }
+
+  virtual void body() { origen.port(mPort).execute(); }
+};
+REGISTER_TESTMETHOD("FunctionalTest", OrigenFunctionalTest);

data/src/advantest/smt7/origen/test_methods/RecordBin.cpp

@@ -0,0 +1,39 @@
+#include "testmethod.hpp"
+
+// for test method API interfaces
+#include "mapi.hpp"
+using namespace std;
+#include "origen.hpp"
+
+/**
+ * Test method class.
+ *
+ * For each testsuite using this test method, one object of this
+ * class is created.
+ */
+class OrigenRecordBin : public testmethod::TestMethod {
+ protected:
+  int mBin;
+  int mSoftbin;
+
+ protected:
+  /**
+   *Initialize the parameter interface to the testflow.
+   *This method is called just once after a testsuite is created.
+   */
+  virtual void initialize() {
+    // Add your initialization code here
+    // Note: Test Method API should not be used in this method!
+    addParameter("bin", "int", &mBin, testmethod::TM_PARAMETER_INPUT);
+    addParameter("softbin", "int", &mSoftbin, testmethod::TM_PARAMETER_INPUT);
+  }
+
+  /**
+   *This test is invoked per site.
+   */
+  virtual void run() {
+    Origen::site().bin(mBin);
+    Origen::site().softbin(mSoftbin);
+  }
+};
+REGISTER_TESTMETHOD("RecordBin", OrigenRecordBin);

data/src/advantest/smt8/origen/common/Origen.java

@@ -0,0 +1,334 @@
+package origen.common;
+
+import java.util.List;
+import xoc.dta.ITestContext;
+import xoc.dta.datatypes.MultiSiteLong;
+import xoc.dta.datatypes.MultiSiteString;
+import xoc.dta.measurement.IMeasurement;
+import xoc.dta.setupaccess.IPattern;
+import xoc.dta.signals.ISignal;
+
+public class Origen {
+
+  /**
+   * Define the different loglevels <br>
+   * Internally the SMT8 logging system will be used (message()) the constants here just work as
+   * shorthand for default use cases
+   */
+  public static final int LOG_METHODTRACE = 9;
+
+  public static final int LOG_DATA = 10;
+  public static final int LOG_PARAM = 3;
+  public static final int LOG_FUNC = 4;
+  public static final int LOG_FAIL = 2;
+  public static final int LOG_WARNING = 1;
+  public static final int LOG_ERROR = 0;
+
+  // All general multisite variables
+  // The booleans keep track of their state, these are not multisite since we only use multisite
+  // assignments for the _vars
+  private static MultiSiteString _lotid;
+  private static boolean _lotidSet;
+
+  private static MultiSiteLong _wafer;
+  private static boolean _waferSet;
+
+  private static MultiSiteLong _x;
+  private static boolean _xSet;
+
+  private static MultiSiteLong _y;
+  private static boolean _ySet;
+
+  private static MultiSiteLong _blockCycles;
+  private static boolean _blockCyclesSet;
+
+  private static MultiSiteLong _pageCycles;
+  private static boolean _pageCyclesSet;
+
+  public static ITestContext context;
+  public static IMeasurement meas;
+
+  /**
+   * Implementing the SMT8 message system also for this non-TM class. Perhaps not the prettiest
+   * thing to do but it fixes the logging. The context needs to be set from a TM (like Base)
+   *
+   * @param level
+   * @param msg
+   */
+  @SuppressWarnings("deprecation")
+  public static void message(int level, String msg) {
+    // No longer works on SMT 8.2, should this function be removed completely?
+    // context.message(level,msg);
+  }
+
+  public Origen() {
+    _lotidSet = false;
+    _waferSet = false;
+    _xSet = false;
+    _ySet = false;
+  }
+
+  /**
+   * Returns the IPattern from the name of the pattern
+   *
+   * @param patname
+   * @return
+   */
+  public static IPattern getPat(String patname) {
+    return context.pattern(patname);
+  }
+
+  /**
+   * Patch data per site
+   *
+   * @param subroutinePattern Name of the pattern to patch
+   * @param pin Name of the pin to use
+   * @param decData The data to patch with
+   * @param size The amount of vectors to patch
+   */
+  public static void overlaySubroutinePerSite(
+      String subroutinePattern, String pin, MultiSiteLong decData, int size) {
+    message(Origen.LOG_METHODTRACE, "Performing patching on " + subroutinePattern);
+    OrigenHelpers.overlaySubroutine(
+        getPat(subroutinePattern),
+        Origen.pinFromGroup(pin),
+        decData,
+        size,
+        context.getActiveSites());
+  }
+
+  /**
+   * Patch the same data to all sites
+   *
+   * @param subroutinePattern Name of the pattern to patch
+   * @param pin Name of the pin to use
+   * @param decData The data to patch with
+   * @param size The amount of vectors to patch
+   */
+  public static void overlaySubroutineAllSites(
+      String subroutinePattern, String pin, long decData, int size) {
+    message(Origen.LOG_METHODTRACE, "Performing patching on " + subroutinePattern);
+    OrigenHelpers.overlaySubroutine(
+        getPat(subroutinePattern), Origen.pinFromGroup(pin), decData, size);
+  }
+
+  /**
+   * Get 1 pin name from a pingroup. Throws an exception if the group contains more than 1 pin
+   *
+   * @param group
+   * @return
+   */
+  public static String pinFromGroup(String group) {
+    List<ISignal> dutGroup = meas.getSignalGroup(group).getDutSignals();
+    if (dutGroup.size() > 1) {
+      throw new NumberFormatException("Can only patch one signal at a time");
+    }
+    return dutGroup.get(0).toString();
+  }
+
+  //    /**
+  //     * Debug function to display the STDF variables to check if they are properly setup
+  //     */
+  //    public static void showDieInfoFromSTDF() {
+  //      MultiSiteLong x_coord =context.testProgram().variables().getLong("STDF.X_COORD");
+  //      MultiSiteLong y_coord =context.testProgram().variables().getLong("STDF.Y_COORD");
+  //      MultiSiteString wafer_id =context.testProgram().variables().getString("STDF.WAFER_ID");
+  //      MultiSiteString lot_id =context.testProgram().variables().getString("STDF.LOT_ID");
+  //      String sublot_id =context.testProgram().variables().getString("STDF.SBLOT_ID").get();
+  //      message(Origen.LOG_DATA,"Wafer_id:" + wafer_id);
+  //      message(Origen.LOG_DATA,"Lot_id:" + lot_id);
+  //      message(Origen.LOG_DATA,"Sublot_id:" + sublot_id);
+  //      message(Origen.LOG_DATA,"(x,y):(" + x_coord + "," + y_coord + ")");
+  //    }
+
+  /** Set the lot ID to the given value, e.g. "ABC1234" */
+  public static void lotid(MultiSiteString v) {
+    _lotid = v;
+    _lotidSet = true;
+  }
+
+  /** Convert long value to 8 character ASCII string */
+  private static String toASCII(long value) {
+    int length = 8;
+    StringBuilder builder = new StringBuilder(length);
+    for (int i = length - 1; i >= 0; i--) {
+      builder.append((char) ((value >> (8 * i)) & 0xFF));
+    }
+    return builder.toString();
+  }
+
+  /** Set the lot ID based on the integer representation returned from lotidInt */
+  public static void lotid(MultiSiteLong v) {
+    MultiSiteString lotStr = new MultiSiteString("");
+    for (int site : v.getActiveSites()) {
+      long val = v.get(site);
+      lotStr.set(site, toASCII(val));
+    }
+    lotid(lotStr);
+  }
+
+  /* Get the lot ID. If it has not previously been set to a value it will be automatically queried
+   * from the test system.
+   */
+  public static MultiSiteString lotid() {
+    if (!_lotidSet) {
+      MultiSiteString lot_id =
+          context.testProgram().variables().getString("STDF.WAFER_ID"); // for use with prober
+      //            MultiSiteString lot_id = new MultiSiteString("TR7T7290W25D0"); // for debug
+      // purpose
+
+      MultiSiteString batch_id = new MultiSiteString();
+      for (int site : context.getActiveSites()) {
+        String perSiteWID = lot_id.get(site); // per site string contains batch id & wafer number
+        String sBatch =
+            perSiteWID.substring(
+                0, Math.min(perSiteWID.length(), 8)); // this will give you batch id
+        batch_id.set(site, sBatch);
+        System.out.println("Wafer batch " + sBatch);
+      }
+
+      _lotid = batch_id; // store the batch number
+      //          _lotidSet = true;
+    }
+
+    return _lotid;
+  }
+
+  /**
+   * Returns the lot ID as a 64-bit integer that is suitable for programming to the device. Each
+   * character in the lotID is converted to its ASCII code. An error will be raised if the length of
+   * the current lotID overflows 64-bits.STDF.WAFER_ID
+   */
+  public static MultiSiteLong lotidInt() {
+    MultiSiteLong tempLong = new MultiSiteLong();
+    MultiSiteString lotid = lotid();
+    for (int site : lotid.getActiveSites()) {
+      String id = lotid.get(site);
+
+      // Convert each character to ascii using 2 hex (8 bytes)
+      StringBuilder sb = new StringBuilder();
+      char[] letters = id.toCharArray();
+      for (char ch : letters) {
+        sb.append(Long.toHexString(ch));
+      }
+      // Convert the hex string to long again
+      tempLong.set(site, Long.parseLong(sb.toString(), 16));
+    }
+    return tempLong;
+  }
+
+  /** Set the wafer number to the given value */
+  public static void wafer(MultiSiteLong valMSL) {
+    _wafer = valMSL;
+    _waferSet = true;
+  }
+
+  /**
+   * Get the wafer number. If it has not previously been set to a value it will be automatically
+   * queried from the test system.
+   */
+  public static MultiSiteLong wafer() {
+    if (!_waferSet) {
+      MultiSiteString wafer_id =
+          context.testProgram().variables().getString("STDF.WAFER_ID"); // for use with prober
+      //            MultiSiteString wafer_id = new MultiSiteString("TR7T7290W55D0"); // for debug
+      // purpose
+
+      // Expect to return something like "TR7T7290W25D0)", where 25 is the wafer number
+
+      MultiSiteLong mslWnum = new MultiSiteLong(0);
+      for (int site : context.getActiveSites()) {
+        String perSiteWID = wafer_id.get(site); // per site string contains batch id & wafer number
+        String sWnum =
+            perSiteWID.substring(
+                perSiteWID.length() - 4,
+                perSiteWID.length() - 2); // extracted wafer number as string
+        Long lWnum = new Long(sWnum); // wafer number in Long
+        mslWnum.set(site, lWnum);
+        System.out.println("Wafer number " + lWnum);
+      }
+
+      // TBD :check for valid value
+      //        if (lWnum < 1 || lWnum > 25) {
+      //                  throw new Error("ERROR: Wafer is out of the range : " + mslWnum);
+      //              }
+
+      _wafer = mslWnum; // store the wafer number
+      //          _waferSet = true;
+    }
+    return _wafer;
+  }
+
+  /** Query the X and Y coordinates from the test system and set them for all sites. */
+  public static void setXY() {
+    MultiSiteLong x_coord =
+        context.testProgram().variables().getLong("STDF.X_COORD"); // for use with probe
+    MultiSiteLong y_coord =
+        context.testProgram().variables().getLong("STDF.Y_COORD"); // for use with probe
+
+    //        MultiSiteLong x_coord = new MultiSiteLong(90); // for debug purpose
+    //        MultiSiteLong y_coord = new MultiSiteLong(100); // for debug purpose
+
+    // TBD
+    //        if (x_coord.lessThan(-32768) || x_coord.greaterThan(32767) ) {
+
+    //             throw new NumberFormatException("Can only patch one signal at a time");
+    //           cout << "ERROR: X is out of the range of an Int16: " << lx << endl;
+    //           ERROR_EXIT(TM::EXIT_FLOW);
+
+    //         }
+
+    //         GetDiePosXYOfSite(_number, &lx, &ly);
+    //         if (lx < -32768 || lx > 32767) {
+    //         cout << "ERROR: X is out of the range of an Int16: " << lx << endl;
+    //         ERROR_EXIT(TM::EXIT_FLOW);
+    //         }
+    //         if (ly < -32768 || ly > 32767) {
+    //         cout << "ERROR: Y is out of the range of an Int16: " << ly << endl;
+    //         ERROR_EXIT(TM::EXIT_FLOW);
+    //         }
+    //         _x = (int) lx;
+    //         _y = (int) ly;
+
+    _x = x_coord;
+    _y = y_coord;
+    //       _xSet = true;
+    //       _ySet = true;
+  }
+
+  /**
+   * Get the X co-ord. If it has not previously been set to a value it will be automatically queried
+   * from the test system.
+   */
+  public static MultiSiteLong x() {
+    if (!_xSet) {
+      setXY();
+    }
+    return _x;
+  }
+
+  /**
+   * Get the Y co-ord. If it has not previously been set to a value it will be automatically queried
+   * from the test system.
+   *
+   * @return
+   */
+  public static MultiSiteLong y() {
+    if (!_ySet) {
+      setXY();
+    }
+    return _y;
+  }
+
+  /** Set the X co-ordinate to the given value */
+  public static void x(MultiSiteLong v) {
+    _x = v;
+    _xSet = true;
+  }
+
+  /** Set the Y co-ordinate to the given value */
+  public static void y(MultiSiteLong v) {
+    _y = v;
+    _ySet = true;
+  }
+}