Skip to content

Commit 125cbfe

Browse files
authored
Merge pull request #894 from luxonis/standalone_update
Update standalone mode docs
2 parents 5c65953 + e7c7027 commit 125cbfe

File tree

1 file changed

+25
-4
lines changed

1 file changed

+25
-4
lines changed

docs/source/tutorials/standalone_mode.rst

Lines changed: 25 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,33 @@
11
Standalone mode
22
===============
33

4-
**Standalone / Hostless / On-The-Edge mode** means that the OAK camera isn't connected to a host computer. This can
5-
be achieved by first :ref:`flashing the bootloader <Flash the bootloader>` and then :ref:`flashing the pipeline <Flash the pipeline>`
6-
and assets (NN models) to the OAK's flash memory.
4+
**Standalone / Hostless / On-The-Edge mode** means that the camera starts the (:ref:`flashed <Flash the pipeline>`) application as soon as it gets power, without being connected to any particular host computer.
5+
This is useful for applications where camera is stationary and just inspecting the world and providing analytics (eg. people/vehicle counting, LPR, fall detection, etc.)
6+
7+
Usually, this mode is also more robust to any instabilities (eg. networking issues, where connection between camera and host computer would drop), as application will restart automatically.
78

89
Standalone mode is **only possible on OAKs that have on-board flash** memory, which are currently
910
`OAK POE <https://docs.luxonis.com/projects/hardware/en/latest/#poe-designs>`__ and OAK IOT camera models.
1011

12+
**Scenarios** when standalone mode is particularly useful:
13+
14+
- People/vehicle/object tracking and counting (People counting `demo here <https://github.com/luxonis/depthai-experiments/tree/master/gen2-people-tracker>`__). Each camera can do its own counting (inside Script node), and only send final count (eg. every hour) to some server via MQTT/HTTP.
15+
- License Plate Recognition (LPR) camera (`demo here <https://github.com/luxonis/depthai-experiments/tree/master/gen2-license-plate-recognition>`__). Each camera does vehicle detection, license plate detection and LPR, and only reports license plate (in string) to a server.
16+
- Fall detection for elderly people (`demo here <https://www.youtube.com/watch?v=npiG-Dy7yQ4>`__). Each camera tracks people and checks their poses for any anomalies (eg. person falling down). If anomaly is detected, it sends an alert to a server.
17+
18+
In case you already have a computer on-board (eg. a robot/drone), standalone mode isn't as useful, and just adds extra complexity.
19+
20+
Communication with the camera
21+
#############################
22+
23+
To "communicate" with the outside world (eg. a server), POE cameras can use :ref:`Script` node to send/receive networking packets (HTTP/TCP/UDP...). Here are a few examples:
24+
25+
- `TCP streaming <https://github.com/luxonis/depthai-experiments/tree/master/gen2-poe-tcp-streaming>`__ (camera being either server or client)
26+
- `HTTP server <https://docs.luxonis.com/projects/api/en/latest/samples/Script/script_mjpeg_server/#script-mjpeg-server>`__
27+
- `HTTP client <https://docs.luxonis.com/projects/api/en/latest/samples/Script/script_http_client/>`__
28+
- `MQTT client <https://github.com/luxonis/depthai-experiments/tree/master/gen2-poe-mqtt>`__
29+
30+
1131
Converting a demo to standalone mode
1232
####################################
1333

@@ -37,8 +57,9 @@ or script node, as mentioned above.
3757
Flash the bootloader
3858
####################
3959

60+
To run the application on the camera, a `Bootloader` is required. Note that bootloader is already flashed on all POE cameras, as it's also required for network booting.
4061
The :ref:`Bootloader` is packaged together with the depthai, so if you have the latest depthai version, you can flash the
41-
latest bootloader version. To flash the bootloader, we suggest using the :ref:`Device Manager`. To view the API code behind
62+
latest bootloader version. To flash the latest bootloader, we suggest using the :ref:`Device Manager`. To view the API code behind
4263
it, see :ref:`Flash Bootloader` example code.
4364

4465
Flash the pipeline

0 commit comments

Comments
 (0)