Getting Started

Thank you

Congratulations on purchasing a Labforge Bottlenose smart camera! As a small, Canadian company we sincerely appreciate your business. Please don’t hesitate to reach out to us should you have any questions or need assistance.

Included in the Box

Bottlenose is available in two versions: stereo and monocular.

Inside the box for the stereo version you will find the Labforge Bottlenose stereo camera and a business card with our support and contact information.

If you purchased the monocular version, the box will contain the monocular Labforge Bottlenose camera and a business card with our support and contact information.

Hardware Requirements

To use the camera for the first time, you have to chose an appropriate lens* (not included in the Bottlenose package), and a 12V 2.0A power adapter (not included in the Bottlenose package).

We recommend the XP Power VEL24US120-US-JA as suitable power adapter.

*The monocular version of Bottlenose requires one CS-mount lens and the stereo version requires an identical pair of CS-mount lenses. CS-mounts can accommodate S-mount or M12 and C-mount lenses via an adapter. Please contact us if you need help with lens selection.

Software Requirements

  • Microsoft Windows 10 or 11
  • Ubuntu Linux 18.04, 20.04, 22.04 on x64
  • Nvidia Jetpack aarch64

Connecting Your Camera

Please plug the Bottlenose Ethernet port into a Gigabit Ethernet network that can serve a DHCP address; like most home or office routers do. Bottlenose also supports LLA for direct Ethernet connections.

Power up Bottlenose by connecting the power adapter after the Ethernet is connected to the network.

For first time use, a firmware update is required after unboxing Bottlenose.

Download and Install the SDK

  1. Download the driver and SDK from our GitHub repository.
  2. Install the eBUS SDK on your target platform.
  3. From the available SDK options make sure Install GigE Vision Driver is checked.

Run and Launch the Viewer

After the driver and SDK are installed, 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.

Firmware Update on Bottlenose

Bottlenose can receive firmware updates via FTP. To enable the update functionality, start eBUS Player, connect to the camera and enable the firmware update from the Device Configuration.

After EnableUpdate has been set to true the FTP server will become active. Please use the IP address shown in eBUS Player to connect to the ftp server.

You can find the latest firmware updates for Bottlenose here.

FileZilla Update Example

Install an FTP client like FileZilla on your system and start it.

Open the Site Manager and create a new connection to the IP Address shown in eBUS Player. Make sure

  • Logon Type is set to anonymous
  • In the advanced tab limit the number of simultaneous connections to 1

Then connect to the site you just created and store the firmware file in the empty root directory. As soon as the file is received and validated by Bottlenose, Bottlenose will begin the update process.

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

The update status is shown in the UpdateStatus register of the Bottlenose device configuration. As soon as the update starts, both Ethernet LEDs on Bottlenose will turn off.

Once the update is complete the green Ethernet LED will remain on until power is disconnected/cycled. At this point it is safe to power cycle Bottlenose to apply the update.

If the firmware update binary gets corrupted in the process, the Bottlenose FTP server will reject the file with an error code, only valid firmware files can be uploaded to Bottlenose.

Disconnecting power during the update process will permanently disable the sensor.

Command Line Update Example

Most operating systems ship with a built in command line FTP client that can be used to perform the update instead of installing 3rd party software. In Microsoft Windows the FTP client can be started from the command line and takes the target IP address as sole parameter.

C:\Users\treid>ftp 192.168.1.33
Connected to 192.168.1.33
220 "Welcome to Labforge FTP"
500 "FTP error:command not recognized"
User (192.168.1.33:(none)): anonymous
331 "User name ok need password"
Password:
230 "User logged in proceed"
ftp>binary
200 "data type changed to I"
ftp> send update-tmpv7706-bn3-release.tar
200 "PORT command success"
150 "Opening Binary mode data connection for cmd STOR"
226 "Transfer completed"
ftp: 24668160 bytes sent in 0.35Seconds 69487.77Kbytes/sec
  • Username: anonymous
  • Password:

Most FTP clients by default transmit in ASCII or UTF-8 which will corrupt the firmware binary in transmission. Make sure to enable binary transfer.

ftp> binary

Then upload the firmware binary by either PUT (Linux) or SEND (Windows) commands.

# Windows
ftp> send <downloaded update file>
# Linux
ftp> put <downloaded update file>

If the firmware binary is valid, Bottlenose will begin the update process immediately after flashing. As soon as the update starts, both Ethernet LEDs on Bottlenose will turn off. Once the update is complete the green Ethernet LED will remain on. At this point it is safe to power cycle Bottlenose to apply the update.