Merge pull request #4297 from AllskyTeam/Upgrade-to-ZWO-SDK-1.37

Upgrade to zwo sdk 1.37

Author: Alex-developer

README.md

@@ -14,24 +14,27 @@ In order to run the Allsky software you need:
 
  * A Raspberry Pi Zero 2, Pi 2, Pi 3, Pi 4, Pi 5, or Le Potato.
  * A camera:
-    * Any ZWO camera sold before October 2024.
-    * One of the following Raspberry Pi cameras:
-       * RPi HQ (IMX477 sensor)
-       * RPi Module 3 (IMX708 sensor)
-       * RPi Version 1 (OV5647 sensor; NOT RECOMMENDED: 0.9 second maximum exposure)
-       * IMX290 60.00 fps
-       * ArduCam 16 MP (IMX519 sensor)
-       * ArduCam 64 MP (arducam_64mp sensor)
-       * ArduCam 462 (arducam-pivariety sensor)
-       * Waveshare imx219-d160 (IMX290 sensor)
-       * ArduCam 64 MP Owlsight (OV64a40 sensor)
-       * OneInchEye IMX283 (IMX283 sensor)
+    * Any ZWO camera sold before February 1, 2025,
+    * or one of the following cameras:
+       * Raspberry Pi:
+          * HQ (IMX477 sensor)
+          * Module 3 (IMX708 sensor)
+          * Version 1 (OV5647 sensor; NOT RECOMMENDED: 0.9 second maximum exposure)
+       * Arducam:
+          * 16 MP (IMX519 sensor)
+          * 64 MP (arducam_64mp sensor)
+          * 462 (arducam-pivariety sensor)
+          * 64 MP Owlsight (OV64a40 sensor)
+       * Other:
+          * Waveshare imx219-d160 (IMX290 sensor)
+          * OneInchEye IMX283 (IMX283 sensor)
+          * IMX290 60.00 fps
 
 
    
 > __NOTES:__
 >	- Only the Raspberry Pi OS is supported.  Other operating systems like Ubuntu are NOT supported.  If possible use the newest Bookworm 64-bit release. Bullseye will also work. __Buster support will be dropped in the next major release__.
->	- The ZWO ASI120-series cameras are __not__ recommended due to their tendency to produce errors and poor-quality images.
+>	- The ZWO ASI120-series cameras are __not__ recommended due to their tendency to produce poor-quality images.
 >	- The Pi Zero with its limited memory and _very_ limited CPU power is not recommended.  You probably won't be able to create keograms, startrails, or timelapse videos.
 >	- The Pi Zero 2 with its limited memory and somewhat limited CPU power is not recommended unless cost is the only concern.  Creating keograms, startrails, and timelapse videos may or may not be possible.
 >	- The Le Potato is the only "Pi-compatible" board that we've found to actually be compatible, so buyer beware.
@@ -77,15 +80,20 @@ It should be used before requesting support on GitHub.
 
  
 <!-- =============================================================================== --> 
-## Allsky Website and remote server
+## Allsky Website
 
 The local Allsky Website (i.e., on the Pi) is installed with Allsky but must be enabled in the WebUI in order to use it.
 You can also install the Allsky Website on a remote server so it can be viewable via the Internet.
 
 See [Installation / Upgrading --> Website](https://htmlpreview.github.io/?https://raw.githubusercontent.com/AllskyTeam/allsky/master/html/documentation/installations/AllskyWebsite.html) for information on how to install and configure an Allsky Website.
 
+&nbsp;
+<!-- =============================================================================== --> 
+## Remote server
 Allsky images, keograms, startrails, and timelapse videos can optionally be uploaded to a remote server __not__ running an Allsky Website.  This is useful if you have a personal website and want to include the most recent Allsky images.
 
+See [Installation / Upgrading --> Remote server](https://htmlpreview.github.io/?https://raw.githubusercontent.com/AllskyTeam/allsky/master/html/documentation/installations/RemoteServer.html) for information on how to configure a remote server.
+
 ---
 
 
@@ -123,6 +131,10 @@ By default, a timelapse video is generated at the end of nighttime from all of t
 
 "Mini" timelapse videos can also be created every few images, and contain the last several images.  They are useful to see what the sky was recently like.
 
+
+See [Explanations / How To --> Timelapses](https://htmlpreview.github.io/?https://raw.githubusercontent.com/AllskyTeam/allsky/master/html/documentation/explanations/timelapses.html).
+
+
 ---
 
 

scripts/utilities/showSupportedCameras.sh

@@ -15,6 +15,7 @@ OK="true"
 DO_HELP="false"
 DO_ZWO="false"
 DO_RPI="false"
+ZWO_FILE="${ALLSKY_HOME}/src/lib/armv7/libASICamera2.a"
 while [[ $# -gt 0 ]]; do
 	ARG="${1}"
 	case "${ARG,,}" in
@@ -27,8 +28,15 @@ while [[ $# -gt 0 ]]; do
 		--zwo)
 			DO_ZWO="true"
 			;;
+		--zwo-file)
+			ZWO_FILE="${2}"
+			if [[ ! -f ${ZWO_FILE} ]]; then
+				E_ "File '${ZWO_FILE}' not found." >&2
+				OK="false"
+			fi
+			;;
 		-*)
-			echo -e "${RED}Unknown argument '${ARG}' ignoring.${NC}" >&2
+			E_ "Unknown argument '${ARG}'." >&2
 			OK="false"
 			;;
 	esac
@@ -38,23 +46,26 @@ done
 usage_and_exit()
 {
 	local RET=${1}
-	{
-		echo
-		[[ ${RET} -ne 0 ]] && echo -en "${RED}"
-		echo "Usage: ${ME} [--help] --rpi | --zwo"
-		[[ ${RET} -ne 0 ]] && echo -en "${NC}"
-		echo "    where:"
-		echo "      '--help' displays this message and exits."
-		echo "      '--rpi' displays a list of supported Raspberry Pi and compatible cameras."
-		echo "      '--zwo' displays a list of supported ZWO cameras."
-	} >&2
+	exec 2>&1
+	echo
+	local MSG="Usage: ${ME} [--help] [--zwo-file f] --rpi | --zwo"
+	if [[ ${RET} -ne 0 ]]; then
+		E_ "${MSG}"
+	else
+		echo -e "${MSG}"
+	fi
+	echo "where:"
+	echo "    '--help' displays this message and exits."
+	echo "    '--zwo-file f' looks in this file for list of supported ZWO cameras."
+	echo "    '--rpi' displays a list of supported Raspberry Pi and compatible cameras."
+	echo "    '--zwo' displays a list of supported ZWO cameras."
 	exit "${RET}"
 }
 
 [[ ${DO_HELP} == "true" ]] && usage_and_exit 0
 [[ ${OK} == "false" ]] && usage_and_exit 1
 if [[ ${DO_RPI} == "false" && ${DO_ZWO} == "false" ]]; then
-	echo -e "${RED}You must specify --rpi and/or --zwo${NC}" >&2
+	E_  "You must specify --rpi and/or --zwo" >&2
 	usage_and_exit 2
 fi
 
@@ -94,7 +105,7 @@ if [[ ${DO_ZWO} == "true" ]]; then
 	[[ ${DO_RPI} == "true" ]] && echo -e "\n===== Supported ZWO cameras:"
 
 	# Any of the libraries should work.
-	strings "${ALLSKY_HOME}/src/lib/armv7/libASICamera2.a" |
+	strings "${ZWO_FILE}" |
 		grep '_SetResolutionEv$' | \
 		sed -e 's/^.*CameraS//' -e 's/17Cam//' -e 's/_SetResolutionEv//' | \
 		sort -u