This document outlines how to install CamDo custom firmware to enable the scripting functionality of your HERO4 camera (previously available on the HERO3 series). The firmware update is not required for standard use of the Blink, Bullet, and Dash controller boards but can be applicable for some advanced applications. The Pro and Cloud versions can be used for controlling the WiFi settings of the HERO4 camera.
If you have already installed the firmware, documentation on the script commands available and sample scripts are available here. To purchase the custom firmware, refer to the product page here.
This update is required for the successful use of the HERO4 camera with our legacy controller boards: Time Lapse Intervalometer (TL-004), Programmable Scheduler (PS-004), Motion Detector (MD-004), Wired Remote(PB-W), and Bullet Cable(BULLET-5) products, all discontinued July 2016.
Before installing the custom CSI firmware update, please ensure your GoPro has the most recent version of the standard GoPro firmware before you begin. The most recent HERO4 firmware can be installed by following the instructions outlined on GoPro’s website here.
Required items for HERO4 firmware update:
Install this firmware at your own risk! The user agrees that there is a risk that patching firmware and updating the camera can damage the camera permanently and in a way not covered by the GoPro warranty. The user agrees not to hold the website owner or software authors responsible in any way.
There are 4 main steps to update the firmware. Detailed instructions are included below.
Step 1 - Receive custom csiController after purchase
Step 2 - Update camera firmware
Step 3 - Copy the csiController file to the SD card
Step 4 - Install a CSI script to the SD card
Please follow the steps below very carefully. It is important to do everything exactly as described without skipping or changing anything. An SD card reader is required. The camera should not be connected to the computer during these steps. The battery should be fully charged before beginning.
STEP 1 - RECEIVE THE CUSTOM csiController AFTER PURCHASE
After the purchase of the Pro or Cloud version of the HERO4 CSI Firmware or a CamDo product that requires the Lite-Firmware version, you should have been prompted with an automated email asking to supply the version.txt file from the HERO4 camera(s) you are planning to install the update with. If you have made a purchase but have not received this email, please contact firstname.lastname@example.org and include your order number and attach the version.txt file from your HERO4 camera(s). Note that some browsers may give security warnings or might automatically mark an email containing a .zip file as spam.
If you require the Lite-csiController for use with one of our legacy controller boards that have been discontinued July 2016, follow the instructions on this page: http://cam-do.com/pages/hero4-firmware-patch
The version.txt file can be found on the camera's SD card in the MISC folder after formatting the SD card using the GoPro camera. If you have important footage on the SD card, make sure to save all the footage on your SD card to another device before formatting.
STEP 2 - UPDATE CAMERA FIRMWARE
This procedure will install a CamDo modified version of firmware on your camera that will allow the HERO4 to run script commands that are saved to the SD card. The custom firmware can be removed by reinstalling the standard HERO4 firmware version available on GoPro’s website.
STEP 3 - COPY THE CSICONTROLLER FILE TO THE SD CARD
After installing the CSI firmware update, the next step is to copy the script interpreter (csiController) to the SD card. The csiController will read CSI scripts on the SD card and interpret the command lines of the script that are used to perform automated functions when the camera is powered on. The csiController is coded specifically to your camera's serial number.
STEP 4 - INSTALL A CSI SCRIPT TO THE SD CARD
SAMPLE CSI LITE SCRIPTS
Take one photo and turn off camera:
Take a 30 second video and turn off camera:
SAMPLE CSI PRO SCRIPTS
Turn on WiFi when camera is powered on:
Turn on WiFi when camera is powered on and maintain WiFi connection after exiting USB mode:
Turn on WiFi for set time before turning off WiFi and the camera (used with Blink for scheduling a time for downloading time lapse images with the GoPro App):
IP Changer (Pro/Cloud)
The IP address is chosen by a new “ip.csi” file that needs to be saved on the SD card and can be used with a separate autoexec.csi script:
SAMPLE CSI CLOUD SCRIPTS
Automatic upload of images to DropBox (requires the input of router settings and an active CamDo Cloud service subscription). Information on how to adjust the script to include your personal router information can be found <here>:
Connect the camera to a local WiFi router as a CLIENT (camera normally acts as a host) to enable REST GET commands to be issued to the camera. (requires the input of router settings):