HOWTO Acquire Log Information

From Variscite Wiki
HOWTO - Acquire Log Information

This HOWTO article meant to facilitate Variscite SOM integration process for the customers.
Variscite provides reference hardware (Evaluation Kit) and all software packages are fully tested with the appropriate Variscite Evaluation Kit. When customer facing some problem the root cause can be:

  • Due to the old software release (the issue can be fixed in the latest release)
  • Due to software customization introduced by customer
  • Due to hardware issues related to customer carrier design
  • Due to Variscite bug

To facilitate the root cause analysis we ask our customers to acquire terminal logs using our Evaluation Kit and latest recovery SD card.
Below summarized actions required to acquire terminal logs using latest recovery SD card.

Download the recovery SD card image

  • For VAR-SOM-MX7

Download mx7-som-recovery-sd.vXX.img.gz (latest) from Variscite's FTP server: ftp://customerv:Variscite1@ftp.variscite.com/VAR-SOM-MX7/Software/

  • For DART-6UL/ULL

Download mx6ul-dart-recovery-sd.vXX.img.gz (latest) from Variscite's FTP: ftp://customerv:Variscite1@ftp.variscite.com/DART-6UL/Software

  • For VAR-SOM-MX6, DART-MX6, VAR-SOM-SOLO

Download mx6-som-recovery-sd.vXX.img.gz (latest) from Variscite's FTP server: ftp://customerv:Variscite1@ftp.variscite.com/VAR-SOM-MX6/Software/

  • For VAR-SOM-AM43

Download am43-som-nand_recovery-sd-Yocto-*-XX (latest) from Variscite's FTP server: ftp://customerv:Variscite1@ftp.variscite.com/VAR-SOM-AM43/Software/

  • For VAR-SOM-AM33

Download am33-som-nand_recovery-sd-Yocto-*-XX (latest) from Variscite's FTP server: ftp://customerv:Variscite1@ftp.variscite.com/VAR-SOM-AM33/Software/


Write the image to an SD card

During the SD card image writing all files and partitions are erased from target device.
Double check that the device is correct to avoid accidentally overwriting a different device and potentially damaging your existing operating system.

Using a Linux based host

Plug-in the SD card to your Linux host PC, run dmesg and see which device is added (i.e. /dev/sdX or /dev/mmcblkX)

$ sudo umount /dev/sdX?*

# For  files:
$  <image name>. | sudo dd of=/dev/sdX bs=1M && sync

(Replace /dev/sdX with your actual device)

Using a Windows based host

  • Download Win32 Disk Imager from: https://sourceforge.net/projects/win32diskimager/ and install it.
  • Extract the downloaded image:
    • For extracting a .gz file the latest 7-Zip can be used, for example.
    • For extracting a .zst file the latest WinRAR can be used, for example.
  • Insert your SD card into your PC.
    No need to format the SD card before writing the image to it, as the card will be formatted once it will be flashed.
  • Run the file named Win32DiskImager.exe (in Windows 7, 8 and 10 we recommend that you right-click this file and choose “Run as administrator”). 
  • If the SD card (Device) you are using isn’t found automatically. Click on the drop down box and select it.
  • In the Image File box, choose the .img/.wic file you have extracted previously.
  • Click Write.
  • After a few minutes, you receive a notification that your SD has been created successfully.

Using a Mac OS X host

Use the dd Utility for MAC OS X to flash .img/.wic files to your SD card

Boot Evaluation Kit from SD card

Now when you have the recovery SD card follow the following steps from the relevant Evaluation Kit Quick Start Guide

  • Perform "Evaluation Kit Initial Setup"
  • Setting "the Host PC for Debug"
  • Perform "Booting from SD Card"

Below are the links to Variscite Evaluation Kits Quick Start Quides
VAR-SOM-MX6 Kits - Quick Start Guide
One of VAR-STK-MX6_V2, VAR-DVK-MX6_V2, VAR-DVK-MX6_V2-PRO
DART-MX6 Kits - Quick Start Guide
One of VAR-STK-DT6, VAR-DVK-DT6
VAR-SOM-SOLO / DUAL Evaluation Kits - Quick Start Guide
One of VAR-STK-SOLO, VAR-DVK-SOLO, VAR-STK-DUAL, VAR-DVK-DUAL
VAR-SOM-AM43 Kits - [1]
One of VAR-STK-AM43, VAR-DVK-AM43

Acquire System Logs

  • Login as root (no password)
  • From Linux command line, type: "dmesg".
  • Send to Variscite's support team the console output.