Category: Troubleshooting
Products: All Argon Products
Platform: Raspberry Pi
Keywords: Argon script, Argon installation script, Argon bash script, bash script, installation script, script not working, script failed, installer failed, installation failed, Argon installer, Argon folders, folder missing, folders missing, directory missing, directories missing, folder not created, directory not created, custom folder missing, script did not create folder, missing files, missing directories, /sys/class/backlight, backlight directory empty, OpenPlotter, Ubuntu, LibreELEC, DietPi, Volumio, moOde, Batocera, Recalbox, Home Assistant OS, Kali Linux, Debian, third-party operating system, custom operating system, unsupported operating system, feature missing, OLED not working, display not working, backlight not working, fan not working, buttons not working, GPIO not working, Argon software compatibility
Overview
If the Argon installation script does not work, required folders are not created, expected directories are missing, or certain Argon product features do not function correctly, the most common cause is that the system is running a third-party operating system instead of the official Raspberry Pi OS.
Argon installation scripts are developed, tested, and officially supported on Raspberry Pi OS. Many third-party operating systems modify the Linux kernel, boot configuration, directory structure, drivers, and hardware interfaces, which can prevent the script from installing correctly or accessing the files and directories it requires.
Because of these operating system differences, some folders, directories, or hardware features may not be available even though the Argon hardware itself is functioning correctly.
Symptoms
Customers may experience one or more of the following:
- The Argon installation script fails.
- The bash script completes but features do not work.
- Required folders are not created.
- Required directories are missing.
/sys/class/backlightis empty.- OLED functions are unavailable.
- Backlight controls do not work.
- Fan controls do not work.
- Buttons do not function.
- Display controls are unavailable.
- Other Argon-specific features are missing.
Recommended Troubleshooting
Before concluding that the hardware or installation script is faulty, perform the following steps:
- Install the latest official Raspberry Pi OS.
- Update the operating system to the latest available packages.
- Run the appropriate Argon installation script for your product.
- Verify that all expected Argon features operate correctly.
If everything functions correctly on Raspberry Pi OS but not on your third-party operating system, the issue is caused by software compatibility rather than a hardware fault.
Why This Happens
Third-party operating systems frequently modify components used by the Argon installation scripts, including:
- Linux kernel configuration
- Boot configuration
- Device drivers
- GPIO interfaces
- Fan interfaces
- Display interfaces
- System directory structure
- File locations
- Hardware abstraction layers
Because of these differences, the installation script may not be able to:
- Create required folders.
- Locate required directories.
- Install configuration files.
- Detect supported hardware interfaces.
- Enable certain product features.
This behavior does not necessarily indicate a problem with the Argon hardware.
Community Support for Third-Party Operating Systems
Some third-party operating systems provide community-developed packages, plugins, or add-ons that enable partial support for Argon products.
These community projects are maintained independently and may not always be updated when the operating system changes.
As a result, functionality may vary depending on the operating system version.
Frequently Asked Questions
The Argon installation script does not work.
The Argon installation scripts are officially supported on Raspberry Pi OS. If you are using a third-party operating system, verify the hardware first using the latest Raspberry Pi OS.
The script finished successfully, but the features do not work.
Many third-party operating systems use different system architectures, drivers, and directory layouts that may prevent Argon features from operating correctly.
The Argon folders were not created.
Some third-party operating systems do not use the same directory structure as Raspberry Pi OS. As a result, the installation script may not create or access the expected folders.
Why is /sys/class/backlight empty?
This directory is managed by the operating system and its drivers. Some third-party operating systems do not expose the same backlight interface used by Raspberry Pi OS, which prevents the Argon software from controlling the display.
Why do the fan, OLED, buttons, or display work on Raspberry Pi OS but not on my operating system?
Argon products are developed and validated using Raspberry Pi OS. If the hardware functions correctly on Raspberry Pi OS but not on another operating system, the issue is software compatibility rather than a hardware fault.
Comments
0 comments
Article is closed for comments.