# Copyright (c) 2023 OwnTech
# SPDX-License-Identifier: LGLPV2.1

description: |
    GPIO pins exposed on OwnTech Spin headers.

    The OwnTech Spin board provides 6 headers:
    * 3 around the external egde of the board,
    * 3 within the board.

    Proceeding counter-clockwise:
    * A 20-pin header on the external left of the board, numbered from 1 to 20 top to bottom.
      Pins 3, 8, 13 and 18 are GND, thus not exposed in this binding.
    * A 20-pin header on the external right of the board, numbered from 21 to 40 bottom to top.
      Pins 23, 28, 33 and 38 are GND, while pins 36, 39 and 40 are voltage, thus not
      exposed in this binding.
    * A 5-pin header on the internal top left of the board, numbered from 41 to 45.
    * A 7-pin header on the internal bottom left of the board, numbered from 46 to 52.
    * A 6-pin header on the bottom of the board, numbered from 53 to 58.
      Pins 54 and 57 are GND, thus not exposed in this binding.
    * A 1-pin header on the internal bottom right of the board, numbered 59.


    This binding provides a nexus mapping for 49 pins.
    Pins not described in this map are displayed between curly brackets.

    ----------------------------------
    |  1                         (40)|
    |  2                         (39)|
    | (3)                        (38)|
    |  4  41                      37 |
    |  5  42                     (36)|
    |  6  43                      35 |
    |  7  44                      34 |
    | (8) 45                     (33)|
    |  9                          32 |
    | 10                          31 |
    | 11                          30 |
    | 12                          29 |
    |(13) 46                     (28)|
    | 14  47                      27 |
    | 15  48                      26 |
    | 16  49                      25 |
    | 17  50                      24 |
    |(18) 51                     (23)|
    | 19  52                  59  22 |
    | 20  53 (54) 55  56 (57) 58  21 |
    ----------------------------------

compatible: "spin-header"

include: [gpio-nexus.yaml, base.yaml]