Skip to content

Commit 27104a0

Browse files
authored
Merge pull request #824 from luxonis/crash_report_docs
Added crash report docs
2 parents da2b14f + 890076a commit 27104a0

File tree

2 files changed

+55
-0
lines changed

2 files changed

+55
-0
lines changed
Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,50 @@
1+
Crash report
2+
============
3+
4+
In case of a firmware crash, OAK cameras will automatically generate a crash report and store it in the device.
5+
The crash report contains information about the crash, such as the stack trace, the device's configuration,
6+
and the device's state at the time of the crash. The crash report can be read from the device and sent to Luxonis for debugging purposes.
7+
8+
9+
Demo
10+
####
11+
12+
In case a crash report was found on the device, this example will read it and save it to a json file:
13+
14+
.. code-block:: bash
15+
16+
> python crash_report.py
17+
Crash dump found on your device!
18+
Saved to crashDump_0_184430102163DB0F00_3575b77f20e796b4e79953bf3d2ba22f0416ee8b.json
19+
Please report to developers!
20+
21+
Please **send the crash reports** together `with an MRE <https://docs.luxonis.com/en/latest/pages/support/#depthai-issue>`__ (DepthAI issue)
22+
to our `Discuss Forum <https://discuss.luxonis.com/>`__. Thank you!
23+
24+
Setup
25+
#####
26+
27+
.. include:: /includes/install_from_pypi.rst
28+
29+
Source code
30+
###########
31+
32+
.. tabs::
33+
34+
.. tab:: Python
35+
36+
Also `available on GitHub <https://github.com/luxonis/depthai-python/blob/main/examples/CrashReport/crash_report.py>`__
37+
38+
.. literalinclude:: ../../../../examples/CrashReport/crash_report.py
39+
:language: python
40+
:linenos:
41+
42+
.. tab:: C++
43+
44+
Also `available on GitHub <https://github.com/luxonis/depthai-core/blob/main/examples/CrashReport/crash_report.cpp>`__
45+
46+
.. literalinclude:: ../../../../depthai-core/examples/CrashReport/crash_report.cpp
47+
:language: cpp
48+
:linenos:
49+
50+
.. include:: /includes/footer-short.rst

docs/source/tutorials/code_samples.rst

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,7 @@ Code Samples
88
../samples/bootloader/*
99
../samples/calibration/*
1010
../samples/ColorCamera/*
11+
../samples/crash_report/*
1112
../samples/EdgeDetector/*
1213
../samples/FeatureTracker/*
1314
../samples/host_side/*
@@ -51,6 +52,10 @@ are presented with code.
5152
- :ref:`RGB scene` - Shows how to select ColorCamera's scene and effect
5253
- :ref:`RGB video` - Displays high resolution frames of the RGB camera
5354

55+
.. rubric:: Crash report
56+
57+
- :ref:`Crash report` - In case of a firmware crash, example reads it from the device and saves it to a json file
58+
5459
.. rubric:: EdgeDetector
5560

5661
- :ref:`Edge Detector` - Performs edge detection on all camera streams

0 commit comments

Comments
 (0)