OpenCores
URL https://opencores.org/ocsvn/socgen/socgen/trunk

Subversion Repositories socgen

[/] [socgen/] [trunk/] [tools/] [documentation/] [create_lib_doc] - Rev 130

Go to most recent revision | Compare with Previous | Blame | View Log

eval 'exec `which perl` -S $0 ${1+"$@"}'
   if 0;

#/**********************************************************************/
#/*                                                                    */
#/*             -------                                                */
#/*            /   SOC  \                                              */
#/*           /    GEN   \                                             */
#/*          /    TOOL    \                                            */
#/*          ==============                                            */
#/*          |            |                                            */
#/*          |____________|                                            */
#/*                                                                    */
#/*                                                                    */
#/*                                                                    */
#/*                                                                    */
#/*  Author(s):                                                        */
#/*      - John Eaton, jt_eaton@opencores.org                          */
#/*                                                                    */
#/**********************************************************************/
#/*                                                                    */
#/*    Copyright (C) <2010-2011>  <Ouabache Design Works>              */
#/*                                                                    */
#/*  This source file may be used and distributed without              */
#/*  restriction provided that this copyright statement is not         */
#/*  removed from the file and that any derivative work contains       */
#/*  the original copyright notice and the associated disclaimer.      */
#/*                                                                    */
#/*  This source file is free software; you can redistribute it        */
#/*  and/or modify it under the terms of the GNU Lesser General        */
#/*  Public License as published by the Free Software Foundation;      */
#/*  either version 2.1 of the License, or (at your option) any        */
#/*  later version.                                                    */
#/*                                                                    */
#/*  This source is distributed in the hope that it will be            */
#/*  useful, but WITHOUT ANY WARRANTY; without even the implied        */
#/*  warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR           */
#/*  PURPOSE.  See the GNU Lesser General Public License for more      */
#/*  details.                                                          */
#/*                                                                    */
#/*  You should have received a copy of the GNU Lesser General         */
#/*  Public License along with this source; if not, download it        */
#/*  from http://www.opencores.org/lgpl.shtml                          */
#/*                                                                    */
#/**********************************************************************/


############################################################################
# General PERL config
############################################################################
use Getopt::Long;
use English;
use File::Basename;
use Cwd;
use XML::LibXML;
use lib './tools';
use sys::lib;
use yp::lib;


$OUTPUT_AUTOFLUSH = 1; # set autoflush of stdout to TRUE.


############################################################################
### Process the options
############################################################################

Getopt::Long::config("require_order", "prefix=-");
GetOptions("h","help",
) || die "(use '$program_name -h' for help)";


##############################################################################
## Help option
##############################################################################
if (  $opt_h or $opt_help  ) 
  { print "\n create_lib_doc  vendor_name library_name [component_name]";
    print "\n";
    exit 1;
  }


##############################################################################
## 
##############################################################################



my $parser = XML::LibXML->new();

$home = cwd();
my $projects         = "/projects";

#############################################################################
## 
## 
#############################################################################

  my $vendor         = $ARGV[0];
  my $library        = $ARGV[1];
  my $work_dir       = $ARGV[2];


if(defined $work_dir)
  {chomp($work_dir);}
else 
  {$work_dir ="/doc_dir";}

my $path  = "${home}${work_dir}";
mkdir $path,0755             unless( -e $path );
my $path  = "${home}${work_dir}/${vendor}__${library}";
mkdir $path,0755             unless( -e $path );



$root = "${home}${projects}/${vendor}/${library}";
$dest = "${home}${work_dir}/${vendor}__${library}";
&sys::lib::link_dir( "$root", "$dest"  );

my @components   = yp::lib::find_components($vendor,$library);

foreach my  $component (@components) 

{
unless (yp::lib::find_componentConfiguration($vendor,$library,$component)) {print "Missing ComponentCfg  $vendor, $library, $component \n";  }
 my $socgen_file      = $parser->parse_file(yp::lib::find_componentConfiguration($vendor,$library,$component));
 my $doc_library_path = $socgen_file->findnodes("//socgen:componentConfiguration/socgen:doc/socgen:library_path/text()")->to_literal;
 my $lib_comp_sep     = yp::lib::find_lib_comp_sep($vendor,$library,$component);           

 my $path  = "${home}${projects}/${vendor}/${library}${doc_library_path}";
 mkdir $path,0755             unless( -e $path );

 $doc_library_path = "${doc_library_path}/Geda";

 my $path  = "${home}${projects}/${vendor}/${library}${doc_library_path}";
 mkdir $path,0755             unless( -e $path );

 my $path  = "${home}${projects}/${vendor}/${library}${doc_library_path}/sym";
 mkdir $path,0755             unless( -e $path );

 my $path  = "${home}${projects}/${vendor}/${library}${doc_library_path}/sch";
 mkdir $path,0755             unless( -e $path );

 my $path  = "${home}${projects}/${vendor}/${library}${doc_library_path}/png";
 mkdir $path,0755             unless( -e $path );

 my $path  = "${home}${projects}/${vendor}/${library}${doc_library_path}/src";
 mkdir $path,0755             unless( -e $path );

 my @versions =       yp::lib::find_component_versions($vendor,$library,$component);

foreach my  $version   (@versions)
   {
   my $variant;
   if($version) {$variant = "${component}_${version}"}
   else         {$variant = "${component}"}
   my $module_name =       yp::lib::get_module_name($vendor,$library,$component, $version);
   print "gEDA directories  for   $vendor  $library - $component  $version $variant ==  $module_name  \n"; 


#/*********************************************************************************************/
#/                                                                                            */
#/  Create filelists for simulation, synthesis and linting                                    */
#/                                                                                            */
#/                                                                                            */
#/*********************************************************************************************/

my  @filelist =       yp::lib::parse_component_brothers("$vendor","$library","$component","$version");

foreach $line (@filelist) 
   {
   $_ = $line;
   if(/::(\S+)::(\S+)::(\S+)::(\S+)::/) 
     { 
     $new_project        = $2;
     $new_component      = $3;
     $new_vendor         = $1;
     $new_version        = $4;                
     print "Seeking  $new_vendor $new_project $new_component $new_version \n";
     my $spirit_component_file    = $parser->parse_file(yp::lib::find_ipxact_component($new_vendor,$new_project,$new_component,$new_version));

     foreach  my   $i_name ($spirit_component_file->findnodes("//spirit:componentGenerator/spirit:name"))
       {
       my($gen_name)            = $i_name ->findnodes('../spirit:name/text()')->to_literal ;
       my($gen_generatorExe)    = $i_name ->findnodes('../spirit:generatorExe/text()')->to_literal ;
       foreach  my   $i_name ($spirit_component_file->findnodes("//spirit:componentGenerator[spirit:name/text() = '$gen_name']/spirit:vendorExtensions/socgen:envIdentifier"))
          {
          my($gen_envidentifier)  = $i_name ->findnodes('./text()')->to_literal ;

          if($gen_envidentifier eq ":*Documentation:*"   )           
             {
             my $cmd = "./tools/sys/build_generate -prefix /doc_dir -vendor    $vendor -project  $library -component  $component -version  $version  \n";
             if (system($cmd)) {}
             my $filename = find_filename("fs-sim",   ${vendor},  ${library} , ${component} ,  ${version}  );
             my $cmd = "cp     ${home}${work_dir}/${filename}.v    ${home}${projects}/${vendor}/${library}${doc_library_path}/src/${module_name}.v     \n";
             if (system($cmd)) {}
             my $filename = find_filename("fs-doc",   ${vendor},  ${library} , ${component} ,  ${version}  );
             my $outfile ="${home}${projects}/${vendor}/${library}${doc_library_path}/sym/";
             my $cmd = "./tools/documentation/ver2gedasym     ${home}${work_dir}/${filename}    $outfile   \n";
             if (system($cmd)) {}
             my $outfile ="${home}${projects}/${vendor}/${library}${doc_library_path}/sch/";
             my $cmd = "./tools/documentation/ver2gedasch     ${home}${work_dir}/${filename}    $outfile   \n";
             if (system($cmd)) {}
             my $symfile ="${home}${projects}/${vendor}/${library}${doc_library_path}/sym/${module_name}.sym";
             my $pngfile ="${home}${projects}/${vendor}/${library}${doc_library_path}/png/${module_name}_sym.png";
             my $cmd ="gaf export -c -s auto -m 5px  --dpi  600  --no-color -o  $pngfile $symfile \n";
             if (system($cmd)) {}
             my $schfile ="${home}${projects}/${vendor}/${library}${doc_library_path}/sch/${module_name}.sch";
             my $pngfile ="${home}${projects}/${vendor}/${library}${doc_library_path}/png/${module_name}_sch.png";
             my $cmd ="gaf export -c -s auto -m 5px  --dpi  600  --no-color -o  $pngfile $schfile \n";
             if (system($cmd)) {}
             }


          }
       }
     }
   }
   
   }

}




#/*********************************************************************************************/
#/  find filename                                                                             */
#/                                                                                            */
#/  returns gloabal  name of the file                                                         */
#/                                                                                            */
#/                                                                                            */
#/*********************************************************************************************/

sub find_filename 
   {
   my @params             = @_;
   my $version            = pop(@params);
   my $component          = pop(@params);
   my $project            = pop(@params);
   my $vendor             = pop(@params);
   my $filesetref_name    = pop(@params);


   my $variant;
   if($version)       {$variant   = "${component}_${version}";}
   else               {$variant   = "${component}";}

   my  @filelist       = yp::lib::parse_component_brothers("$vendor","$project","$component","$version");
   my $comp_xml_sep    = yp::lib::find_comp_xml_sep($vendor,$project,$component,$version);  
   my $lib_comp_sep    = yp::lib::find_lib_comp_sep($vendor,$project,$component);
   my $library_path    = "${lib_comp_sep}${component}${comp_xml_sep}";


   foreach $line (@filelist) 
     {
     $_ = $line;
     if(/::(\S+)::(\S+)::(\S+)::(\S+)::/) 
       { 
       $new_vendor         = $1;
       $new_project        = $2;
       $new_component      = $3;
       $new_version        = $4;
       my $spirit_component_file    = $parser->parse_file(yp::lib::find_ipxact_component($new_vendor,$new_project,$new_component,$new_version));

       foreach  my   $i_name ($spirit_component_file->findnodes("//spirit:fileSets/spirit:fileSet/spirit:file/spirit:name"))
              {    
              my($file_name)      = $i_name ->findnodes('./text()')->to_literal ;
              my($file_type)      = $i_name ->findnodes('../spirit:userFileType/text()')->to_literal ;
              my($logical_name)   = $i_name ->findnodes('../spirit:logicalName/text()')->to_literal ;
              my($view_file)      = $i_name ->findnodes('../../spirit:name/text()')->to_literal ;
              if(($file_type eq "libraryDir") &&  ($logical_name eq "dest_dir")  )
                 { 
                 if( $view_file eq  $filesetref_name )  { return ("${vendor}__${project}${library_path}/${file_name}${variant}"); };
                 }     
              }
      }
     }
   }

Go to most recent revision | Compare with Previous | Blame | View Log

powered by: WebSVN 2.1.0

© copyright 1999-2024 OpenCores.org, equivalent to Oliscience, all rights reserved. OpenCores®, registered trademark.