FAQ
- “No AUTD3 devices found” is displayed
- “One or more slaves are not responding” or “Slow network was detected” is displayed
- Frequent transmission failures when using
link::SOEM
- Frequent link disconnections
- Errors when using
RemoteTwinCAT
link - How to access transducer phase/amplitude data?
- How to access AM modulation data?
- Others
“No AUTD3 devices found” is displayed
-
When using
link::SOEM
on macOS or Linux, root privileges are required.-
On Linux, this can be avoided by setting the following permissions with the
setcap
command:sudo setcap cap_net_raw,cap_net_admin=eip <your executable file>
-
On macOS, this can be avoided by adding read permissions to the
/dev/bpf*
files:sudo chmod +r /dev/bpf*
-
-
(Windows) Use the latest npcap.
-
Virtual machines like WSL are not supported.
- It may work on VirtualBox, but the behavior is unstable.
“One or more slaves are not responding” or “Slow network was detected” is displayed
-
Update the driver.
- If using Realtek on Windows, install the driver labeled
Win10 Auto Installation Program (NDIS)
from the official site (also for Windows 11).
- If using Realtek on Windows, install the driver labeled
-
(Windows) Use the latest npcap.
-
Increase the values of
send_cycle
andsync0_cycle
. -
(Windows) From the properties of the relevant network adapter in Device Manager, uncheck “Allow the computer to turn off this device to save power” in the “Power Management” tab.
Frequent transmission failures when using link::SOEM
-
This issue occurs when:
sync_mode
is set toDC
and,
- The onboard ethernet interface is used
and, it has been confirmed to occur in the following situations:
- Using RealSense, Azure Kinect, Web cameras, etc.
- Generally occurs when the camera is activated.
- Playing videos or audio
- Or opening video sites (like YouTube) in an internet browser.
- Using Unity
- Occurs just by launching it.
- Playing animations in Blender
- Other operations (like modeling) are fine.
-
To avoid this issue, try one of the following:
- Set
sync_mode
toFreeRun
. - Use Linux or macOS.
- However, virtual machines are not acceptable.
- Use
TwinCAT
,RemoteTwinCAT
, orRemoteSOEM
links. - Use a USB to Ethernet adapter.
- It has been confirmed to work properly with at least the “ASIX AX88179” chip.
- Note that this issue can occur with PCIe-connected ethernet adapters as well, not just onboard ones.
- Set
-
If this issue occurs in situations other than those listed above, or if it does not occur in the listed situations, please actively report it on GitHub Issues.
Frequent link disconnections
- If this frequently occurs when outputting ultrasound, check if the power supply is sufficient.
- Each device can consume up to 50W.
Errors when using RemoteTwinCAT
link
- It may be blocked by the firewall, so either disable the firewall or open TCP/UDP port 48898.
- Disconnect all LAN connections other than the server on the client PC.
How to access transducer phase/amplitude data?
- Create your desired
Gain
. Refer to Creating Custom Gain.
How to access AM modulation data?
- Create your desired
Modulation
. Refer to Creating Custom Modulation.
Others
- Feel free to ask questions or report bugs on GitHub Issues.