LATTICE TECHNOLOGY, INC. For Version 1.3 and later XVL BOM Assembler Tutorial For Version 1.3 and later

June 2012 Lattice Technology, Inc. 2 Introduction and Objectives The XVL BOM Assembler is a command-line application that converts XVL models into XML structure files and XML structure files into XVL models. By the end of this tutorial, you will be able to perform the following command-line operations: –Generate assembly structure XML file. –Generate XVL assembly model out of XML file and part files. –Export mass properties in XML. –Export a log file.

June 2012 Lattice Technology, Inc. 3 Agenda Required Files Installing the Visual C++ Runtime Component Command Syntax Generating Assembly Structure XML Files Generating XVL Assembly Models Exporting XML with Mass Properties Exporting Log Files XML Format

June 2012 Lattice Technology, Inc. 4 Required Files In order to execute XVL BOM Assembler, you need the following files*: –xvlbomassembler.exe Command line application –xvlbom_schema.xsd XML schema check file –xerces-c_1_3x8.dll Xerces-C++ DLL for reading and writing XVL files –xerces-c_2_8.dll Xerces-C++ DLL for reading and writing XML files * These files are located in: \Lt_BomAssembler\Bin\

June 2012 Lattice Technology, Inc. 5 Installing the Visual C++ Runtime Component To use XVL BOM Assembler, Visual C++ runtime component must be installed. To install Visual C++ runtime component, simply double-click the vcredist_x86.exe* file. * vcredist_x86.exe is located in: \Lt_BomAssembler\

Basic Format: June 2012 Lattice Technology, Inc. 6 Command Syntax ParameterDescription -i input_fileInput file. -o output_fileOutput file. -nop Specifies not to output part XVL files when the input file is an XVL file and the output file is an XML file. -p mode Specify whether or not to include process information. “mode" can be either of the following values: 0 : Ignore process information and only use assembly information. 1 : Use both assembly and process information. 2 : Use process information only. -mSpecify this option when output file is to include mass properties. -t type num tol Specifies the tessellation parameters to be used in the mass properties calculation. (This option is meaningful only when [–m] option is specified.) -rSpecify this option to output a log file in the same folder as the output file. xvlbomassembler.exe [-nop] [-p mode] [-m] [-t type num tol] [-r] * Parameters in braces ([ ]) are optional.

Generating XVL Assembly Models Specify an XML file as input and an XVL file as output to generate an XVL model from an XML file. June 2012 Lattice Technology, Inc. 7 Assembly structural tree + XVL part files Generate XML Example: xvlbomassembler.exe -i sample.xml -o sample.xv2 XVL assembly model

Generating Assembly Structure XML Files Specify an XVL file as input and an XML file as output to generate and assembly structure XML file for the XVL file. June 2012 Lattice Technology, Inc. 8 Assembly structural tree + XVL assembly model XVL part files Generate XML Example: xvlbomassembler.exe -i sample.xv2 -o sample.xml

XVL file is created with process tree information. Lattice Technology, Inc. 9 Import Process Information June Assembly structural tree - Process tree + XVL part files XML XVL assembly model Generate Process Tree * Requires Process option. Example: xvlbomassembler.exe -i sample.xml -o sample.xv2 –p 1

Lattice Technology, Inc. 10 Export Process Information in XML June 2012 XVL assembly model Process Tree Generate * Requires Process option. XVL file is created with process tree information. Example: xvlbomassembler.exe -i sample.xml -o sample.xv2 –p 1 - Assembly structural tree - Process tree + XVL part files XML

Use the –m option to add mass properties to the XML file. Exporting XML with Mass Properties 1/2 June 2012 Lattice Technology, Inc. 11 Example: xvlbomassembler.exe -i sample.xv2 -o sample.xml -m Example of mass properties (in XML): Assembly structural tree + Mass properties XVL assembly model XML Generate

Use the –t option to specify the tessellation tolerance to use when calculating the mass properties. Exporting XML with Mass Properties 2/2 June 2012 Lattice Technology, Inc. 12 Example: xvlbomassembler.exe -i sample.xv2 -o sample.xml –m –t ParameterDescription type Specify one of the following integer values to indicate the polygon division type. 1: Rough 2: Fast 3: Normal 4: Fine 5: Analytic num Maximum number of divisions for polygon division (an integer between 1 and 32). tol Specify the tolerance for polygon division. Basic Format: xvlbomassembler.exe [-m] [-t type num tol] * When the –t option is not specified, default values are used.

Use the –r option to export a log file. Exporting Log Files June 2012 Lattice Technology, Inc. 13 Example: xvlbomassembler.exe -i sample.xv2 -o sample.xml –r ParameterDescription -r A log file is exported in the same folder as the output file. The log file name is the same as the output file but with the extension ".log“. Return code: 0 Successful completion. -1 Incorrect format. -2 Cannot find license. -3 Cannot open input file. -4 Cannot open output file. -5 The specified input or output file name extension is invalid. -6 The version of the XVL file is not supported. -7 Schema error for input XML file. -8 Entity ID or instance ID update error for input XVL file. (An XVL assembly or part name is not set correctly, for example) -100 An unexpected error occurred.

For details of the XML format, please see XVL_BOM_Assembler- XML_Format.pdf.* XML Format June 2012 Lattice Technology, Inc. 14 * XVL_BOM_Assembler-XML_Format.pdf is located in: \Lt_BomAssembler\Doc

June 2012 Lattice Technology, Inc. 15 Questions? E. T F W.