black forest motion PINE Lite, PINE, PINE R User Manual

Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 1 of 114
Black Forest Motion PINE Controller User Manual
PINE Motion Controller
User Manual
Valid for: PINE, PINE LITE, PINE R Firmware Version: 1.5
Release Date: 6. June 2019 Revision: 1
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 2 of 114
Black Forest Motion PINE Controller User Manual
Dear customer,
Thank you for purchasing the PINE Motion Controller from Black Forest Motion. As our customer, you receive our highest attention and we are always there for you, if you have questions or suggestions to our products.
In order to make it as easy as possible for you to start using our product, please read this user manual carefully and familiarize yourself with its safe and efficient operation.
Keep this user manual in a safe place so that it can be accessed at any time if necessary.
The current user manual is also always available for download from our website:
https://www.blackforestmotion.com/support
Company Address:
Black Forest Motion GmbH Waldstraße 2 D-78136 Schonach im Schwarzwald Tel.: +49 (0) 7722 920203 E-Mail: info@blackforestmotion.com
https://blackforestmotion.com
Register Court: County Court Freiburg im Breisgau
Register Number: HRB 717974 CEO: Moritz Huber, Patrick Ketterer
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 3 of 114
Black Forest Motion PINE Controller User Manual
Content
1. Usage of this Manual ............................................................................................ 5
2. Preface ................................................................................................................... 6
3. Introduction............................................................................................................ 7
4. Safety Instructions ................................................................................................. 8
5. Technical Specifications .................................................................................... 10
6. Connections ........................................................................................................ 11
6.1. Difference between the PINE Models ....................................................... 11
6.2. Motors ............................................................................................................. 11
6.2.1. Compatible 3rd Party Manufacturers .................................................. 11
6.2.2. Motor Connector Pinout ....................................................................... 12
6.3. Cameras ......................................................................................................... 12
6.3.1. Technical Details of the Camera Ports ............................................... 14
6.4. AUX Input ....................................................................................................... 14
6.4.1. Technical Details of the AUX Input ...................................................... 15
6.5. Power Supply of the Controller ................................................................... 16
6.6. Mounting Options ......................................................................................... 16
7. Operation of the Controller ............................................................................... 17
7.1. Boot-Up Process ............................................................................................ 17
8. PINE Motion App ................................................................................................. 18
8.1. Connection with a PINE Controller ............................................................ 18
8.2. Motor Profiles / Motor Quick Setup ............................................................ 20
8.3. Motor Setup Assistant ................................................................................... 22
8.4. Status Bar ........................................................................................................ 24
8.5. Homescreen .................................................................................................. 24
8.6. Motor Settings ................................................................................................ 25
8.7. Connections .................................................................................................. 29
8.8. Freerun ............................................................................................................ 31
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 4 of 114
Black Forest Motion PINE Controller User Manual
8.9. Application Modes ....................................................................................... 33
8.9.1. General Screen Layout ......................................................................... 33
8.9.2. Time-Lapse .............................................................................................. 35
8.9.3. Video ........................................................................................................ 46
8.9.4. Giga-Pixel ................................................................................................ 50
8.9.5. 3D-Scan ................................................................................................... 62
8.9.6. 360-Degree ............................................................................................. 73
8.9.7. Live ........................................................................................................... 87
8.9.8. Turntable .................................................................................................. 91
8.9.9. Astro ......................................................................................................... 92
8.9.10. Intervalometer ..................................................................................... 94
8.10. Multitasking ................................................................................................. 97
9. Firmware Updates ............................................................................................... 98
9.1. Activating the Firmware Update Mode on PINE ..................................... 98
9.2. Updating on Windows................................................................................ 100
9.3. Updating on Mac OS X .............................................................................. 102
10. Troubleshooting and FAQs ............................................................................ 105
11. Index ................................................................................................................. 110
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 5 of 114
Black Forest Motion PINE Controller User Manual
1. Usage of this Manual
This manual serves as a help and reference document for the end user of the Black Forest Motion PINE Controller. Read this manual thoroughly to familiarize yourself with the function of the device.
In this manual different info fields are used to clarify important points for the reader. These are listed below.
Important Note
Tip
This is an important hint. Please observe it to avoid unexpected behavior of the device.
This is a useful tip that will be helpful when using the device.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 6 of 114
Black Forest Motion PINE Controller User Manual
2. Preface
This work is protected by copyright. The rights based thereby, in particular those of the translation, the reprint, the lecture, the removal of illustrations or tables, the radio transmission, the microfilming or the duplication on other ways and the storage in data processing plants, remain reserved, also with only partial utilization.
The trademarks and brand names used in this book are the property of their respective owners.
All contents, illustrations, graphics were created with the greatest care. The author accepts no liability for any damage, in particular personal injury or damage to property, which may result from the use of this book.
Unless otherwise indicated, photos and illustrations are the property of the author.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 7 of 114
Black Forest Motion PINE Controller User Manual
3. Introduction
PINE, PINE LITE and PINE R are the most universal and flexible motion controllers on the market.
PINE is a universal and smartphone-controlled device for motion-controlled photography and video applications. With PINE you can create automated camera movements, panoramic Giga-pixel and 360° photos, motion­controlled time-lapse, automated 3D photogrammetry scans and more.
Universal and flexible
PINE is widely compatible with existing hardware such as sliders, pan/tilt heads and focusing units. Control up to 4 axes and 2 cameras simultaneously with one controller. Corresponding adapter cables to third-party systems are available from Black Forest Motion.
Smartphone-Control
The most convenient way to control your system. Simply use your smartphone or tablet and the PINE Motion App gives you access to the extensive functions of the PINE Controller. Once you've set everything up, the PINE Controller ends its task even if the connection to the app is disconnected or your phone's battery dies. The PINE Motion App is available for Android and iOS devices.
High-quality Connectors & Cables
PINE uses high quality, lockable Hirose connectors for a secure connection to the motors. The camera and power connections are equipped with industry standard connectors.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 8 of 114
Black Forest Motion PINE Controller User Manual
4. Safety Instructions
a) Before operating the device, make sure that you only use cables and
accessories manufactured or recommended by us.
b) Never connect or disconnect a motor connection to the controller while
it is in operation. Disconnect the power supply to the PINE Controller before connecting or disconnecting motors. Otherwise the motors or the controller as well as all connected devices may be damaged!
c) Never use the controller in humid or wet environments such as rain. Water
and moisture entering the controller may destroy it, cause unexpected behavior, or cause personal injury from electric shock.
d) With the PINE Controller you can control stepper motors. These stepper
motors can generate a very high force, especially if they are geared. It is your responsibility as a user to ensure that no persons are injured, or other damage is caused during operation.
e) Before the motors are connected to the PINE Controller, all motors should
be mechanically brought into a position where they can move freely.
f) PINE has no sensors to detect the current position of the motors. It may
happen that a motor is mechanically blocked (e.g. if it is overloaded or blocked) and does not continue to rotate. In this case, the stored positions no longer correspond to the current positions of the Motion Control. If a stored sequence is then played back, the movement can be completely different from the movement programmed by the user. In the worst case, this can lead to defects in the attached accessories, cables or even injuries.
g) If the device and the connected motors behave differently than
expected, please disconnect the power supply at the PINE Controller immediately to stop the movement.
h) Do not reset the PINE controller into firmware update mode without
intending to install a new firmware. The controller cannot be used in update mode until a new firmware has been installed.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 9 of 114
Black Forest Motion PINE Controller User Manual
The symbol of a crossed-out wheeled bin indicates that our device complies with the Directive 2012/19/EU of the European Parliament and European Council of 27.01.2003 on the separate collection of electrical and electronic equipment.
By affixing the CE mark, we declare that our device, in accordance with EU Regulation 765/2008, meets the applicable requirements laid down in the Community harmonization legislation on its affixing.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 10 of 114
Black Forest Motion PINE Controller User Manual
5. Technical Specifications
PINE
PINE LITE
PINE R
Operating Temperature
-20° to +45°
Storage Temperature
-30° to +60°
Humidity
10%-90% not condensing
Connectors
Power: DC-Barrel 2.1x5.5mm Center Positive
USB: Micro USB B
Motors: Hirose HR10A-7R-6S(73) (6-pin Female)
4x
2x
4x Cameras: 2.5mm TRS 3-pin
2x
1x
1x
AUX: 2.5mm TRS 3-pin
1x
1x
1x
Expansion RJ11 6-pin
2x
0x
0x
Limitswitch
Mechanical (NC) Switch for each Motor (Pin 5 and Pin 6 on the HR10 Connectors)
Motor Type
Bipolar Stepper motors (max. 1.2A per Chanel)
Motor Ports
Not limited with Expansion
4x
2x
4x
Expansion
Daisy Chain over Bluetooth or RJ11
Yes
No
No Input-voltage
10-24V
Dimensions
L/W/H: 99 x 77 x 30mm
Weight
Approx. 150g
App Compatibility
Android 4.3 or newer / iPhone 5 and iOS 10.3 or newer
Wireless Range
30-100m under ideal conditions and line of sight
Wireless Technology
Bluetooth Low Energy 4.1 (2.4-2.48 GHz)
CPU
ARM Cortex
Firmware Update
Over Micro USB (With PINE Firmware Updater Utility)
All PINE controllers were subjected to the following test specifications, which were successfully passed:
Radio interference voltage mains
connection EN 61000-6-3:2007+A1:2011
Radio interference field strength EN 61000-6-3:2007+A1:2011
ESD-Test EN 61000-4-2:2009
Testing against electromagnetic fields EN 61000-4-3:2006+A1:2008+A2:2010
Burst-Test EN 61000-4-4:2012
Surge-Test EN 61000-4-5:2014
Testing against conducted radio
interference EN 61000-4-6:2014
Testing against magnetic fields with
energy frequencies EN 61000-4-11:2004
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 11 of 114
Black Forest Motion PINE Controller User Manual
6. Connections
The PINE models have different connectors configurations. They differ in the number of motor and camera connections as well as the serial RJ11 sockets.
6.1. Difference between the PINE Models
PINE
PINE LITE
PINE R
Number of Motor Ports
4 2 4
Number of Camera Ports
2 1 1
Number of AUX Ports
1 1 1
Wireless expandable
Yes
Only with PINE
Only with PINE
Wired expandable
Yes
No
No
6.2. Motors
Only stepper motors may be connected to the motor sockets. The connection is made via a lockable high-quality Hirose HR10 socket.
The motors available via Black Forest Motion offer the same high-quality connectors and can be connected with the standard Black Forest Motion 4pin Hirose cables.
In addition, the PINE controllers support various third-party motor units. These are listed in the following chapter.
6.2.1. Compatible 3
rd
Party Manufacturers
Any motorized slider, pan/tilt head, turntable, focus/zoom unit that has a stepper motor can be connected to PINE. Here are some examples of working systems:
Dynamic Perception Stage Zero Slider Dynamic Perception Stage One Slider Dynamic Perception Sapphire Pro Pan + Tilt Head Dynamic Perception Stage R Rotary System MDK V5 Pan & Tilt Head MDK V6 Pan & Tilt Head Rhino Motion Slider PocketSlider PT PRO PT Pan Tilt Head (PocketSlider) Nic-O-Slider
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 12 of 114
Black Forest Motion PINE Controller User Manual
Nic-O-Tilt Head eMotimo Turntable PureMoCo Focus/Zoom Unit GVM Slider Many more
6.2.2. Motor Connector Pinout
The following connection diagram is given for the proper use of your own stepper motors.
Connections 5 and 6 can be used for mechanical limit switches (normally closed). If the contacts are opened, the PINE controller can detect the start positions of the motors (if activated in the app).
6.3. Cameras
All cameras that can be triggered with a so-called "trigger cable" can be connected. Cables from other manufacturers can also be used. On the controller side, these cables must have a 2.5mm 3-pin TRS plug.
The following cables, which are compatible with the specified cameras, are
available as accessories (see following page):
Never disconnect motors from the PINE Controller while it is powered on. Never plug motors into the controller while it is active. This can lead to defects of the internal motor drivers. Always disconnect the power supply before connecting and disconnecting motors.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 13 of 114
Black Forest Motion PINE Controller User Manual
Type
Camera
E3
For Canon: G10/G11/G12/G15/G1X/G1X II/T1i/T2i/T3i/T3/T4i/T5i/450D/500D/550D/600D/650D/700D/70D/750D /760D/800D/80D/100D/60D/77D/M6/M5/400D/350D/300D/1300D/1 200D/1100D/1000D/SX50/SX60
N3
For Canon: 7D/7DII/6D/50D/5DII/5DIII/5D/5D4/5DS/40D/30D/20D/10D/1D/1DS/ 1DX/ 1Ds Mark II/1Ds Mark III/1Ds Mark IV/EOS-1V/EOS-3
DC0
For Nikon: D1/D1H/D1X/D2/D2H/D2X/D3/D3s/D3x/D4/D5/D100/D200/D300/D 300s/D500/D700/ D800 /D800e/D810/F100/F90/F90X/N90s/F6/F5 For Fujifilm: S3 Pro/S5 Pro For Kodak: DCS-14N
DC2
For Nikon: D7500/D750/D7200/D7100/D7000/D610/D600/D5600/D5500/D5300/ D5200/D5100/ D5000/D3300/D3200/D3100/D90/DF/P7700/P7800/coolpix A
S1
For Sony: a900/a850/a800/a700/a580/a560/a550/a500/a450/a400/a350/a3 00/a200/a100/ a99/ a77/a65/ a57/a55/a35/a33/a77M2/a99M2 For Konica Minolta: DIMAGE a2/a1/9/7Hi/7i/7/5/4/3/DYNAX 7D/5D
S2
For Sony: a9/a7/a7R/a7S/a7SII/a7R II/a6500/a6300/a6000/a5100/a5000/a3000/HX300/HX50/ HX60/RX100 II/RX100 III/RX100M4/RX100M5/a58/NEX-3N
L1
For Panasonic DMC: FZ50/FZ50K/FZ50S/FZ30/FZ30K/FZ20/FZ20K/FZ20S/FZ300/FZ200/FZ150/ FZ100/FZ1000/FZ2000/FZ2500/G85H/G85/G10/G7/G6/G5/G3/G2/G 1/GH4A/GH4/GX8/GX7/GX1/GH3/GH2/GH1/GF1/LC-1/L1/L10/DC­GH5 For Leica: DIGILUX2/DIGILUX3
UC1
For Olympus: E-620/E-600/E-550/E-520/E-510/E-450/E-420/E-410/E-100/E-30/E­M10/E-M10II/E-M5/E-M5II/E-M1/E-PM1/E-PM2/PEN-F/E-PL8/E-PL7/E­PL6/E-PL5/E-PL3/E-PL2/E-P5/E-P3/E-P2/E-P1 SP: SP-590UZ/570UZ/565UZ/560UZ/550UZ/510UZ/810UZ/SZ-300MR/SZ­20/SZ-11/XZ-1
E2
For Fujifilm: X-M1/X100T/X100F/X-T20/X-T2/X-T1/X-T10/X-E2/X-A1/X-A2/X-A3/ X-A10/X70/X30/GFX50S/XQ1/XQ2/FinePix S1/X-PRO2
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 14 of 114
Black Forest Motion PINE Controller User Manual
6.3.1. Technical Details of the Camera Ports
The PINE Controller has two potential-free, galvanically isolated open collector/drain outputs (Solid State Relay) per camera socket. One output controls the focus and the other the shutter release of the camera. Both outputs are connected to the ground connector of the camera by the PINE controller.
In the following, a symbolic representation of the internal wiring is shown:
6.4. AUX Input
In addition to the camera connections, the PINE Motion Controllers also have a connection for an AUX input. This input can be used, for example, to control a time-lapse motion with an external interval generator. The connector can be connected to the flash sync connector of a camera or directly to the corresponding interval generator.
A typical application is the use of the PINE motion controller with the stop trick animation software Dragonframe. The camera is controlled directly by Dragonframe via USB. The PINE can then be operated in Slave Mode. For this purpose, the camera is connected to the AUX port of the PINE controller via a special connection cable at the flash synchronization connection. In time-lapse mode, the interval setting must now be changed to SLAVE MODE. With a corresponding delay time, the PINE moves the camera to the next desired position after each image.
A similar application is the operation of the PINE Controller by an external interval generator such as the VIEW by Timelapse+. This takes over the interval and can then also carry out a so-called interval ramping.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 15 of 114
Black Forest Motion PINE Controller User Manual
6.4.1. Technical Details of the AUX Input
The AUX input of the PINE Controller has two inputs which are internally connected to 3.3V via pull-up resistors.
The following schematic shows the internal wiring of the AUX socket.
If the AUX input is used, the inputs must be connected to the ground line via potential-free open collector/drain circuits.
So far, only the AUX_B input (front center pin of the TRS connector) is used.
The AUX_A input is reserved for later developments.
Do not connect any external voltages to the inputs of the AUX socket! This can destroy the internal components. Only use potential-free, open collector/drain circuits (optocouplers or solid-state relay outputs) to connect the input lines to the ground line.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 16 of 114
Black Forest Motion PINE Controller User Manual
6.5. Power Supply of the Controller
Universal, rechargeable batteries and power supply units can be used for the voltage supply. They should output a DC voltage in the range between 10 and 24V. We recommend a voltage of 12V.
Connected batteries and power supplies should be able to deliver at least 15W or 1.5A.
It is essential to use a suitable DC cable with a 2.1x5.5mm plug. The middle "Center" connector must be positive.
Using other DC connectors (e.g. 2.5x5.5mm) can cause sudden restarts or voltage losses. This might also result in connection problems with the App.
6.6. Mounting Options
To attach the PINE Controller to the Motion Control (Slider, Pan & Tilt, etc.) different threads are attached to the bottom of the controller. The middle thread is a ¼" UNC photo thread. This allows to attach the Controller to any photo tripod or photo accessory. In addition, the PINE controller offers four metric M4 threads that are specially arranged. Here, the mounting plate can be mounted in two directions - horizontally and vertically. This plate can be slid onto the Arca-Swiss profiles of the Nic-O-Tilt or slider and is held in place by magnets.
¼“ UNC
M4
The PINE Controller can only be operated via the DC socket. The USB socket is used for pure data transfer and firmware updates and cannot be used for connecting power supplies to the controller.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 17 of 114
Black Forest Motion PINE Controller User Manual
7. Operation of the Controller
Please observe all above mentioned safety instructions before putting the PINE Controller into operation! First connect all motors to the controller before connecting the power supply. Make sure that all motors can move freely.
If you have connected the PINE controller to the motors, you can plug in the power supply via the DC socket. The controller now starts its boot process. Various tests of the internal components are carried out. All LEDs light up at least once during the boot up process.
7.1. Boot-Up Process
After connecting the power supply, the boot process starts. The status LED lights up red and flashes green at the same time. After a successful boot process, the red status LED goes out and then remains flashing green. The controller is then ready for operation and ready to establish a Bluetooth connection with a smartphone.
If the status LED remains red even after several seconds, the boot process has failed and the power supply must be disconnected and reconnected.
During the boot process, the blue Bluetooth connection LEDs also light up. In these moments the wireless modules of the controller are checked and initialized.
If the LEDs under the motor sockets light up red, the controller checks whether motors are connected to the corresponding sockets. If a motor is connected, it should make a short buzzing noise. If the motor has been successfully detected, the motor LED changes to green. Otherwise, if no motor is detected, the LED will turn off. If not all connected motors have been detected, check the connectors and restart the controller.
If all LEDs of the controller flash red after connecting the power supply, this indicates that the voltage is outside the allowed specifications. Check that the voltage is between 10V and 24V.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 18 of 114
Black Forest Motion PINE Controller User Manual
8. PINE Motion App
With the PINE Motion App, the PINE Controller can be controlled remotely. The app is available for Android devices (version 4.3 or newer) and iOS devices (iPhone 5 and newer / iOS 10.3 or newer). It can be downloaded from the Google Play Store or App Store. More information can also be found on our website.
Both versions of the app (Android and iOS) are almost identical. In some views, however, the apps differ. In this chapter you will therefore find screenshot views from both apps.
At the first start of the Apps, the permissions for different services have to be granted. If the user does not grant them all, the app may not start. In this case, uninstall the app and reinstall it. Enter all requested permissions.
8.1. Connection with a PINE Controller
After a successful boot process (status LED flashes green), the controller can be connected to a smartphone and the PINE Motion App via Bluetooth.
First make sure that the PINE Motion App is installed on your smartphone.
Before starting the PINE Motion App, activate the Bluetooth function of your smartphone. Some mobile phones also require an active GPS/location function to establish a successful connection with the controller. The PINE Motion app only uses GPS data to store your location in user-created XML files in Giga-Pixel and 360-degree mode. Otherwise your GPS data will not be used or stored.
Do not try to pair your smartphone with the PINE Controller using the phone's Bluetooth settings. A Bluetooth connection is handled exclusively via the PINE Motion App and no Bluetooth settings need to be adjusted.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 19 of 114
Black Forest Motion PINE Controller User Manual
After starting the PINE Motion App, it starts the Bluetooth scan process after about 3 seconds and searches for a PINE Controller. If the "Auto-Connect” option is activated, the app connects automatically as soon as a controller is found. The controller indicates a successful and active Bluetooth connection via a blue connection LED.
If the app does not find a controller after approx. 60 seconds, it stops the search process to reduce the battery consumption. A new search process can be started via the "Scan" or field.
If the "Auto-Connect" option is deactivated, you must tap on the "PINE" entry as soon as the controller is within range and has been found. The "Auto Connect" option can be activated and deactivated directly on the connections screen in Android and can be changed under "Connections" in iOS.
The demo mode of the app can be accessed via the "DEMO" field. Use this mode to familiarize yourself with the app if you have not yet purchased a PINE Controller.
Android iOS
It is recommended to close the app completely and start it new with every new use. Do the same if you have problems establishing a connection. In this case, restarting the controller itself can also help.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 20 of 114
Black Forest Motion PINE Controller User Manual
8.2. Motor Profiles / Motor Quick Setup
After successful Bluetooth connection, the Motor Quick Setup will appear (if motors are connected). This selection can be used to set different motor profiles for the motors. These motor profiles define settings such as motor gear ratio and output current. For a correct function of the motors, all profiles should be set correctly. Only in this case is it ensured that the motors move as specified by the app. The appropriate profiles are already stored for the motors, sliders and pan & tilt heads distributed via Black Forest Motion.
Android iOS
Take enough time to understand the need for motor profiles. If the motors behave strangely, become very hot, or make noises, there is a high probability that incorrect profiles have been selected.
The "Default" profile within the app defines a motor current of 0.4A. This is too low for many standard motors to provide a proper function. Therefore, set the appropriate profiles correctly.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 21 of 114
Black Forest Motion PINE Controller User Manual
If motors were not detected during the boot process, they can also be activated manually under the "Undetected Motors" section of the Motor Quick Setup. Activate the motors and confirm the selection with "Confirm".
The Motor Quick Setup can be accessed at any time via the Homescreen and the icon in the status bar.
The profiles for the motors are stored according to the motor ports. If you for example always connect your slider to motor port 1 and the Pan & Tilt units to 2 & 3, the entered profiles will be loaded again the next time you start the app. All you need to do now is confirm the selection.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 22 of 114
Black Forest Motion PINE Controller User Manual
8.3. Motor Setup Assistant
If no predefined motor profile is available for your system, you can create your own profile in just a few steps. To do this, tap on the symbol to the right of the profiles for the corresponding motor. An intuitive Motor Setup Wizard will then open and guide you step by step through the process.
1. First select whether the connected unit is a slider (linear unit) or a pan/tilt
(rotation unit).
2. In the second step, specify a distance or angle by which you want to
move the motor. As an example, for a pan/tilt motor we set an angle of 90 degrees. Now you have to turn the motor exactly 90 degrees. Use the arrow keys for forward / backward. You can use the slide bar to adjust the speed to move larger angles faster and smaller angles more accurate and slower. If you have rotated the motor by exactly the same angle as indicated above, you can jump to the next step. Based on the distance travelled, the PINE Controller can now automatically determine the gear ratio of your motors.
3. On the last page of the Motor Setup Wizard you can now enter a name
for your profile and save the profile. You can then use this profile at any time to define exactly this motor.
When you have defined and set the profiles for all motors, confirm the Quick Motor Setup. The app now transmits all data to the controller. This may take a
few seconds. You will then be taken to the Home screen.
If the motor does not rotate properly at step 2, the set output current is probably too low. The current is 0.4A after controller restart. In this case, cancel the Setup Assistant and increase the motor current under Motor Settings (see also chapter 7.6).
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 23 of 114
Black Forest Motion PINE Controller User Manual
Android
iOS
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 24 of 114
Black Forest Motion PINE Controller User Manual
8.4. Status Bar
In the status bar you will find the settings for triggering the various camera ports as well as a motor icon. The motor icon is used within the Homescreen to access the motor quick setup and within some other applications as a motor selection menu (see the description of the different applications below for more details).
You can also use the question mark to display explanations of the different modes. If you have any questions, you will find a quick answer to the mode you are currently using.
The iOS App also has a blue Bluetooth icon on the left that indicates the status of the Bluetooth connection. The symbol is blue when the connection is active, otherwise it is grey. If you tap on the field, you will get additional options to disconnect manually and reconnect if the connection is lost.
Android iOS
8.5. Homescreen
On the Homescreen, you will find all accesses points to the applications of the PINE Motion App. Each mode or button is explained below.
Android iOS
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 25 of 114
Black Forest Motion PINE Controller User Manual
8.6. Motor Settings
In the Motor Settings, important properties of the connected motors can be adapted. Take enough time to understand all possible settings. This is important and necessary for the proper functioning of the motors.
In the upper part of the view, the connected motors can be selected. Tap on the symbols to do this. A selected motor appears with a colored motor icon, while the inactive motors have grayed-out icons. Settings are made separately for each motor.
Android iOS
The motor profiles can also be set under the motor settings (similar to the Motor Quick Setup). Further profiles can also be added via the Motor Setup Wizard. To do this, click on the green symbol.
Within the iOS App, motor profiles can also be copied using the icon.
User-created profiles can be deleted via the red icon.
In addition to the profiles, you can also assign names to the individual motors. These names are then displayed in the other modes and are useful for quick identification of the individual axes.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 26 of 114
Black Forest Motion PINE Controller User Manual
A maximum speed per motor can also be set. This is global for the motor. All speed settings within the different modes are to be understood proportional to this total speed.
Under the Advanced tab, advanced settings can be made. For predefined motor profiles (except the default profile) the settings for Ratio/Revolution and Current are blocked.
The following settings can be adjusted:
Ratio and Revolution
This is an important setting if you want exact position values to be displayed within the app. For application modes such as Time Lapse or Video, this setting may be irrelevant for the function of the motors if they do not require exact position values. However, if you use the Giga-Pixel, 3D scan, or 360-degree mode, a correct setting of the gear ratio is absolutely necessary.
A rotation unit (e.g. Pan/Tilt) requires a setting of the gear ratio. Specify the ratio between the stepper motor shaft and the (externally accessible) pan or tilt axis shaft.
Example NT Head: The unit contains a worm gear with a ratio of
1:32. Specify exactly this ratio in the app.
A linear unit (e.g. slider) requires a setting of the moved distance per stepper motor revolution.
Example BFM Slider: Our BFM Slider has a gear diameter of 25mm
(which adapts to the toothed belt). With a stepper motor without gearbox (1:1), the slider moves by L=25xπ=78,5mm per motor shaft revolution. Enter a rotation of 78. 5mm in the app. For a stepper motor with gearbox (e.g. 14:1) the moved slider distance per
revolution is reduced to L=25xπ/14=5,6mm.
Enter a rotation of 5.6mm in the app.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 27 of 114
Black Forest Motion PINE Controller User Manual
Current
Defines the maximum current for the motor in amperes. It can be set up to 1.2A. If a motor is too warm, the current should be reduced. If a motor does not appear to be moving or has too little power, increase the current.
The end user is responsible for setting an output current within the range permitted for the motor. If a motor is overloaded and defects in the motor occur, the end user is responsible.
Energy Saving
This limits the current for the motor during standstill. This can be used on motors with gearbox or worm gears.
A setting of 0% does not save any energy during standstill and the motor is continuously operated at full output current. This setting provides the best motor performance and response.
A setting of 100% completely reduces the output current during standstill to 0A.
Zero Position
This allows the position of the motor to be reset to zero. This setting is only relevant if you want to work with absolute position values. When using a slider, you can, for example, set the zero position at the end stop of the slider. Then you can enter exact absolute positions for keyframes to move the slider to a certain position.
If you have connected mechanical limit switches to the controller and slider, you can also start an automatic calibration here. The slider moves until the limit switch is activated. This position is then used as the new zero position.
If you use a lens unit from Black Forest Motion, do not exceed an output current of 0.4A! All other motor units available from Black Forest Motion can be operated up to 1.2A.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 28 of 114
Black Forest Motion PINE Controller User Manual
Invert
Reverses the direction of movement of the motor.
If you use the slide bars inside the app to move the motors and a connected slider moves to the right, the slider will move to the left after an inversion.
Limits
Limits for the motors can be set here. This means that a motor can only move between the two defined limits.
Limits are helpful for sliders if you don't want to worry about driving the slider to the end stop.
If you switch off the controller, it loses its information about the current positions of the motors. If you then restart the controller, the current positions are initialized with zero. If you want to use the previous limit positions again, you must ensure that the zero position is set correctly again.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 29 of 114
Black Forest Motion PINE Controller User Manual
8.7. Connections
Under Connections, the connected controllers and motors are displayed. In addition, information of the controller can be called up here and the controller can be set to firmware update mode. Within the iOS App, the "Auto­Connect" function can be activated and deactivated here as well. If this function is active, the app will automatically connect to the controller after launching the app if the controller is ready.
Furthermore, additional PINE controllers (not PINE LITE or PINE R) can be connected to an existing connection via "Add Controller". All PINE controllers are connected in a chain (daisy chain), while the smartphone is connected to the first controller in the chain.
Android iOS
Night Mode
When night mode is activated, all LEDs on the controller are switched off. Use the night mode if you want to take pictures in the dark and do not want any interference from external light sources.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 30 of 114
Black Forest Motion PINE Controller User Manual
Controller Info
The Info symbol provides important information about the connected controller. These are:
Serial number of the controller
Firmware version and release date
Supply voltage
Controller Identification
The status LED of the corresponding controller flashes red 5 times after pressing the symbol. This serves to identify the controller when several devices are connected.
Firmware Update Mode
You can put the controller into firmware update mode by tapping on the red symbol and confirming the appearing message. Do this only if you intend to install a new firmware on the controller.
If you put the controller into firmware update mode, the firmware on it will be completely deleted. This is necessary for a new installation. The blue connection LEDs light up slightly while the controller is in firmware update mode.
For more information on how to update the controller firmware, refer to chapter 8 of this manual.
The entire controller is not functional if it is in firmware update mode. Only when a new firmware has been installed via our update program, the controller will be functional again.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 31 of 114
Black Forest Motion PINE Controller User Manual
8.8. Freerun
The Freerun mode can be used to move the motors freely in real time.
The Android and iOS apps differ within the Freerun mode as shown below.
Android iOS
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 32 of 114
Black Forest Motion PINE Controller User Manual
Both App versions have arrow keys and slide bars to move the individual motors. The slide bars react linearly according to the bar’s deflection. This means that the motor rotates slowly when the bar is moved to the right or left only minimally and at the maximum speed with full bar deflection.
Within the Android App you select the motors via the upper motor symbols. With iOS all motors are arranged on one screen.
The Android App also has a virtual joystick. The two axes for X and Y can be freely assigned to motors and the axes can also be inverted.
Motor Speed
With the Android App, you define the motor speed using the provided slide bar.
For the iOS App, tap on the colored motor name. There you can adjust the speed with a slide bar.
Motor Ramps (Ease IN/OUT)
Ramps or Ease-In and Ease-Out define how smoothly the motor starts and stops when the arrow keys or slide bars are operated. A high Ease value causes the motors to start and stop slowly and gently. Both ramp (Ease) values are limited to 100% in total.
With the Android App, you define the motor ramps using the provided slide bars.
For the iOS App, tap on the colored motor name. There the ramp values can be set with slide bars.
Hold Speed (only Android)
If you have activated this option, the motor will continue to move even if you release the arrow keys or slide bars. Stop the motors by disabling the Hold Speed switch or tapping the icon.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 33 of 114
Black Forest Motion PINE Controller User Manual
8.9. Application Modes
The PINE Motion App offers various applications. These applications can be used to create time-lapse, images, videos or scans. All application modes are explained in this chapter.
8.9.1. General Screen Layout
All application modes of the PINE Motion App are similar in their screen layout. This subchapter gives a short overview, which should help you to understand the different areas within the modes.
Android iOS
In the upper graphic, the important parts of the general user interface are colored (using the time lapse mode as an example).
The upper red area is divided into 2 to 4 sections depending on the
mode. Within the Android App you can move to the next view with a swipe to the right or left. Within the iOS version you can get to the next view by using the labeled buttons.
Settings,
Controls, Graphs
Keyframes
Motor Controls
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 34 of 114
Black Forest Motion PINE Controller User Manual
In the red area you can also make important settings for the respective mode and change parameters. Tap on the blue symbols to do this.
You can also start, pause and stop recording in this area. You will find the corresponding buttons for Start , Pause , Forward , Backward and Stop .
In some modes you will also find graphs in this area that visualize the current motion sequences.
In the blue or middle area, you can add, delete or change keyframe
positions. You can find more information on this in the following
explanation of the individual modes.
Keyframes are arranged horizontally in this area (provided the mode supports multiple keyframes). You can swipe to the right and to the left to see all keyframes.
In the lower or orange area, you will find slide bars for the motor
controls. Motors are arranged vertically one below the other. If not
all motors fit on the screen, you can scroll down using a swipe motion.
Within each mode you will also find a question mark icon on the right side of the status bar. Here you will find further help texts explaining the
respective mode.
Tap on the colored motor names in this area. Here you can make other important settings for each motor for each mode. For example, the motor ramps and the motor speed can be adjusted.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 35 of 114
Black Forest Motion PINE Controller User Manual
8.9.2. Time-Lapse
The time-lapse mode is used for motorized time-lapse recordings. An alternative name is for example: SMS or Shoot-Move-Shoot. This means that the camera stands still during recording before it moves a step. This is a fundamental difference to systems with continuous motion. This means that there will be no motion blur in the image.
8.9.2.1. General Operating Method
The PINE controller processes a defined interval several times. This interval includes the triggering of the camera, pause times, and motor movements. Each time the camera is triggered, the motors (and also the camera) are in a new position. The motor movement takes place along a path programmed by the user (via keyframes).
If you now combine all individual images of your camera to a video, you get a moving time-lapse recording.
8.9.2.2. Recommended Workflow
Set keyframes
Adjusting Interval and Camera Settings
Define total recording time (number of images)
Testing the procedure with the Test Modes
(Possibly adjust interval, pause times, and speed)
Start recording
8.9.2.3. Setting Keyframes
Use the motor slide bars to move the motors (or sliders or Pan & Tilt etc.). Think about a motion path or sequence and define keyframe positions. A keyframe is a specific motor position such as the start or end point of a movement.
When all motors are e.g. at the desired start position, you set the first keyframe over the first (left) Symbol. Keyframes are set for all connected motors at the current positions. As soon as a keyframe has been set successfully, a green checkmark appears next to the keyframe symbol. Set further keyframes in the same way. In most cases, two keyframes are sufficient.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 36 of 114
Black Forest Motion PINE Controller User Manual
However, further keyframes can be set via the symbol in order to realize more complex movements.
Already set keyframes can be overwritten at any time by pressing the keyframe symbol again (short tap).
Each keyframe is also assigned a frame or image number. After the corresponding number of frames, the motors will be located at the respective keyframe.
8.9.2.4. Editing and deleting Keyframes
If at least one keyframe has been set, you can use the icon to display an extended view of the keyframes. The corresponding motor positions are now displayed under each keyframe symbol. The position values are assigned to the motors in color (same colors corresponding to the motor names next to the slide bars). The frame numbers assigned to the keyframes are in yellow.
All position values and image numbers can now be changed manually by tapping on the values. A dialog box will appear where you can adjust values. You can also move individual motors to the
selected keyframe positions.
Hold down the keyframe symbol of a set keyframe (with green checkmark) to let all motors move to the corresponding keyframe.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 37 of 114
Black Forest Motion PINE Controller User Manual
Delete keyframes by tapping on the icons while in the extended keyframe view.
When you are finished editing the keyframes, tap the icon again.
8.9.2.5. Interval and Camera Settings
Open the Interval settings via the icon. Here you can adjust time values within a single interval. All time values are processed by the controller in the sequence as listed (from top to bottom).
Change the times using the and symbols. A short tap on the symbols increases or decreases the value by 0.1 seconds. If you hold down the symbols, the values change faster.
Android iOS
Make sure that the correct motor profiles are set or that the gear ratio values under the motor settings are correct. Only then will meaningful position values be displayed here.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 38 of 114
Black Forest Motion PINE Controller User Manual
Camera
Determines how long the trigger signal of the camera is pressed. In time-lapse mode, always set your camera to manual focus and not automatic focus.
If you define the exposure time via your camera, this time serves as a pure trigger impulse and a time of 0.1 to 0.3 seconds is sufficient.
However, if you operate your camera in the so-called Bulb mode, you can set a longer time here. In this case, the exposure time is defined by this time setting. This allows you to set the shutter release time for night shots to more than 30 seconds (the maximum exposure time for most cameras).
Alternatively, you can also take HRD pictures with a longer camera time. Set your camera to bracketing mode. Then set the camera time in the app long enough for your camera to complete all bracketing shots.
Delay
This is a waiting time that starts after the camera time has elapsed. After the waiting time has elapsed, the motor movement begins. Set this time so that your camera can complete the current shot before the motors begin to rotate.
If you define the exposure time via your camera, this value must be adjusted to the actual exposure time. For example, if you have set an exposure time of 5 seconds using your camera, set the camera time to 0.1 seconds and the delay time to at least 5.0 seconds.
However, if you operate your camera in Bulb mode, you can set the delay time to a short value such as 0.5 seconds.
Movement
This time signals how long the motors move within an interval. This time cannot be changed directly. It depends on the programmed movement distance, number of images, and motor
speed.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 39 of 114
Black Forest Motion PINE Controller User Manual
Excess
Based on the previously listed times, there is a minimum interval time. The excess time is an automatically calculated time and signals the difference between the set interval time and the minimum interval time. With an excess time of 0.0 seconds, you have reached the minimum interval time.
Interval
This is the total interval time. It determines how long a single interval lasts and thus determines the time difference between the captured images.
As explained under Excess, all set times result in a minimum
interval time which cannot be undercut.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 40 of 114
Black Forest Motion PINE Controller User Manual
8.9.2.6. Slave Mode
The slave mode allows you to operate the PINE controller via an external interval generator such as the VIEW by Timelapse+. Connect the external interval generator to the AUX input of the PINE controller and activate the slave mode in the interval settings (you can switch
between “Regular Mode” and “Slave Mode” within the dialog
window).
Android iOS
Set keyframes in Slave mode in the same way as for normal/regular usage and set the desired number of intervals that should be executed.
In slave mode, the PINE controller waits to move the motors until it detects an external signal from the interval generator. In the Interval settings, all times except the Delay time are hidden. With the Delay time you can set how long the PINE controller should wait after receiving the external signal via the AUX input before moving the motors.
For more important information about the AUX input, refer to chapter
5.4 of this manual.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 41 of 114
Black Forest Motion PINE Controller User Manual
8.9.2.7. Determine the Recording Time
The PINE Motion App gives you several ways to determine the total recording time. Settings for number of frames, time-lapse video duration, and recording time are all linked. So be aware that all parameters will change if you change only one value.
Number of Pictures
Use the icon to determine the number of images. This also determines the number of intervals.
The total recording time then results from the multiplication of the interval time and the number of images.
Set Recording Time directly
Use the icon to specify directly how long the recording should last. The selection is divided into hours, minutes and seconds.
With the iOS version of the app, the number of images is adjusted after entering the recording time.
With the Android version of the app you can also determine whether the number of images or the interval time should be adjusted, which allows the set recording time.
Time-Lapse Video Time (rendered Time)
Use the icon to specify how long the rendered time-lapse video should be. This setting takes the set frame rate into account.
With the iOS version of the app, the number of images is adjusted after entering the video time.
With the Android version of the app you have the possibility to adjust either the number of pictures or the picture rate, which allows the set video time.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 42 of 114
Black Forest Motion PINE Controller User Manual
Frame-Rate
The frame rate has no direct influence on the actual time-lapse operation. This setting is only used by the app to calculate the rendered time lapse duration (video time) mentioned above.
It is recommended (but not mandatory) to render the actual time-lapse video in post-production at the same frame rate as the one set within the app.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 43 of 114
Black Forest Motion PINE Controller User Manual
8.9.2.8. Test Modes
In time-lapse mode, you can make use of three different test modes before starting the actual recording. This should help you to check if all values have been set correctly and the recording will be successful.
Start the tests by tapping on the blue icons. The icons will then change to STOP fields. You can use these to cancel the tests prematurely.
Exposure Test
Triggers the camera once with the set camera time.
Interval Test
Executes a total of 5 intervals with the current settings. The camera will be triggered, pause times are waited, and the motors are moved.
Movement Test
Moves the motors along the programmed distance from start to finish. The total movement time corresponds to the set video time. This test gives you an impression of the motion sequences of the finished (rendered) time-lapse video.
If the set video time is too short to perform the movement, you will be notified.
In this test, the motors are first moved to the start position. When all motors have arrived there, you will get another message to start the actual movement test.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 44 of 114
Black Forest Motion PINE Controller User Manual
8.9.2.9. Start and Stop the Recording
As soon as all keyframes are set, all settings have been made and the test modes have been checked, the time-lapse recording can be started. This can be done by clicking on the green symbol. The motors are then moved to the start position.
Within the iOS App you can also determine after tapping on the PLAY button whether the recording is started automatically as soon as all motors have arrived at the start position, or whether you want to start the recording manually. Manual start is helpful e.g. for stop motion recordings.
With the Android App the recording starts automatically as soon as all motors are at the start position.
During the recording, you can see the current progress on the screen. Among other things, the remaining recording time and number of pictures as well as a progress loading circle are displayed there. With Android, the motion graph is also visualized with a current position marker.
Android iOS
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 45 of 114
Black Forest Motion PINE Controller User Manual
The recording can be paused at any time using the icon. In the paused state, you can use the and icon to manually control the interval sequence. This is useful for stop motion recordings.
The icon can also be used to stop the entire recording at any time.
With the symbol you can set whether you want to hear a signal tone on your mobile phone after completion of all images.
The "Keep Active" function can be activated and deactivated via the icon. If this function is activated, the camera will continue to fire when all the set images have been taken (the motors will then be at a standstill at the last keyframe position). Use this to extend your time-lapse recording, if unexpected events occur, which you want to have in your time-lapse recording.
We recommend using motor ramps (Ease Out) if you plan to use the "Keep active" function. This will slow down the motor movement towards the end and will give you a nice smooth transition.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 46 of 114
Black Forest Motion PINE Controller User Manual
8.9.3. Video
The video mode is used to create programmed real-time video movements. This mode can be used in video production to realize repeatable and smooth camera movements. Due to the exact repeatability of the movements, this mode is also ideal for special effects video production.
8.9.3.1. General Operating Method
The PINE controller moves the connected motors (or sliders, pan & tilt, or similar) along a distance programmed by the user. The user enters the time required for the movement in seconds. The camera is in video recording mode. The camera video recording must be started manually by the user before the motor movement is started via the PINE Motion App.
8.9.3.2. Recommended Workflow
Set keyframes
Determine recording time
Start recording
8.9.3.3. Setting Keyframes
Use the slide bars to move the motors (or sliders or Pan & Tilt etc.). Think about a motion path or sequence and define keyframe positions. A keyframe is a specific motor position such as the start or end point of a movement.
If all motors are e.g. at the desired start position, you set the first Keyframe over the first (left) Symbol. Keyframes are set for all connected motors at the current positions. As soon as a keyframe has been set successfully, a green checkmark appears next to the keyframe symbol. Set further keyframes in the same way. In most cases, 2 keyframes are sufficient.
However, further keyframes can be set via the symbol to realize more complex movements.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 47 of 114
Black Forest Motion PINE Controller User Manual
From the second keyframe on, another dialog window appears when setting a keyframe. Here you enter the desired time (in seconds) at which the motors should be at the current position/keyframe.
Already set keyframes can be overwritten at any time by pressing the keyframe symbol again (short tap).
8.9.3.4. Editing and deleting Keyframes
If at least one keyframe has been set, you can use the icon to display an extended view of the keyframes. The corresponding motor positions are now displayed under each keyframe symbol. The position values are assigned to the motors in color (same colors corresponding to the motor names next to the slide bars). The time values assigned to the keyframes are in yellow.
All position values and times can now be changed manually by tapping on the values. A dialog box will appear where you can adjust values. You can also move individual motors to the selected keyframe
positions.
Hold down the keyframe symbol of a set keyframe (with green checkmark) to let all motors move to the corresponding keyframe.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 48 of 114
Black Forest Motion PINE Controller User Manual
Delete keyframes by tapping on the icons while in the extended keyframe view.
When you are finished editing the keyframes, tap the icon again.
8.9.3.5. Motor Ramps
Motor ramps can be set for each motor by tapping on the colored motor names to the left of the slide bars. A dialog box will appear where you can find more slide bars for Ease-In and Ease-Out. A high Ease value will cause the motors to start and stop slowly and gently. Both ramp (Ease) values are limited to 100% in total.
8.9.3.6. Start and Stop the Recording
As soon as all keyframes are set, the video recording can be started. You can do this by clicking on the green symbol. The motors are then moved to the start position.
As soon as all motors have arrived at the start position (first keyframe), you can start the video recording on your camera. Then start the motor movements by pressing the symbol again.
During the recording, you can see the current progress on the screen. Among other things, a progress loading circle is displayed there. With Android, the motion graph is also visualized with a current position marker.
The symbol can also be used to end the entire recording at any time.
Make sure that the correct motor profiles are set or that the gear ratio values under the motor settings are correct. Only then will meaningful position values be displayed here.
The PINE Controller will not automatically start the video recording on your camera. You will have to start the recording manually over your camera bevor starting the motor movement from the app.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 49 of 114
Black Forest Motion PINE Controller User Manual
8.9.3.7. Loop Mode
Use the symbol to activate loop mode when the recording has been started. With this function, all motors change direction when they reach the last keyframe. This means they oscillate permanently between the first and last keyframe until the recording is finished manually by the user. Alternatively, you can deactivate the loop mode at any time by pressing the symbol again. In this case the controller finishes the current move and stops as soon as the motors have reached the first or last keyframe.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 50 of 114
Black Forest Motion PINE Controller User Manual
8.9.4. Giga-Pixel
With the Giga-Pixel mode you can create high-resolution Giga-Pixel panoramas in combination with a Pan & Tilt head.
For this mode we recommend our NT Head (also known as Nic-O-Tilt) together with the Nodal point adapter rails. It is also recommended (in some cases even absolutely necessary) to align the camera to its nodal point.
8.9.4.1. General Operating Method
The PINE Controller lets your camera take single images in the form of rows and columns (2-dimensional matrix). The Pan & Tilt head always moves from top left to bottom right. All single images can then be stitched together to a large, high-resolution panorama in post­production using a stitching software (e.g. PTGui or Windows ICE).
8.9.4.2. Determine the Motor Functions
For this mode, the PINE controller needs to know which motor port is used for the Pan (horizontal) axis and which for the Tilt (vertical) axis. When you select the Giga-Pixel mode from the Homescreen, a dialog box appears where you can make this selection.
Android iOS
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 51 of 114
Black Forest Motion PINE Controller User Manual
If desired, the Giga-Pixel mode can also be used with only one axis (e.g. Pan). In this case select the entry with "---" for the unused motor.
Optionally, you have the possibility to set an option so that the motor selection does not appear again the next time. The app remembers your current selection and sets the motors automatically in the future. You can do this if you always use the same motor ports for Pan and Tilt.
The dialog window for the motor selection can also be viewed at any time within the Giga-Pixel mode via the icon in the status bar.
Confirm the motor selection with Continue.
8.9.4.3. Recommended Workflow
Set panorama view-port (keyframes for top left and bottom
right)
Adjust Interval and Camera Settings
Define camera setup (focal length, sensor size, etc.)
Determine Matrix Traversal
Create XML file (optional)
Start recording
8.9.4.4. Setting the Panorama-View
In this step you determine the horizontal and vertical view of your desired panorama.
Use the slide bars to move the two motors. Start moving the camera to the desired upper left corner of the panorama. Then place the keyframe with the icon. Do the same for the lower right corner of the panorama and place the keyframe with the icon. Both keyframes (top left and bottom right) can be set in any order.
Make sure that you have selected the correct profiles for the motors. If the profiles are unsuitable, the matrix size (number of rows and columns) will be calculated incorrectly.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 52 of 114
Black Forest Motion PINE Controller User Manual
Successfully set keyframes are indicated by a green checkmark next to the keyframe symbol.
Set keyframes can be overwritten at any time by pressing the keyframe symbol again.
If you hold down the field of a set keyframe, a dialog box opens where you can also define keyframe positions manually. You also have the possibility to move motors to the respective keyframe.
Android iOS
8.9.4.5. Interval and Camera Settings
Open the Interval settings via the icon. Here you can adjust time values within a single interval (consisting of camera trigger, pause times and motor movement). All time values are processed by the controller in the sequence as listed (from top to bottom).
Change the times using the and symbols. A short tap on the symbols increases or decreases the value by 0.1 seconds. If you hold
down the symbols, the values change faster.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 53 of 114
Black Forest Motion PINE Controller User Manual
Android iOS
Focus
Determines how long the focus signal of the camera is activated. Use this time when operating your camera with automatic focus.
However, we recommend using the camera in manual focusing mode for the Giga-Pixel mode. In this case, set this value to 0.0 seconds.
Trigger/ Exposure
Determines how long the trigger signal of the camera is released.
If you define the exposure time via your camera, this time serves as a pure trigger impulse and a time of 0.1 to 0.3 seconds is sufficient.
However, if you operate your camera in bulb mode, you can set a longer time here. In this case, the exposure time is defined by this time setting. This allows you to set the shutter release time for night shots to more than 30 seconds (the maximum exposure time for most cameras).
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 54 of 114
Black Forest Motion PINE Controller User Manual
Alternatively, you can also take HRD pictures with a longer release time. Set your camera to bracketing mode. Then set the trigger time in the app long enough for your camera to finish taking all bracketing shots.
Delay
This is a waiting time which begins after the trigger time has elapsed. After the waiting time has elapsed, the motor movement begins. Set this time so that your camera can complete the current shot before the motors start rotating.
If you define the exposure time via your camera, this value must be adjusted to the actual exposure time. For example, if you have set an exposure time of 5 seconds using your camera, set the camera time to 0.1 seconds and the delay time to at least 5.0 seconds.
However, if you operate your camera in Bulb mode, you can set the delay time to a short value such as 0.5 seconds.
Movement
This time signals how long the motors move within an interval. This time cannot be changed directly. It depends on the programmed movement distance (keyframes), number of rows and columns, and motor speed.
Excess
Based on the previously listed times, there is a minimum interval time. The excess time is an automatically calculated time and signals the difference between the set interval time and the minimum interval time. With an excess time of 0.0 seconds, you
have reached the minimum interval time.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 55 of 114
Black Forest Motion PINE Controller User Manual
Interval
This is the total interval time. It determines how long a single interval lasts and thus determines the time difference between the recorded images.
As explained under Excess, all set times result in a minimum interval time which cannot be undercut.
8.9.4.6. Camera Setup / Matrix Size
Once both keyframes have been set for top left and bottom right, the PINE Motion App can determine how many rows and columns are required for the desired panorama entirely from your camera equipment.
Alternatively, you can set the number of rows and columns using the Set Manually option. The corresponding selection fields will then appear as soon as you activate the option.
Use the icon to specify the information about your camera equipment for the matrix size.
Android iOS
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 56 of 114
Black Forest Motion PINE Controller User Manual
Focal Length
Enter the actual focal length of your lens here. There is no need to do any conversions (e.g. the focal length related to 35mm). The Crop factor of the camera sensor does not have to be considered here for the focal length setting.
For very high-resolution panoramas, we recommend using telephoto lenses in the range of 100mm to 400mm in Giga-Pixel mode.
Sensor Size
Tap on the symbol to go through a selection of pre-defined sensor sizes. The most frequently used sensor sizes are stored here. If you are not sure which sensor size to use, consult your camera's manual to find out.
If you have a camera whose sensor size cannot be found in the predefined list, you can define your own sensor sizes using the icon. Enter the dimensions of the sensor in mm for width and height and give the sensor a name of your choice. The saved sensor can then also be found in the sensor list. Sensors you have created can be edited and deleted at any time using the corresponding buttons (the currently selected sensor is changed or deleted).
Overlap
Enter the percentage by which the captured images should overlap (vertically and horizontally). The more overlap you specify, the more images will be captured. A larger overlap simplifies the stitching process. We recommend overlaps of at least 20-30%.
Camera Orientation
Determines whether you have mounted your camera in the landscape or portrait orientation. We recommend a portrait orientation.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 57 of 114
Black Forest Motion PINE Controller User Manual
8.9.4.7. Set Matrix Size manually
You can also manually determine the size of the matrix by specifying the number of rows and columns. Activate the "Set manually " option under the "Matrix Size" settings. The corresponding fields for entering rows and columns will then be displayed. The matrix calculation via the camera equipment like focal length and sensor size (see chapter
7.9.4.6) is deactivated.
8.9.4.8. Matrix Traversal
The PINE Motion App gives you 3 different options for traversing the matrix. Each option has its advantages and disadvantages.
Android iOS
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 58 of 114
Black Forest Motion PINE Controller User Manual
R-L-R (Right – Left – Right)
Single images are captured row by row. The camera is at a standstill during image capture.
Positive:
+ Makes it relatively easy to exclude entire rows from
the stitching Process
+ Suitable for all exposure times
Negative:
- Possibly not well suited for scenarios with many moving objects (e.g. clouds)
Diagonal
Single images are captured in a diagonal style starting from top left to bottom right. The camera is at a standstill during image capture.
Positive:
+ Well suited for scenarios with moving objects
(e.g. clouds)
+ Suitable for all exposure times
Negative:
- Difficult to exclude individual rows from stitching
Continuous
Single frames are taken row by row. The camera is in a continuous horizontal movement during image capture.
Positive:
+ The recording time can be reduced enormously.
Negative:
- Only suitable for short exposure times of 1/1000s or shorter.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 59 of 114
Black Forest Motion PINE Controller User Manual
8.9.4.9. Move to specific Matrix Index
When all keyframes are set and the matrix size is defined, you can move to any matrix position via the button. Use the slide bars to select a specific row and column and move the camera to the desired position by pressing the Play button. This function is useful to check your programmed positions.
Look at the current image view of your camera at the approached matrix positions and consider whether the stitching software might have problems merging the images.
8.9.4.10. XML Files
XML files contain special information about the entire panorama image, which is helpful for the stitching process of the individual images via a stitching software.
The following information is stored in the files:
- Positions (horizontal & vertical angle) for each image
- Focal length, sensor size, camera orientation
- image overlap
- Location Information
As soon as all keyframes have been set via the PINE app and the matrix size has been determined, an XML file for the current settings
can be created. You can do this via the icon.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 60 of 114
Black Forest Motion PINE Controller User Manual
Android iOS
When creating the XML files, specify a file name and the number of bracketing images (if HDR was captured).
After successful creation of the XML file, you can save or share it on your smartphone (Email, Dropbox, etc.). Import this file together with
the captured images into your stitching software (e.g. PTGui).
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 61 of 114
Black Forest Motion PINE Controller User Manual
8.9.4.11. Start the Recording
Start the recording with the green icon. You will now be asked if you want to create an XML file for the current recording. If you have not yet created an XML file, do so now (for more information on XML files, see the previous section 7.9.4.10). Then the motors will be moved to the upper left corner of the image section and the recording will start automatically.
On the screen you will now see a progress bar and an animated graph of a virtual matrix. Matrix fields are colored green according to the progress.
If desired, the recording can be paused at any time via the symbol. In the paused state, you can use the and symbol to control the flow of the individual images manually. Continue the process at any time using the icon.
The icon can also be used to stop the entire recording at any time.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 62 of 114
Black Forest Motion PINE Controller User Manual
8.9.5. 3D-Scan
The 3D scan mode enables the automated acquisition of single images of an object from several viewing angles. With the help of these single images, a virtual 3D model of the scanned object can be created with a photogrammetry software (e.g. Agisoft Photoscan or RealityCapture).
8.9.5.1. General Operating Method
The 3D scan mode can be operated with several motors, depending on requirements and application. In all cases, however, you will need a motorized turntable. We also recommend a vertically aligned slider, a tilt axis (e.g. NT Head unit), and an optional lens motor unit (or macro slide) for optimal results.
The camera must be attached to the slider together with the tilt axis. The camera can so be moved vertically and also tilted up and down with the tilt axis. The object to be scanned is located on the turntable. In addition, focus stacking can be achieved with the connected lens motor unit.
Additional information about the hardware setup can be found in our separate manual about the 3D scan mode.
During each scan process, the turntable will move in steps and the camera will be triggered at each step. With focus stacking, several images with different focus areas are taken per turntable position. After each complete turntable rotation, the remaining motors (slider and tilt) are moved before a new turntable rotation is started. Thus, single pictures of the object (on the turntable) are taken from several
horizontal and also vertical angles.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 63 of 114
Black Forest Motion PINE Controller User Manual
8.9.5.2. Determine the Motor Functions
For this mode, the PINE controller needs to know which motor port is used for the turntable and which for the optional focus. If you select the 3D scan mode from the Homescreen, a dialog box appears where you can make this selection.
Android iOS
If you do not use a focus motor, select the entry with "---".
Optionally you have the possibility to set an option here so that the motor selection does not appear again the next time. The app remembers your current selection and sets the motors automatically in the future. You can do this if you always operate your motors for Pan and Tilt at the same motor ports.
The dialog window for the motor selection can also be viewed at any time within the 3D-Scan mode via the icon in the status bar.
Confirm the motor selection with Continue.
Make sure that you have selected the correct profiles for the motors.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 64 of 114
Black Forest Motion PINE Controller User Manual
8.9.5.3. Recommended Workflow
Determination of the number of images per turntable revolution
Determination of the number of rows and keyframes
(only with slider and tilt)
Definition of focus stacking images and focus range
Adjusting Camera Settings
Start recording
3D Model Creation with Photogrammetry Software
8.9.5.4. Pictures per Turntable Revolution
You can specify how many individual images should be taken for a complete 360-degree rotation of the turntable. Tap the icon to do this.
Android iOS
Set the number of turntable-steps over the number fields. For example, if you select 10 turntable steps, the turntable will rotate 36 degrees after each captured image.
Optionally, you can determine whether the turntable should be moved back to its starting position at the end of a complete revolution. Use this option if the turntable cannot rotate several times
due to connected cables.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 65 of 114
Black Forest Motion PINE Controller User Manual
If the "Return to Start" option is deactivated, the turntable continues its movement after one full revolution (provided the number of vertical rows is greater than 1).
8.9.5.5. Number of Vertical Rows
The number of rows determines how many vertical steps a connected slider (and tilt axis) completes during the scanning process. This setting also defines the number of complete turntable revolutions. To adjust the number of rows, tap on the Symbol.
Android iOS
There are 2 ways to define the vertical rows:
Simple Row Setup
For this option you define the number of rows in the upper dialog window. You also set two keyframes for the "View Below" and "View Above". Move the motors for Slider and Tilt to the desired positions and tap the corresponding or icon on the main 3D-mode screen. The intermediate positions for the slider and the tilt axis are linearly interpolated based on the keyframes and number of rows.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 66 of 114
Black Forest Motion PINE Controller User Manual
Custom Row Setup
With the custom row setup, you can manually set the slider and tilt positions for each row (up to a maximum of 10 rows). The main view of the 3D scan mode will change as shown below.
Android iOS
Move the motors for Slider and Tilt to the desired positions and set keyframes for each row by tapping on the and symbols.
Successfully placed keyframes will be marked with a green checkmark next to the keyframe symbol.
Set keyframes can be overwritten at any time by pressing the keyframe symbol again (short tap).
Hold down the keyframe symbol of a set keyframe (with green checkmark) to let all motors move to the corresponding keyframe.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 67 of 114
Black Forest Motion PINE Controller User Manual
If at least one keyframe has been set, you can use the icon to display an extended view of the keyframes. The corresponding motor positions are now displayed under each keyframe symbol. The position values are assigned to the motors in color (same colors corresponding to the motor names next to the slide bar).
All position values can now be changed manually by tapping on the values. A dialog box will appear in which you can adjust values. You can also move individual motors to the selected keyframe positions.
Delete keyframes by tapping on the icons while in the extended keyframe view.
When you are finished editing the keyframes, tap the icon again.
Make sure that the correct motor profiles are set or that the gear ratio values under the motor settings are correct. Only then will meaningful position values be displayed here.
If the 3D scan mode is only used with a turntable (without slider and tilt), no keyframes have to be set.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 68 of 114
Black Forest Motion PINE Controller User Manual
8.9.5.6. Focus Stacking
If you have a focus motor connected and defined in the motor selection, you have the possibility to capture focus stacking images per turntable step. Tap on the symbol. If no focus motor has been defined, access to this function is blocked or not visible.
Android iOS
Here you can define how many focus stacking images should be taken per turntable position.
In addition, you define the entire focus range by setting keyframes for the two focus end ranges. Use the slide bar to move the focus motor. Then use the symbols to set the keyframes for Start and End.
Successfully set keyframes are indicated by a green checkmark next to the keyframe symbol. In addition, a symbol appears on the main screen as soon as both focus keyframes have been set.
Set keyframes can be overwritten at any time by pressing the keyframe symbol again.
The intermediate focus positions are linearly interpolated based on the keyframes and the number of images.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 69 of 114
Black Forest Motion PINE Controller User Manual
8.9.5.7. Camera Settings
Open the Camera Settings by clicking the icon. Here you can adjust time values for camera release, pause times and motor movement. All time values are processed by the controller in the sequence as listed (from top to bottom).
Change the times using the and symbols. A short tap on the symbols increases or decreases the value by 0.1 seconds. If you hold down the symbols, the values change faster.
Android iOS
Focus
Determines how long the focus signal of the camera is activated. Use this time when operating your camera with automatic focus.
However, we recommend using the camera in manual focus for 3D scan mode. This is also absolutely necessary if you use focus stacking with a focus motor. In this case, set this time value to 0.0
seconds.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 70 of 114
Black Forest Motion PINE Controller User Manual
Trigger / Exposure
Determines how long the trigger signal of the camera is released.
If you define the exposure time via your camera, this time serves as a pure trigger impulse and a time of 0.1 to 0.3 seconds is sufficient.
However, if you operate your camera in bulb mode, you can set a longer time here. In this case, the exposure time is defined by this time setting.
Alternatively, you can take HRD pictures with a longer shutter release time. To do this, set your camera to bracketing mode. Then set the trigger time in the app long enough for your camera to capture all bracketing shots.
Delay
This is a waiting time which begins after the trigger time has elapsed. After the waiting time, the motor movement begins. Set this time so that your camera can complete the current shot before the motors start rotating.
If you define the exposure time via your camera, this value must be adjusted to the actual exposure time. For example, if you have set an exposure time of 5 seconds using your camera, set the camera time to 0.1 seconds and the delay time to at least 5.0 seconds.
However, if you operate your camera in Bulb mode, you can set the delay time to a short value such as 0.5 seconds.
Standstill
Defines how long the motors should remain at a standstill after the movement has been completed before another image is taken (start of focus time). Use this time to eliminate possible vibrations of the camera caused by the motor movement before a new
image is taken.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 71 of 114
Black Forest Motion PINE Controller User Manual
8.9.5.8. Slave Mode
The slave mode allows you to operate the PINE Controller via an external interval generator. To do this, connect the external Interval device to the AUX input of the PINE Controller and activate the Slave mode under Camera Settings.
In slave mode, the PINE Controller waits to move the motors until it detects an external signal from the interval device. In the Camera Settings, all times except the Delay / Pause time are hidden. With the Delay time you can set how long the PINE controller should wait after receiving the external signal via the AUX input before moving the motors.
For more important information about the AUX input, refer to chapter
5.4 of this manual.
8.9.5.9. Start the Recording
Start the recording with the green symbol as soon as all settings have been made and keyframes have been set. Then the motors are moved to the start position (first keyframe or "below view") and the recording process is started. If the 3D mode is used without slider and tilt, the turntable starts its current rotation immediately after all data has been transferred to the controller.
On the screen you will see a progress circle and information about the remaining recording time.
If desired, the recording can be paused at any time using the icon. In the paused state, you can use the and symbol to control the flow of the individual images manually. Continue the process at any time using the icon.
The icon can also be used to stop the entire recording at any time.
You can use the icon to set whether a signal tone should sound on your mobile phone after all images have been completed. After capturing all pictures, you will also receive a message informing you about the completion. Additionally, you have the possibility to start another scan process. The motors then move in the inverted direction of the previous scan.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 72 of 114
Black Forest Motion PINE Controller User Manual
8.9.5.10. Photogrammetry 3D-Model Creation
All single images taken via PINE can be used to create virtual 3D models with the help of a photogrammetry software from third party manufacturers. Suitable applications are e.g. Agisoft Photoscan or RealityCapture.
Black Forest Motion does not offer its own software solution or support for 3D model creation. The end user is therefore dependent on the software applications of third-party manufacturers. However, you are welcome to contact us for advice.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 73 of 114
Black Forest Motion PINE Controller User Manual
8.9.6. 360-Degree
With the 360-degree mode you can create professional and high­resolution 360-degree images with your DSLR or mirrorless camera in combination with a Pan & Tilt head.
For this mode, we recommend our NT Head (also known as Nic-O-Tilt) together with the Nodal Point Adapter rails. It is recommended to align the camera to its nodal point so that the images can be easily merged at the end.
8.9.6.1. General Operating Method
The PINE Controller automatically aligns your camera (which is mounted on the pan head) in all directions and creates single images at different positions. The sequence starts with an image vertically upwards (towards the sky) and ends with one or more images vertically downwards (towards the ground). In between, several horizontally aligned images are created in order to obtain the complete 360-degree view of the surrounding. All individual images can then be imported into an appropriate image processing software (stitching software) such as PTGui to combine the images into a 360­degree photo.
The 360-degree mode can also be used to create time-lapse sequences. The process for creating a single 360-degree image is then repeated several times (optionally also with additional slider movement between the individual 360-degree images).
8.9.6.2. Determine the Motor Functions
For this mode, the PINE controller needs to know which motor port is used for the Pan (horizontal) axis and which for the Tilt (vertical) axis. When you select the 360-degree mode from the Homescreen, a dialog box appears where you can make this selection.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 74 of 114
Black Forest Motion PINE Controller User Manual
Android iOS
Optionally you have the possibility to set an option here so that the motor selection does not appear again the next time. The app remembers your current selection and sets the motors automatically in the future. You can do this if you always operate your motors for Pan and Tilt at the same motor connections.
The dialog window for the motor selection can also be accessed at any time within the 360-degree mode via the icon in the status bar.
Confirm the motor selection with Continue.
Make sure that you have selected the correct profiles for the motors. If the profiles are unsuitable, the Pan and Tilt axis will move incorrectly.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 75 of 114
Black Forest Motion PINE Controller User Manual
8.9.6.3. Recommended Workflow
Use the Sphere Calculator to determine the number of vertical
rows and horizontal columns.
Adjust Camera Settings
(Set optional keyframes for time lapse and make further time-
lapse based settings)
Align camera manually (move to start position)
Create XML file (optional)
Start recording
8.9.6.4. Screen Layout
In 360-degree mode, the upper part of the user interface is divided into several views. Under Android, you can select the views by swiping to the right or left. In iOS there are corresponding selection fields (Sphere - Time-Lapse - Controls - Graph).
In the first view on the far left, settings are made which influence a single 360-degree photo. Here you can set for example how many rows and columns should be taken per 360-degree photo. You can also make camera settings and create XML files here.
Android iOS
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 76 of 114
Black Forest Motion PINE Controller User Manual
In the second view from the left, all Time-Lapse relevant settings are made. If you only want to create a single 360-degree photo, set the number of intervals to 1. The remaining settings then do not have to be considered. However, if you want to create several 360-degree photos in sequence, which you finally want to merge into a time­lapse, you can enter the number of total intervals here and also set optional keyframes for a connected slider.
Android iOS
In the third view you have as usual the control elements to start and stop recordings.
In the fourth view on the right you can see a motion graph if you have set keyframes and you are creating several 360-degree photos in a row (time-lapse).
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 77 of 114
Black Forest Motion PINE Controller User Manual
8.9.6.5. Sphere-Calculator
The Sphere Calculator allows you to automatically calculate and set the number of rows and columns required based on your camera equipment (focal length, sensor size, image overlap, etc.).
If you are in the left view at the top of the screen (or within the Sphere settings in iOS), tap the icon to start the Sphere Calculator.
Android iOS
Within the sphere calculator, you can make various settings regarding your camera equipment. In the lower part of the dialog you will be given recommendations about the number of vertical rows and horizontal columns. The recommendations can be accepted directly via the "Apply" field and you do not have to make any further settings for the rows and columns.
The possible settings in the Sphere-Calculator are listed and explained below:
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 78 of 114
Black Forest Motion PINE Controller User Manual
Focal Length
Enter the actual focal length of your lens here. There is no need to do any conversions (e.g. the focal length related to 35mm). The Crop factor of the camera sensor does not have to be considered here with the focal length setting.
The 360-degree mode is mainly optimized for use with wide-angle and fisheye lenses in the focal length range between 8mm and 30mm because the number of vertical rows is limited to 5 and the number of horizontal columns to 9. Therefore, it may happen that a setting cannot be applied using the sphere calculator.
Overlap
Specify the percentage by which the captured images should overlap (vertically and horizontally). The more overlap you specify, the more images will be captured. A larger overlap simplifies the stitching process. We recommend overlaps of at least 20-30%.
Sensor Size
Tap on the symbol to go through a selection of pre-defined sensor sizes. The most frequently used sensor sizes are stored here. If you are not sure which sensor size to use, consult your camera's manual to find out.
If you want to create a very high-resolution 360­degree photo using a lens with a large focal length, you can also use the Giga Pixel mode. Set the keyframe for "top left" when the camera is facing up towards the sky. Then move the camera 360 degrees horizontally (Pan) and 180 degrees vertically (Tilt) so that the camera is aligned to the ground. Then set the “bottom right” keyframe.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 79 of 114
Black Forest Motion PINE Controller User Manual
If you have a camera whose sensor size cannot be found in the predefined list, you can add your own sensor sizes using the icon. Enter the dimensions of the sensor in mm for width and height and give the sensor a name of your choice. The saved sensor can then also be found in the sensor list. Sensors you have created can be edited and deleted at any time using the corresponding buttons (the currently selected sensor is changed or deleted).
Lens Type
Determine whether you are using a fisheye or a regular (rectilinear) lens. Tap on the icon to change settings.
Camera Orientation
Determines whether you have mounted your camera in the landscape or portrait orientation. We recommend a portrait orientation. Tap on the icon to change the settings.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 80 of 114
Black Forest Motion PINE Controller User Manual
8.9.6.6. Set Number of Vertical Rows manually
As an alternative to the Sphere calculator, you can also specify the number of vertical rows manually. To do this, tap the symbol in the Sphere settings (top left view).
Android iOS
Set the number of vertical rows using the number field and confirm the selection with "Set ". Currently, between 3 and 5 rows are possible.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 81 of 114
Black Forest Motion PINE Controller User Manual
8.9.6.7. Set Number of Horizontal Columns manually
As an alternative to the Sphere calculator, you can also specify the number of horizontal columns manually. To do this, tap the icon in the Sphere settings (top left view).
Android iOS
Depending on how many vertical rows are set, you will see the number of horizontal images (columns) for each vertical row. We call this view a Column Pattern.
In the example views above, 4 vertical rows have been set. You can see this from the 4 entries from left to right.
The first row contains the Zenith image. This is the image when the camera is pointing upwards towards the sky. The number of images or columns here is always "1".
The last row contains the Nadir image. This is the image when the camera is pointing down to the ground. You have the option to create one, two, or no nadir image at all. If two nadir images are created, they will be created offset by 45 degrees (rotated around the pan axis).
In the intermediate rows (between Zenith and Nadir) between 1 and 9 horizontal images can be defined.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 82 of 114
Black Forest Motion PINE Controller User Manual
8.9.6.8. Camera Settings
Open the Camera Settings by clicking the icon. Here you can set time values for focus time, shutter release time and pause time. All time values are processed by the controller in the sequence as listed (from top to bottom).
Change the times using the and symbols. A short tap on the symbols increases or decreases the value by 0.1 seconds. If you hold down the symbols, the values change faster.
Android iOS
Focus
Determines how long the focus signal of the camera is activated. Use this time when operating your camera with automatic focus.
However, we recommend that you operate the camera in manual focus for 360-degree mode. In this case, set this time to
0.0 seconds.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 83 of 114
Black Forest Motion PINE Controller User Manual
Trigger / Exposure
Determines how long the trigger signal of the camera is released.
If you define the exposure time via your camera, this time serves as a pure trigger impulse and a time of 0.1 to 0.3 seconds is sufficient.
However, if you operate your camera in bulb mode, you can set a longer time here. In this case, the exposure time is defined by this time setting. This allows you to set the shutter release time for night shots to more than 30 seconds (the maximum exposure time for most cameras).
Alternatively, you can also take HRD pictures with a longer trigger time. Set your camera to bracketing mode. Then set the trigger time in the app long enough for your camera to capture all bracketing shots.
Delay
This is a waiting time which begins after the trigger time has elapsed. After the waiting time, the motor movement begins. Set this time so that your camera can complete the current shot before the motors start rotating.
If you define the exposure time via your camera, this value must be adjusted to the actual exposure time. For example, if you have set an exposure time of 5 seconds using your camera, set the camera time to 0.1 seconds and the delay time to at least 5.0 seconds.
However, if you operate your camera in Bulb mode, you can set the delay time to a short value such as 0.5 seconds.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 84 of 114
Black Forest Motion PINE Controller User Manual
8.9.6.9. Time-Lapse Settings (optional)
The 360-degree mode allows you to repeat the sequence for capturing a 360-degree photo several times. You create single photos, which you first have to combine to 360-degree photos. Afterwards all 360-degree photos can be combined to a time-lapse.
In the second view at the top of the screen (or under the Time Lapse settings) you will find settings similar to those found in the regular Time­Lapse mode.
We recommend that you start by creating regular time-laps sequences. Please read chapter 7.9.2 of this manual. This should enable you to apply what you have learned in 360-degree mode.
The "Intervals" setting defines the number of 360-degree photos that will be created in sequence. The "Main-Interval" time determines the duration for the creation of a single 360-degree photo. Based on the number of vertical rows and horizontal columns of a 360-degree photo, a minimum main interval time results.
Alternatively, you can use other motor axes such as a slider for 360­degree time-lapse to integrate another movement. Set keyframes (maximum 2) for start and end of additional motors. The slider will then move one step after creating all single frames for a 360-degree photo before starting a new cycle for a 360-degree photo.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 85 of 114
Black Forest Motion PINE Controller User Manual
8.9.6.10. XML Files
XML files contain special information about the entire 360-degree recording, which is helpful for the stitching process of the individual images via a stitching software.
The following information is stored in the files:
- Positions (horizontal & vertical angle) for each image
- Focal length, sensor size, camera orientation
- image overlap
- Location Information
As soon as all settings of the vertical rows and horizontal columns have been made via the PINE app, an XML file for the current settings can be created. You can do this using the symbol.
Android iOS
When creating the XML files, specify a file name and the number of bracketing images (if HDR was captured).
After successfully creating the XML file, you can save or share it on your smartphone (Email, Dropbox, etc.). Import this file together with
the captured images into your stitching software (e.g. PTGui).
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 86 of 114
Black Forest Motion PINE Controller User Manual
8.9.6.11. Start the Recording
Before starting each shot, always move your Pan & Tilt head so that the camera is pointing vertically upwards towards the sky. Also remember that the horizontal pan axis starts its 360-degree movement in the positive direction (same direction if you move the slide bars to the right). Therefore, make sure that the connected motor cables have enough clearance to allow a complete 360-degree rotation.
Start the recording with the green symbol. You will now be asked if you want to create an XML file for the current recording. If you have not yet created an XML file, do so now (for more information on XML files, please refer to the previous section 7.9.6.10). The data will then be transferred from your mobile phone to the controller. In Android the recording starts by pressing the Play button again and in iOS the recording starts automatically.
On the screen you will see a progress indicator for the creation of the single images of the 360-degree sequence and the entire time-lapse intervals. Android iOS
The icon can also be used to stop the entire recording at any time.
Use the symbol to set whether you want to hear a sound on your
mobile phone after all images have been captured.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 87 of 114
Black Forest Motion PINE Controller User Manual
8.9.7. Live
The Live mode is ideal for video recordings of live events such as music concerts or shows.
8.9.7.1. General Operating Method
With the PINE Motion App, you can define several positions / keyframes for all connected motors in live mode. We also call the keyframes scenes in live mode. A scene can thus be assigned to a certain view (e.g. view of an individual musician on the stage). In recording mode, you can change scenes at the touch of a button via a simple user interface. The motors then move to the programmed positions / keyframes.
8.9.7.2. Recommended Workflow
Set keyframes
Set motor speeds
Switching between programmed scenes in recording mode
8.9.7.3. Screen Layout
There are two different views in Live mode.
In the "Setup" view, motors can be moved manually and keyframes or scenes can be set. Select this view via the icon.
In the "Recording" view, the motors can then be moved automatically to the programmed scenes by pressing a key. Select this view via the icon.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 88 of 114
Black Forest Motion PINE Controller User Manual
8.9.7.4. Setting Keyframes
Within the "Setup" view, use the motor slide bars to move the motors (or sliders or pan & tilt etc.). Think about interesting views which you want to be able to approach by pressing a button. Then set the keyframes by pressing the and symbols.
As soon as a keyframe has been set successfully, a green checkmark appears next to the keyframe symbol.
Already set keyframes / scenes can be overwritten at any time by pressing the keyframe symbol again (short tap).
Android iOS
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 89 of 114
Black Forest Motion PINE Controller User Manual
8.9.7.5. Editing and deleting Keyframes
If at least one keyframe / scene has been set, you can use the icon to display an extended view of the keyframes. The corresponding motor positions are now displayed under each keyframe symbol. The position values are assigned to the motors in color (same colors according to the motor names next to the sliders). The keyframe numbers are yellow.
All position values can now be changed manually by tapping on the values. A dialog box will appear in which you can adjust values. You can also move individual motors to the selected keyframe positions.
Delete keyframes by tapping on the icons while in the extended keyframe view.
When you are finished editing the keyframes, tap the icon again.
Make sure that the correct motor profiles are set or that the gear ratio values under the motor settings are correct. Only then will meaningful position values be displayed here.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 90 of 114
Black Forest Motion PINE Controller User Manual
8.9.7.6. Recording View
As soon as all desired scenes have been programmed, you can switch to the recording view via the icon. Each scene is now assigned a square tile.
Tap on a tile to move all motors to the programmed scene. While the motors are moving, the text of the scene numbering appears in orange. As soon as all motors in the scene have come to a standstill, the number changes to green. This indicates at which scene the motors are currently located.
To stop a current movement early, tap on any tile.
Android iOS
Press and hold a tile to adjust the motor speed for each scene separately. With the Android version of the app you also have the possibility to assign names (or descriptions) for each scene. Furthermore, background images can be set for the tiles in the Android version and via the icon you can specify how many tiles are displayed horizontally.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 91 of 114
Black Forest Motion PINE Controller User Manual
8.9.8. Turntable
In turntable mode, rotary axes can be controlled with a continuous rotary motion. It is important to ensure that the motors and the corresponding mechanical attachments can move freely.
Before entering the turntable mode, the Android App displays a dialog window where you can select all the motors you want to use for the turntable mode. The app will then display the selected motors within the turntable mode. With the iOS App, no dialog window appears and all connected motors are visible within the mode.
Android iOS
Press the symbol to start the motor movement. The symbol then changes to a symbol which can be used to stop the motor again.
Within the Android App, you can make further settings by tapping on the motor names. These are: Speed (positive and negative in percent) and the values for Ease-In and Ease-Out. The latter represent the ramps for smooth starting and stopping of the motors.
Within the iOS App, only the ramps are set after tapping on the motor name. Speeds and direction of rotation can be set directly adjusted via the and symbols. iOS also has slide bars for each motor, which you can also use to move motors manually.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 92 of 114
Black Forest Motion PINE Controller User Manual
8.9.9. Astro
With the Astro mode, you can let motors move so slowly that they can compensate the movement of the earth's axis. This way, you can realize long exposure photographs of the night sky.
For astro tracking, you can use an axis of the NT Head from Black Forest Motion, for example. It is important to align the motor axis so that it corresponds to the earth axis. For the alignment you can use e.g. various astro-apps or a star finder.
Android iOS
A dialog window appears under Android when you enter the Astro mode. Select which motors you want to use for the Astro mode (only rotation units are shown here). The selected motors will then be displayed within the mode.
With the iOS App no dialog window appears and all connected motors are visible within the Astro mode.
Make sure you have the correct motor profiles selected for the motors in order for the tracking to work correctly.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 93 of 114
Black Forest Motion PINE Controller User Manual
Press the symbol to start the motor movement. The symbol then changes to a symbol which can be used to stop the motor again.
The motors move so slowly that a direct movement is hardly visible!
Change the direction of motor rotation by pressing the symbols.
The Astro mode gives you the choice of four different tracking speeds. These can be selected by pressing the corresponding icons:
Sidereal
The tracking is done at star speed. Use this option if you want all stars to be point-shaped.
½ Sidereal
Tracking takes place at half the speed of a star. Use this option if you want to achieve a foreground in a relatively good sharpness range and at the same time have point-shaped stars. The stars will however not be completely point-shaped.
Solar
Tracking is done at solar speed.
Lunar
The tracking is done at moon speed.
The efficiency of the astro tracking is strongly dependent on a proper alignment of the motor rotary axis. Use great care to make the alignment.
Probably you will need some trials and test runs to get the alignment right.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 94 of 114
Black Forest Motion PINE Controller User Manual
8.9.10. Intervalometer
The Intervalometer mode allows you to use the PINE Controller without motors. This allows you to trigger cameras that are connected to the PINE Controller in a fixed time interval to create static time-lapse.
At the time of writing of this manual, the Intervalometer mode is only available within the Android App. For iOS, this will be available at a later time.
Android
8.9.10.1. Set Parameters
The following parameters can be set for each camera port (the operating sequence is from top to bottom as the parameters are listed). Tap on the blue numerical values to change the values.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 95 of 114
Black Forest Motion PINE Controller User Manual
Delay
This is a simple pause time that you can use to delay camera triggers. For example, you can operate 2 cameras simultaneously with the same interval time but let one camera trigger before the other. To do this, set the delay time to 0.0s for one camera and to a desired delay value for the other.
Focus
Determines how long the focus signal of the camera is activated. Use this time when operating your camera with automatic focus.
Trigger / Exposure
Determines how long the trigger signal of the camera is released.
If you define the exposure time via your camera, this time serves as a pure trigger impulse and a time of 0.1 to 0.3 seconds is sufficient.
However, if you operate your camera in bulb mode, you can set a longer time here. In this case, the exposure time is defined by this time setting. This allows you to set the shutter release time for night shots to more than 30 seconds (the maximum exposure time for most cameras).
Alternatively, you can also take HRD pictures with a longer trigger time. Set your camera to bracketing mode. Then set the trigger time in the app long enough for your camera to connect all bracketing shots.
Interval
This is the total interval time. It determines how long a single interval lasts and thus determines the time difference between the captured images.
Pictures
Here you can define how many images should be created. You can also select the option "Infinite" to trigger the camera for an indefinite time.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 96 of 114
Black Forest Motion PINE Controller User Manual
Counter
This value counts the captured images. Tap this value to reset the counter.
Ramping
Reserved for later development.
8.9.10.2. Start the Recording
Each camera can be started via a separate icon. These are the icons at the bottom of the screen.
The icon then changes to an icon that can be used to stop recordings at any time.
Alternatively, several cameras can be started and stopped at the same time. To do this, set the checkboxes that are placed above the name of each camera. Then tap on the or symbols in the upper part of the screen with the text addition "Start Selection" and "Stop Selection".
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 97 of 114
Black Forest Motion PINE Controller User Manual
8.10. Multitasking
The PINE Controller is able to operate certain application modes simultaneously. This applies to the Turntable or Astro mode in combination with e.g. the Time-Lapse or Video mode.
To operate for example a motor axis in astro mode and at the same time use the time-lapse mode with other motors, proceed as follows:
I. First start the Astro mode and activate a desired motor axis there.
II. Exit the Astro mode and start the Time-Lapse mode.
On the Homescreen, you will now see icons for currently active modes.
Within the Time-Lapse mode, the motor active in Astro mode will not be visible. Set keyframes as usual and start the recording.
III. The access to the Astro mode is now blocked until the time-lapse
recording has finished.
IV. As soon as the time-lapse recording is finished, you can enter the Astro
mode again and the still active motor can be stopped.
In the same way, the turntable or video mode can also be used for multitasking.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 98 of 114
Black Forest Motion PINE Controller User Manual
9. Firmware Updates
This chapter explains how you can update the firmware of the PINE Motion Controller.
As the software of the controller is always being developed further by us to improve overall user experience and introduce new features, firmware updates are a way to give our PINE users access to the newest software releases.
Firmware updates are always optional, but we recommend using always the latest releases, so you get access to the newest features.
Most firmware updates also require the latest PINE Motion App updates for Android and iOS in order to obtain access to the new features. Always make sure you are using the newest apps available in the Google Play and App Store.
9.1. Activating the Firmware Update Mode on PINE
Before you can update the firmware, the PINE Controller needs to be set to a special Firmware Update Mode.
Only activate the Firmware Update Mode when you really intend to update the firmware of the controller.
The controller is completely unfunctional once it is in the Update Mode and will only be functional again after a new firmware has been uploaded.
We also recommend that you first install and launch the Update Utility Software listed under Chapters 3 or 4 before activating the Firmware Update Mode.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 99 of 114
Black Forest Motion PINE Controller User Manual
I. Connect a suitable USB cable to the PINE Controller (micro USB) and your
computer.
II. Plug in the power supply for the Controller
III. Connect to the Controller with the PINE Motion App
IV. Go to the “Connections” Section
V. Tap the Symbol and confirm the appearing Dialog
VI. The PINE Controller should now be in Firmware Update Mode and is ready
to receive a new firmware. The blue LEDs on the controller should be on slightly to indicate the update mode.
The controller will now be unfunctional until a new firmware has been uploaded.
Make sure you are using a proper USB cable and not one only capable of supplying power. If firmware updates keep failing, try a different USB cable.
Black Forest Motion GmbH
Waldstraße 2
78136 Schonach
Page 100 of 114
Black Forest Motion PINE Controller User Manual
9.2. Updating on Windows
For Windows, we have our own Firmware Updater Utility for the PINE Controller.
Go to the Downloads section on our website to download the Updater Utility for Windows.
Install the Utility Software by launching the setup.exe file in the ZIP folder you downloaded. You might need to give permission to install 3rd party apps during the installation process.
Some versions of Windows might require additional USB drivers, so the updater utility can detect the PINE Controller. If you are having problems detecting the controller via USB, install the Windows drivers found in our Downloads section. Updates under Windows 10 should work right away without installing any additional drivers, however, on older operating systems, you will likely need to install those drivers.
I. With your PINE Controller still connected via USB to your computer (and
powered over the DC connector), launch the Updater Utility.
If you disconnected power from the controller after activating the Update Mode over the App, always first connect the USB cable to the controller and your computer, then connect the power supply.
II. Expand the Ports List and select the COM port. If the list is empty, click
the “Refresh” Button
Loading...