Mason Docs

Use ADB to collect logs from your Mason developer kit

At times you may need to collect debug logs from your Mason device. This can be done locally on your machine using adb.

This guide will walk you through physically connecting to your Mason device, and collecting logs using adb.

Looking for a way to remotely debug your device? Visit our Mason X-Ray guide

Prerequisites

Steps

  1. To use adb with a Mason device connected over USB, you must enable USB debugging in the device system settings, under Developer options. The Developer options screen is hidden by default. To make it visible, go to Settings > About phone and tap Build number 7 times or until you see a prompt ("toast") that says You're now a developer!

  2. Then press the Back button until you exit the Settings app completely (or swipe right on it via the Recents menu to close it)

  3. Re-enter Settings, and scroll down to Developer options

  4. Turn on USB debugging

  5. Connect your device to your computer via USB. If prompted, check the box to always allow access to the device from the computer it is connected to.

  6. Open a terminal window (on MacOS or Linux) or a Command prompt (on Windows), and navigate to the directory from step 1 above. The adb tool can be found under the platform-tools/ sub directory.

  7. To collect logs, enter adb logcat -v threadtime > logs01.txt. This will start collecting logs to the named file.

  8. Run through the scenario on the device.

  9. Press Ctrl-C in the terminal or command window from step 8 to exit adb

  10. Send the file logs01.txt or whatever you named it to Mason Support

Support

Next steps