# Lightning Payment Dual Beer Tap Controller

A Bitcoin Lightning Network payment-activated dual beer tap controller using Raspberry Pi and LNbits. Monitor two different Lightning wallets and control two separate beer taps independently.

## 🚀 Project Overview

This enhanced system monitors **two different LNbits Lightning wallets** for incoming payments and automatically activates the corresponding 12V solenoid valve when payments are received. Perfect for Bitcoin-powered dual beer taps, different beer types, pricing tiers, or any beverage dispensing application requiring independent payment-activated hardware control.

- bitcoinswitch_tester.py - python file to test your lnbits api
- lightning_solenoid_polling.py - python script to test controls of a single solenoid
- dual_beer_tap.py - final solution to control 2 beer taps, each for a different lnbits wallet
- config_example.py - example configurations for dual_beer_tap

## ⚡ Features

- **Dual beer tap system** - Monitor two different LNbits wallets simultaneously
- **Independent tap control** - Each wallet triggers its own beer tap
- **Fast internal payment detection** - Catches instant payments within the same LNbits server
- **Timezone-aware timestamp handling** - Proper handling of API timestamps
- **Real-time Lightning payment detection** via LNbits API polling
- **Reliable payment verification** using dedicated payment status endpoints
- **Hardware control** via GPIO relay switching for two separate relays
- **Smart filtering** - only new payments trigger activation (ignores historical)
- **Configurable settings per beer tap** - Different minimum payments, pour rates, durations
- **Automatic reconnection** and error handling
- **Memory management** - Prevents memory leaks with payment tracking cleanup
- **Detailed logging** for monitoring and debugging both beer taps

## 🛠 Hardware Requirements

### Core Components
- **Raspberry Pi Zero W** (with WiFi) or Raspberry Pi 4
- **MicroSD card** (8GB+, Class 10 recommended)
- **2x 5V Relay Modules** (3-terminal: COM, NO, NC) - or 1x dual relay module
- **2x 12V Solenoid Valves** (2-wire, normally closed recommended) - for beer tap control
- **12V Power Supply** (5A+ recommended for dual beer taps)
- **Jumper wires** for connections

### Pi pinout
```
Left Side (Odd pins):          Right Side (Even pins):
═════════════════════          ═══════════════════════
Pin 1  - 3V3                   Pin 2  - 5V (Relay 1)
Pin 3  - GPIO2                 Pin 4  - 5V (Relay 2)
Pin 5  - GPIO3                 Pin 6  - GND (Relay 1)
...                            ...
Pin 11 - GPIO17                Pin 12 - GPIO18 (Relay 1)
Pin 13 - GPIO27                Pin 14 - GND (Button 1)
Pin 15 - GPIO22                Pin 16 - GPIO23 (Button 1)
Pin 17 - 3V3                   Pin 18 - GPIO24 (Button 2)
Pin 19 - GPIO10                Pin 20 - GND (Button 2)
...                            ...
Pin 35 - GPIO19 (Relay 2)      Pin 36 - GPIO16
Pin 37 - GPIO26                Pin 38 - GPIO20
Pin 39 - GND (Relay 2)         Pin 40 - GPIO21

┌────────────────────────────────────────────────────────────────────────┐
│         LIGHTNING PAYMENT DUAL SOLENOID SYSTEM WITH BUTTONS            │
└────────────────────────────────────────────────────────────────────────┘

RELAY 1 (GPIO 18):
═══════════════════
Pi Pin 12 (GPIO18) ──────► Relay 1 Signal (S)
Pi Pin 2  (5V)     ──────► Relay 1 VCC (+)
Pi Pin 6  (GND)    ──────► Relay 1 GND (-)

    Relay 1 Power Side:
    12V+ ──► COM (center)
    NO (left) ──► Solenoid 1 Wire 1
    Solenoid 1 Wire 2 ──► 12V-


RELAY 2 (GPIO 19):
═══════════════════
Pi Pin 35 (GPIO19) ──────► Relay 2 Signal (S)
Pi Pin 4  (5V)     ──────► Relay 2 VCC (+)
Pi Pin 39 (GND)    ──────► Relay 2 GND (-)

    Relay 2 Power Side:
    12V+ ──► COM (center)
    NO (left) ──► Solenoid 2 Wire 1
    Solenoid 2 Wire 2 ──► 12V-


BUTTONS:
════════
Pi Pin 16 (GPIO23) ──┬─[ Button 1 ]─┬── Pi Pin 14 (GND)
                     └───────────────┘

Pi Pin 18 (GPIO24) ──┬─[ Button 2 ]─┬── Pi Pin 20 (GND)
                     └───────────────┘


12V POWER DISTRIBUTION:
═══════════════════════
        ┌─────────────┐
        │  12V Power  │
        │   Supply    │
        │   (+)  (-)  │
        └──┬──────┬───┘
           │      │
           │      ├──────► Solenoid 1 Wire 2
           │      └──────► Solenoid 2 Wire 2
           │
           ├────────────► Relay 1 COM
           └────────────► Relay 2 COM
```
### Relay Connections
```
Relay Module → Pi Zero W Pin
VCC         → Pin 2 (5V)
GND         → Pin 6 (GND) 
IN          → Pin 12 (GPIO 18)
```

### Power Circuit (12V side):
```
12V Power Supply (+) → Relay COM terminal
Relay NO terminal    → Solenoid cable 2
Solenoid cable 1     → 12V Power Supply (-)
```
### Control Circuit (Pi side):
```
Pi GPIO 18 (Pin 12) → Relay S pin ✅
Pi 5V (Pin 2)       → Relay + pin ✅  
Pi GND (Pin 6)      → Relay - pin ✅
```
### Complete Wirig Diagram
```
┌────────────────────────────────────────────────────────────────────────┐
│         LIGHTNING PAYMENT DUAL SOLENOID SYSTEM WITH BUTTONS            │
└────────────────────────────────────────────────────────────────────────┘

┌──────────────────┐    ┌───────────┐  ┌───────────┐    ┌──────────────┐
│  Raspberry Pi    │    │  Relay 1  │  │  Relay 2  │    │  Solenoids   │
│  Zero W          │    │  (GPIO18) │  │  (GPIO19) │    │              │
│                  │    │           │  │           │    │              │
│  [GPIO Layout]   │    │  [Ctrl]   │  │  [Ctrl]   │    │              │
│                  │    │  S ─────  │  │  S ─────  │    │              │
│  Pin 1  (3V3)    │    │  + ─────  │  │  + ─────  │    │              │
│  Pin 2  (5V) ────┼────┼──┤        │  │           │    │              │
│  Pin 3  (GPIO2)  │    │  - ─────  │  │  - ─────  │    │              │
│  Pin 4  (5V) ────┼────┼──────────────┼──┤        │    │              │
│  Pin 5  (GPIO3)  │    │           │  │           │    │              │
│  Pin 6  (GND)────┼────┼──┤        │  │           │    │              │
│  Pin 7  (GPIO4)  │    │  [Power]  │  │  [Power]  │    │              │
│  Pin 8  (GPIO14) │    │  NO(L)────┼──┼───────────┼────┤ Solenoid 1+  │
│  Pin 9  (GND)    │    │  COM(C)───┼──┼───────┐   │    │              │
│  Pin 10 (GPIO15) │    │  NC(R)    │  │       │   │    │              │
│  Pin 11 (GPIO17) │    │           │  │  NO(L)────┼────┤ Solenoid 2+  │
│  Pin 12 (GPIO18)─┼────┼──► S      │  │  COM(C)───┼────┼──┐           │
│  Pin 13 (GPIO27) │    └───────────┘  │  NC(R)    │    │  │           │
│  Pin 14 (GND)────┼────┐              │      G  S │    │  │           │
│  Pin 15 (GPIO22) │    │              └──────|─|──┘    │  │           │
│  Pin 16 (GPIO23)─┼──┐ │                     | |       │  │           │
│  Pin 17 (3V3)    │  │ │                     | |       │  │           │
│  Pin 18 (GPIO24)─┼─┐│ │                     | |       │  │           │
│  Pin 19 (GPIO10) │ ││ │                     | |       │  │           │
│  Pin 20 (GND)────┼┐││ │                     | |       │  │           │
│  Pin 21 (GPIO9)  │││││                      | |       │  │           │
│  Pin 22 (GPIO25) │││││                      | |       │  │           │
│  Pin 24 (GPIO8)  │││││                      | |       │  │           │
│  Pin 25 (GND)    │││││                      | |       │  │           │
│  Pin 26 (GPIO7)  │││││                      | |       │  │           │
│  Pin 27 (ID_SD)  │││││                      | |       │  │           │
│  Pin 28 (ID_SC)  │││││                      | |       │  │           │
│  Pin 29 (GPIO5)  │││││                      | |       │  │           │
│  Pin 30 (GND)    │││││                      | |       │  │           │
│  Pin 31 (GPIO6)  │││││                      | |       │  │           │
│  Pin 32 (GPIO12) │││││                      | |       │  │           │
│  Pin 33 (GPIO13) │││││                      | |       │  │           │
│  Pin 34 (GND)    │││││                      | |       │  │           │
│  Pin 35 (GPIO19)─┼┼┼┼┼──────────────────────|─| S     │  │           │
│  Pin 36 (GPIO16) │││││                      |         │  │           │
│  Pin 37 (GPIO26) │││││                      |         │  │           │
│  Pin 38 (GPIO20) │││││                      |         │  │           │
│  Pin 39 (GND)────┼┼┼┼┼──────────────────────┤         │  │           │
│  Pin 40 (GPIO21) │││││                                │  │           │
└──────────────────┘││││└────────────────────────────────┼──┼───────────┘
                    │││││                                │  │
                    │││││         ┌──────────────────────┘  │
                    │││││         │  ┌──────────────────────┘
                    │││││   ┌─────▼──▼─────┐
                    │││││   │  12V DC      │
                    │││││   │  Power       │
                    │││││   │  Supply      │
                    │││││   │  (+)    (−)  │
                    │││││   └──┬──────┬────┘
                    │││││      │      │
                    │││││      │      └────► Solenoid 1-
                    │││││      │      └────► Solenoid 2-
                    │││││      │
                    ││││└──────┐
                    │││└────┐  │
                    ││└──┐  │  │
                    │└─┐ │  │  │
                    │  │ │  │  │
                  ┌─▼──▼─┐ ┌▼──▼─┐
                  │Button│ │Button│
                  │  1   │ │  2   │
                  │ [  ] │ │ [  ] │
                  └──────┘ └──────┘
```