Skip to content

Commit f1bea86

Browse files
committed
Add "Tips & Tricks" page
1 parent cf911df commit f1bea86

File tree

2 files changed

+33
-2
lines changed

2 files changed

+33
-2
lines changed

content/docs/_index.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,8 @@ Welcome to the Syntalos documentation!
88
## Explore
99

1010
{{< cards >}}
11-
{{< card link="setup/install/" title="Install Syntalos" icon="download" >}}
12-
{{< card link="intro/" title="Introduction" icon="newspaper" >}}
11+
{{< card link="setup/install" title="Install Syntalos" icon="download" >}}
12+
{{< card link="intro" title="Introduction" icon="newspaper" >}}
1313
{{< card link="modules/" title="Modules" icon="view-grid" >}}
14+
{{< card link="tips-tricks" title="Tips & Tricks" icon="light-bulb" >}}
1415
{{< /cards >}}

content/docs/tips-tricks.md

Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
---
2+
title: Tips & Tricks
3+
prev: intro
4+
next: modules/_index
5+
---
6+
7+
This page contains semi-random tips and tricks that came up while using Syntalos and that other
8+
experimenters may run into, but that do not necessarily warrant their own page.
9+
10+
### USB hardware fails / is slow if I plug in many USB devices
11+
12+
This is a very common issue especially if you are using many USB cameras simultaneously.
13+
For cameras specifically, you can try switching to a different mode of connection,
14+
for example using them via ethernet if the camera support GigE.
15+
16+
If you *need* to use USB, the cause of the issues is usually that multiple USB ports share the same USB
17+
controller on commodity hardware. This means that despite multiple USB ports being available,
18+
the potential maximum bandwidth (and sometimes even power) is split between them.
19+
Syntalos can visualize which USB controllers your devices are connected to, so you can
20+
redistribute them to ports where controllers are not shared. Click on *Diagnostics → USB Devices*
21+
to get a list (and even more detailed information if USBView is installed).
22+
23+
If this does not help, and your problem is power, a powered USB hub can help in some rare
24+
cases. If that is not the problem or does not help, adding a USB expansion card always solved
25+
the issue so far.
26+
Ideally, buy a card which has dedicated controllers for each USB port - those are a lot more
27+
expensive than regular USB expansion cards, but are worth the money for scientific applications.
28+
29+
We had very good experience with the [StarTech.com 4-Port USB PCIe Card with 4X Independent USB Controllers](https://www.amazon.com/dp/B0DCKC11JM)
30+
card (link points to its Amazon page).

0 commit comments

Comments
 (0)