#168Intermediário

Jogo de cabo de guerra com LEDs e Raspberry Pi Pico (fita NeoPixel + 2 botões + buzzer)

Duelo de botões para dois jogadores! O Raspberry Pi Pico transforma uma fita NeoPixel WS2812B de 30 LEDs em uma corda: vermelho à esquerda, azul à direita. Cada toque avança sua cor em um LED; preencha a fita para vencer a rodada e ganhe 3 rodadas para vencer a partida. Se apertar cedo demais na contagem regressiva, você perde terreno; o buzzer passivo dá um clique diferente a cada jogador, e a partida termina em um arco-íris. neopixel, debounce e som sem bloqueio em MicroPython.

0.0(0)
1 concluído
Jogo de cabo de guerra com LEDs e Raspberry Pi Pico (fita NeoPixel + 2 botões + buzzer)
Um jogo luminoso de cabo de guerra em que você e um amigo disputam quem tem os dedos mais rápidos. Um lado da fita de 30 LEDs é vermelho e o outro é azul; quem aperta o botão mais rápido puxa o nó do meio para o seu lado, e quem preencher toda a fita com sua cor primeiro vence a rodada. Quem começa antes da hora recebe uma penalidade, o primeiro a ganhar três rodadas vence a partida, e depois vem um show de arco-íris com uma melodia de vitória.

Vídeo

Esquema do circuito

Jogo de cabo de guerra com LEDs e Raspberry Pi Pico (fita NeoPixel + 2 botões + buzzer) - Circuit

Código-fonte

MicroPython
1# ─────────────────────────────────────────
2#   BlueGrays · bluegrays.com
3#   Jogo de cabo de guerra com LEDs e Raspberry Pi Pico (fita NeoPixel + 2 botões + buzzer)
4# ─────────────────────────────────────────
5# Duelo de botões para dois jogadores. Cada aperto empurra a sua cor um
6# passo na fita; quem chega primeiro à outra ponta vence a rodada, e quem
7# vence 3 rodadas primeiro vence a partida. Apertar antes da hora durante
8# a contagem custa 2 passos.
9#
10# Pinos:
11#   GP2  -> DIN da fita
12#   GP14 -> Botão do jogador 1 (RED), outra perna no GND
13#   GP16 -> Botão do jogador 2 (BLUE), outra perna no GND
14#   GP15 -> Buzzer (+)
15
16from machine import Pin, PWM
17from neopixel import NeoPixel
18import time
19import math
20
21# ============ CONFIGURAÇÕES ============
22NUM_LEDS = 30          # LEDs na fita
23BRIGHTNESS = 0.6       # ~0.4 A com cores, tudo bem para USB
24WIN_ROUNDS = 3         # Rodadas para vencer a partida
25FALSE_START_STEPS = 2  # Penalidade por queimar a largada
26SOUND_ON = True        # Efeitos sonoros
27
28RED = (255, 0, 0)      # Jogador 1
29BLUE = (0, 60, 255)    # Jogador 2
30
31# Nó = número de LEDs vermelhos (a fronteira entre as cores). Os dois jogadores precisam do mesmo
32# número de passos.
33START = NUM_LEDS // 2                   # Fronteira inicial
34GOAL = min(START, NUM_LEDS - START)     # Passos necessários para vencer
35
36# ============ HARDWARE ============
37strip = NeoPixel(Pin(2), NUM_LEDS)
38btn1 = Pin(14, Pin.IN, Pin.PULL_UP)   # Jogador 1
39btn2 = Pin(16, Pin.IN, Pin.PULL_UP)   # Jogador 2
40buzzer = PWM(Pin(15))
41buzzer.duty_u16(0)
42
43
44# ============ SOM ============
45class Sound:
46    """
47    TR: Bloklamayan nota calici: oyun ses calarken de butonlari okur
48    EN: Non-blocking note player: the game keeps reading buttons while sound plays
49    """
50
51    def __init__(self, pwm):
52        self.pwm = pwm
53        self.queue = []
54        self.until = 0
55
56    def play(self, notes):
57        # notes = [(frequência, ms), ...], frequência 0 = pausa
58        if SOUND_ON:
59            self.queue = list(notes)
60            self.until = 0
61
62    def update(self):
63        now = time.ticks_ms()
64        if self.until and time.ticks_diff(now, self.until) < 0:
65            return
66        if not self.queue:
67            if self.until:
68                self.pwm.duty_u16(0)
69                self.until = 0
70            return
71        freq, ms = self.queue.pop(0)
72        if freq:
73            self.pwm.freq(freq)
74            self.pwm.duty_u16(20000)
75        else:
76            self.pwm.duty_u16(0)
77        self.until = time.ticks_add(now, ms)
78
79
80sound = Sound(buzzer)
81
82
83# ============ BOTÃO ============
84class Button:
85    """
86    TR: 15 ms debounce ile yeni basislari yakalar
87    EN: Catches new presses with a 15 ms debounce
88    """
89
90    def __init__(self, pin):
91        self.pin = pin
92        self.state = 1
93        self.raw = 1
94        self.changed = time.ticks_ms()
95
96    def pressed(self):
97        now = time.ticks_ms()
98        raw = self.pin.value()
99        if raw != self.raw:
100            self.raw = raw
101            self.changed = now
102        if time.ticks_diff(now, self.changed) > 15 and raw != self.state:
103            self.state = raw
104            return raw == 0
105        return False
106
107    def sync(self):
108        # Esquece apertos antigos (um botão segurado entre rodadas não é penalizado)
109        self.state = self.raw = self.pin.value()
110        self.changed = time.ticks_ms()
111
112
113b1 = Button(btn1)
114b2 = Button(btn2)
115
116
117# ============ AUXILIARES DE DESENHO ============
118def dim(color, k=1.0):
119    # Escala uma cor pelo brilho global e por k
120    s = BRIGHTNESS * k
121    return (int(color[0] * s), int(color[1] * s), int(color[2] * s))
122
123
124def fill(color, k=1.0):
125    c = dim(color, k)
126    for i in range(NUM_LEDS):
127        strip[i] = c
128    strip.write()
129
130
131def draw_rope(knot):
132    # `knot` LEDs ficam vermelhos (esquerda) e o resto azul (direita); 2 LEDs de cada lado da
133    # fronteira formam o "nó" brilhante
134    for i in range(NUM_LEDS):
135        if i < knot:
136            k = 1.0 if knot - i <= 2 else 0.45   # Os LEDs perto do nó são mais fortes
137            strip[i] = dim(RED, k)
138        else:
139            k = 1.0 if i - knot < 2 else 0.45
140            strip[i] = dim(BLUE, k)
141    strip.write()
142
143
144def wheel(pos):
145    # Converte 0-255 em uma cor do arco-íris
146    pos %= 256
147    if pos < 85:
148        return (255 - pos * 3, pos * 3, 0)
149    if pos < 170:
150        pos -= 85
151        return (0, 255 - pos * 3, pos * 3)
152    pos -= 170
153    return (pos * 3, 0, 255 - pos * 3)
154
155
156def wait_ms(ms):
157    # Espera mantendo o som tocando
158    end = time.ticks_add(time.ticks_ms(), ms)
159    while time.ticks_diff(end, time.ticks_ms()) > 0:
160        sound.update()
161        time.sleep_ms(5)
162
163
164# ============ FASES DO JOGO ============
165def attract():
166    # Espera: as duas cores respiram, qualquer botão começa o jogo
167    print("Baslamak icin bir butona bas / Press a button to start")
168    b1.sync()
169    b2.sync()
170    t0 = time.ticks_ms()
171    while True:
172        sound.update()
173        t = time.ticks_diff(time.ticks_ms(), t0)
174        k = 0.25 + 0.75 * (math.sin(t / 400) + 1) / 2
175        for i in range(NUM_LEDS):
176            if i < START:
177                strip[i] = dim(RED, k)
178            else:
179                strip[i] = dim(BLUE, 1.25 - k)   # Respira em fase oposta
180        strip.write()
181        if b1.pressed() or b2.pressed():
182            return
183        time.sleep_ms(15)
184
185
186def countdown():
187    # Contagem 3-2-1; apertos antecipados são penalizados. Retorna o nó inicial
188    knot = START
189    b1.sync()
190    b2.sync()
191    colors = [(255, 0, 0), (255, 150, 0), (0, 255, 0)]   # Vermelho, amarelo, verde
192    for step in range(3):
193        fill(colors[step], 0.6)
194        if step == 2:
195            sound.play([(1200, 200)])   # GO! (já!)
196            break
197        sound.play([(600, 150)])
198        end = time.ticks_add(time.ticks_ms(), 800)
199        while time.ticks_diff(end, time.ticks_ms()) > 0:
200            sound.update()
201            if b1.pressed():
202                knot -= FALSE_START_STEPS
203                print("Oyuncu 1 erken basti! / Player 1 false start!")
204                sound.play([(150, 200)])
205            if b2.pressed():
206                knot += FALSE_START_STEPS
207                print("Oyuncu 2 erken basti! / Player 2 false start!")
208                sound.play([(150, 200)])
209            time.sleep_ms(5)
210    # As penalidades não podem empurrar o nó até uma ponta
211    return max(START - GOAL + 2, min(START + GOAL - 2, knot))
212
213
214def play_round(knot):
215    # Duelo de botões; retorna o vencedor (1 ou 2) quando o nó chega a uma ponta
216    draw_rope(knot)
217    while True:
218        sound.update()
219        moved = False
220        if b1.pressed():
221            knot += 1
222            sound.play([(440, 25)])
223            moved = True
224        if b2.pressed():
225            knot -= 1
226            sound.play([(660, 25)])
227            moved = True
228        if moved:
229            if knot >= START + GOAL:   # Fita toda vermelha
230                return 1
231            if knot <= START - GOAL:   # Fita toda azul
232                return 2
233            draw_rope(knot)
234        time.sleep_ms(1)
235
236
237def celebrate_round(winner, scores):
238    # A cor do vencedor pisca 3 vezes e depois aparecem os pontos do placar
239    color = RED if winner == 1 else BLUE
240    print("Turu kazanan / Round winner: Oyuncu / Player", winner, "| Skor / Score:", scores[0], "-", scores[1])
241    sound.play([(523, 120), (659, 120), (784, 120), (1047, 300)])
242    for _ in range(3):
243        fill(color)
244        wait_ms(180)
245        fill((0, 0, 0))
246        wait_ms(120)
247    # Placar: pontos vermelhos a partir da esquerda, azuis a partir da direita
248    for i in range(NUM_LEDS):
249        strip[i] = (0, 0, 0)
250    for s in range(scores[0]):
251        strip[s * 2] = dim(RED)
252    for s in range(scores[1]):
253        strip[NUM_LEDS - 1 - s * 2] = dim(BLUE)
254    strip.write()
255    wait_ms(1800)
256
257
258def celebrate_match(winner):
259    # Fim da partida: onda de arco-íris e música de vitória
260    print("MACI KAZANAN / MATCH WINNER: Oyuncu / Player", winner)
261    sound.play([(784, 150), (784, 150), (784, 150), (1047, 450), (0, 80), (988, 150), (1047, 500)])
262    t0 = time.ticks_ms()
263    while time.ticks_diff(time.ticks_ms(), t0) < 3500:
264        sound.update()
265        offset = time.ticks_diff(time.ticks_ms(), t0) // 8
266        for i in range(NUM_LEDS):
267            strip[i] = dim(wheel(i * 256 // NUM_LEDS + offset))
268        strip.write()
269        time.sleep_ms(15)
270    fill(RED if winner == 1 else BLUE)
271    wait_ms(1000)
272
273
274# ============ LOOP PRINCIPAL ============
275print("== BlueGrays · bluegrays.com ==")
276print("Pico LED Halat Cekme / LED Tug of War")
277
278scores = [0, 0]
279while True:
280    attract()
281    while max(scores) < WIN_ROUNDS:
282        start_knot = countdown()
283        winner = play_round(start_knot)
284        scores[winner - 1] += 1
285        celebrate_round(winner, scores)
286    celebrate_match(1 if scores[0] > scores[1] else 2)
287    scores = [0, 0]
288

Perguntas frequentes

Minha fita não tem 30 LEDs. Posso usar outro comprimento?

Sim. Defina `NUM_LEDS` no início do código com a quantidade de LEDs da sua fita; o ponto inicial (`START`) e os passos necessários para vencer (`GOAL`) são calculados automaticamente. Em uma fita de 60 LEDs, cada jogador precisa apertar 30 vezes para vencer, então as rodadas duram mais.

Preciso mesmo do resistor de 330 Ω e do capacitor de 470 µF?

No Wokwi, não, mas são recomendados no circuito real. Coloque um resistor de 330 Ω em série entre GP2 e DIN da fita, e um capacitor de 470 µF entre 5V e GND da fita (terminal longo no 5V). Eles protegem o primeiro LED e evitam cintilação e cores aleatórias.

O USB do Pico é suficiente para alimentar a fita?

Com 30 LEDs e `BRIGHTNESS = 0.6`, a fita consome no máximo cerca de 0,4 A, o que o USB consegue fornecer. VBUS só fornece 5V enquanto o USB está conectado. Para uma fita mais longa ou maior brilho, use uma fonte separada de 5V/2A e conecte os GNDs.

Como mudar a quantidade de rodadas e a penalidade por largada antecipada?

`WIN_ROUNDS` é a quantidade de rodadas necessárias para vencer a partida (3 por padrão). `FALSE_START_STEPS` define quantos passos recua quem aperta antes da hora (2 por padrão; defina como 0 para desativar a penalidade). Para jogar sem som, defina `SOUND_ON = False`.