[EVA-2020-02.git] / exec / photograph / update_temp_photograph.sh

#!/bin/bash
# Desc: Ninfacyzga-1: Capture and store photograph from a camera to temporary directory for 24 hours
# Usage: update_temp_photo.sh arg1
# Input: arg1: camera tag name (e.g. "DC1")
# Depends: age, gnu coreutils, libgps, sleepRand.py

#==BEGIN Define Parameters==
temp_dir="/dev/shm"; # default
iso_date="$(date +%Y%m%dT%H%M%S%z)";
#iso_date_ns="$(date +%Y%m%dT%H%M%S.%N%z)";
device_hostname="$(hostname)";
nfg_base_dir="../../"; # root directory of ninfacyzga-1 git repo
nfg_unitproc_path="$nfg_base_dir"/exec/unitproc;
sleep_rand_path="$nfg_base_dir"/exec/unitproc/sleepRand.py;
PATH="$nfg_unitproc_path:$PATH"; # include unitprocess nfg executables

declare -Ag appRollCall # Associative array for storing app status
declare -Ag fileRollCall # Associative array for storing file status
declare -Ag dirRollCall # Associative array for storing dir status
#==END Define Parameters==

#==BEGIN Define Functions==
yell() { echo "$0: $*" >&2; }      #o Yell, Die, Try Three-Fingered Claw technique
die() { yell "$*"; exit 111; }     #o Ref/Attrib: https://stackoverflow.com/a/25515370
try() { "$@" || die "cannot $*"; } #o
checkapp() {
    # Desc: If arg is a command, save result in assoc array 'appRollCall'
    # Usage: checkapp arg1 arg2 arg3 ...
    # Version: 0.1.1
    # Input: global assoc. array 'appRollCall'
    # Output: adds/updates key(value) to global assoc array 'appRollCall'
    # Depends: bash 5.0.3
    local returnState    

    #===Process Args===
    for arg in "$@"; do
	if command -v "$arg" 1>/dev/null 2>&1; then # Check if arg is a valid command
	    appRollCall[$arg]="true";
	    if ! [ "$returnState" = "false" ]; then returnState="true"; fi;
	else
	    appRollCall[$arg]="false"; returnState="false";
	fi;
    done;

    #===Determine function return code===
    if [ "$returnState" = "true" ]; then
	return 0;
    else
	return 1;
    fi;
} # Check that app exists
checkfile() {
    # Desc: If arg is a file path, save result in assoc array 'fileRollCall'
    # Usage: checkfile arg1 arg2 arg3 ...
    # Version: 0.1.1
    # Input: global assoc. array 'fileRollCall'
    # Output: adds/updates key(value) to global assoc array 'fileRollCall';
    # Output: returns 0 if app found, 1 otherwise
    # Depends: bash 5.0.3
    local returnState

    #===Process Args===
    for arg in "$@"; do
	if [ -f "$arg" ]; then
	    fileRollCall["$arg"]="true";
	    if ! [ "$returnState" = "false" ]; then returnState="true"; fi;
	else
	    fileRollCall["$arg"]="false"; returnState="false";
	fi;
    done;
    
    #===Determine function return code===
    if [ "$returnState" = "true" ]; then
	return 0;
    else
	return 1;
    fi;
} # Check that file exists
checkdir() {
    # Desc: If arg is a dir path, save result in assoc array 'dirRollCall'
    # Usage: checkdir arg1 arg2 arg3 ...
    # Version 0.1.1
    # Input: global assoc. array 'dirRollCall'
    # Output: adds/updates key(value) to global assoc array 'dirRollCall';
    # Output: returns 0 if app found, 1 otherwise
    # Depends: Bash 5.0.3
    local returnState

    #===Process Args===
    for arg in "$@"; do
	if [ -d "$arg" ]; then
	    dirRollCall["$arg"]="true";
	    if ! [ "$returnState" = "false" ]; then returnState="true"; fi
	else
	    dirRollCall["$arg"]="false"; returnState="false";
	fi
    done
    
    #===Determine function return code===
    if [ "$returnState" = "true" ]; then
	return 0;
    else
	return 1;
    fi
} # Check that dir exists
displayMissing() {
    # Desc: Displays missing apps, files, and dirs
    # Usage: displayMissing
    # Version 0.1.1
    # Input: associative arrays: appRollCall, fileRollCall, dirRollCall
    # Output: stderr: messages indicating missing apps, file, or dirs
    # Depends: bash 5, checkAppFileDir()
    local missingApps value appMissing missingFiles fileMissing
    local missingDirs dirMissing
    
    #==BEGIN Display errors==
    #===BEGIN Display Missing Apps===
    missingApps="Missing apps  :";
    #for key in "${!appRollCall[@]}"; do echo "DEBUG:$key => ${appRollCall[$key]}"; done
    for key in "${!appRollCall[@]}"; do
	value="${appRollCall[$key]}";
	if [ "$value" = "false" ]; then
	    #echo "DEBUG:Missing apps: $key => $value";
	    missingApps="$missingApps""$key ";
	    appMissing="true";
	fi;
    done;
    if [ "$appMissing" = "true" ]; then  # Only indicate if an app is missing.
	echo "$missingApps" 1>&2;
    fi;
    unset value;
    #===END Display Missing Apps===

    #===BEGIN Display Missing Files===
    missingFiles="Missing files:";
    #for key in "${!fileRollCall[@]}"; do echo "DEBUG:$key => ${fileRollCall[$key]}"; done
    for key in "${!fileRollCall[@]}"; do
	value="${fileRollCall[$key]}";
	if [ "$value" = "false" ]; then
	    #echo "DEBUG:Missing files: $key => $value";
	    missingFiles="$missingFiles""$key ";
	    fileMissing="true";
	fi;
    done;
    if [ "$fileMissing" = "true" ]; then  # Only indicate if an app is missing.
	echo "$missingFiles" 1>&2;
    fi;
    unset value;
    #===END Display Missing Files===

    #===BEGIN Display Missing Directories===
    missingDirs="Missing dirs:";
    #for key in "${!dirRollCall[@]}"; do echo "DEBUG:$key => ${dirRollCall[$key]}"; done
    for key in "${!dirRollCall[@]}"; do
	value="${dirRollCall[$key]}";
	if [ "$value" = "false" ]; then
	    #echo "DEBUG:Missing dirs: $key => $value";
	    missingDirs="$missingDirs""$key ";
	    dirMissing="true";
	fi;
    done;
    if [ "$dirMissing" = "true" ]; then  # Only indicate if an dir is missing.
	echo "$missingDirs" 1>&2;
    fi;
    unset value;
    #===END Display Missing Directories===

    #==END Display errors==
} # Display missing apps, files, dirs
timeUntilNextDay(){
    # Desc: Report seconds until next day.
    # Version: 1.0.3
    # Output: stdout: integer seconds until next day
    # Output: exit code 0 if stdout > 0; 1 if stdout = 0; 2 if stdout < 0
    # Usage: timeUntilNextDay
    # Usage: if ! myTTL="$(timeUntilNextDay)"; then yell "ERROR in if statement"; exit 1; fi
    # Depends: date 8, echo 8, yell, try
    
    local returnState timeCurrent timeNextDay secondsUntilNextDay
    timeCurrent="$(date --iso-8601=seconds)" ; # Produce `date`-parsable current timestamp with resolution of 1 second.
    timeNextDay="$(date -d "$timeCurrent next day" --iso-8601=date)"; # Produce timestamp of beginning of tomorrow with resolution of 1 second.
    secondsUntilNextDay="$(( $(date +%s -d "$timeNextDay") - $(date +%s -d "$timeCurrent") ))" ; # Calculate seconds until closest future midnight (res. 1 second).
    if [[ "$secondsUntilNextDay" -gt 0 ]]; then
	returnState="true";
    elif [[ "$secondsUntilNextDay" -eq 0 ]]; then
	returnState="warning_zero";
	yell "WARNING:Reported time until next day exactly zero.";
    elif [[ "$secondsUntilNextDay" -lt 0 ]]; then
	returnState="warning_negative";
	yell "WARNING:Reported time until next day is negative.";
    fi

    try echo "$secondsUntilNextDay"; # Report
    
    # Determine function return code
    if [[ "$returnState" = "true" ]]; then
	return 0;
    elif [[ "$returnState" = "warning_zero" ]]; then
	return 1;
    elif [[ "$returnState" = "warning_negative" ]]; then
	return 2;
    fi
} # Report seconds until next day
set_script_ttl() {
    #Desc: Sets script_ttl seconds
    #Usage: set_script_ttl
    #Input: none
    #Output: var: script_ttl (integer seconds)
    #Depends: timeUntilNextDay()

    # Set script lifespan to end at start of next day
    if ! script_ttl="$(timeUntilNextDay)"; then # sets scriptTTL, then checks exit code
	if [[ "$script_ttl" -eq 0 ]]; then
	    ((script_ttl++)); # Add 1 because 0 would cause 'timeout' to never timeout.
	fi;
    fi;
} # Set script_ttl in seconds until next day
update_temp_file() {
    # Input: var: $temp_photo_path file path to save photo
    # Depends: checkapp(), raspistill
    encoding="jpg";
    try raspistill -gps -t 0 -q 95 -ex auto -e "$encoding" -o "$temp_photo_path";
};
showUsage() {
    # Desc: Display script usage information
    # Usage: showUsage
    # Version 0.0.1
    # Input: none
    # Output: stdout
    # Depends: GNU-coreutils 8.30 (cat)
    cat <<'EOF'
    USAGE:
        update_temp_photograph.sh [camera_name]

    EXAMPLE:
      update_temp_photograph.sh DC1
EOF
} # Display information on how to use this script.

main() {
    :
    #===BEGIN process arguments===
    if [[ $# -ge 1 ]]; then
	camera_name="$1";
    else
	die "ERROR:Not enough arguments.";
	showUsage;
    fi;
    
    temp_photo_dir="$temp_dir"/ninfacyzga/photograph; # generic-use dir
    temp_photo_filename="$camera_name".jpg; # use jpg encoding
    temp_photo_path="$temp_photo_dir"/"$temp_photo_filename";
    #===END process arguments===
    #===BEGIN Check for required files, dirs, and apps===
    # Create output dir for photo dir
    flag_exit_early="false";
    if ! checkdir "$temp_photo_dir"; then
	try mkdir -p "$temp_photo_dir";
    fi;
    
    # Check for missing files
    if ! checkfile "$sleep_rand_path"; then
	flag_exit_early="true";
    fi;
    
    # Check for missing apps
    if ! checkapp raspistill; then
	flag_exit_early="true";
    fi;
    
    # Display missing
    displayMissing;
    if [[ $flag_exit_early == "true" ]]; then
	die "ERROR:Exiting early.";
    fi;
    #===END Check for required files, dirs, and apps===

    #===BEGIN main loop===
    set_script_ttl;
    while [[ $SECONDS -lt "$script_ttl" ]]; do
	# Capture new photograph
	try update_temp_file;
	try python3 "$sleep_rand_path" --upper 3600.0 10.0;
    done;
    #===END main loop===
};

#==END Define Functions==

main "$@";
Commit	Line	Data
8233253b SBS	1	#!/bin/bash
	2	# Desc: Ninfacyzga-1: Capture and store photograph from a camera to temporary directory for 24 hours
	3	# Usage: update_temp_photo.sh arg1
	4	# Input: arg1: camera tag name (e.g. "DC1")
	5	# Depends: age, gnu coreutils, libgps, sleepRand.py
	6
	7	#==BEGIN Define Parameters==
	8	temp_dir="/dev/shm"; # default
	9	iso_date="$(date +%Y%m%dT%H%M%S%z)";
	10	#iso_date_ns="$(date +%Y%m%dT%H%M%S.%N%z)";
	11	device_hostname="$(hostname)";
	12	nfg_base_dir="../../"; # root directory of ninfacyzga-1 git repo
	13	nfg_unitproc_path="$nfg_base_dir"/exec/unitproc;
	14	sleep_rand_path="$nfg_base_dir"/exec/unitproc/sleepRand.py;
	15	PATH="$nfg_unitproc_path:$PATH"; # include unitprocess nfg executables
	16
	17	declare -Ag appRollCall # Associative array for storing app status
	18	declare -Ag fileRollCall # Associative array for storing file status
	19	declare -Ag dirRollCall # Associative array for storing dir status
	20	#==END Define Parameters==
	21
	22	#==BEGIN Define Functions==
	23	yell() { echo "$0: $*" >&2; } #o Yell, Die, Try Three-Fingered Claw technique
	24	die() { yell "$*"; exit 111; } #o Ref/Attrib: https://stackoverflow.com/a/25515370
	25	try() { "$@" \|\| die "cannot $*"; } #o
	26	checkapp() {
	27	# Desc: If arg is a command, save result in assoc array 'appRollCall'
	28	# Usage: checkapp arg1 arg2 arg3 ...
	29	# Version: 0.1.1
	30	# Input: global assoc. array 'appRollCall'
	31	# Output: adds/updates key(value) to global assoc array 'appRollCall'
	32	# Depends: bash 5.0.3
	33	local returnState
	34
	35	#===Process Args===
	36	for arg in "$@"; do
	37	if command -v "$arg" 1>/dev/null 2>&1; then # Check if arg is a valid command
	38	appRollCall[$arg]="true";
	39	if ! [ "$returnState" = "false" ]; then returnState="true"; fi;
	40	else
	41	appRollCall[$arg]="false"; returnState="false";
	42	fi;
	43	done;
	44
	45	#===Determine function return code===
	46	if [ "$returnState" = "true" ]; then
	47	return 0;
	48	else
	49	return 1;
	50	fi;
	51	} # Check that app exists
	52	checkfile() {
	53	# Desc: If arg is a file path, save result in assoc array 'fileRollCall'
	54	# Usage: checkfile arg1 arg2 arg3 ...
	55	# Version: 0.1.1
	56	# Input: global assoc. array 'fileRollCall'
	57	# Output: adds/updates key(value) to global assoc array 'fileRollCall';
	58	# Output: returns 0 if app found, 1 otherwise
	59	# Depends: bash 5.0.3
	60	local returnState
	61
	62	#===Process Args===
	63	for arg in "$@"; do
	64	if [ -f "$arg" ]; then
65	fileRollCall["$arg"]="true";
66	if ! [ "$returnState" = "false" ]; then returnState="true"; fi;
67	else
68	fileRollCall["$arg"]="false"; returnState="false";
69	fi;
70	done;
71
72	#===Determine function return code===
73	if [ "$returnState" = "true" ]; then
74	return 0;
75	else
76	return 1;
77	fi;
78	} # Check that file exists
79	checkdir() {
80	# Desc: If arg is a dir path, save result in assoc array 'dirRollCall'
81	# Usage: checkdir arg1 arg2 arg3 ...
82	# Version 0.1.1
83	# Input: global assoc. array 'dirRollCall'
84	# Output: adds/updates key(value) to global assoc array 'dirRollCall';
85	# Output: returns 0 if app found, 1 otherwise
86	# Depends: Bash 5.0.3
87	local returnState
88
89	#===Process Args===
90	for arg in "$@"; do
91	if [ -d "$arg" ]; then
92	dirRollCall["$arg"]="true";
93	if ! [ "$returnState" = "false" ]; then returnState="true"; fi
94	else
95	dirRollCall["$arg"]="false"; returnState="false";
96	fi
97	done
98
99	#===Determine function return code===
100	if [ "$returnState" = "true" ]; then
101	return 0;
102	else
103	return 1;
104	fi
105	} # Check that dir exists
106	displayMissing() {
107	# Desc: Displays missing apps, files, and dirs
108	# Usage: displayMissing
109	# Version 0.1.1
110	# Input: associative arrays: appRollCall, fileRollCall, dirRollCall
111	# Output: stderr: messages indicating missing apps, file, or dirs
112	# Depends: bash 5, checkAppFileDir()
113	local missingApps value appMissing missingFiles fileMissing
114	local missingDirs dirMissing
115
116	#==BEGIN Display errors==
117	#===BEGIN Display Missing Apps===
118	missingApps="Missing apps :";
119	#for key in "${!appRollCall[@]}"; do echo "DEBUG:$key => ${appRollCall[$key]}"; done
120	for key in "${!appRollCall[@]}"; do
121	value="${appRollCall[$key]}";
122	if [ "$value" = "false" ]; then
123	#echo "DEBUG:Missing apps: $key => $value";
124	missingApps="$missingApps""$key ";
125	appMissing="true";
126	fi;
127	done;
128	if [ "$appMissing" = "true" ]; then # Only indicate if an app is missing.
129	echo "$missingApps" 1>&2;
130	fi;
131	unset value;
132	#===END Display Missing Apps===
133
134	#===BEGIN Display Missing Files===
135	missingFiles="Missing files:";
136	#for key in "${!fileRollCall[@]}"; do echo "DEBUG:$key => ${fileRollCall[$key]}"; done
137	for key in "${!fileRollCall[@]}"; do
138	value="${fileRollCall[$key]}";
139	if [ "$value" = "false" ]; then
140	#echo "DEBUG:Missing files: $key => $value";
141	missingFiles="$missingFiles""$key ";
142	fileMissing="true";
143	fi;
144	done;
145	if [ "$fileMissing" = "true" ]; then # Only indicate if an app is missing.
146	echo "$missingFiles" 1>&2;
147	fi;
148	unset value;
149	#===END Display Missing Files===
150
151	#===BEGIN Display Missing Directories===
152	missingDirs="Missing dirs:";
153	#for key in "${!dirRollCall[@]}"; do echo "DEBUG:$key => ${dirRollCall[$key]}"; done
154	for key in "${!dirRollCall[@]}"; do
155	value="${dirRollCall[$key]}";
156	if [ "$value" = "false" ]; then
157	#echo "DEBUG:Missing dirs: $key => $value";
158	missingDirs="$missingDirs""$key ";
159	dirMissing="true";
160	fi;
161	done;
162	if [ "$dirMissing" = "true" ]; then # Only indicate if an dir is missing.
163	echo "$missingDirs" 1>&2;
164	fi;
165	unset value;
166	#===END Display Missing Directories===
167
168	#==END Display errors==
169	} # Display missing apps, files, dirs
170	timeUntilNextDay(){
171	# Desc: Report seconds until next day.
172	# Version: 1.0.3
173	# Output: stdout: integer seconds until next day
174	# Output: exit code 0 if stdout > 0; 1 if stdout = 0; 2 if stdout < 0
175	# Usage: timeUntilNextDay
176	# Usage: if ! myTTL="$(timeUntilNextDay)"; then yell "ERROR in if statement"; exit 1; fi
177	# Depends: date 8, echo 8, yell, try
178
179	local returnState timeCurrent timeNextDay secondsUntilNextDay
180	timeCurrent="$(date --iso-8601=seconds)" ; # Produce `date`-parsable current timestamp with resolution of 1 second.
181	timeNextDay="$(date -d "$timeCurrent next day" --iso-8601=date)"; # Produce timestamp of beginning of tomorrow with resolution of 1 second.
182	secondsUntilNextDay="$(( $(date +%s -d "$timeNextDay") - $(date +%s -d "$timeCurrent") ))" ; # Calculate seconds until closest future midnight (res. 1 second).
183	if [[ "$secondsUntilNextDay" -gt 0 ]]; then
184	returnState="true";
185	elif [[ "$secondsUntilNextDay" -eq 0 ]]; then
186	returnState="warning_zero";
187	yell "WARNING:Reported time until next day exactly zero.";
188	elif [[ "$secondsUntilNextDay" -lt 0 ]]; then
189	returnState="warning_negative";
190	yell "WARNING:Reported time until next day is negative.";
191	fi
192
193	try echo "$secondsUntilNextDay"; # Report
194
195	# Determine function return code
196	if [[ "$returnState" = "true" ]]; then
197	return 0;
198	elif [[ "$returnState" = "warning_zero" ]]; then
199	return 1;
200	elif [[ "$returnState" = "warning_negative" ]]; then
201	return 2;
202	fi
203	} # Report seconds until next day
204	set_script_ttl() {
205	#Desc: Sets script_ttl seconds
206	#Usage: set_script_ttl
207	#Input: none
208	#Output: var: script_ttl (integer seconds)
209	#Depends: timeUntilNextDay()
210
211	# Set script lifespan to end at start of next day
212	if ! script_ttl="$(timeUntilNextDay)"; then # sets scriptTTL, then checks exit code
213	if [[ "$script_ttl" -eq 0 ]]; then
214	((script_ttl++)); # Add 1 because 0 would cause 'timeout' to never timeout.
215	fi;
216	fi;
217	} # Set script_ttl in seconds until next day
218	update_temp_file() {
219	# Input: var: $temp_photo_path file path to save photo
220	# Depends: checkapp(), raspistill
221	encoding="jpg";
222	try raspistill -gps -t 0 -q 95 -ex auto -e "$encoding" -o "$temp_photo_path";
223	};
224	showUsage() {
225	# Desc: Display script usage information
226	# Usage: showUsage
227	# Version 0.0.1
228	# Input: none
229	# Output: stdout
230	# Depends: GNU-coreutils 8.30 (cat)
231	cat <<'EOF'
232	USAGE:
233	update_temp_photograph.sh [camera_name]
234
235	EXAMPLE:
236	update_temp_photograph.sh DC1
237	EOF
238	} # Display information on how to use this script.
239
240	main() {
241	:
242	#===BEGIN process arguments===
243	if [[ $# -ge 1 ]]; then
244	camera_name="$1";
245	else
246	die "ERROR:Not enough arguments.";
247	showUsage;
248	fi;
249
250	temp_photo_dir="$temp_dir"/ninfacyzga/photograph; # generic-use dir
251	temp_photo_filename="$camera_name".jpg; # use jpg encoding
252	temp_photo_path="$temp_photo_dir"/"$temp_photo_filename";
253	#===END process arguments===
254	#===BEGIN Check for required files, dirs, and apps===
255	# Create output dir for photo dir
256	flag_exit_early="false";
257	if ! checkdir "$temp_photo_dir"; then
258	try mkdir -p "$temp_photo_dir";
259	fi;
260
261	# Check for missing files
262	if ! checkfile "$sleep_rand_path"; then
263	flag_exit_early="true";
264	fi;
265
266	# Check for missing apps
267	if ! checkapp raspistill; then
268	flag_exit_early="true";
269	fi;
270
271	# Display missing
272	displayMissing;
273	if [[ $flag_exit_early == "true" ]]; then
274	die "ERROR:Exiting early.";
275	fi;
276	#===END Check for required files, dirs, and apps===
277
278	#===BEGIN main loop===
279	set_script_ttl;
280	while [[ $SECONDS -lt "$script_ttl" ]]; do
281	# Capture new photograph
282	try update_temp_file;
283	try python3 "$sleep_rand_path" --upper 3600.0 10.0;
284	done;
285	#===END main loop===
286	};
287
288	#==END Define Functions==
289
290	main "$@";