FileManager

The Bottlenose FileManager is an easy-to-use utility that makes operations such as firmware updates and AI weights transfer to your camera hassle-free.

Installing the Utility

The Bottlenose file utility should be installed on the computer that will interact with the camera

1. Download the file utility firmware_utility.exe for your operating system here.
2. Double-click on the install the utility

Firmware Update

1. Download the new firmware-bottlenose.tarfirmware from here.
2. Start the file utility. For Windows, you can access Bottlenose Utilities from your Start Menu.

3. Click the select button to connect your Bottlenose camera. Make sure the camera is connected and accessible.

3. Set the Transfer type to Firmware

4. Select the newly download firmware file. It's most likely in Downloads, your default download folder. You can also directly drag and drop the file inside the file text box.

5. Click upload to upgrade the camera.

🚧

Do not disconnect power or interact in any way with Bottlenose until the update process is complete.

The utility displays the status of the update. The camera also blinks its Ethernet status LED green to notify that the firmware upgrade is ongoing.

6. Once the update is done without errors, you may now close the utility, restart your camera and use eBus Player to stream interact with the new firmware.

Calibration Parameters

The file utility can be used to transfer calibration file into the camera for calibration. This utility currently support the calib.io format, the Kalibr format with only the Pinhole model, and a Bottlenose format. The Bottlenose format is a YAML format with each camera node containing the following fields.

• fx: the horizontal focal length
• fy: the vertical focal lenght
• cx: the horizontal principal point
• cy: he vertical principal point
• k1: the radial distortion parameters k1
• k2: the radial distortion parameters k2
• k3: the radial distortion parameters k3
• p1: the tangential distortion parameters p1
• p2: the tangential distortion parameters p2
• tvec: The translation vector specified as [tx, ty, tz]
• rvec: the rotation vector specified as [rx, ry, rz]
• width: the calibrated image width
• height : the calibrated image height

👍

Parameters k2, k3, p1, p2 are optional and default to zero. Also, tvec and rvec can be omitted when all components are zeros.

The following shows an example calibration file for a stereo Bottlenose camera using the Bottlenose format.

cam0:
 fx: 1987.056256568158
 fy: 1987.056256568158
        
 cx: 1093.500298952126
 cy: 866.9088903543686        
 k1: -0.14981977634391333
 k2: -0.08593589340885537    
            
 tvec: [0.0, 0.0, 0.0]        
 rvec: [0.0, 0.0, 0.0]
 width: 1920
 height: 1440
 
cam1:
 fx: 1973.047227618774
 fy: 1973.047227618774
        
 cx: 1025.0670209192651
 cy: 841.4264394134296
        
 k1: -0.15244075354715458
 k2: -0.05594888490548099
        
 tvec: [0.1294776881086207, 0.0021832385850557375, -0.011641424658114402]                
 rvec: [-0.0018785701226511835, 0.014522091363680155, 0.0013294885018857211]
 width: 1920
 height: 1440

To upload a supported calibration file into a Bottlenose camera,

1. Start the utility if it is not running yet.
2. Click the Select button to connect to your Bottlenose camera
3. Set the Transfer type to Calibration

4. Click the folder button to select your calibration file. You can also choose to drag and drop the file inside the file text box.

5. Click Upload and wait for confirmation.

6. Quit the application when done.

AI Demo

Use this section to load an AI model onto the camera. The camera does not have enough onboard storage to keep the AI model at shutdown. Please do this step at every reboot or power-up of the camera.

AI Weights Transfer

1. If you do not have a weights file yet, download one from here.
2. Start the utility if it is not running yet.

3. Click the select button to connect your to Bottlenose camera
4. Set the Transfer type to DNN Weights

5. Select the weights file. You can also choose to drag and drop the file inside the file text box.

6. Click Upload and wait for confirmation.

Click Quit or X to close the utility and start eBus Player to stream from the camera with the new AI model.

Run and Launch the Viewer

Start eBUS Player to interact with Bottlenose.

Click on Select/Connect and choose the Bottlenose camera from the available devices. It may take up to 40 seconds for Bottlenose to boot after you connect the power.

Improving User Experience

Change the colour profile

If the colour does not look right, it may be due to the type of lighting used in your office or the trade show.

Please change the colour profile:

Enable Jumbo Frames

For better performance, we recommend enabling Jumbo Frames on your network and setting it to at least 9000. To do so, follow these steps. This is a one-time setup.

1. Close any existing camera sessions. Example eBUS Player or the Labforge Bottlenose utility apps.
2. Open the Network and Sharing Center.
3. Click Change adapter settings.
4. Right-click the network for which you want to enable jumbo frames and select Properties.
5. Under the Networking tab, click the Configure button for the network adapter.
6. Select the Advanced tab.
7. Select Jumbo Frame and change the value from disabled to 9014 Bytes or to 9KB MTU, depending on your system.
8. Click OK to save and close the windows.