Findsensor tool

Overview

Tool to find Fixposition sensors on the local (ethernet) network.

See Fixposition SDK: Build and installation on how to build and run this app, or Fixposition SDK: Running pre-built apps on how to run it using pre-built Docker images.

Command line help

findsensor (fpsdk: release, no ROS, 0.0.0-heads/main-0-gbd34a92)
Copyright (c) Fixposition AG (www.fixposition.com) and contributors
License: see the LICENSE files included in the source distribution
 
Tool to find Fixposition sensors on the local (ethernet) network
 
Usage:
 
    findsensor [flags]
 
Where:
 
    -h, --help     -- Print program help screen, and exit
    -V, --version  -- Print program, version and license information, and exit
    -v, --verbose  -- Increase logging verbosity, multiple flags accumulate
    -q, --quiet    -- Decrease logging verbosity, multiple flags accumulate
    -J, --journal  -- Use systemd journal logging markers instead of colours (default: auto)
    -p <port>, --port <port>  -- Port number to use (default: 8952)
    -a <addr>, --addr <addr>  -- Multicast address to use (default: 239.255.89.52)
    -u <uid>, --uid <uid>     -- Look for a particular sensor (default: report all found sensors)
    -t <dur>, --timeout <dur> -- Timeout waiting for response [s] (default: 1.5)
    -T <ttl>, --ttl <ttl>     -- TTL (hops) to use for sent UDP packets (default: 32)
    -j, --json                -- Output JSON object response (to stdout, one line per response)
 
Notes:
 
    - The sensor discovery functionality is not available for all Fixposition sensors and/or
      software versions
    - The sensor discovery uses IPv4 UDP multicast (to 239.255.89.52:8952). As such the functionality
      is subject to your local network setup and your system configuration (router and network
      configuration, firewall configuration, etc.).
 
Examples:
 
    Look for any sensor in the network and print the information about the found sensors:
 
        $ findsensor
 
        Querying (timeout 1.5s) ...
        Found fp-6d9d2c (VRTK2_STK)
            - Interface eth0
                - Address 172.22.1.60/20
            - Interface wlan0
                - Address 192.168.43.156/24
            - Interface wlan1
                - Address 10.0.1.1/24
        Found fp-fe771e (VRTK2_STK_P)
            - Interface eth0
                - Address 172.22.1.17/20
            - Interface wlan1
                - Address 10.0.1.1/24
        Found xf-a0d2d8 (EAGLE_PBXA1)
            - Interface eth0
                - Address 172.22.1.18/20
            - Interface usb0
                - Address 10.0.3.1/24
        Found 3 sensors
 
    Quietly look for a particular sensor and print the information as JSON:
 
        $ findsensor --quiet --uid xf-a0d2d8 --json
 
        {"ifs":{"eth0":["172.22.1.60/20"],"wlan0":["192.168.43.156/24"],"wlan1":["10.0.1.1/24"]},\
         "props":{"product_model":"VRTK2_STK"},"uid":"fp-6d9d2c"}
        ...
 
    Find all "fp" sensors and print their UID and first eth0 address:
 
        $ findsensor --quiet --json | jq -r 'select(.uid|startswith("xf-")) | .uid +  + .ifs.eth0[0]'
 
        fp-6d9d2c 172.22.1.60/20
        fp-fe771e 172.22.1.17/20