- Notice
- Interfaces
- General Setting
- Appendix
Please read manual carefully before install, operate, or transport MiiVii device.
Ensure that the correct power range is being used before powering the device.
Avoid hot plugging.
To properly turn off the power, please shut down the Ubuntu system first, and then cut off the power. Due to the particularity of the Ubuntu system, on the Nvidia developer kit, if the power is turned off when the startup is not completed, there will be a 0.03% probability of abnormality, which will cause the device to fail to start. Due to the use of the Ubuntu system, the same problem also exists on the Miivii device.
Do not use cables or connectors other than described in this manual.
Do not use MiiVii device near strong magnetic fields.
Backup your data before transportation or MiiVii device is idle.
Recommend to transport MiiVii device in its original packaging.
Brief
MiiVii Apex Xavier is an embedded computing platform based on NVIDIA Jetson AGX Xavier. With waterproof and shockproof connectors and powerful computer vision processing capability, Apex Xaiver is designed for autonomous machines, especially for outdoor environment use. Apex Xavier offers synchronization feature, which is essential for multi-sensor fusion. In addition, a variety of computer vision algorithm acceleration SDK are provided on Apex Xavier platform.
Included in the Box
Apex Xavier×1
Power Supply×1
Power cable×1
I/O Cable Assemblies×1
4G Antenna×2
WiFi Antenna×2
Quick Start×1
Specifications
Processor
Processor | NVIDIA Jetson AGX Xavier |
---|---|
CPU | 8-core ARM v8.2 64-bit CPU |
GPU | 512-core Volta GPU |
Memory | 32GB 256-Bit LPDDR44 |
DL Accelerator | 2×NV DLA Engines |
Storage | 32GB eMMC 5.1 |
I/O
Interface | Quantity | Note | |
Network | Ethernet | 1×8pin Waterproof Gigabit Ethernet port 1×RJ45 Gigabit Network port | Alternative RJ45 and waterproof port |
WIFI | 1 | 2.4G/5.8G 300Mbps | |
Camera | Camera | 8×CSI 1 Lane GMSL FAKRA Z TYPE | 9V Transmission distance up to 15 meters |
Video output | Video out | 1×GMSL FAKRA Z TYPE | |
HDMI | 1×HDMI 2.0 TYPE A | ||
USB | USB | 2×USB 3.1 TYPE A 1×Micro USB | USB 5V, 1A Micro USB 5V, 0.5A |
I/O | GPIO | 5xGPIO | IN 0-12V, OUT 3.3V |
CAN | 2 | DB9 Terminal With CAN chip Terminal resistor 120Ω | |
UART | 1xDebug 2xTTL/RS232 2xRS232/422/485 | DB9 Terminal TTL 3.3V | |
SPI | 1 | 3.3V | |
I2C | 1 | 3.3V | |
I2S | 1 | 3.3V | |
Sync I/O | 1xSYNC_IN 2xSYNC_OUT 2xSYNC_PPS | DB9 Terminal SYNC_IN 0-12V, SYNC_OUT 3.3V, SYNC_PPS 3.3V | |
User Expansion | TF | 1xTF Slot | MicroSD card supported |
M.2 | 1×M.2 M Key 1×M.2 B Key | 2280 SIZE NVME SSD 4G LTE | |
Function Key | Power KEY | 1 | Button |
Reset KEY | 1 | Button | |
Recovery KEY | 1 | Button |
Power Supply
Power Supply | Spec |
---|---|
Input Type | DC |
Input Voltage | Wide input 12-50V DC |
Typical consumption | 30W |
Mechanical
Mechanical | Spec |
---|---|
Dimensions (W×H×D) | 245mm×68mm×172mm (I/O ports and mounting holes included) 213mm×68mm×143mm (I/O ports and mounting holes excluded) |
Weight | 2.2Kg |
Environmental
Environmental | Spec |
---|---|
Operating Temperature | -20℃-70℃, 0.2~0.3m/s air flow5 |
Storage Temperature | -25℃-80℃ |
Storage Humidity | 10%-90% non-condensing |
Vibration | 5gn,10Hz~150Hz,3 Axis6 |
Protection | IP4X7 |
Certification
Certification | Status |
---|---|
CE | Passed |
CCC, FCC, RoHS, SRRC | Processing |
[4] Jetson AGX Xavier increase of DRAM memory size from 16GB to 32GB.
[5] According to GB/T 2423-2008 Working frequency is subject to change after temperature reaches 60℃
[6] According to GB/T 2423.10-2008
[7] Professional I/O ports are IP67-rated. To achieve IP67 rating of Apex Xavier, please contact MiiVii for a second version of case design.
Dimensions and mounting hole position as below:
Up view(Unit:mm) |
---|
Left view(Unit:mm) |
|
Support
MiiVii is glad to help you with any questions you may have about our product, or about the use of the technology for your application. The fastest way is sending us an email: . Or you could visit our developer forum: http://forum.miivii.com for solutions.
Warranties
Warranty period: One year from the date of delivery.
Warranty content: MiiVii warrants the product manufactured by us to be free from defects in material and workmanship during warranty period. Please contact helpdesk@miivii.com for return material authorization (RMA) prior to returning any items for repair or exchange. The product must be returned in its original packaging to prevent damage during shipping. Before returning any product for repair, it is recommended to back up your data and delete any confidential or personal data.
Interfaces
Interfaces
Front panel
Figure Apex Xavier Front view |
Interface | Name | Description |
---|---|---|
DC IN | Power interface | Power input voltage: 12-50V |
STATUS_LED | System status indicator | System on: solid blue System off: solid red |
POWER_LED | Carrier board status indicator | Carrier board power on: solid yellow Carrier board system on: solid white Carrier board system error: solid red |
LAN(Waterproof) | Gigabit Ethernet | Only LAN port one could work at the same time |
LAN(RJ45) | Gigabit Ethernet | Only LAN port one could work at the same time |
HDMI | HDMI Port | HDMI 2.0 |
USB×2 | USB3.1Port | USB 3.1 is backwards compatible with USB 3.0 and USB 2.0 |
Micro USB | Micro USB Port | Support USB OTG |
LAN(Waterproof) Pin:
Figure LAN(Waterproof) Pin |
Circuit | Description |
---|---|
1 | MDI0+ |
2 | MDI0- |
3 | MDI1+ |
4 | MDI1- |
5 | MDI2+ |
6 | MDI2- |
7 | MDI3+ |
8 | MDI3- |
Left Panel
Figure Apex Xavier Left Panel |
Interface | Name | Description |
---|---|---|
GMSL IN | GMSL in | Support 8 GMSL cameras(9v) |
GMSL OUT | GMSL out | Support 1 GMSL display |
There is no restriction between two groups. When you connect cameras to a specific camera group, you must attach the cameras in sequential order: A1 to A4 or B1 to B4. Homogeneous camera types are required per camera group.
Right Panel
Figure Apex Xavier Right Panel |
Interface | Name | Description |
---|---|---|
EXPANSION PORT① | I/O Expansion Port 1 | 1×DEBUG 2×TTL/232(TTL 3.3V) 2×232/422/485 2 × CAN(With CAN chip, terminal resistor 120Ω) 2×SYNC_PPS(3.3V) 1× SYNC_OUT(3.3V) 1×SYNC_IN(Logic High 1V-12V, Logic Low 0V-0.8V) 1 × POWER_ONKEY 1×FORCE_RECOVERY 1×RESET |
EXPANSION PORT② | I/O Expansion Port 2 | 1×IIS(3.3V) 1×IIC(3.3V) 1×SPI(3.3V) 5×GPIO(For IN: Logic High 1V-12V, Logic Low 0V-0.8V. For OUT:3.3V) |
I/O Expansion Port Pin Definitions
There are two I/O expansion ports at the right panel of Apex Xavier, as EXPANSION PORT ① and EXPANSION PORT ②:
Figure I/O Expansion Ports |
EXPANSION PORT ① Pin Assignments
Figure EXPANSION PORT ① |
Port Name | Pin | Definition | Description |
UART(TTL/232)A DEBUG8 | G1 | UART(TTL/232)A_RX | UART(TTL/232)A: TTL-RX/232-RX |
H1 | UART(TTL/232)A_TX | UART(TTL/232)A: TTL-TX/232-TX | |
J1 | GND | Ground | |
UART(TTL/232)B | D1 | UART(TTL/232)B_RX | UART(TTL/232)B: TTL-RX/232-RX |
E1 | UART(TTL/232)B_TX | UART(TTL/232)B: TTL-TX/232-TX | |
F1 | GND | Ground | |
UART(TTL/232)C | B2 | UART(TTL/232)C_RX | UART(TTL/232)C: TTL-RX/232-RX |
A2 | UART(TTL/232)C_TX | UART(TTL/232)C: TTL-TX/232-TX | |
A3 | GND | Ground | |
UART(232/422/485)A | K1 | UART(232_RX/485_A/422_T+)A | UART(232/422/485)A: 232_RX/485_A/422_T+ |
L1 | UART(232_TX/485_B/422_T-)A | UART(232/422/485)A: 232_TX/485_B/422_T- | |
M1 | UART(422_R+)A | UART(232/422/485)A: 422_R+ | |
M2 | UART(422_R-)A | UART(232/422/485)A: 422_R- | |
L2 | GND | Ground | |
UART(232/422/485)B | G2 | UART(232_RX/485_A/422_T+)B | UART(232/422/485)B: 232_RX/485_A/422_T+ |
F2 | UART(232_TX/485_B/422_T-)B | UART(232/422/485)B: 232_TX/485_B/422_T- | |
E2 | UART(422_R+)B | UART(232/422/485)B: 422-R+ | |
D2 | UART(422_R-)B | UART(232/422/485)B: 422-R- | |
C2 | GND | Ground | |
CAN_A | B3 | CAN_A_L | CAN_A Low |
C3 | CAN_A_H | CAN_A High | |
CAN_B | D3 | CAN_B_L | CAN_B Low |
E3 | CAN_B_H | CAN_B High | |
PPS_A | A1 | PPS_A_RX | PPS_A: TTL-RX/232-RX |
B1 | PPS_A_TX | PPS_A: TTL-TX/232-TX | |
C1 | GND | Ground | |
F3 | PPS_A_SYNC | PPS_A_SYNC Pulse signal | |
G3 | GND | Ground | |
PPS_B | K2 | PPS_B_RX | PPS_B: TTL-RX/232-RX |
J2 | PPS_B_TX | PPS_B: TTL-TX/232-TX | |
H2 | GND | Ground | |
H3 | PPS_B_SYNC | PPS_B_SYNC Pulse signal | |
J3 | GND | Ground | |
SYNC_IO | K3 | SYNC_IN | Sync in Signal |
L3 | GND | Ground | |
M3 | SYNC_OUT | Sync out Signal | |
M4 | GND | Ground | |
K4 | GND | Ground | |
RESET | J4 | RESET | Reset |
RECOVERY | G4 | FORCE_RECOVERY | Recovery |
POWER | E4 | POWER_ONKEY | Power |
GND | H4 | GND | Ground |
F4 | |||
D4 |
[8] UART(TTL/232)A is a DEBUG port, all TTL is 3.3V
If you want to use GPS Sync function, please refer to the following instruction:
Connect GPS NMEA Serial port to UART(TTL/232)B port of Apex Xavier(Baud 9600), device node is /dev/ttyUART_TTL_232_B
Connect GPS PPS Port to SYNC_IO PIN1of Apex Xavier, device node is /dev/miivii-sync-in-a
These two nodes above is occupied while GPS Sync function is available.
EXPANSION PORT ② Pin Assignment
Figure EXPANSION PORT② |
Port Name | Pin | Definition | Description |
SPI Port | A4 | SPI_SCK | SPI continuous serial clock |
B4 | SPI_MISO | SPI master input slave output, or master in slave out | |
C4 | SPI_MOSI | SPI SPI master output slave input, or master out slave in | |
D4 | SPI_CS0 | SPI slave select | |
E4 | GND | Ground | |
IIS Port | F4 | IIS_MCLK05 | IIS master clock |
G4 | IIS_PWM01 | IIS interrupt | |
H4 | IIS_SDIN | IIS serial data in | |
H3 | IIS_SDOUT | IIS serial data out | |
G3 | IIS_FS | IIS frame sync | |
F3 | IIS_CLK | IIS continuous serial clock | |
E3 | GND | Ground | |
IIC Port | D3 | IIC_CLK | IIC serial clock |
C3 | IIC_DAT | IIC serial data | |
B3 | GND | Ground | |
Audio Port | A3 | IN1P | MIC Signal |
A2 | AUD_HPOR | Right channel signal | |
B2 | AUD_HPOL | Left channel signal | |
C2 | GND | Ground | |
GPIO Ports | D2 | GPIO_A1 | GPIO_IN |
F2 | GPIO_B13 | ||
H2 | GPIO_C24 | GPIO_OUT | |
G1 | GPIO_D26 | ||
E1 | GPIO_E33 | ||
GND | E2 | GND | Ground |
G2 | |||
H1 | |||
F1 | |||
A1 | |||
5V | B1 | 5V | 5V |
GPIO Pin Assignment
Port Name | Pin Number | GPIO | Default Setting | GPIO Export Value |
GPIO | D2 | GPIO_A | GPIO_IN | 339 |
F2 | GPIO_B | 433 | ||
H2 | GPIO_C | GPIO_OUT | 387 | |
G1 | GPIO_D | 390 | ||
E1 | GPIO_E | 413 |
Rear Panel
Figure Apex Xavier Rear Panel |
Interface | Name | Description |
---|---|---|
①② | 2.4G/5.8G WiFi Antenna connector | Connect to 2.4G/5.8G WiFiantenna |
③④ | 4G Antenna connector | Connect to 4G antenna |
Apex Xavier provides one I/O cable with 10 DB-9(DE-9) connectors and 3 buttons, as an extension of EXPANSION PORT ①
Number | Port | Quantity | Details |
---|---|---|---|
1 | UART_TTL/232 | 3 | Black DB9 connector |
2 | UART_232/422/485 | 2 | Gray DB9 connector |
3 | CAN | 2 | White DB9 connector |
4 | PPS | 2 | Dark Blue DB9 connector |
5 | Sync I/O | 2 | Share one dark green DB9 connector |
6 | Button | 3 | 1 RESET Button(White) 1 RECOVERY Button(Black) 1 POWER_ONKEY Button(Red) |
Figure I/O Cable |
UART(TTL/232)Ports and Pin Assignments
Apex Xavier provides 3 TTL/RS232 ports: UART(TTL/232)A, UART(TTL/232)B and UART(TTL/232)C. UART(TTL/232)A is for debugging use. Black DB9 connectors from I/O cable are shown as below:
Figure UART(TTL/232) Cable and Connectors |
3 UART(TTL/232) DP9 connectors pin assignments:
Figure UART(TTL/232) Pin |
UART(TTL/232)A | UART(TTL/232)B | UART(TTL/232)C | |||
Pin | Signal | Pin | Signal | Pin | Signal |
2 | UART(TTL/232)A_RX | 2 | UART(TTL/232)B_RX | 2 | UART(TTL/232)C_RX |
3 | UART(TTL/232)A_TX | 3 | UART(TTL/232)B_TX | 3 | UART(TTL/232)C_TX |
5 | GND | 5 | GND | 5 | GND |
UART(232/422/485) Ports and Pin Assignments
Apex Xavier provides 2 RS232/RS485/RS422ports: UART(232/485/422)A and UART(232/485/422)B. Gray DB9 connectors from I/O cable are shown as below:
Figure UART(422/485) Cable and Connectors |
2 UART(232/422/485) DP9 connectors pin assignments:
Figure UART(422/485) Pin |
UART(232/422/485)A | UART(232/422/485)B | ||
Pin | Signal | Pin | Signal |
2 | UART(232_RX/485_A/422_T+)A | 2 | UART(232_RX/485_A/422_T+)B |
3 | UART(232_TX/485_B/422_T-)A | 3 | UART(232_TX/485_B/422_T-)B |
5 | GND | 5 | GND |
6 | UART(422_R-)A | 6 | UART(422_R-)B |
7 | UART(422_R+)A | 7 | UART(422_R+)B |
Relation of UART Port and device node as follow:
Pin | UART Port | Device Node |
---|---|---|
1 | UART(TTL/232)A | DEBUG |
2 | UART(TTL/232)B | ttyUART_TTL_232_B |
3 | UART(TTL/232)C | ttyUART_TTL_232_C |
4 | UART(232/422/485)A | ttyUART_232_422_485_A |
5 | UART(232/422/485)B | ttyUART_232_422_485_B |
DIP switch for UART Ports:
Open Apex Xavier’s bottom cover, DIP switches are shown as below:
Figure Apex Xavier DIP Switch |
DIP switch settings are shown in the table below:
Figure DIP Switch Mapping |
Number | UART Port | DIP Switch | DIP Switch Settings |
1 | PPS_A | UART1 | 1.For TTL signal: Switch to 'TTL’ 2.For 232 signal: Switch to '232' (default) |
2 | PPS_B | UART7 | |
3 | UART(TTL/232)A | UART3 | |
4 | UART(TTL/232)B | UART2 | |
5 | UART(TTL/232)C | UART9 | |
6 | UART(232/422/485)A | UART5 | 1.For 232 signal: Switch to '232' 2.For 422/485 signal: Switch to '422/485'(default) |
7 | UART(232/422/485)B | UART8 |
[9] Default switch for PPS ports and UART(TTL/232) ports is 232,default switch for UART(232/422/485) ports is 485/422
CAN Ports and Pin Assignments
Apex Xavier provides 2 CAN ports: CAN_A and CAN_B. White DB9 connectors from I/O cable are shown as below:
Figure CAN Cable and Connectors |
2 CAN connectors pin assignments:
Figure CAN Pin |
CAN_A | CAN_B | ||
Pin | Signal | Pin | Signal |
2 | CAN_A_L | 2 | CAN_B_L |
7 | CAN_A_H | 7 | CAN_B_H |
PPS Ports and Pin Assignments
Apex Xavier provides 2 PPS ports: PPS_A(115200 Bd) and PPS_B(9600 Bd)10. The blue DB9 connectors from I/O cable are shown as below:
[10] For the usage of PPS function, please refer to the "PPS Sync Method" section in "Synchronization Function"
Figure PPS Cable and Connector |
PPS_A(115200 Bd) and PPS_B(9600 Bd), Pin Assignments:
Figure PPS Pin |
PPS_A | PPS_B | ||
Pin | Signal | Pin | Signal |
1 | GND | 1 | GND |
2 | PPS_A_RX | 2 | PPS_B_RX |
3 | PPS_A_TX | 3 | PPS_B_TX |
5 | GND | 5 | GND |
6 | PPS_A_SYNC | 6 | PPS_B_SYNC |
SYNC Ports and Pin Assignments
Apex Xavier provides 2 sync I/O ports: Sync_out and Sync_in11. They share the green DB9 connector from I/O cable:
Figure Sync IO Cable and Connector |
SYNC_IO DB9 connector pin assignments::
Figure Sync IO Pin |
Synchronization Signal | |
Pin | Signal |
1 | SYNC_IN_A |
2 | SYNC_OUT_A |
3 | NC |
6 | GND |
7 | GND |
8 | GND |
[11] For the usage of Sync_out and Sync_in function, please refer to the "Sync out Method" and "Sync in Method" sections in "Synchronization Function"
Buttons
Apex Xavier provides 3 buttons: RESET, POWER_ONKEY and FORCE_RECOVERY.
Figure Function Buttons |
Name | Function | Color |
---|---|---|
RESET | Restart | White |
POWER_ONKEY | Power on | Red |
FORCE_RECOVERY | Enter Recovery mode | Black |
Apex Xavier provides expansion sockets for SSD, 4G module, TF card and SIM card. Remove screws on Apex Xavier’s bottom cover as shown in below:
Figure Apex Xavier Button Cover |
Expansion sockets are shown as below. After installation, SSD card and 4G module need to be screwed. Connect 4G antenna cable (attached to the board) to 4G module.
Figure Apex Xavier Expansion Sockets |
General Setting
General Setting
System
MiiVii device use Ubuntu system. Default username: nvidia default password: nvidia
System Image and Flashing Tool
Please visit MiiVii developer forum: http://forum.miivii.com/ for flash tool and system image.
Power on
Connect an external HDMI display to MiiVii's HDMI port.
Connect a USB keyboard and mouse.
Connect the included AC adapter to power socket. Plug AC adapter into an appropriately rated electrical outlet.
Figure Startup |
Power off: Use the following command in terminal.
For MiiVii device with entity PWR button, you can also press and hold PWR button.
sudo poweroff
Reset: Use the following command in terminal.
sudo reboot
MiiVii Setting
MiiVii Device provides a setting program called MiiVii Setting. You can get access to basic information and settings through MiiVii Setting. Click the icon on upper right corner。In addition, these settings can be set through code, please refer to the section after MiiVii Setting introduction.
Figure Version Info |
You can set up GMSL camera here. MiiVii Device Apex has two groups of GMSL camera GMSL_A and GMSL_B, while MiiVii Device S2Pro has only one group GMSL_A.
Figure Set up GMSL Camera |
You can set up Sync mode here:
Figure Set Synchronization Mode |
Default setting is NTP mode. MiiVii Device accept NTP service while set to this mode.
MiiVii Device accept GPS synchronization while set to GPS mode.
MiiVii Device cannot be synchronized but can synchronize other sensors while set to None mode.
You can also set Sync out frequency here, please note it is not GMSL frequency.
Finish setting and exit
Figure Finish setting |
You can also check software version through code
cat /etc/miivii_release APEX 4.2.2-1.5.0
Set up GMSL Camera
When accessing GMSL camera for the first time and changing GMSL camera model, you need to change the configuration file and restart the device.Configuration file path:/opt/miivii/config/gmsl_camera/camera.cfg MVGCB-001A :Entron MVGCB-002A: Calmcar MVGCB-003A:Adayo MVGCB-006A:Sensing The default configuration of GMSL_A and GMSL_B are both MVGCB-001A.
Set up synchronization Mode and Sync out frequency Synchronization Mode and Sync out frequency settings need to modify the configuration file and restart the device.Configuration file path:/opt/miivii/config/sync/sync.cfg Synchronization Mode is achieved by modifying the X value of "sync_type:X". 0:GPS mode 1:NTP mode 2:None mode Sync out frequency is achieved by modifying the XX value of "sync_out_freq:XX". Only integers are supported.\
cat /opt/miivii/config/sync/sync.cfg sync_out_freq:25 sync_type:2 /* note: sync_out_freq---the frequency is 25 for sync out time sync_type---0 is for GPS calibrate time 1 is for SYS calibrate time 2 can not calibrate time
MiiVii device has several power modes. You can set up power mode through the green NVIDIA icon on the upper right corner.
Figure Power mode Icon |
For MiiVii device equipped with NVIDIA Jetson AGX Xavier, the following table shows details of each power mode . The default mode is 3.
You can also set up through code:
#check current mode sudo nvpmodel -q verbose # set to a certain mode sudo nvpmodel -m [MODE ID] #achieve best performance of current mode sudo jetson_clocks #check more info sudo jetson_clocks --show
GPIO
Please change the code in <> to your GPIO export value
#switch to root sudo su - #set GPIO to high echo 1 > /sys/class/gpio/<gpio339>/vlaue #set GPIO to low echo 0 > /sys/class/gpio/<gpio339>/vlaue
For auto config, write above commands to file /etc/rc.local
.
Note: Description of GPIO external connection
DO is on/off output (on/off output is no output voltage, control output low voltage, pin grounding in normal time, control output high voltage, pin neither output high level nor low level, high resistance state.If the external pull-up resistor is connected, the voltage will be drawn to the power supply voltage of the pull-up resistor at the time of high output voltage.)
Set to high voltage, DO foot and external voltage are the same (0V~40V); Set to low level, DO feet for the ground.
UART
Open device node in /dev/. Then use stty command to set parameters. See stty command manual for details, please change the code in <> to your UART device node.
#config UART $ sudo stty -F /dev/<ttyTHS1> speed 115200 cs8 -parenb -cstopb -echo #send data through UART $ sudo echo “miivii tty debug” > /dev/<ttyTHS1> #receive data from UART $ sudo cat /dev/<ttyTHS1>
Use GPS To Give Time To The Device
Advantages of GPS timing function: The device obtains local standard time signal from GPS satellite through GPS device, so as to accurately locate the device time
GPS Support Model
The serial port supports modifying baud rate. The default baud rate is 9600 GPS brand supported: all GPS devices that conform to GPRMC data standard format output and must have PPS second pulse output
Connection Mode
Refer to the "Interface Description" in the manual.
Timing Function Configuration
When the GPS is connected for the first time, the system configuration should be conducted in MiiVii Setting configuration software. Configure the Sync Mode option to GPS Mode and restart the system.Please refer to the section of "MiiVii Setting" for specific methods.
Check Whether The Timing Was Successful
Modify the system time, enter the command
sudo date -s "2018-10-1"
Wait for 2~3s, check the current time, and enter the command
data
If the display time is: "2018-10-1", it means the timing failed If the display time is: "current time", the timing is successful
Troubleshooting
If the timing fails, fault troubleshooting shall be carried out
1. Check If The GPS Has Output
Type the command
cat /dev/ttyTHS1
The terminal receives output with a GPRMC field, such as: GPRMC,014600.00,A,2237.496474,N,11356.089515,E,0.0,225.5,310518,2.3,W,A*23
2. Check The OUTPUT of THE GPS PPS Signal
Type the command
hexdump /dev/miivii-sync-in-a
The terminal has hexadecimal data output, such as: 0000400 02fe 9f40 490e 562d 1647 004e 0000 0000
3. Identify Methods
If the above "1"&"2" has no output, indicating that the GPS is not working properly, you can put the GPS out of the window or go outside for testing, or change the GPS for testing
If the output of "1"&"2" is normal, check whether the MiiVii Setting configuration is in GPS mode. If not, change the mode and restart it
After the above operation, GPS timing is still unsuccessful, enter the command
hexdump /dev/miivii-sync-out
The terminal has hexadecimal data output, such as: 0000400 02fe 9f40 490e 562d 1647 004e 0000 0000
If there is no data output, it may be that there is no matching brush tool and mirror brush. It is recommended to check the mirror and the brush tool to re-brush
If there is data output, it may be a hardware problem,it is recommended to contact after-sales maintenance treatment
CAN
Please check cansend.c and candump.c from https://github.com/linux-can/can-utils for instructions.
Test command:
sudo modprobe can sudo modprobe can_raw sudo modprobe mttcan sudo ip link set can0 type can bitrate 500000 berr-reporting on loopback off sudo ip link set up can0 sudo cansend can0 123#abcdabcd sudo candump can0 sudo ip -details -statistics link show can0 sudo ifconfig can0 down
CAN fd:
sudo modprobe can sudo modprobe can_raw sudo modprobe mttcan sudo ip link set can0 type can bitrate 500000 dbitrate 2000000 berr-reporting on fd on sudo ip link set up can0 sudo cansend can0 213##011
SSD Setting
#check ssd information:
sudo fdisk -lu
Figure SSD Information |
#Format SSD:
sudo mkfs -t ext4 /dev/nvme0n1
Figure Formatting SSD |
#Check UUID:
sudo blkid /dev/nvme0n1
Figure SSD UUID |
Setting method of automatic mounting SSD: Create a systemd service in the /etc/systemd/system path to automatically mount the SSD when booting, such as: miivii_mount_ssd.service
#Create miivii_mount_ssd.service vim miivii_mount_ssd.service [Unit] Description=MIIVII specific script After=udev.service [Service] ExecStart=/etc/systemd/miivii_mount_ssd.sh [Install] WantedBy=multi-user.target
Create a script in the /etc/systemd/ path to mount the SSD, such as: miivii_mount_ssd.sh
#Create miivii_mount_ssd.sh vim miivii_mount_ssd.sh #!/bin/bash mount -o rw /dev/nvme0n1 /home/nvidia/workspace
change mode for this script
sudo chmod +x miivii_mount_ssd.sh
Set the mounted SSD service to start at boot
sudo systemctl enable miivii_mount_ssd.service
WiFi Setting
MiiVii S2, S2Pro and EVO TX2 ,EVO TX2 GMSL2 has WiFi function.While Apex Xavier MiiVii EVO Xavier, Lite NX and Lite Nano provides WiFi function via a expansion module. Please refer to the information in [Expansion] to intall WiFi module. Click the network icon in upper-right corner of the desktop. Find the name of your WiFi network and click on it. Enter your password and click ‘Connect’.
Figure WiFi Connection |
4G Setting
4G module is not included in MiiVii device package. Please refer to the information in [Expansion] to intall 4G module. Instructions for 4G module configuration are shown as below, using QUECTEL EM05 as an example. EM05 4G driver is included in MiiVii system. This SIM card could be detected automatically. There should be 4 devices under /dev/ttyUSB0~/dev/ttyUSB3.
Users need to choose their own 4G LTE SIM card(note that mobile phone sim card and IOT sim card is supported, but IOT sim card is hardware-binding, please consult your carrier for more information ). Before getting started, please insert SIM card into sim socket.
Click the network icon in upper-right corner of the desktop. Find 'Edit Connections', then click 'add'.
Change connection type to 'Mobile Broadband'
Next
Change country to 'China'. Then choose network provider.
If your network provider is not included in the list, then enter it manually.
Choose your Plan
China Mobile choose 'Internet',China Unicom and China Telecom choose default
APN settings: China Mobile: cmnet; China Unicom: 3gnet; China Telecom: ctnet
Check entire settings, then click 'Apply'
Enter username and password, click 'save'
Click the network icon in upper-right corner of the desktop. Then connect to your network. If you need auto connection, please edit Network connections:
Select 'General', then check 'Automatically connect to this network when it is available'
Reset MiiVii device, you can automatically connect to 4G network
Sync Introduction
Apex Xavier provides 3 ways to synchronize sensor input data: PPS, Sync in and Sync out. Synchronization error is within 1μs. (Error estimation method is attached to the end of this section)
Figure Sync Fearure Schematic |
Sync Function
PPS Sync Method
MiiVii device generates PPS(Pulse width: 50ms)1. The NMEA GPRMC message is sent through PPS port. NMEA message example:
$GPRMC,060249.000,A,3949.63046,N,11616.48565,E,0.296,,291118,,,A*4d
[1] For the hardware connection method of the PPS, please refer to the "PPS Ports and Pin Assignments" section in the "I/O Cable"
'060249.000' represents 'Time of fix 06:02:49 UTC'. Receiving PPS signal and GPRMC message, sensors which support PPS synchronization, could synchronize their internal clock with system time. Together with the timestamp, sensor data is sent to MiiVii device, so that Apex Xavier receives the data acquisition time.
Figure PPS Sync Method Schematic |
Synchronization verification (RS-LiDar-16 sensor):
When the sensor connects with Apex Xavier using only data wire, device ROS Node sends hardware timestamp to the system, which is determined by sensor’s internal clock. As shown below, there is a big difference between hardware timestamp and system time.
Figure Comparison of Lidar Time and ROS time without Synchronization |
After connecting the sensor with MiiVii device's PPS_SYNC and PPS_TX pin, the sensor’s internal clock is synchronized with system time. Comparing the hardware timestamp and system time, when the difference is less than 100ms, it means PPS synchronization is functional.
Figure Comparison of Lidar Time and ROS time after Synchronization |
Sync out Method
MiiVii device could generate one 1-30Hz signal (Pulse width: 5ms) through its sync-out pin2. This signal is received by sensors as trigger signal for data acquisition. Meanwhile, MiiVii device records the moment of this signal’s rising edge. After data acquisition, MiiVii device associates received data with the trigger signal’s rising edge moment as data timestamp. Thus, MiiVii device system obtains data acquisition time.
[2] For the hardware connection method of the Sync out, please refer to the "SYNC Ports and Pin Assignments" section in the "I/O Cable"
Figure Sync out Method Schematic (25Hz) |
Also, MiiVii device provides sync-out feature for GMSL interface. See GMSL Camera Section for details.
Synchronization Verification
Set the sensor to external sync configuration. By recording ROS bags, check whether the sensor trigger signal equals to your setting or not. If the difference is within 1Hz, it means sync-out method is functional.
Sync in Method
Sensors with sync-in mode could generate a signal at the beginning of data acquisition3
. MiiVii device receives this signal and records its rising edge moment. After data acquisition, MiiVii device associates received data with the signal’s rising edge moment as data timestamp. Thus, MiiVii device system obtains data acquisition time.
[3] For the hardware connection method of the Sync in, please refer to the "SYNC Ports and Pin Assignments" section in the "I/O Cable"
Figure Sync in Method Schematic (10Hz) |
Synchronization Verification:
Print the signal’s timestamp received by SYNC_IN pin. Compare this timestamp with system time of frame received (ros::time::now). If the difference is less than 100 ms, it means sync-in method is functional.
Synchronization error estimation
Measure PPS signal duration with oscilloscope
Figure PPS Signal Duration |
Theoretical Value(μs) | Measurement Result(μs) | Error(μs) | |
---|---|---|---|
PPS | 1000000 | 999999.4 | 0.6 |
Measure sync-out signal duration with oscilloscope
Figure Sync-out Signal Duration (10Hz) |
Theoretical Value(μs) | Measured Value(μs) | Error(μs) | |
---|---|---|---|
Sync out | 100000 | 99999.2 | 0.8 |
Evaluate synchronization feature by measuring timestamp jitter
Sample code to calculate timestamp jitter
MiiVii device provides sample code for users to evaluate the synchronization feature.
#navigate to the following directory cd /opt/miivii/feature/sync_test/bin #evaluate sync-out method performance ./sync_out_test #evaluate sync-in method performance ./sync_in_test #evaluate pps synchronization method performance ./pps_test
Sync out jitter measurement
Sample code(sync_out_test) could run real-time analytics on the received timestamp. Time interval, frequency, max deviation and standard deviation are printed out.
Figure Sync out Test Result |
Sync in jitter measurement
Connect an external signal with fixed frequency to MiiVii device SYNC_IN pin. Run sample code (sync_in_test) for real-time analytics on the received timestamp.
MiiVii device's SYNC_OUT pin could be used as an 25Hz external signal to connect with SYNC_IN pin
Figure Sync Pin Connection Schematic |
Figure Sync-in Jitter Test Result |
PPS jitter measurement
Connect MiiVii device's PPS pin and SYNC_IN pin. Run sample code (pps_test) for real-time analytics on the received timestamp.
Figure Sync Pin Connection Schematic |
Figure PPS Test Result |
GMSL
GMSL cameras do not support hot swapping.
GMSL Sync is triggered by one sync signal with frequency of 25Hz,you can set up frequency from 14Hz to 30Hz in gmsl SDK.
MAXIM GMSL can drive a cable length of 15 meters.
Support 8-Bit YUV format video with resolution of 1280×720@25, 1280×728@25, 1280×800@25 and 1280×1080@25.
Support following GMSL camera brand and model:
Entron : S001A190CM0A,S001A105CM0A,S001A065CM0A,S001A038CM0A,F001R182CM0S,F001R120CM0S,F001R100CM0S,F001R060CM0S,F001R028CM0S
Calmcar: CA20205201,CA30212801,CA30211201,CA10219201
Adayo: C1A201,C1A203,C1A204
Sensing:SG1-AR0143-H030,SG1-AR0143-H059,SG1-AR0143-H125,SG1-AR0143-H197 For more GMSL camera support information, please contect: helpdesk@miivii.com
Connection
Please refer to 'Interfaces'
Camera Setup
Please set up your GMSL camera in MiiVii Setting before use.
Video Output
MiiVii device offers egl_demo and opencv_demo for gmsl video output. Please refer to opt/miivii/features/gmsl_camera
Demo code13:
#Complie cp -ravf /opt/miivii/features ~/ cd ~/features/gmsl_camera make -j; #Execuate with only one camera plugged ./bin/4cameras_egl_demo -d /dev/video0 -s 1280x720 ./bin/8cameras_egl_demo -d /dev/video0 -s 1280x720 ./bin/cameras_opencv_demo -d /dev/video0 -s 1280x720 -r 25
#If you have 2 cameras plugged in port A
./bin/cameras_opencv_demo -d /dev/video0 -s 2560x720 -r 25
#If you have 4 cameras plugged in port A
./bin/cameras_opencv_demo -d /dev/video0 -s 5120x720 -r 25
Figure GMSL Output |
[13] parameters are defined by camera resolution. For <nWxH>, n is the number of connected cameras; WxH is video resolution. For instance, when two 1280x720 cameras are connected, parameters should be set at <2560x720>. When connected to different camera group, /dev/videoX should be set as /dev/video0 or /dev/video1.
MiiVii offers several demo code:
Algorithm: MiiVii device offers human, vehicle, bicycle detection. Please refer to /opt/miivii/features/algorithm
Acceleration SDK: MiiVii device provides acceleration SDK based on Yolo v3. Please refer to /opt/miivii/features/miivii-accelerator
ROS demo: MiiVii device offers ROS DEMO. Please refer to /opt/miivii/ros_demo
Among them, miivii_msgs is the message rule of ROS. miivii_gmsl is the ROS node of GMSL camer. miivii_detector is the ROS node of object detection.
Besides, MiiVii also open source part of our code in Github. Please visit https://github.com/MiiViiDynamics for more information.
Exception Handling
If bug occurs to you while developing, please check DEBUG log first:
Step 1: Find the position of DEBUG port in 'Interfaces'
Step 2: Connect DEBUG port with a PC using a UART-USB cable1
Step 3: Download Serial debugging tool in the PC, set Baud to 115200
Step 4: Check DEBUG log
[1]:According to the information in 'Interfaces', select the RS232-USB cable or TTL-USB cable。
1.Function Introduction
Miivii burning tool, suitable for Miivii series products.The tool has two main functions: burn images and clone images. You can burn the official image of Miivii power for Miivii devices using an X86 architecture PC as the burn host. After developing a Miivii device for some time, you can save your progress by cloning an existing device images and burning it to other Miiivii devices.
2.Prepare Software And Hardware
2.1. Burn The Host Ready
It is necessary to connect the writing host to the Miivii device to burn the images. The recommended figuration of the write host is as follows:
● CPU uses Intel core series processors with X86 architecture
● Memory 8GB DDR3 and above
● Spare hard disk capacity 40G and above
● The system is Ubuntu Linux X64 v16.04 or V18.04
2.2. Prepare Miivii Burn Tools And Miivii Device Images
● Low for a link: https://en.miivii.com/index.php?s=index/category/index&id=119
● Download the Miivii burn tool
● Download the Miivii device image and the image MD5 value
● Store the above files in the same path as the burn host
● Supports simultaneous burning of multiple identical devices, but does not support simultaneous burning of multiple different devices
Note: The file storage path cannot contain Chinese characters or special characters
2.3. Prepare The Hardware
● Miivii equipment and power, USB data cable
3. The Operation
3.1 Hardware Connection
● Connect the writing port of Miivii device to the writing host through USB data cable
3.2 Use of Software
3.2.1. Images Burn
● Copy the images and MD5 values to the imGS folder of the burn tool
● Go to the bin folder of the burn tool and open the Burn tool "MVflasher"
● Click [Enter upper computer password] button, enter the current burning host boot password
● In the device model on the right, select the device you want to burn and the Images version. Click the "Burn file" button to select the specific image for burn
● Click the "burn" button to enter the burn process:
● Images burning usually takes more than 15 minutes to complete. Please be patient:
3.2.2. Images Clone
● Enter the FORCE_Recovery mode of the Miivii device to be cloned according to method 3.1, and open the burn tool
● Click [Enter upper computer password] button,enter the current burning host boot password
● Click the "Clone file" button to modify the path and name of the clone file saved in the write host :
Note: The file storage path cannot contain Chinese characters or special characters
● Click the "clone" button to enter the cloning process, as shown in the figure:
● Images cloning usually takes more than 30 minutes to complete:
● Cloning completed, will generate a clone image and MD5 file, please burn again according to step 3.2.1 operation
Note: if you encounter problems in the cloning process, please contact Miivii power for help:
Attached 1. Kernel and DTB burn
Miivii device burn tool can burn system kernel and DTB separately, click [more] in the upper right corner to choose.
Note: before you do this in meters, power after confirmation: helpdesk@miivii.com
Attached 2. Self-test For Burning Problems
If you encounter burning problem, please first conduct self-test according to the following items:
● Check whether the upper computer boot password is entered in the upper left corner of the burn tool
● Check whether to enter the Recovery mode, can be identified by the lsusb command
● Check whether Micro USB cable quality is up to standard and whether it is only a dual-core cable used for charging
● Check upper computer, whether it is x86-64 architecture desktop, notebook.(Server, embedded device, virtual machine and other devices are not supported temporarily)
● Check whether the upper computer system is Linux 1604 /1804
● Check the disk format, the recommended disk format for burning hosts is EXT4
● Check whether the upper computer capacity is enough
● The Images and burn tool storage path cannot have Chinese or other special characters