# Panodash - a script for panorama shooting
# with GoPro Hero 3+ Black or Silver as camera
# and with Panohero (http://panohero.de) as panorama head.
# Written by Martin Herdieckerhoff, inspired and tested
# by Johannes Löffelmann (and Thomas Bredenfeld?).
# Use at your own risk!
#
# On http://panohero.de/panodash,
# this material is or will be available:
# - Detailed instructions
# - Scripts or apps for panorama shooting in bright or dark environments
# - Scripts or apps for panorama shooting with various GoPro Hero models
# - Scripts or apps for panorama shooting with or without exposure series
#
# This script must be put onto the SD-card of the Hero 3+.
# After powering on the camera , the script will shoot
# 7 exposure series at iso 100, each series with 3 images.
# The exposure times are suitable for bright daylight:
#   1/200s, 1/500s, 1/125s
# All required settings are made by the script.
# No further manual settings are required.
#
# This is the suggested order of shooting directions:
# 1.) 3 directions upward
# 2.) 3 directions downward
# 3.) 1 direction downward with moved tripod (to cover the nadir)
# For ease of stitching it is suggested to rotate the arm of the Panohero clockwise.
# Each needed change of position for the Panohero is signalled
# to the user by text on the front display of the camera (for training)
# and by the red LED on the back of the camera (for use in the field).
#
# Unclear:
# - Is it possible to drop some sleep-commands?
# - Is it possible to reduce the sleep-times between shots?
# - Is a command available for sleeping milliseconds or other fractions of a second?
#
# When you modify the script yourself:
# Be sure to use Unix-style line endings.
#
# You are invited to contribute improvements for this script to info@herdima.de!

# ---------------------------------------------------
# Turn off WiFi to prevent unnecessary consumption of power:
#t app button wifi P
#sleep 5
#t app button wifi R
# Unclear:
# - How can we check whether wifi is on?
# - What conditional commands are supported (if any at all)?

# Make the user aware that the camera is controlled by a script:
# Turn on 3 red LEDs:
t app led red_front on
t app led red_top_bottom on
t app led red_back on

# Display some information on the front display:
t app fp_show 4
t app fp_string 'Camera controlled for Panohero'
sleep 3
t app fp_show 4
t app fp_string '7 exposure series of 3 shots'
sleep 3
t app fp_show 4
t app fp_string 'exposures for bright daylight'
sleep 3

# Turn off 3 red LEDs:
t app led red_front off
t app led red_top_bottom off
t app led red_back off

# Apply some appropriate settings: -----------------
t app appmode photo 		# Turn on photo mode
t app photo_size 12W 		# Wide angle (12MP)

t ia2 -ae off			# Auto exposure off
#t ia2 -af off			# Auto focus off
t ia2 -awb off			# Auto WB off

t ia2 -3a 1 1 1 1		# Turn off auto modes
# Unclear:
# Which of the 4 preceding commands are really needed
# and what is the effect of the other ones?

#t app white_balance 3000	#force White Balance
t app white_balance 5500	#force White Balance
#t app white_balance 6500	#force White Balance
#t app white_balance native	#force White Balance
# Unclear:
# Would the line with 'native' work?

# 1st AEB series, up ----------------------------------

t ia2 -ae still_exp 100 1144 1144
#sleep 1
t app button shutter PR 
sleep 2
t ia2 -ae still_exp 100 887 887
#sleep 1
t app button shutter PR 
sleep 2
t ia2 -ae still_exp 100 630 630
#sleep 1
t app button shutter PR 
sleep 2

# 2nd AEB series, up ---------------------------------
t app fp_show 4
t app fp_string 'Series 2; turn within 12s'

# Blink rear red LED two times to request turn of Panohero:
t app led red_back on
sleep 3
t app led red_back off
sleep 3
t app led red_back on
sleep 3
t app led red_back off
sleep 3

t ia2 -ae still_exp 100 1144 1144
#sleep 1
t app button shutter PR 
sleep 2
t ia2 -ae still_exp 100 887 887
#sleep 1
t app button shutter PR 
sleep 2
t ia2 -ae still_exp 100 630 630
#sleep 1
t app button shutter PR 
sleep 2

# 3rd AEB series, up ---------------------------------
t app fp_show 4
t app fp_string 'Series 3; turn within 12s'

# Blink rear red LED two times to request turn of Panohero:
t app led red_back on
sleep 3
t app led red_back off
sleep 3
t app led red_back on
sleep 3
t app led red_back off
sleep 3

t ia2 -ae still_exp 100 1144 1144
#sleep 1
t app button shutter PR 
sleep 2
t ia2 -ae still_exp 100 887 887
#sleep 1
t app button shutter PR 
sleep 2
t ia2 -ae still_exp 100 630 630
#sleep 1
t app button shutter PR 
sleep 2

# 4th AEB series, down -------------------------------

# Blink rear red LED three times to request
# switch between up and down position of Panohero:

t app fp_show 4
t app fp_string 'Switch between up and down in 20s'

t app led red_back on
sleep 3
t app led red_back off
sleep 3
t app led red_back on
sleep 3
t app led red_back off
sleep 3
t app led red_back on
sleep 3
t app led red_back off
sleep 5

t ia2 -ae still_exp 100 1144 1144
#sleep 1
t app button shutter PR 
sleep 2
t ia2 -ae still_exp 100 887 887
#sleep 1
t app button shutter PR 
sleep 2
t ia2 -ae still_exp 100 630 630
#sleep 1
t app button shutter PR 
sleep 2

# 5th AEB series, down -------------------------------
t app fp_show 4
t app fp_string 'Series 5; turn within 12s'

# Blink rear red LED two times to request turn of Panohero:
t app led red_back on
sleep 3
t app led red_back off
sleep 3
t app led red_back on
sleep 3
t app led red_back off
sleep 3

t ia2 -ae still_exp 100 1144 1144
#sleep 1
t app button shutter PR 
sleep 2
t ia2 -ae still_exp 100 887 887
#sleep 1
t app button shutter PR 
sleep 2
t ia2 -ae still_exp 100 630 630
#sleep 1
t app button shutter PR 
sleep 2

# 6th AEB series, down -------------------------------
t app fp_show 4
t app fp_string 'Series 6; turn within 12s'

# Blink rear red LED two times to signal turn of Panohero:
t app led red_back on
sleep 3
t app led red_back off
sleep 3
t app led red_back on
sleep 3
t app led red_back off
sleep 3

t ia2 -ae still_exp 100 1144 1144
#sleep 1
t app button shutter PR 
sleep 2
t ia2 -ae still_exp 100 887 887
#sleep 1
t app button shutter PR 
sleep 2
t ia2 -ae still_exp 100 630 630
#sleep 1
t app button shutter PR 
sleep 2

# 7th AEB series, down, nadir --------------------------

t app fp_show 4
t app fp_string 'Move tripod in 25s'

# Blink rear red LED three times to request change of
# position (moving of tripod) for nadir series:
t app led red_back on
sleep 3
t app led red_back off
sleep 3
t app led red_back on
sleep 3
t app led red_back off
sleep 3
t app led red_back on
sleep 3
t app led red_back off
sleep 3

t app fp_show 4
t app fp_string '7s to Nadir series'
sleep 7

t ia2 -ae still_exp 100 1144 1144
#sleep 1
t app button shutter PR 
sleep 2
t ia2 -ae still_exp 100 887 887
#sleep 1
t app button shutter PR 
sleep 2
t ia2 -ae still_exp 100 630 630
#sleep 1
t app button shutter PR 
sleep 2

# Power off camera ----------------------------------
#t app fp_show 4
#t app fp_string 'Auto off in 10s'

# Signal end of script to user:
t app fp_show 4
t app fp_string 'End of Panodash. Please power off'

t app led red_front on
t app led red_top_bottom on
t app led red_back on
sleep 5
t app led red_front off
t app led red_top_bottom off
t app led red_back off

# These commands for power-off (but with sleep 3) did not work:
#t app button power P
#sleep 5
#t app button power R
# Unclear:
# What commands are needed to power off the Hero 3+?