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.

Vídeo
Esquema do circuito

Código-fonte
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]
288Perguntas 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`.
