gphoto2-webapi server

.gitignore

@@ -44,6 +44,7 @@ snap/.snapcraft
 *.x86_64
 *.hex
 gphoto2/gphoto2
+gphoto2/gphoto2-webapi
 
 # Debug files
 *.dSYM/
@@ -56,6 +57,9 @@ gphoto2/gphoto2
 .dirstamp
 po/*.header
 
+# Visual Studio Code
+.vscode/
+
 auto-m4/
 auto-aux/
 Makefile

Makefile.am

@@ -15,3 +15,38 @@ all-local:
 # Dummy target to force Automake to make the "distclean" target depend on it
 distclean-local:
 	@:
+
+# Where to get mongoose from
+MONGOOSE_REPO    = https://github.com/cesanta/mongoose.git
+MONGOOSE_RELEASE = 7.7
+
+# The files to copy from the upstream mongoose repo to gphoto2/mongoose/
+MONGOOSE_FILES  =
+MONGOOSE_FILES += README.md
+MONGOOSE_FILES += LICENSE
+MONGOOSE_FILES += mongoose.c
+MONGOOSE_FILES += mongoose.h
+
+# Update local copy of mongoose source to latest mongoose release
+update-mongoose:
+	@set -ex; \
+	test -f "$(srcdir)/.git/config"; \
+	if test -f mongoose-repo/.git/config; then \
+	  (cd mongoose-repo; git fetch -v); \
+	else \
+	  git clone '$(MONGOOSE_REPO)' mongoose-repo; \
+	fi; \
+	(cd mongoose-repo; \
+	  latest="$$(git tag --sort=version:refname | tail -n1)"; \
+	  if test "x$(MONGOOSE_RELEASE)" = "x$$latest"; then :; else \
+	    echo "The latest upstream mongoose release is $$latest."; \
+	    echo "We still have MONGOOSE_RELEASE=$(MONGOOSE_RELEASE) in Makefile.am."; \
+	    echo "To update our mongoose copy to $$latest, update Makefile.am to"; \
+	    echo "MONGOOSE_RELEASE=$${latest} and re-run 'make update-mongoose'."; \
+	    exit 1; \
+	  fi; \
+	  git checkout "$$latest" ); \
+	for f in $(MONGOOSE_FILES); do \
+	  cp -f "mongoose-repo/$$f" "$(srcdir)/gphoto2/mongoose/$$f"; \
+	done; \
+	(cd "$(srcdir)"; git diff gphoto2/mongoose)

README_WEBAPI_SERVER.md

@@ -0,0 +1,258 @@
+# GPhoto2 WEBAPI Server
+
+I need to control my camera via a small embedded controller so i decided to implement this little server direct into the wonderful gphoto2 application. 
+
+2022 June, Thorsten Ludewig ([email protected])
+
+## Run server
+
+`gphoto2-webapi --server` default port 8866
+
+binding to a different port 
+
+`gphoto2-webapi --server-url=http://0.0.0.0:9999 --server`
+
+binding to a specific ip and or port
+
+`gphoto2-webapi --server-url=http://127.0.0.1:8866 --server`
+
+## API Calls - all HTTP GET
+
+Nearly all responses are [JSON](https://json.org) formated.
+
+### general
+
+- `http://<server ip>:8866/` 
+
+  version information for now
+
+- `http://<server ip>:8866/api/version` 
+
+  version information
+
+- `http://<server ip>:8866/api/auto-detect` 
+
+  show detected camera info
+  ```jsonc
+  {
+    result: [
+              {
+                model: "Canon EOS 550D",
+                port: "usb:003,005"
+              }
+            ],
+    return_code: 0
+  }
+  ```
+
+- `http://<server ip>:8866/api/trigger-capture` 
+
+  trigger capture image
+
+- `http://<server ip>:8866/api/capture-image`
+
+  response
+
+  ```jsonc
+  {
+    images: [
+      {
+        info: {
+          name: "IMG_0322.CR2",
+          folder: "/store_00020001/DCIM/100CANON",
+          path: "/store_00020001/DCIM/100CANON/IMG_0322.CR2",
+          mtime: 1655724028,
+          size: 21937775,
+          type: "image/x-canon-cr2"
+        },
+        download: false
+      },
+      {
+        info: {
+          name: "IMG_0322.JPG",
+          folder: "/store_00020001/DCIM/100CANON",
+          path: "/store_00020001/DCIM/100CANON/IMG_0322.JPG",
+          mtime: 1655724026,
+          size: 4038986,
+          height: 3456,
+          width: 5184,
+          type: "image/jpeg"
+        },
+        download: false
+      }
+    ],
+    return_code: 0
+  }
+  ```
+
+- `http://<server ip>:8866/api/capture-image-download` 
+
+  response
+
+  ```jsonc
+  {
+    images: [
+      {
+        info: {
+          name: "IMG_0321.CR2",
+          folder: "/store_00020001/DCIM/100CANON",
+          path: "/store_00020001/DCIM/100CANON/IMG_0321.CR2",
+          mtime: 1655723756,
+          size: 21888193,
+          type: "image/x-canon-cr2"
+        },
+        download: true,
+        local_folder: "/home/user/Projects/gphoto2",
+        keeping_file_on_camera: true
+      },
+      {
+        info: {
+          name: "IMG_0321.JPG",
+          folder: "/store_00020001/DCIM/100CANON",
+          path: "/store_00020001/DCIM/100CANON/IMG_0321.JPG",
+          mtime: 1655723756,
+          size: 4113431,
+          height: 3456,
+          width: 5184,
+          type: "image/jpeg"
+        },
+        download: true,
+        local_folder: "/home/user/Projects/gphoto2",
+        keeping_file_on_camera: true
+      }
+    ],
+    return_code: 0
+  }
+  ```
+
+- `http://<server ip>:8866/api/show-preview` 
+
+  show preview image
+
+- `http://<server ip>:8866/api/capture-movie` 
+
+  online preview as motion jpeg stream 
+
+  *ATTENTION: Only one stream is supported!*
+
+### server
+
+- `http://<server ip>:8866/api/server/shutdown` 
+
+  shutdown http server
+
+### config
+
+- `http://<server ip>:8866/api/config/list` 
+
+  list available config names
+
+- `http://<server ip>:8866/api/config/list-all` 
+
+  list config including current and available config values
+
+- `http://<server ip>:8866/api/config/set-index/<config name>?i=<index value>` 
+
+  set the `config name` to the specified `index value` 
+
+- `http://<server ip>:8866/api/config/get/<config name>` 
+
+  get single config property
+
+  sample request
+
+  `http://localhost:8866/api/config/get/main/imgsettings/colorspace`
+
+  response
+
+  ```jsonc
+  {
+    path: "/main/imgsettings/colorspace",
+    label: "Farbraum",
+    readonly: false,
+    type: "MENU",
+    current: "sRGB",
+    choice: [
+        {
+          index: 0,
+          value: "sRGB"
+        },
+        {
+          index: 1,
+          value: "AdobeRGB"
+        }
+      ],
+    return_code: 0
+  }
+  ```
+
+- `http://<server ip>:8866/api/config/set/<config name>?v=<value>` 
+
+  set the `config name` to the specified `value` 
+
+### file
+
+- `http://<server ip>:8866/api/file/get/<path to file/image>` 
+
+  response - native file
+
+- `http://<server ip>:8866/api/file/exif/<path to image>` 
+
+  response 
+
+  ```jsonc
+  {
+    make: "Canon",
+    model: "Canon EOS 550D",
+    orientation: "Oben links",
+    xresolution: "72",
+    yresolution: "72",
+  ...
+  }
+  ``` 
+
+- `http://<server ip>:8866/api/file/list/<path to folder>` 
+
+  response
+
+  ```jsonc
+  {
+    path: "/store_00020001/DCIM/",
+    files: [
+             {
+               name: "100CANON",
+               isFolder: true
+             }
+           ],
+    entries: 1,
+    return_code: 0
+  }
+  ```
+
+- `http://<server ip>:8866/api/file/delete/<path to file>` 
+
+  remove specified file
+
+## Mongoose HTTP Server - LICENSE
+
+https://github.com/cesanta/mongoose
+
+
+```
+Copyright (c) 2004-2013 Sergey Lyubka
+Copyright (c) 2013-2021 Cesanta Software Limited
+All rights reserved
+
+This software is dual-licensed: you can redistribute it and/or modify
+it under the terms of the GNU General Public License version 2 as
+published by the Free Software Foundation. For the terms of this
+license, see <http://www.gnu.org/licenses/>.
+
+You are free to use this software under the terms of the GNU General
+Public License, but WITHOUT ANY WARRANTY; without even the implied
+warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+See the GNU General Public License for more details.
+
+Alternatively, you can license this software under a commercial
+license, as set out in <https://mongoose.ws/licensing/>.
+```

configure.ac

@@ -19,6 +19,7 @@ AM_INIT_AUTOMAKE([
   dist-bzip2
   dist-xz
   check-news
+  subdir-objects
 ])
 
 GP_CHECK_SHELL_ENVIRONMENT