Connecting to Your Printer

This guide will help you connect your Ryzer LED controller to your Bambu Lab 3D printer using MQTT communication.

What is MQTT?#

MQTT (Message Queuing Telemetry Transport) is how your Bambu Lab printer communicates its status:

• Print progress and state
• Temperature readings
• Error conditions
• Layer information

Ryzer listens to these messages and can respond with LED patterns based on printer status.

Before You Begin#

Make sure you have:

• ✅ Ryzer connected to your WiFi network (First Time Setup)
• ✅ Bambu Lab printer connected to the same WiFi network
• ✅ Access to your printer’s touchscreen
• ✅ Ryzer web interface open at http://ryzer.local

⚠️ Important: Ryzer and your printer MUST be on the same network for MQTT to work!

Step 1: Find Your Printer Information#

You need to gather three pieces of information from your Bambu Lab printer.

1. Printer IP Address#

How to find it:

1. On your printer’s touchscreen, navigate to:

   • Settings (gear icon)
   • Network or WiFi
   • Look for IP Address

2. Write down the IP address:

   • Format: 10.0.0.252 (example)
   • Usually starts with 192.168.x.x or 10.0.x.x

📸 Screenshot Needed: Bambu Lab printer screen showing Network settings with IP address

2. Access Code (LAN Access Password)#

What is it? The Access Code is your printer’s MQTT password. It’s required for any device to connect to your printer locally.

How to find it:

1. On your printer’s touchscreen:

   • Settings (gear icon)
   • Network or WiFi
   • Access Code or LAN Access

2. Write down the 8-character code:

   • Format: bc59c3d1 (example)
   • Contains numbers and lowercase letters
   • Case-sensitive!

📸 Screenshot Needed: Bambu Lab printer screen showing Access Code

💡 Tip: You can change the Access Code if needed. Just remember to update Ryzer with the new code!

3. Device Serial Number#

What is it? Your printer’s unique identifier, used to construct the MQTT topic.

How to find it:

1. On your printer’s touchscreen:

   • Settings (gear icon)
   • Device or About
   • Serial Number or SN

2. Write down the serial number:

   • Format: 00M09C431202374 (example)
   • Starts with 00M or 01M or 01P
   • 15 characters total

📸 Screenshot Needed: Bambu Lab printer screen showing Serial Number/Device ID

Quick Reference Table#

Fill this in as you gather information:

Step 2: Configure Ryzer MQTT Settings#

Now let’s enter this information into Ryzer:

1. Open Ryzer web interface:

   • Navigate to http://ryzer.local or your Ryzer IP address
   • Go to the Connection page

2. Enter printer information:

   Server (IP Address):

   • Enter your printer’s IP address
   • Example: 10.0.0.252
   • No http:// or other prefix needed

   Password (Access Code):

   • Enter the 8-character access code
   • Case-sensitive: use lowercase only
   • Example: bc59c3d1

   Device ID (Serial Number):

   • Enter your printer’s serial number
   • Usually starts with 00M, 01M, or 01P
   • Example: 00M09C431202374

   Client ID:

   • Leave as default: bambu-led-controller
   • Or customize if you prefer (letters, numbers, hyphens only)

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

Step 3: Test the Connection#

Before saving, let’s verify the connection works:

1. Click “Test Connection” button:

   • Ryzer will attempt to connect to your printer
   • This takes 5-10 seconds

2. Watch for result:

   • ✅ Success: “Connection successful!” message
   • ❌ Failed: Error message with details

If Connection Succeeds#

Great! You’ll see:

• “Successfully connected to printer”
• Green checkmark or success indicator

Proceed to Step 4 to save your settings.

If Connection Fails#

Common error messages and solutions:

“Connection timeout”#

Cause: Can’t reach printer at that IP address Solutions:

• Double-check printer IP address
• Ensure printer is powered on
• Verify printer is connected to WiFi (check printer screen)
• Ping printer: ping 10.0.0.252 (use your IP)
• Make sure Ryzer and printer are on same network

“Authentication failed”#

Cause: Wrong access code/password Solutions:

• Verify access code on printer (Settings → Network)
• Check for typos (case-sensitive!)
• Try copying/pasting the code
• Ensure you’re using the LAN access code (not Bambu Cloud password)

“Connection refused”#

Cause: MQTT port blocked or printer not accepting connections Solutions:

• Restart printer (power cycle)
• Check printer firmware is up to date
• Verify LAN mode is enabled on printer
• Try different client ID

Step 4: Save Configuration#

Once the test succeeds:

1. Click “Save Configuration” button

2. Wait for confirmation:

   • “Configuration saved successfully”
   • Settings are stored in Ryzer’s filesystem

3. Ryzer will now connect automatically:

   • On every boot
   • After network reconnection
   • When returning from sleep mode

💡 Tip: Your settings are saved to Ryzer’s internal storage. Even after power loss, your MQTT configuration is preserved!

Step 5: Verify Connection Status#

Let’s confirm Ryzer is receiving data from your printer:

Check Connection Indicator#

On the Ryzer web interface Connection page:

• Green indicator: Connected and receiving data
• Red indicator: Not connected
• Yellow indicator: Connecting…

Start a Print (Optional)#

Want to see it in action?

1. Start any print on your Bambu Lab printer

2. Watch for LED response (future feature):

   • LEDs will change based on print status
   • Indicates Ryzer is receiving print updates

3. Check Ryzer interface:

   • Some firmwares show last message received
   • Look for recent timestamp

📸 Screenshot Needed: Ryzer Connection page showing “Connected” status with green indicator

Understanding MQTT Topics#

For advanced users, here’s how Ryzer connects to your printer:

MQTT Connection Details#

Example topic: If your serial is 00M09C431202374, Ryzer subscribes to:

device/00M09C431202374/report

Your printer publishes JSON messages to this topic containing all status information.

Troubleshooting MQTT Connection#

Connection Works But No LED Response#

This is normal! Currently, Ryzer receives the MQTT messages but LED animations based on print status are a future feature.

To verify it’s working:

• Check that Test Connection succeeds
• Ensure no error messages in Ryzer logs

Connection Drops After a While#

Possible causes:

• Printer went to sleep mode
• Router dropping idle connections
• Weak WiFi signal

Solutions:

• Check WiFi signal strength of both devices
• Move devices closer to router
• Update Ryzer firmware (improved reconnection logic)

Can’t Connect to Printer After it Moves#

If you moved your printer to a different network:

1. Find printer’s new IP address
2. Update Ryzer configuration with new IP
3. Test and save

If printer IP changed on same network (DHCP):

1. Check printer for new IP address
2. Update Ryzer configuration
3. Consider setting static IP on printer (router settings)

Multiple Printers#

Want to connect to multiple Bambu Lab printers?

Currently, Ryzer can only connect to ONE printer at a time. To switch printers:

1. Go to Connection page
2. Enter new printer’s information
3. Test and save

Future firmware may support multiple printers with LED strip zones.

Security and Privacy#

Is My Data Safe?#

Yes! MQTT communication is:

• ✅ Local only - Never leaves your network
• ✅ Encrypted - Uses TLS encryption
• ✅ Password protected - Requires access code
• ✅ Private - No cloud services involved

What Data Does Ryzer Receive?#

Ryzer receives status messages from your printer including:

• Print progress percentage
• Layer information
• Temperatures (bed, nozzle)
• Print state (printing, paused, complete, error)
• Filament usage estimates

Ryzer does NOT:

• ❌ Send data to the internet
• ❌ Store your print files
• ❌ Track your printing habits
• ❌ Share data with third parties

Everything stays on your local network!

Supported Bambu Lab Printers#

Ryzer has been tested with:

• ✅ X1 Series (X1, X1 Carbon, X1E)
• ✅ P1 Series (P1P, P1S)
• ✅ A1 Series (A1, A1 Mini)

All Bambu Lab printers use the same MQTT protocol, so Ryzer should work with current and future models.

See Compatibility for detailed printer compatibility.

Next Steps#

Now that Ryzer is connected to your printer:

1. Configure LED Settings - Set LED count and brightness
2. Check for Updates - Ensure latest firmware
3. Learn LED Patterns - Understand status colors (future)

Advanced Configuration#

Change MQTT Client ID#

The Client ID uniquely identifies Ryzer to your printer. Default is bambu-led-controller.

When to change:

• Running multiple Ryzer devices
• Avoiding conflicts with other MQTT clients
• Personal preference

Requirements:

• Letters, numbers, hyphens, underscores only
• Max 23 characters
• Must be unique on your network

MQTT Connection Parameters#

For developers or advanced users:

{
  "server": "10.0.0.252",
  "port": 8883,
  "use_tls": true,
  "verify_cert": false,
  "username": "bblp",
  "password": "your-access-code",
  "client_id": "bambu-led-controller",
  "topic": "device/YOUR-SERIAL/report",
  "qos": 0,
  "buffer_size": 34464
}

These are configured automatically by Ryzer - no manual editing needed!

Need More Help?#

• MQTT Troubleshooting - Detailed MQTT issue solutions
• FAQ - Common questions about printer connections
• API Documentation - For custom integrations

Estimated Configuration Time: 5-10 minutes Difficulty: Beginner-friendly Requirements: Printer and Ryzer on same WiFi network