5 use Data::Dump qw(dump);
12 my $opt_horizontal = 0;
24 'invert!' => \$opt_invert,
25 'vertical-flip!' => \$opt_vertical,
26 'horizontal-flip!' => \$opt_horizontal,
27 'edge-pins!' => \$opt_edge,
28 'middle-pins!' => \$opt_middle,
29 'zebra!' => \$opt_zebra,
30 'lines!' => \$opt_lines,
31 'read=s' => \$opt_read,
32 'pins=s' => \$opt_pins,
33 'color' => \$opt_color,
34 'pinmux' => \$opt_pinmux,
38 my $font_w = 1.67; # < 2.54, font is not perfect square
39 my $font_b = 2.10; # font baseline position
41 $opt_read .= '/' unless $opt_read =~ m/\/$/;
44 open(my $fh, '<', $opt_read . shift);
51 my $model = slurp('/proc/device-tree/model');
52 $model =~ s/\x00$//; # strip kernel NULL
53 warn "# model [$model]";
56 open(DATA, '<', $opt_pins) if $opt_pins;
65 warn "MODEL [$1] == [$model] ?\n";
66 if ( $model =~ m/$1/ ) {
71 } elsif ( $include || $opt_pins ) {
72 push @{ $pins->{$1} }, $line_i while ( m/\t\s*(\w+\d+)/g );
78 warn "IGNORE: [$_]\n";
82 if ( ! $opt_pins && ! $pins ) {
84 $glob =~ s/^(\w+).*$/$1/;
85 my @pins = glob "pins/${glob}*";
86 die "pins/${glob} NOT FOUND for this board, please create one and contribute" unless @pins;
87 warn "# possible pins: ",dump( \@pins );
92 die "add pin definition for # $model" unless $pins;
94 #warn "# lines ",dump( \@lines );
95 warn "# pins ",dump($pins);
99 glob($opt_read . '/sys/devices/platform/soc*/*.serial/tty/tty*'), # 4.x
100 glob( '/sys/devices/soc.*/*.uart/tty/tty*') # 3.10
102 my @v = split(/\//, $_);
103 $serial_tty->{ $v[-3] } = $v[-1];
105 warn "# serial_tty = ",dump($serial_tty);
114 my ($pin, $note) = @_;
115 if ( $pins->{$pin} ) {
116 foreach my $line ( @{$pins->{$pin}} ) {
117 my $t = $lines[$line];
121 $t =~ s/$pin/$pin $note/ || warn "can't find $pin in [$t]";
124 warn "# $line: $lines[$line]\n";
127 warn "IGNORED: pin $pin function $note\n";
131 open(my $fh, '<', $opt_read . '/sys/kernel/debug/pinctrl/pinctrl-maps');
134 if ( m/^device (\S+)/ ) {
136 if ( my $replace = $serial_tty->{$device} ) {
137 $device = $replace; # replace serial hex with kernel name
139 $device =~ s/^[0-9a-f]*\.//; # remove hex address
141 } elsif ( m/^group (\w+\d+)/ ) {
144 } elsif ( m/^function (\S+)/ ) {
147 if ( $device && $pin && $function ) {
148 push @{ $pin_function->{$pin} }, "$device $function";
150 annotate_pin $pin, "[$device $function]";
152 warn "missing one of ",dump( $device, $pin, $function );
162 warn "# pin_function = ",dump($pin_function);
165 # insert kernel gpio info
167 open(my $pins_fh, '<', (glob "/sys/kernel/debug/pinctrl/*/pins")[0]);
169 if ( m/^pin (\d+) \(([^\)]+)\)/ ) {
170 $linux_gpio_name->{$1} = $2;
173 warn "# linux_gpio_name = ",dump( $linux_gpio_name );
177 open(my $gpio_fh, '<', '/sys/kernel/debug/gpio');
182 my @l = split(/\s*[\(\|\)]\s*/, $_);
183 warn "XXX ", dump( \@l );
184 if ( $l[0] =~ m/gpio-(\d+)/ ) {
185 if ( my $pin = $linux_gpio_name->{$1} ) {
186 $gpio_debug->{ $pin } = $l[2];
187 $l[3] =~ s/\s\s+/ /g;
188 annotate_pin $pin, qq{"$l[2]" $l[3]};
190 warn "FIXME can't find $1 in ",dump( $linux_gpio_name );
196 warn "# gpio_debug = ",dump( $gpio_debug );
200 my $have_sunxi_pio = `which sunxi-pio`;
201 if ( $have_sunxi_pio ) {
203 open(my $pio, '-|', 'sunxi-pio -m print');
207 my @p = split(/\s+/,$_);
208 warn "# pio ",dump(\@p);
209 # annotate input 0 and output 1 pins
210 # annotate_pin $p[0], ( $p[1] ? 'O' : 'I' ) . ':' . $p[4] if $p[1] == 0 || $p[1] == 1;
212 annotate_pin $pin, join(' ',@p) if ! $opt_svg;
218 my $have_raspi_gpio = `which raspi-gpio`;
219 if ( $have_raspi_gpio ) {
223 open(my $pio, '-|', 'raspi-gpio get');
226 if ( m/^\s*GPIO (\d+): (.+)/ ) {
227 my $pin = 'gpio' . $1;
229 annotate_pin $pin, $2 if ! $opt_svg;
234 open(my $pio, '-|', 'raspi-gpio funcs '.join(',',@gpio_pins));
238 if (m/^(\d+)\s+(.*)/) {
239 annotate_pin 'gpio'.$1,"($2)" if $opt_alt;
248 my $pinmux_path = (glob("/sys/kernel/debug/pinctrl/*/pinmux-functions"))[0];
249 if ( $opt_pinmux && -e $pinmux_path ) {
250 open(my $mux, '<', $pinmux_path);
253 if ( m/function: (\w+), groups = \[ (.*) \]/ ) {
254 my ( $func, $pins ) = ( $1, $2 );
255 foreach ( split(/\s+/,$pins) ) {
256 push @{ $pinmux->{$_} }, $func;
259 warn "IGNORED [$pinmux_path] [$_]\n";
263 foreach my $pin ( keys %$pinmux ) {
264 if ( exists $pins->{$pin} ) {
265 annotate_pin $pin, '{' . join(' ', @{$pinmux->{$pin}}) . '}';
267 warn "IGNORED mux on $pin\n";
271 warn "# pinmux = ",dump( $pinmux );
276 my @max_len = ( 0,0,0,0 );
279 shift(@lines) while ( ! $lines[0] ); # remove empty at beginning
280 pop(@lines) while ( ! $lines[-1] ); # remove empty at end
282 foreach my $line (@lines) {
283 if ( $line =~ m/^#/ ) {
284 push @line_parts, [ $line ] unless $opt_svg && $line =~ m/^###+/; # SVG doesn't display 3rd level comments
287 $line =~ s/\[(\w+)\s+(\w+)\] \[\1\s+(\w+)\]/[$1 $2 $3]/g; # compress kernel annotation with same prefix
288 $line =~ s/(\[(?:uart\d*|serial|tty\w+))([^\t]*\]\s[^\t]*(rx|tx)d?)/$1 $3$2/gi;
289 $line =~ s/(\[i2c)([^\t]*\]\s[^\t]*(scl?k?|sda))/$1 $3$2/gi;
290 $line =~ s/(\[spi)([^\t]*\]\s[^\t]*(miso|mosi|s?clk|c[se]\d*))/$1 $3$2/gi;
291 $line =~ s/\s*\([^\)]+\)//g if ! $opt_alt;
293 # shorten duplicate kernel device/function
294 $line =~ s/\[serial (\w+) (uart\d+)\]/[$2 $1]/g;
295 $line =~ s/\[(\w+) (\w+) \1(\d+)\]/[$1$3 $2]/g;
297 $line =~ s/\[(\w+)\s+([^\]]+)\s+\1\]/[$1 $2]/g; # duplicate
299 my @v = split(/\s*\t+\s*/,$line,4);
300 @v = ( $v[2], $v[3], $v[0], $v[1] ) if $opt_horizontal && $v[2];
302 push @line_parts, [ @v ];
303 foreach my $i ( 0 .. 3 ) {
304 next unless exists $v[$i];
305 next if $v[$i] =~ m/^#/; # don't calculate comments into max length
306 my $l = length($v[$i]);
307 $max_len[$i] = $l if $l > $max_len[$i];
311 warn "# max_len = ",dump( \@max_len );
312 warn "# line_parts = ",dump( \@line_parts );
314 #print "$_\n" foreach @lines;
320 print qq{<?xml version="1.0" encoding="UTF-8" standalone="no"?>
322 xmlns:dc="http://purl.org/dc/elements/1.1/"
323 xmlns:cc="http://creativecommons.org/ns#"
324 xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
325 xmlns:svg="http://www.w3.org/2000/svg"
326 xmlns="http://www.w3.org/2000/svg"
327 xmlns:xlink="http://www.w3.org/1999/xlink"
330 viewBox="0 0 210 297"
337 }; # svg, insert rest of rect
339 print qq{<rect x="0" y="0" width="210" height="297" style="fill:#000000" id="high-contrast"/>} if $opt_invert;
344 my $cols = { # foreground background
345 txt => [ '#000000', '#ffffff' ],
346 pins => [ '#ffffff', '#ff00ff' ],
347 vcc => [ '#ff0000', '#ffff00' ],
348 gnd => [ '#000000', '#00ffff' ],
349 i2c => [ '#008800', '#ffcccc' ],
350 serial=>[ '#000088', '#ccffcc' ],
351 spi => [ '#880000', '#ccccff' ],
356 die "$swap not found in ",dump($cols) unless $cols->{$swap};
357 my ( $c1, $c2 ) = @{ $cols->{$swap} };
358 $cols->{$swap} = [ $c2, $c1 ];
361 swap_cols 'txt' if $opt_invert;
365 my ($name,$x,$y,$col) = @_;
367 return '' unless $opt_color;
369 $y -= $font_b; # shift box overlay to right vertical position based on font baseline
372 my ($x,$y,$col,$fill) = @_;
373 print qq{<rect x="$x" y="$y" height="2.54" width="}, $max_len[$col] * $font_w, qq{" style="fill:$fill;stroke:#ffffff;stroke-width:0.10" />\n};
377 if ( $name =~ m/^(\d+)$/ ) { # pins
379 my ( $fg, $bg ) = @{ $cols->{pins} };
381 my $w = $max_len[$col]*$font_w - 0.1;
384 #print qq{<polygon points="$x,$y $cx,$y $x,$cy $x,$y" stroke="$fg" stroke-width="0.25" fill="$bg" />};
385 #print qq{<polygon points="$x,$cy $cx,$cy $cx,$y $x,$cy" stroke="$bg" stroke-width="0.25" fill="$fg" />};
386 print qq{<rect x="$x" y="$y" width="$w" height="2.54" stroke="$fg" stroke-width="0.3" fill="$bg" />};
387 my ( $fg, $bg ) = @{ $cols->{txt} };
388 print qq{<rect x="$x" y="$y" width="$w" height="2.54" rx="1" ry="1" stroke="$fg" stroke-width="0.3" fill="$bg" />};
392 return qq{ style="fill:$bg"};
395 if ( $name =~ m/(VCC|3V3|3.3V|5v)/i ) {
396 my ($fg,$bg) = @{ $cols->{vcc} };
398 return qq{ style="fill:$fg"};
399 } elsif ( $name =~ m/(G(ND|Round)|VSS|0v)/i ) {
400 my ($fg,$bg) = @{ $cols->{gnd} };
402 return qq{ style="fill:$fg"};
403 } elsif ( $name =~ m/\[(\w+)/ ) { # kernel
405 my ($fg,$bg) = @{ $cols->{txt} };
406 $dev = 'serial' if $dev =~ m/^tty/;
407 ($fg,$bg) = @{ $cols->{$dev} } if exists $cols->{$dev};
409 return qq{ style="fill:$fg"};
411 my ( $fg, $bg ) = @{ $cols->{txt} };
413 #return qq{ style="fill:$fg"};
420 my @cols_order = ( 0,1,2,3 );
421 my @cols_align = ( '','-','','-' ); # sprintf prefix
423 my @cols_shuffle = @cols_order;
426 # pins outside on the right
427 @cols_shuffle = ( 0,1,3,2 ) if $opt_edge;
428 @cols_align = ( '-','-','','' );
429 } elsif ( $opt_middle ) {
431 @cols_shuffle = ( 1,0,2,3 );
432 @cols_align = ( '','','-','-' );
436 my ( $what, $order ) = @_;
438 foreach my $i ( 0 .. $#$what ) {
439 $new->[$i] = $what->[ $order->[$i] ];
441 warn "# cols_shuffle what=",dump($what)," order=",dump($order)," new=",dump($new);
445 @cols_order = cols_shuffle( \@cols_order, \@cols_shuffle );
446 @max_len = cols_shuffle( \@max_len, \@cols_shuffle );
448 warn "# cols_order = ",dump( \@cols_order );
449 warn "# cols_align = ",dump( \@cols_align );
451 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";
455 my ($fg,$bg) = @{ $cols->{txt} };
456 my $line_fmt = qq{<line x1="%s" y1="%s" x2="%s" y2="%s" style="stroke:$fg;stroke-width:0.10;fill:$bg" />\n};
461 return unless $opt_svg;
462 push @cut_marks, sprintf($line_fmt, $x-5, $y-$font_b, $x+5, $y-$font_b);
463 push @cut_marks, sprintf($line_fmt, $x, $y-$font_b-5, $x, $y-$font_b+5);
467 $max_x += $max_len[$_] * $font_w foreach ( 0 .. 3 );
468 #cut_mark $max_x, $y;
471 my ($x,$y,$max_x) = @_;
472 push @cut_marks, sprintf($line_fmt, $x, $y-$font_b, $max_x, $y-$font_b);
476 my $last_cut_mark = 0;
479 my ( $from, $to ) = @_;
480 warn "# connector $from - $to ",dump( $line_parts[$from], $line_parts[$to] );
481 if ( $opt_vertical ) {
482 foreach my $i ( 0 .. int(($to-$from)/2) ) {
483 my $t = $line_parts[$from + $i];
484 $line_parts[$from + $i] = $line_parts[$to - $i];
485 $line_parts[$to - $i] = $t;
492 foreach my $i ( 0 .. $#line_parts ) {
493 next if $line_parts[$i]->[0] =~ m/^###/;
494 if (exists $line_parts[$i]->[1]) {
500 } elsif ($from && $to) {
501 connector $from => $to;
505 connector $from => $to if $from && $to;
507 foreach my $i ( 0 .. $#line_parts ) {
508 # $i = $#line_parts - $i if $opt_vertical;
509 my $line = $line_parts[$i];
513 # not a minimal two column pin description
514 if ( ! exists $line->[1] ) {
515 $last_cut_mark = 1 if $line->[0] =~ m/^##/; # skip comments
517 # before first empty line
518 if ( $last_cut_mark == 0 ) {
522 line $x, $y, $max_x if $opt_lines;
523 $y += 15; # make spacing between pinouts
525 } elsif ( $last_cut_mark ) {
531 #warn "CUTMARK no magic";
534 line $x, $y, $max_x if $opt_lines && exists $line->[1];
536 my ($fg,$bg) = @{ $cols->{txt} };
537 my $tspan = qq{<tspan x="$x" y="$y" style="line-height:2.54;fill:$fg;stroke:none;">\n};
540 foreach my $i ( 0 .. $#cols_order ) {
541 my $order = $cols_order[$i];
542 next unless $line->[$order];
544 my $text_anchor = 'middle';
545 my $len = $max_len[$i];
546 my $x2 = $x_pos + ( $len * $font_w ) / 2;
548 if ( $#$line == 0 && $line->[$order] =~ s/^#+s*// ) {
549 # comment, center over whole width
550 $len = length($line->[$order]);
551 $x2 = $x + (($max_x-$x)/2); # middle
552 $tspan .= qq{\t<tspan x="$x2" text-anchor="$text_anchor"}.sprintf( '>%' . $cols_align[$i] . $len . 's</tspan>', $line->[0]);
554 $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]);
556 $x_pos += $len * $font_w;
559 $tspan .= qq{\n</tspan>\n};
560 push @later,sprintf $tspan, @$line;
563 # swap pin colors for line stripe
565 swap_cols $_ foreach qw( pins txt );
572 if ( $#$line == 0 ) {
573 print $line->[0], "\n";
575 push @$line, '' while ($#$line < 3); # fill-in single row header
576 printf $fmt, map { $line->[$_] } @cols_order;
585 line $x, $y, $max_x if $opt_lines;
592 style="font-size:2.34px;line-height:2.54px;font-family:'Andale Mono';stroke:none"
593 xml:space="preserve">
597 print @later, qq{</text>\n}, @cut_marks, qq{</g>\n</svg>};
601 # you can add pin definitions below, but they should go into pins/