Difference between revisions of "Configuring Display Devices"
Line 3: | Line 3: | ||
Look in the “custom” folder in the zynthian-sys GitHub repository. Inside, there is a subfolder called “display”, and inside that is a subfolder for every device that requires customized config files: | Look in the “custom” folder in the zynthian-sys GitHub repository. Inside, there is a subfolder called “display”, and inside that is a subfolder for every device that requires customized config files: | ||
− | '''zynthian-sys''' - System config files for Zynthian. Adjustments and adds. | + | '''zynthian-sys''' - System config files for Zynthian. Adjustments and adds. The device’s subfolder name should match the name used in the webconf tool. |
− | |||
− | The device’s subfolder name should match the name used in the webconf tool. | ||
As you see, currently there are only 2 customized devices (the 2 officially supported displays), but more displays should be added, specially for getting touch support out-the-box. | As you see, currently there are only 2 customized devices (the 2 officially supported displays), but more displays should be added, specially for getting touch support out-the-box. | ||
Line 14: | Line 12: | ||
1.) Copy the files you have customized in the next 3 places: | 1.) Copy the files you have customized in the next 3 places: | ||
− | + | + /etc | |
− | + | + /boot/firmware/overlays | |
− | |||
to a subfolder inside “/zynthian/zynthian-sys/custom”, with the same name used by the webconf tool. You must re-create the directory structure inside the subfolder. Take a look at the existing examples. | to a subfolder inside “/zynthian/zynthian-sys/custom”, with the same name used by the webconf tool. You must re-create the directory structure inside the subfolder. Take a look at the existing examples. |
Revision as of 09:38, 3 October 2024
1 Custom displays
Look in the “custom” folder in the zynthian-sys GitHub repository. Inside, there is a subfolder called “display”, and inside that is a subfolder for every device that requires customized config files:
zynthian-sys - System config files for Zynthian. Adjustments and adds. The device’s subfolder name should match the name used in the webconf tool.
As you see, currently there are only 2 customized devices (the 2 officially supported displays), but more displays should be added, specially for getting touch support out-the-box.
2 Adding new custom display configurations
Please consider helping to add more devices to the “custom” folder. It’s easy: When you have a configuration that works for you:
1.) Copy the files you have customized in the next 3 places:
+ /etc + /boot/firmware/overlays
to a subfolder inside “/zynthian/zynthian-sys/custom”, with the same name used by the webconf tool. You must re-create the directory structure inside the subfolder. Take a look at the existing examples.
2.) Try to re-configure your display from the webconf tool. If it still work after this, probably you did a good work in the previous step, so we can continue. If not ... try to find the problem ;-)
3.) Fork the zynthian-sys repository and copy/upload the new custom subfolder with its content, as you do it in the step 1.
4.) Send a pull request with some explanation and I will review the changes and merge with the master repo for making available the custom configuration in the next software update.