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

December 2010 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.

December 2010 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

December 2010 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\

December 2010 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: December 2010 Lattice Technology, Inc. 6 Command Syntax ParameterDescription -i input_file Input file. -o output_file Output file. -m Specify 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.) -r Specify this option to output a log file in the same folder as the output file. xvlbomassembler.exe [-m] [-t type num tol] [-r] * Parameters in braces ([ ]) are optional.

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. December 2010 Lattice Technology, Inc. 7 Assembly structural tree + XVL assembly model XVL part files Generate XML Example: xvlbomassembler.exe -i sample.xv2 -o sample.xml

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. December 2010 Lattice Technology, Inc. 8 Assembly structural tree + XVL part files Generate XML Example: xvlbomassembler.exe -i sample.xml -o sample.xv2 XVL assembly model

Use the –m option to add mass properties to the XML file. Exporting XML with Mass Properties 1/2 December 2010 Lattice Technology, Inc. 9 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 December 2010 Lattice Technology, Inc. 10 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 December 2010 Lattice Technology, Inc. 11 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 December 2010 Lattice Technology, Inc. 12 * XVL_BOM_Assembler-XML_Format.pdf is located in: \Lt_BomAssembler\Doc

December 2010 Lattice Technology, Inc. 13 Questions? E. T F W.