working on rpi 3, not really useful on old 4.9 kernel
[linux-gpio-pinout] / gpio.pl
diff --git a/gpio.pl b/gpio.pl
index b9e731d..4491529 100755 (executable)
--- a/gpio.pl
+++ b/gpio.pl
@@ -6,14 +6,21 @@ use Data::Dump qw(dump);
 use Getopt::Long;
 
 my $opt_svg = $ENV{SVG} || 0;
-my $opt_alt = $ENV{ALT} || 1;
+my $opt_alt = $ENV{ALT} || 0;
+my $opt_invert = $ENV{INVERT} = 0;
+my $opt_vertical = $ENV{VERTICAL} = 0;
+my $opt_kernel = $ENV{kernel} = 1;
 GetOptions(
        'svg!' => \$opt_svg,
        'alt!' => \$opt_alt,
+       'invert!' => \$opt_invert,
+       'vertical!' => \$opt_vertical,
+       'kernel!' => \$opt_kernel,
 );
 
 # svg font hints
-my $font_w = 1.80; # < 2.54, font is not perfect square
+my $font_w = 1.67; # < 2.54, font is not perfect square
+my $font_b = 2.10; # font baseline position
 
 sub slurp {
        open(my $fh, '<', shift);
@@ -33,12 +40,17 @@ my $line_i = 0;
 my $include = 0;
 while(<DATA>) {
        chomp;
-       if ( m/^#\s*$model/ ) {
-               $include = 1;
+       if ( m/^#\s(.+)/ ) {
+               warn "MODEL [$1] == [$model] ?\n";
+               if ( $model =~ m/$1/ ) {
+                       $include = 1;
+               } else {
+                       $include = 0;
+               }
        } elsif ( m/^#\s+/ ) {
-               $include = 0;
+               $include = 1;
        } elsif ( $include ) {
-               push @{ $pins->{$1} }, $line_i while ( m/\t(P\w\d+)/g );
+               push @{ $pins->{$1} }, $line_i while ( m/\t(\w+\d+)/g );
 
                push @lines, $_;
 
@@ -52,16 +64,26 @@ die "add pin definition for # $model" unless $pins;
 
 warn "# pins ",dump($pins);
 
+my $pin_function;
+
 open(my $fh, '<', '/sys/kernel/debug/pinctrl/pinctrl-handles');
 while(<$fh>) {
        chomp;
-       if ( m/group: (P\w\d+)\s.+function: (\S+)/ ) {
-               my ($pin, $function) = ($1,$2); 
+       if ( m/group: (\w+\d+)\s.+function: (\S+)/ ) {
+               my ($pin, $function) = ($1,$2);
+               $pin_function->{$pin} = $function;
+
+               next unless $opt_kernel;
+
                if ( $pins->{$pin} ) {
                        foreach my $line ( @{$pins->{$pin}} ) {
 warn "XXX $pin $line";
                                my $t = $lines[$line];
-                               $t =~ s/$pin/$pin [$function]/ || die "can't find $pin in [$t]";
+                               if ( $opt_svg ) {
+                                       $t =~ s/$pin/[$function]/;
+                               } else {
+                                       $t =~ s/$pin/$pin [$function]/ || die "can't find $pin in [$t]";
+                               }
                                $lines[$line] = $t;
                                warn "# $line: $lines[$line]\n";
                        }
@@ -69,7 +91,9 @@ warn "XXX $pin $line";
                        warn "IGNORED: pin $pin function $function\n";
                }
        }
-};
+}
+
+warn "# pin_function = ",dump($pin_function);
 
 my @max_len = ( 0,0,0,0 );
 my @line_parts;
@@ -78,7 +102,11 @@ foreach my $line (@lines) {
                push @line_parts, [ $line ] unless $opt_svg;
                next;
        }
-       $line =~ s/\([^\)]+\)//g && warn "NUKED ALT";
+       $line =~ s/(\[uart\d)(\]\s[^\t]*(rx|tx))/$1 $3$2/gi;
+       $line =~ s/(\[i2c\d)(\]\s[^\t]*(sck|sda))/$1 $3$2/gi;
+       $line =~ s/(\[spi\d)(\]\s[^\t]*(miso|mosi|clk|cs))/$1 $3$2/gi;
+       $line =~ s/\s*\([^\)]+\)//g if ! $opt_alt;
+
        my @v = split(/\s*\t+\s*/,$line,4);
        push @line_parts, [ @v ];
        foreach my $i ( 0 .. 3 ) {
@@ -115,79 +143,153 @@ if ( $opt_svg ) {
    width="210mm">
 
 
-  <g id="layer1">
-
-    <rect y="88.686066" x="30.48" height="2.54" width="73.659996" id="rect4759" style="opacity:1;fill:#0000ff;fill-opacity:1;stroke:none;" />
-
-    <rect
-       y="43.177692"
-       x="30.48"
-       height="2.54"
-       width="73.659996"
-       id="rect4755"
-       style="opacity:0.84200003;fill:#123456;fill-opacity:1;stroke:none;stroke-width:0.28884605;stroke-opacity:1" />
-
-       <rect x="0" y="0" width="210" height="297" style="fill:#000000" id="high-contrast"/>
+<g id="layer1">
 
        }; # svg, insert rest of rect
 
+       print qq{<rect x="0" y="0" width="210" height="297" style="fill:#000000" id="high-contrast"/>} if $opt_invert;
 }
 
 my @later;
 
-my @pin_cols = ( '#ffffff', '#000000' );
+my $cols = {   # foreground background
+       txt  => [ '#000000', '#ffffff' ],
+       pins => [ '#ffffff', '#ff00ff' ],
+       vcc  => [ '#ff0000', '#ffff00' ],
+       gnd  => [ '#000000', '#00ffff' ],
+       i2c  => [ '#008800', '#ffcccc' ],
+       uart => [ '#000088', '#ccffcc' ],
+       spi  => [ '#880000', '#ccccff' ],
+};
+
+sub swap_cols {
+       my $swap = shift;
+       die "$swap not found in ",dump($cols) unless $cols->{$swap};
+       my ( $c1, $c2 ) = @{ $cols->{$swap} };
+       $cols->{$swap} = [ $c2, $c1 ];
+}
+
+swap_cols 'txt' if $opt_invert;
+       
 
 sub svg_style {
        my ($name,$x,$y,$col) = @_;
-       $y -= 2.30; # shift box overlay to right vertical position based on font baseline
+       $y -= $font_b; # shift box overlay to right vertical position based on font baseline
 
        sub rect {
                my ($x,$y,$col,$fill) = @_;
-               print qq{<rect x="$x" y="$y" height="2.54" width="}, $max_len[$col] * $font_w, qq{" style="opacity:1;fill:$fill;fill-opacity:1;stroke:#ffffff;stroke-width:0.10;stroke-opacity:1" />};
+               print qq{<rect x="$x" y="$y" height="2.54" width="}, $max_len[$col] * $font_w, qq{" style="opacity:1;fill:$fill;stroke:#ffffff;stroke-width:0.10" />\n};
 
        }
 
-       if ( $col == 0 || $col == 2 ) { # pins
-               my ( $c1, $c2 ) = @pin_cols;
-               rect $x,$y,$col,$c1;
-               return qq{ style="fill:$c2"};
+       if ( $name =~ m/^(\d+)$/ ) { # pins
+               my $pin = $1;
+               my ( $fg, $bg ) = @{ $cols->{pins} };
+               if ( $pin == 1 ) {
+                       my $w  = $max_len[$col]*$font_w - 0.1;
+                       my $cx = $x + $w;
+                       my $cy = $y + 2.54;
+                       #print qq{<polygon points="$x,$y $cx,$y $x,$cy $x,$y" stroke="$fg" stroke-width="0.25" fill="$bg" />};
+                       #print qq{<polygon points="$x,$cy $cx,$cy $cx,$y $x,$cy" stroke="$bg" stroke-width="0.25" fill="$fg" />};
+                       print qq{<rect x="$x" y="$y" width="$w" height="2.54" stroke="$fg" stroke-width="0.3" fill="$bg" />};
+                       my ( $fg, $bg ) = @{ $cols->{txt} };
+                       print qq{<rect x="$x" y="$y" width="$w" height="2.54" rx="1" ry="1" stroke="$fg" stroke-width="0.3" fill="$bg" />};
+               } else {
+                       rect $x,$y,$col,$fg;
+               }
+               return qq{ style="fill:$bg"};
        }
 
-       if ( $name =~ m/(VCC|3V3)/i ) {
-               rect $x,$y,$col,'#000000';
-               return qq{ style="fill:#ffcc88"};
+       if ( $name =~ m/(VCC|3V3|3.3V)/i ) {
+               my ($fg,$bg) = @{ $cols->{vcc} };
+               rect $x,$y,$col,$bg;
+               return qq{ style="fill:$fg"};
        } elsif ( $name =~ m/(G(ND|Round)|VSS)/i ) {
-               rect $x,$y,$col,'#000000';
-               return qq{ style="fill:#ff8800"};
+               my ($fg,$bg) = @{ $cols->{gnd} };
+               rect $x,$y,$col,$bg;
+               return qq{ style="fill:$fg"};
+       } elsif ( $name =~ m/\[(\w+)\d/ ) { # kernel
+               my $dev = $1;
+               if ( my ($fg,$bg) = @{ $cols->{$dev} } ) {
+                       rect $x,$y,$col,$bg;
+                       return qq{ style="fill:$fg"};
+               }
        } else {
+               my ( $fg, $bg ) = @{ $cols->{txt} };
+               rect $x,$y,$col,$bg;
+               #return qq{ style="fill:$fg"};
                return '';
        }
 }
 
 my $alt_col = 0;
 
-foreach my $line ( @line_parts ) {
+my @cols_order = ( 0,1,2,3 );
+my @cols_align = ( '','-','','-' ); # sprintf prefix
+
+@cols_order = ( 0,1,3,2 ); # pins outside on the right
+@cols_align = ( '','-','-','' );
+
+
+# cut marks
+my ($fg,$bg) = @{ $cols->{txt} };
+my $line_fmt = qq{<line x1="%s" y1="%s" x2="%s" y2="%s" style="stroke:$fg;stroke-width:0.10;fill:$bg" />\n};
 
-       my $pin_color = $alt_col ? '#cccccc' : '#444444';
-       $alt_col = ! $alt_col;
+my @cut_marks;
+sub cut_mark {
+       my ($x,$y) = @_;
+       return unless $opt_svg;
+       push @cut_marks, printf($line_fmt, $x-5, $y-$font_b,   $x+5, $y-$font_b);
+       push @cut_marks, printf($line_fmt, $x,   $y-$font_b-5, $x,   $y-$font_b+5);
+}
+cut_mark $x, $y;
+my $max_x = $x;
+$max_x += $max_len[$_] * $font_w foreach ( 0 .. 3 );
+cut_mark $max_x, $y;
+
+my $last_cut_mark = 0;
+
+foreach my $i ( 0 .. $#line_parts ) {
+       $i = $#line_parts - $i if $opt_vertical;
+       my $line = $line_parts[$i];
 
        if ( $opt_svg ) {
 
-               my $tspan = qq{<tspan x="$x" y="$y" style="font-size:2.82222223px;line-height:2.53999996px;font-family:'Andale Mono';fill-opacity:1;fill:#ffffff;stroke:none;">};
+               if ( ! exists $line->[0] ) {
+                       # before first empty line
+                       if ( $last_cut_mark == 0 ) {
+                               cut_mark $x, $y;
+                               cut_mark $max_x, $y;
+                               $last_cut_mark = 1;
+                               $y += 15; # make spacing between pinouts
+                       }
+               } elsif ( $last_cut_mark ) {
+                       # first full line
+                       cut_mark $x, $y;
+                       cut_mark $max_x, $y;
+                       $last_cut_mark = 0;
+               } else {
+                       warn "CUTMARK no magic";
+               }
+
+               my ($fg,$bg) = @{ $cols->{txt} };
+               my $tspan = qq{<tspan x="$x" y="$y" style="line-height:2.54;fill-opacity:1;fill:$fg;stroke:none;">\n};
 
                my $x_pos = $x;
-               foreach my $i ( 0 .. $#$line ) {
-                       $tspan .= qq{<tspan x="$x_pos"}.svg_style($line->[$i],$x_pos,$y,$i).sprintf(qq{>%-$max_len[$i]s</tspan>}, $line->[$i]);
+               foreach my $i ( @cols_order ) {
+                       next unless $line->[$i];
+                       my $text_anchor = 'middle';
+                       my $x2 = $x_pos + ( $max_len[$i] * $font_w ) / 2;
+                       $tspan .= qq{<tspan x="$x2" text-anchor="$text_anchor"}.svg_style($line->[$i],$x_pos,$y,$i).sprintf( '>%' . $cols_align[$i] . $max_len[$i] . 's</tspan>', $line->[$i]);
                        $x_pos += $max_len[$i] * $font_w;
                }
 
-               $tspan .= qq{</tspan>};
+               $tspan .= qq{</tspan>\n};
                push @later,sprintf $tspan, @$line;
                $y += 2.54;
 
-               # swap pin colors
-               my ( $c1, $c2 ) = @pin_cols;
-               @pin_cols = ( $c2, $c1 );
+               # swap pin colors for line stripes
+               swap_cols $_ foreach qw( pins txt );
 
        } else {
 
@@ -207,12 +309,12 @@ if ( $opt_svg ) {
        id="text4506"
        y="$x"
        x="$y"
-       style="font-size:2.82222223px;line-height:2.53999996px;font-family:'Andale Mono';fill-opacity:1;stroke:none;stroke-width:0.26458332px;stroke-opacity:1"
+       style="font-size:2.34px;line-height:2.54px;font-family:'Andale Mono';fill-opacity:1;stroke:none;stroke-opacity:1"
        xml:space="preserve">
 
        }; #svg
 
-       print @later, qq{
+       print @later, @cut_marks, qq{
 </text>
 </g>
 </svg>
@@ -234,8 +336,8 @@ __DATA__
 36     XN_TP (TP-X2)                           35      YN_TP (TP-Y2)
 34     XP_TP (TP-X1)                           33      YP_TP (TP-Y1)
 32     PD25 (LCDDE)                            31      PB2 (PWM0)
-30     PD26 (LCDHSYNC)-VGA-HSYNC               29      PD24 (LCDCLK)
-28     PD23 (LCDD23)                           27      PD27 (LCDVSYNC)-VGA-VSYNC
+30     PD26 (LCDHSYNC/VGA-HSYNC)               29      PD24 (LCDCLK)
+28     PD23 (LCDD23)                           27      PD27 (LCDVSYNC/VGA-VSYNC)
 26     PD21 (LCDD21)                           25      PD22 (LCDD22)
 24     PD19 (LCDD19/LVDS1N3)                   23      PD20 (LCDD20)
 22     PD17 (LCDD17/LVDS1NC)                   21      PD18 (LCDD18/LVDS1P3)
@@ -312,3 +414,25 @@ __DATA__
 6      PI20 UART7_TX           5       PH3
 4      PI21 UART7_RX           3       PH5
 2      3V3                     1       SATA-5V
+
+# Raspberry Pi 3 Model B Rev 1.2
+1      3.3v                    2       5v
+3      gpio2 (SDA.1)           4       5v
+5      gpio3 (SCL.1)           6       0v
+7      gpio4 (GPIO. 7)         8       gpio14  (TxD)
+9      0v                      10      gpio15  (RxD)
+11     gpio17 (GPIO. 0)        12      gpio18  (GPIO. 1)
+13     gpio27 (GPIO. 2)        14      0v
+15     gpio22 (GPIO. 3)        16      gpio23  (GPIO. 4)
+17     3.3v                    18      gpio24  (GPIO. 5)
+19     gpio10 (MOSI)           20      0v
+21     gpio9 (MISO)            22      gpio25  (GPIO. 6) 
+23     gpio11 (SCLK)           24      gpio8   (CE0)
+25     0v                      26      gpio7   (CE1)
+27     gpio0 (SDA.0)           28      gpio1   (SCL.0)
+29     gpio5 (GPIO.21)         30      0v
+31     gpio6 (GPIO.22)         32      gpio12  (GPIO.26)
+33     gpio13 (GPIO.23)        34      0v
+35     gpio19 (GPIO.24)        36      gpio16  (GPIO.27)
+37     gpio26 (GPIO.25)        38      gpio20  (GPIO.28)
+39     0v                      40      gpio21  (GPIO.29)