Add dslr tips in documentation

pibooth · Feb 2, 2024 · d3e1b65 · d3e1b65
1 parent 95e46e0
commit d3e1b65
Show file tree

Hide file tree

Showing 2 changed files with 30 additions and 0 deletions.
diff --git a/docs/index.rst b/docs/index.rst
@@ -41,6 +41,7 @@ photos of your version.
 
    sources/start.rst
    sources/config/config.rst
+   sources/tutorials/dslr_tips.rst
 
 .. toctree::
    :caption: Scripts and tools

diff --git a/docs/sources/tutorials/dslr_tips.rst b/docs/sources/tutorials/dslr_tips.rst
@@ -0,0 +1,29 @@
+First configuration
+^^^^^^^^^^^^^^^^^^^
+
+- Disable "auto-sleep" or "auto-off" to prevent errors while running pibooth.
+- Disable Wifi feature to solve gphoto2 troubles to detect hardware.
+- Disable the autofocus to avoid gphoto2 troubles to take a picture.
+
+DSLR settings
+^^^^^^^^^^^^^
+
+Most common settings for DSLR:::
+
+    Shutter speed: 1/60
+    Focal Opening: F10
+    ISO: 3200
+
+    Shutter speed: 1/125
+    Focal Opening: F8
+    ISO: 3200
+
+Credits goes to https://fotomax.fr/canon-camera-settings-with-a-magic-mirror-photobooth/, alternative settings are also available, mainly depending on natural light conditions.
+
+Troubleshooting
+^^^^^^^^^^^^^^^
+
+If the DLSR don't manage to take the photo Pibooth will show the "Oops something went wrong" screen. Most of the issues that our users encountered are either linked to:
+
+- Not enough light (or no light at all when the lens cap has not been removed)
+- Camera didn't manage to focus (that's why we advise to disable the autofocus and manually set it at the beginning)