use Data::Dump qw(dump);
use Getopt::Long;
-my $opt_svg = $ENV{SVG} || 0;
-my $opt_alt = $ENV{ALT} || 0;
-my $opt_invert = $ENV{INVERT} = 0;
-my $opt_vertical = $ENV{VERTICAL} = 0;
-my $opt_kernel = $ENV{kernel} = 1;
+my $opt_svg = 0;
+my $opt_alt = 0;
+my $opt_invert = 0;
+my $opt_vertical = 0;
+my $opt_horizontal = 0;
+my $opt_edge = 0;
+my $opt_middle = 0;
+my $opt_zebra = 0;
+my $opt_lines = 0;
+my $opt_read = '';
+my $opt_pins = '';
+my $opt_color = 0;
GetOptions(
'svg!' => \$opt_svg,
'alt!' => \$opt_alt,
'invert!' => \$opt_invert,
- 'vertical!' => \$opt_vertical,
- 'kernel!' => \$opt_kernel,
+ 'vertical-flip!' => \$opt_vertical,
+ 'horizontal-flip!' => \$opt_horizontal,
+ 'edge-pins!' => \$opt_edge,
+ 'middle-pins!' => \$opt_middle,
+ 'zebra!' => \$opt_zebra,
+ 'lines!' => \$opt_lines,
+ 'read=s' => \$opt_read,
+ 'pins=s' => \$opt_pins,
+ 'color' => \$opt_color,
);
# svg font hints
my $font_w = 1.67; # < 2.54, font is not perfect square
my $font_b = 2.10; # font baseline position
+$opt_read .= '/' unless $opt_read =~ m/\/$/;
+
sub slurp {
- open(my $fh, '<', shift);
+ open(my $fh, '<', $opt_read . shift);
local $/ = undef;
<$fh>;
}
$model =~ s/\x00$//; # strip kernel NULL
warn "# model [$model]";
+open(DATA, '<', $opt_pins) if $opt_pins;
+
my @lines;
my $line_i = 0;
} else {
$include = 0;
}
- } elsif ( m/^#\s+/ ) {
- $include = 1;
- } elsif ( $include ) {
+ } elsif ( $include || $opt_pins ) {
push @{ $pins->{$1} }, $line_i while ( m/\t(\w+\d+)/g );
push @lines, $_;
die "add pin definition for # $model" unless $pins;
+#warn "# lines ",dump( \@lines );
warn "# pins ",dump($pins);
+my $serial_tty;
+foreach (
+ glob($opt_read . '/sys/devices/platform/soc*/*.serial/tty/tty*'), # 4.x
+ glob( '/sys/devices/soc.*/*.uart/tty/tty*') # 3.10
+) {
+ my @v = split(/\//, $_);
+ $serial_tty->{ $v[-3] } = $v[-1];
+}
+warn "# serial_tty = ",dump($serial_tty);
+
+
my $pin_function;
my $device;
+my $pin;
+my $function;
-open(my $fh, '<', '/sys/kernel/debug/pinctrl/pinctrl-handles');
+open(my $fh, '<', $opt_read . '/sys/kernel/debug/pinctrl/pinctrl-maps');
while(<$fh>) {
chomp;
- if ( m/device: [0-9a-f]+\.(\w+)/ ) {
+ if ( m/^device (\S+)/ ) {
$device = $1;
- } elsif ( m/group: (\w+\d+)\s.+function: (\S+)/ ) {
- my ($pin, $function) = ($1,$2);
- $pin_function->{$pin} = "$device $function";
-
- next unless $opt_kernel;
-
- if ( $pins->{$pin} ) {
- foreach my $line ( @{$pins->{$pin}} ) {
-warn "XXX $pin $line";
- my $t = $lines[$line];
- if ( $opt_svg ) {
- $t =~ s/$pin/[$device $function]/;
- } else {
- $t =~ s/$pin/$pin [$device $function]/ || die "can't find $pin in [$t]";
+ if ( my $replace = $serial_tty->{$device} ) {
+ $device = $replace; # replace serial hex with kernel name
+ } else {
+ $device =~ s/^[0-9a-f]*\.//; # remove hex address
+ }
+ } elsif ( m/^group (\w+\d+)/ ) {
+ $pin = $1;
+
+ } elsif ( m/^function (\S+)/ ) {
+ $function = $1;
+ } elsif ( m/^$/ ) {
+ if ( $device && $pin && $function ) {
+ push @{ $pin_function->{$pin} }, "$device $function";
+
+ if ( $pins->{$pin} ) {
+ foreach my $line ( @{$pins->{$pin}} ) {
+ my $t = $lines[$line];
+ if ( $opt_svg ) {
+ $t =~ s/$pin/[$device $function]/;
+ } else {
+ $t =~ s/$pin/$pin [$device $function]/ || warn "can't find $pin in [$t]";
+ }
+ $lines[$line] = $t;
+ warn "# $line: $lines[$line]\n";
}
- $lines[$line] = $t;
- warn "# $line: $lines[$line]\n";
+ } else {
+ warn "IGNORED: pin $pin function $function\n";
}
+
} else {
- warn "IGNORED: pin $pin function $function\n";
+ warn "missing one of ",dump( $device, $pin, $function );
}
+
+ $device = undef;
+ $pin = undef;
+ $function = undef;
+
}
}
my @max_len = ( 0,0,0,0 );
my @line_parts;
+
+shift(@lines) while ( ! $lines[0] ); # remove empty at beginning
+pop(@lines) while ( ! $lines[-1] ); # remove empty at end
+
foreach my $line (@lines) {
if ( $line =~ m/^#/ ) {
- push @line_parts, [ $line ] unless $opt_svg;
+ push @line_parts, [ $line ] unless $opt_svg && $line =~ m/^###+/; # SVG doesn't display 3rd level comments
next;
}
- $line =~ s/(\[(?:uart|serial))([^\t]*\]\s[^\t]*(rx|tx)d?)/$1 $3$2/gi;
+ $line =~ s/\[(\w+)\s+(\w+)\] \[\1\s+(\w+)\]/[$1 $2 $3]/g; # compress kernel annotation with same prefix
+ $line =~ s/(\[(?:uart\d*|serial|tty\w+))([^\t]*\]\s[^\t]*(rx|tx)d?)/$1 $3$2/gi;
$line =~ s/(\[i2c)([^\t]*\]\s[^\t]*(scl?k?|sda))/$1 $3$2/gi;
$line =~ s/(\[spi)([^\t]*\]\s[^\t]*(miso|mosi|s?clk|c[se]\d*))/$1 $3$2/gi;
$line =~ s/\s*\([^\)]+\)//g if ! $opt_alt;
$line =~ s/\[serial (\w+) (uart\d+)\]/[$2 $1]/g;
$line =~ s/\[(\w+) (\w+) \1(\d+)\]/[$1$3 $2]/g;
+ $line =~ s/\[(\w+)\s+([^\]]+)\s+\1\]/[$1 $2]/g; # duplicate
+
my @v = split(/\s*\t+\s*/,$line,4);
+ @v = ( $v[2], $v[3], $v[0], $v[1] ) if $opt_horizontal && $v[2];
+
push @line_parts, [ @v ];
foreach my $i ( 0 .. 3 ) {
next unless exists $v[$i];
#print "$_\n" foreach @lines;
-my $fmt = "%$max_len[0]s %-$max_len[1]s %$max_len[2]s %-$max_len[3]s\n";
-
-my $x = 30.00; # mm
-my $y = 30.00; # mm
+my $x = 20.00; # mm
+my $y = 20.00; # mm
if ( $opt_svg ) {
print qq{<?xml version="1.0" encoding="UTF-8" standalone="no"?>
sub svg_style {
my ($name,$x,$y,$col) = @_;
+
+ return '' unless $opt_color;
+
$y -= $font_b; # shift box overlay to right vertical position based on font baseline
sub rect {
} elsif ( $name =~ m/\[(\w+)/ ) { # kernel
my $dev = $1;
my ($fg,$bg) = @{ $cols->{txt} };
+ $dev = 'serial' if $dev =~ m/^tty/;
($fg,$bg) = @{ $cols->{$dev} } if exists $cols->{$dev};
rect $x,$y,$col,$bg;
return qq{ style="fill:$fg"};
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 = ( '','-','-','' );
+my @cols_shuffle = @cols_order;
+
+if ( $opt_edge ) {
+ # pins outside on the right
+ @cols_shuffle = ( 0,1,3,2 ) if $opt_edge;
+ @cols_align = ( '-','-','','' );
+} elsif ( $opt_middle ) {
+ # pins in middle
+ @cols_shuffle = ( 1,0,2,3 );
+ @cols_align = ( '','','-','-' );
+}
+
+sub cols_shuffle {
+ my ( $what, $order ) = @_;
+ my $new = [];
+ foreach my $i ( 0 .. $#$what ) {
+ $new->[$i] = $what->[ $order->[$i] ];
+ }
+ warn "# cols_shuffle what=",dump($what)," order=",dump($order)," new=",dump($new);
+ return @$new;
+}
+
+@cols_order = cols_shuffle( \@cols_order, \@cols_shuffle );
+@max_len = cols_shuffle( \@max_len, \@cols_shuffle );
+
+warn "# cols_order = ",dump( \@cols_order );
+warn "# cols_align = ",dump( \@cols_align );
+
+my $fmt = "%$cols_align[0]$max_len[0]s %$cols_align[1]$max_len[1]s %$cols_align[2]$max_len[2]s %$cols_align[3]$max_len[3]s\n";
# cut marks
push @cut_marks, sprintf($line_fmt, $x-5, $y-$font_b, $x+5, $y-$font_b);
push @cut_marks, sprintf($line_fmt, $x, $y-$font_b-5, $x, $y-$font_b+5);
}
-cut_mark $x, $y;
+#cut_mark $x, $y;
my $max_x = $x;
$max_x += $max_len[$_] * $font_w foreach ( 0 .. 3 );
-cut_mark $max_x, $y;
+#cut_mark $max_x, $y;
+
+sub line {
+ my ($x,$y,$max_x) = @_;
+ push @cut_marks, sprintf($line_fmt, $x, $y-$font_b, $max_x, $y-$font_b);
+}
+
my $last_cut_mark = 0;
if ( $opt_svg ) {
- if ( ! exists $line->[0] ) {
+ # not a minimal two column pin description
+ if ( ! exists $line->[1] ) {
+ $last_cut_mark = 1 if $line->[0] =~ m/^##/; # skip comments
+
# before first empty line
if ( $last_cut_mark == 0 ) {
cut_mark $x, $y;
cut_mark $max_x, $y;
$last_cut_mark = 1;
+ line $x, $y, $max_x if $opt_lines;
$y += 15; # make spacing between pinouts
}
} elsif ( $last_cut_mark ) {
#warn "CUTMARK no magic";
}
+ line $x, $y, $max_x if $opt_lines && exists $line->[1];
+
my ($fg,$bg) = @{ $cols->{txt} };
my $tspan = qq{<tspan x="$x" y="$y" style="line-height:2.54;fill:$fg;stroke:none;">\n};
my $x_pos = $x;
- foreach my $i ( @cols_order ) {
- next unless $line->[$i];
+ foreach my $i ( 0 .. $#cols_order ) {
+ my $order = $cols_order[$i];
+ next unless $line->[$order];
+
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;
+ my $len = $max_len[$i];
+ my $x2 = $x_pos + ( $len * $font_w ) / 2;
+ # is this comment?
+ if ( $#$line == 0 && $line->[$order] =~ s/^#+s*// ) {
+ # comment, center over whole width
+ $len = length($line->[$order]);
+ $x2 = $x + (($max_x-$x)/2); # middle
+ $tspan .= qq{\t<tspan x="$x2" text-anchor="$text_anchor"}.sprintf( '>%' . $cols_align[$i] . $len . 's</tspan>', $line->[0]);
+ } else {
+ $tspan .= qq{\t<tspan x="$x2" text-anchor="$text_anchor"}.svg_style($line->[$order],$x_pos,$y,$i).sprintf( '>%' . $cols_align[$i] . $len . 's</tspan>', $line->[$order]);
+ }
+ $x_pos += $len * $font_w;
}
- $tspan .= qq{</tspan>\n};
+ $tspan .= qq{\n</tspan>\n};
push @later,sprintf $tspan, @$line;
$y += 2.54;
- # swap pin colors for line stripes
- swap_cols $_ foreach qw( pins txt );
+ # swap pin colors for line stripe
+ if ( $opt_zebra ) {
+ swap_cols $_ foreach qw( pins txt );
+ } else {
+ swap_cols 'pins';
+ }
} else {
print $line->[0], "\n";
} else {
push @$line, '' while ($#$line < 3); # fill-in single row header
- printf $fmt, @$line;
+ printf $fmt, map { $line->[$_] } @cols_order;
}
}
}
if ( $opt_svg ) {
+ cut_mark $x,$y;
+ cut_mark $max_x,$y;
+ line $x, $y, $max_x if $opt_lines;
+
print qq{
<text
id="text4506"
}
__DATA__
-# Cubietech Cubieboard2
+# Cubietech Cubieboard
## U14 (Next to SATA connector)
### SPI0
48 PI13 (SPI0-MISO/UART6-RX/EINT25) 47 PI11 (SPI0-CLK/UART5-RX/EINT23)
4 PD1 (LCDD1/LVDS0N0) 3 PD2 (LCDD2/LVDS0P1)
2 Ground 1 PD0 (LCDD0/LVDSP0)
-# Cubietech Cubieboard2
## U15 (Between Ethernet port and USB ports)
### CSI1/TS
1 VCC-5V 2 PH15 (CSI1-PWR/EINT15)
4 PI21 UART7_RX 3 PH5
2 3V3 1 SATA-5V
-# Raspberry Pi 3 Model B Rev 1.2
+# Raspberry Pi
1 3.3v 2 5v
3 gpio2 (SDA.1) 4 5v
5 gpio3 (SCL.1) 6 0v
-7 gpio4 (GPIO. 7) 8 gpio14 (TxD)
+7 gpio4 (WPi 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)
+11 gpio17 (WPi 0) 12 gpio18 (WPi 1)
+13 gpio27 (WPi 2) 14 0v
+15 gpio22 (WPi 3) 16 gpio23 (WPi 4)
+17 3.3v 18 gpio24 (WPi 5)
19 gpio10 (MOSI) 20 0v
-21 gpio9 (MISO) 22 gpio25 (GPIO. 6)
+21 gpio9 (MISO) 22 gpio25 (WPi 6)
23 gpio11 (SCLK) 24 gpio8 (CE0)
25 0v 26 gpio7 (CE1)
+# Raspberry Pi 3 Model B Rev 1.2
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)
+29 gpio5 (WPi 21) 30 0v
+31 gpio6 (WPi 22) 32 gpio12 (WPi 26)
+33 gpio13 (WPi 23) 34 0v
+35 gpio19 (WPi 24) 36 gpio16 (WPi 27)
+37 gpio26 (WPi 25) 38 gpio20 (WPi 28)
+39 0v 40 gpio21 (WPi 29)
+