FAQ#

How to transfer files to/from the SD/LittleFS storage?#

Use the WebUI.

Default passwords?#

For AP mode the WiFi network password is brucenet.

For the WebUI username is admin and password is bruce - these can be changed from the WebUI Settings.

IR/RF transmitter/receiver not working?#

IR requires a line-of-sight between the transmitter and the receiver, which can be easily blocked by solid objects. Light can bounce off some surfaces and still reach the receiver, but don't rely on that too much. Other IR light sources like the sun can also cause interferences.
RF signals propagate in all directions and does not require a line of sight, but can still be blocked by solid objects, especially if made of metal.
Try putting the transmitter and receiver closer (<10cm), many cheap modules have poor ranges, or may be too noisy.
If using unofficially supported modules, double-check that the used pins are correct. These can be changed in the Settings.
Check if the module is active and working during transmission:
- For IR, you can use a smartphone camera to check if the IR LED is blinking.
- Use a multimeter or an oscilloscope to check activity on the data pin/LED/antenna.
- Use another device to check and compare the signals. e.g. rtl_433 for RF, Tasmota or a Broadlink RM4 Pro for both IR and RF.
Most RF modules only supports the 433MHz frequency with ASK/OOK modulation. Check if your .sub file or source signal is compatible.
Check the serial log for errors, some signals may fail to decode.
Even if the signal decodes properly, some devices may use rolling codes or other security mechanism to prevent replay attacks.

Feature X is missing in my device?#

Check the Compatible Device table at the bottom of the Bruce Homepage.

e.g. BadUSB is only available on ESP32-S3-based devices.

My board is not supported?#

For unsupported boards you have to port Bruce to support your device.

More info in the Porting to Devices documentation.

What kind of files can I put on the SD card?#

There is some file examples here.

Including:

There are two very useful external sources of:

How do I customize Bruce?#

You can choose a startup image other than Bruce's default by adding your image as 'boot.jpg' or 'boot.gif' on the root of the filesystems, you can also choose a startup sound if you have a file named 'boot.wav' for it. Also its possible to render images on the Bruce itself via the LittleFS or SD Card manager.