/// <summary>
/// Соответствие между кнопками игрового ввода и цифровыми выходами периферийной платы.
/// Содержит mapping для управления двух игроков, служебных кнопок и датчиков хопера.
/// 
/// Структура:
/// ПЛАТА 1 (биты 0-7):  0=вниз1, 1=влево1, 2=вверх1, 3=право1, 4=поворот1, 5=action1, 6=секретка1, 7=запасная1
/// ПЛАТА 2 (биты 8-15): 8=вниз2, 9=влево2, 10=вверх2, 11=право2, 12=поворот2, 13=action2, 14=секретка2, 15=запасная2
/// ХОПЕРЫ (биты 16-19): 16-17 для платы1, 18-19 для платы2
/// </summary>
public enum ButtonPinMapping
{
    // === ПЛАТА 1: Игрок 1 (биты 0-7) ===
    /// <summary>Кнопка движения вниз для первого игрока</summary>
    down1 = 0,
    /// <summary>Кнопка движения влево для первого игрока</summary>
    left1 = 1,
    /// <summary>Кнопка движения вверх для первого игрока</summary>
    up1 = 2,
    /// <summary>Кнопка движения вправо для первого игрока</summary>
    right1 = 3,
    /// <summary>Поворот для первого игрока</summary>
    turn1 = 4,
    /// <summary>Действие/огонь для первого игрока</summary>
    action1 = 5,
    /// <summary>Секретная/служебная кнопка для первого игрока</summary>
    secret1 = 6,
    /// <summary>Дополнительная/резервная кнопка для первого игрока</summary>
    extra1 = 7,

    // === ПЛАТА 2: Игрок 2 (биты 8-15) ===
    /// <summary>Кнопка движения вниз для второго игрока</summary>
    down2 = 8,
    /// <summary>Кнопка движения влево для второго игрока</summary>
    left2 = 9,
    /// <summary>Кнопка движения вверх для второго игрока</summary>
    up2 = 10,
    /// <summary>Кнопка движения вправо для второго игрока</summary>
    right2 = 11,
    /// <summary>Поворот для второго игрока</summary>
    turn2 = 12,
    /// <summary>Действие/огонь для второго игрока</summary>
    action2 = 13,
    /// <summary>Секретная/служебная кнопка для второго игрока</summary>
    secret2 = 14,
    /// <summary>Дополнительная/резервная кнопка для второго игрока</summary>
    extra2 = 15,

    // === ХОПЕРЫ (биты 16-19) ===
    /// <summary>Датчик наличия приза в хопере платы 1</summary>
    hasPrize1 = 16,
    /// <summary>Датчик выдачи приза из хопера платы 1</summary>
    prizeGiven1 = 17,
    /// <summary>Датчик наличия приза в хопере платы 2</summary>
    hasPrize2 = 18,
    /// <summary>Датчик выдачи приза из хопера платы 2</summary>
    prizeGiven2 = 19
}