Quick Start

Welcome to Ryzer! This guide will get your LED controller up and running in just a few minutes.

What You’ll Need#

• Ryzer LED controller (Seeed XIAO ESP32-C3)
• WS2812B LED strip
• 5V power supply (adequate for your LED count)
• USB-C cable (for initial setup)
• Your Bambu Lab printer connected to WiFi
• A computer or smartphone

Step 1: Connect the Hardware (2 minutes)#

Basic Wiring#

IMPORTANT: Connect power supply BEFORE connecting LEDs to avoid damage.

1. Connect the LED strip:

   • LED Strip DIN (data in) → Ryzer pin D6
   • LED Strip VCC (5V) → Power supply positive (+)
   • LED Strip GND → Power supply negative (-)

2. Connect common ground:

   • Power supply negative (-) → Ryzer GND pin

3. Power the controller:

   • Connect USB-C cable from computer to Ryzer board

LED Status: You should see the LED strip light up WHITE - this means Ryzer is in setup mode.

📸 Screenshot Needed: Wiring diagram showing connections between Ryzer, LED strip, and power supply

⚠️ Safety First: Never connect/disconnect LED strips while powered. Always power off first!

Step 2: Connect to WiFi (2 minutes)#

1. Find the Ryzer network:

   • On your computer or phone, look for WiFi network named “Ryzer”
   • Connect to it (no password required)

2. Configure WiFi:

   • A setup page should open automatically
   • If not, open a browser and go to 192.168.4.1
   • Select your home WiFi network from the list
   • Enter your WiFi password
   • Click Save

3. Wait for connection:

   • LEDs will turn LIGHT BLUE while connecting
   • Then turn BLACK when successfully connected
   • Ryzer will now be on your home network!

📸 Screenshot Needed: WiFi Manager captive portal showing network selection

💡 Tip: If the setup page doesn’t open automatically, disable mobile data on your phone or turn off automatic network switching.

Step 3: Access the Web Interface (1 minute)#

1. Open the Ryzer dashboard:

   • In your browser, go to: http://ryzer.local
   • Or use the IP address shown in your router’s connected devices

2. You should see the Ryzer interface:

   • Connection page (MQTT setup)
   • Firmware page (updates)
   • Lighting page (LED settings)
   • Troubleshooting page

📸 Screenshot Needed: Ryzer web interface homepage/dashboard

⚠️ Can’t connect? Try http://ryzer.local in different browsers. Some networks don’t support mDNS (.local addresses). Use the IP address instead.

Step 4: Connect to Your Printer (3 minutes)#

Now let’s connect Ryzer to your Bambu Lab printer:

Find Your Printer Information#

You’ll need three pieces of information from your Bambu Lab printer:

1. Printer IP Address:

   • On printer touchscreen: Settings → Network → IP Address
   • Example: 10.0.0.252

2. Access Code:

   • On printer touchscreen: Settings → Network → Access Code
   • 8-character code, example: bc59c3d1

3. Device Serial Number:

   • On printer touchscreen: Settings → Device → Serial Number
   • Starts with 00M, example: 00M09C431202374

📸 Screenshot Needed: Bambu Lab printer screen showing where to find IP, Access Code, and Serial Number

Configure Ryzer#

1. In the Ryzer web interface, go to the Connection page

2. Enter your printer information:

   • Server: Printer IP address (e.g., 10.0.0.252)
   • Password: Access code (e.g., bc59c3d1)
   • Device ID: Serial number (e.g., 00M09C431202374)
   • Client ID: Leave default (bambu-led-controller)

3. Click Test Connection:

   • Wait for confirmation that connection succeeded
   • If it fails, double-check your printer information

4. Click Save Configuration

📸 Screenshot Needed: Ryzer Connection page with fields filled in (use example data)

Step 5: Configure LEDs (1 minute)#

1. Go to the Lighting page in Ryzer interface
2. Set your LED count:
   • Count the number of individual LEDs on your strip
   • Enter this number (max 200)
3. Adjust brightness (0-255):
   • Start with 100 for moderate brightness
   • Increase or decrease based on preference
4. Click Save Settings
5. Click Test LEDs to verify all LEDs light up

📸 Screenshot Needed: Lighting configuration page showing LED count and brightness settings

You’re Done! 🎉#

Your Ryzer LED controller is now connected and ready to respond to your printer’s status!

What Happens Next?#

• LEDs will stay BLACK during normal operation
• When you start a print, Ryzer will receive updates from your printer
• LEDs will change colors based on print status (future firmware features)

Next Steps#

• Configure LED patterns for different print states
• Check for firmware updates to get the latest features
• Troubleshoot if something isn’t working

LED Status Colors Reference#

Learn what the different LED colors mean:

Need Help?#

If something isn’t working:

1. Check the Troubleshooting Guide
2. Review the FAQ
3. Visit our Community Forum

Estimated Setup Time: 5-10 minutes Difficulty: Beginner-friendly