Quick Start Guide QG001006 JetCis Evaluation Platform for Mira Sensor Family For All Evaluation Kits Based on NVIDIA Jetson Nano v1-00 • 2021-Feb-04
Document Feedback JetCis ● Evaluation Platform for Mira Sensor Family Content Guide Content Guide 1 Introduction ................................... 3 1.1 1.2 Description.................................................... 3 Key Features ................................................ 3 2 Out of the Box................................ 4 3 Hardware Description ................... 5 3.1 3.2 3.3 NVIDIA Jetson Nano Schematic View ......... 5 Connecting the Hardware .............................
Document Feedback 1 Introduction 1.1 Description JetCis ● Evaluation Platform for Mira Sensor Family Introduction JetCis is a platform for evaluating CMOS image sensors of the Mira product family. The platform is built on top of an NVIDIA Jetson Nano developer kit. The purpose of this guide is not to explain the sensor functionality, nor will it replace the NVIDIA Jetson manual. For that purpose, please refer to the appropriate datasheet/manual.
Document Feedback 2 JetCis ● Evaluation Platform for Mira Sensor Family Out of the Box Out of the Box The kit contains the following items out of the box. Please check if all items listed below are in the box. ● ● ● ● ● ● NVIDIA Jetson Nano Sensor board with lens, lens holder, VCSEL Connector cable for sensor board Tripod with adaptor for sensor board mounting Power supply EU/UK/US Flash drive with documentation Carefully follow all the steps in the next chapter.
Document Feedback 3 Hardware Description 3.1 NVIDIA Jetson Nano Schematic View JetCis ● Evaluation Platform for Mira Sensor Family Hardware Description Figure 2: Schematic Overview of the Jetson Nano Connections, Featuring 2 Camera Connectors.
Document Feedback 3.2 JetCis ● Evaluation Platform for Mira Sensor Family Hardware Description Connecting the Hardware Figure 3: Jetson Nano Connections. Mind the Orientation of the Blue Part of the Cable Connecting the Jetson Nano to the sensor board is done by opening the connectors both on the sensor board and on the Jetson Nano board. Make sure to insert the cable in the Camera Conn.1 port on the right. Insert the flex cable as depicted on Figure 3.
Document Feedback 3.3 JetCis ● Evaluation Platform for Mira Sensor Family Hardware Description Powering Up the System The Jetson Nano does not have a power button. There are two ways to power the Jetson Nano, either with a 5 V barrel jack, or via a micro USB connector. To power on the system, plug in the cable in the appropriate connector (J25 or J28 in Figure 2). Depending on the power input source, the J48 jumper may have to be removed. Refer to Nvidia documentation for more information.
Document Feedback 4 JetCis ● Evaluation Platform for Mira Sensor Family ISP Architecture ISP Architecture The JetCis system integrates two image pipelines. One is able to capture RAW, unprocessed images. These images are often desired to judge the image quality of the image sensor or to perform characterization of certain parameters. On the other hand, we have the ISP pipeline that is used for the live view in the GUI, as well as for capturing video.
Document Feedback 5 JetCis ● Evaluation Platform for Mira Sensor Family Software Description Software Description This chapter will explain how to use the graphical user interface of the EVK. Before proceeding to this step, check if the system is powered on, and the login screen appears. 5.1 The GNOME Desktop Figure 5: Desktop/Main Screen After booting, the GNOME desktop will appear.
Document Feedback 5.1.2 JetCis ● Evaluation Platform for Mira Sensor Family Software Description Configuring the Keyboard Layout By default, the systems sets the keyboard to US QWERTY. In case another keyboard layout is desired, this can be changed in the system settings menu. Refer to the Ubuntu manual for more information: https://help.ubuntu.com/ 5.1.3 Connecting to a Network The Jetson Nano features an Ethernet port for internet access. 5.1.
Document Feedback 5.2 JetCis GUI 5.2.1 Starting the GUI JetCis ● Evaluation Platform for Mira Sensor Family Software Description Figure 6: JetCis Viewer On the desktop, there is a shortcut called JetCisViewer. Double click the desktop icon to open the GUI software. There will appear a prompt to ask a password. Enter the default password (‘jetcis’). Information The GUI can be opened twice. This can be useful in situation where the user wants to stream images from two sensors simultaneously. 5.2.
Document Feedback 5.2.3 JetCis ● Evaluation Platform for Mira Sensor Family Software Description Loading a Configuration File The next step is to select the appropriate configuration file that matches the sensor board. Now press File -> Open Sensor Configuration and select the desired configuration file in the directory ~/JetCis/sensor. Make sure the connected sensor board matches the configuration file. Click open to load all the registers and GUI configurations.
Document Feedback JetCis ● Evaluation Platform for Mira Sensor Family Software Description Menu Bar Figure 8: Menu Bar On top of the window, several actions can be selected by pressing the buttons in the menu bar. For some actions, a shortcut key exists. This is written on the right, e.g. F to toggle full screen. Information Documentation such as datasheets and schematics can be accessed from the help menu. Toolbar Figure 9: Toolbar Below the menu bar, the toolbar is present.
Document Feedback JetCis ● Evaluation Platform for Mira Sensor Family Software Description Widgets On the right of the window, widgets are shown. This contains four tabs: ● ● ● Status: sensor live information, see figure below ISP: image signal processing, see figure below Sensor: control to change sensor parameters, see Figure 7 Figure 10: Status and ISP Tab Waveform and Histogram Figure 11: Waveform and Histogram Two image analysis tool are implemented in the GUI.
Document Feedback JetCis ● Evaluation Platform for Mira Sensor Family Software Description main window again and scroll on the live image. Hence, the plot will be updated. Note that drawing the plot will reduce the framerate, so it is better to pause the image when displaying the histogram. 5.2.5 Read/Write Registers with the GUI On the right side, it is possible to enter an address in the ‘Read’ section. Press GET or ENTER to readout the value from the register.
Document Feedback 5.2.7 JetCis ● Evaluation Platform for Mira Sensor Family Software Description Adding Widgets to the GUI (advanced users) To automate a specific setting, a widget can be added to the GUI. To add a widget to the GUI, select first the directory specific to the sensor, for example: ~/JetCis/Mira130-10bpp2lanes where all the descriptions of the already present widgets are located. Here, select a random python file or one that contains settings which are close to what is desired.
Document Feedback JetCis ● Evaluation Platform for Mira Sensor Family Software Description Figure 15: Example Code of the Digital Gain Slider 3. 5.3 Python Scripting, API and More Besides the GUI, there is another possibility to interface with the camera board. In the folder ~/JetCis/scripting the user can find multiple example python script to directly interface with the camera. To edit and run the python scripts, an editor such as VS Code can be installed on the Jetson Nano.
Document Feedback JetCis ● Evaluation Platform for Mira Sensor Family Software Description To run one of the scripts: 1. Make sure the GUI is closed 2. Open a terminal from the folder containing the script (right click -> new terminal) 3. Execute the following command, and the python script will be executed: python3 example_file.py 4. Or for help, enter to see command line arguments: python3 example_file.py –help 5. Some scripts support arguments, so you can run e.g.: python3 dual_cam.
Document Feedback 6 JetCis ● Evaluation Platform for Mira Sensor Family Transferring Data to Another Computer Transferring Data to Another Computer Using the free application WinSCP, one can copy files between a JetCis kit and a Windows computer. 1. Make sure the JetCis is connected to the internet. 2. Then, find its ip address by running ifconfig in a terminal. 3. On the Windows computer, create a new session in WinSCP. Choose for SFTP protocol, enter the credentials and press Login. 4.
Document Feedback 7 Updating the Software 7.1 Updating the GUI Software JetCis ● Evaluation Platform for Mira Sensor Family Updating the Software Contact your ams Application Support team for information on how to update the GUI software. They will provide you with further instructions. Note: an internet connection is advised when updating the kit. Checkout https://ams.com/download-center for updates or contact your application engineer. The update procedure typically goes as follows: 1.
Document Feedback 8 JetCis ● Evaluation Platform for Mira Sensor Family Resolving Common Problems Resolving Common Problems This chapter explains how to resolve the most common issues. Figure 18: Common Issues Issue Solution/Suggestion The system is not booting Make sure the power supply is plugged in the wall socket and in the NVIDIA Jetson. Make sure the red POWER LED is on after pressing the power button.
