Troubleshooting Guide#

Common issues and solutions for BrightSign development.

Quick Diagnosis#

Player not working
    │
    ├─ No display output
    │   ├─ Check power LED → No light = power issue
    │   ├─ Check video cable → Test with known good cable
    │   └─ Check video mode → May be incompatible resolution
    │
    ├─ Shows setup screen
    │   ├─ No SD card → Insert card with autorun.brs
    │   ├─ No autorun.brs → Create at SD card root
    │   └─ Syntax error → Check DWS for errors
    │
    ├─ Content not playing
    │   ├─ Check file exists → Verify path
    │   ├─ Check codec → May be unsupported format
    │   └─ Check storage space → Clear old content
    │
    └─ Network issues
        ├─ Check cable/WiFi → Physical connectivity
        ├─ Check IP → DHCP or static config
        └─ Check firewall → Required ports open

Common Issues#

Player Shows Setup Screen#

Symptom: Player boots to setup interface instead of your content.

Video Not Playing#

Symptom: Video file won’t play or shows errors.

Network Not Working#

Symptom: No network connectivity.

Script Exits Immediately#

Symptom: Player boots, flashes, then shows setup screen.

Fix: Add event loop at end of Main():

msgPort = CreateObject("roMessagePort")
while true
    msg = wait(0, msgPort)
end while

Cannot Access DWS#

Symptom: Cannot connect to Diagnostic Web Server.

Diagnostic Commands#

Gather System Info#

Sub PrintDiagnostics()
    di = CreateObject("roDeviceInfo")
    print "Model: " + di.GetModel()
    print "Serial: " + di.GetDeviceUniqueId()
    print "Firmware: " + di.GetVersion()

    nc = CreateObject("roNetworkConfiguration", 0)
    if nc <> invalid then
        config = nc.GetCurrentConfig()
        print "IP: " + config.ip4_address
    end if

    storage = CreateObject("roStorageInfo", "SD:")
    if storage <> invalid then
        print "Free: " + storage.GetDriveFreeSpace().ToStr()
    end if
End Sub

Test Network#

Function TestNetwork() As Boolean
    nc = CreateObject("roNetworkConfiguration", 0)
    if nc = invalid then return false

    result = nc.TestInternetConnectivity()
    print "Internet: " + result.ok.ToStr()
    return result.ok
End Function

Check File#

Function CheckFile(path$ As String) As Boolean
    file = CreateObject("roReadFile", path$)
    if file = invalid then
        print "Cannot read: " + path$
        return false
    end if
    return true
End Function

Recovery Procedures#

Force Recovery Mode#

1. Power off player
2. Hold SVC button while powering on
3. Continue holding until recovery screen appears
4. Use DWS to upload new content

Clear Registry#

Sub ClearUserRegistry()
    reg = CreateObject("roRegistrySection", "user_variables")
    if reg <> invalid then
        for each key in reg.GetKeyList()
            reg.Delete(key)
        end for
        reg.Flush()
    end if
End Sub

Error Codes Reference#

Video Errors#

Network Errors#

Getting Help#

1. Check DWS logs at http://<player-ip>/logs
2. Search forums at community.brightsign.biz
3. Review documentation at docs.brightsign.biz
4. Contact support at support@brightsign.biz