Error message

Can not get file info (nid=6472, src=xfinder_scanning_board.png)

How to use xfinder

Since Raspberry Pi has no way to know the IP address etc. in the headless state (state where monitor and keyboard are not connected), it is a bit difficult to perform initial setting. It is possible to connect the monitor and the keyboard first, set the host name and know the IP address from the host name via Avahi as described above, but this method can not be used for Raspberry Pi which is not set at all .

(G)What is xfinder

xfinder is a tool for indexing and logging IP addresses from MAC (Media Access Control) addresses of Ethernet interfaces mounted on CPU boards such as Raspberry Pi and BeagleBone.

A 48-bit unique address (MAC (Media Access Control) address) is allocated to the Ethernet interface, and its high-order 24 bits are unique addresses of vendors (companies developing network devices, etc.). In Ethernet, it is necessary to know each other's MAC address in order to transmit and receive packets, and it is possible to use a protocol called ARP (Address Resolution Protocol) to check the MAC address from the IP address. In xfinder, by finding a pattern of a specific MAC address connected on the network, it is possible to check the IP address of a headless system such as Raspberry Pi, support login by ssh etc. to facilitate setting and development I will.

Find RaspberryPi with xfinder

xfinder is an executable file which can be used as two types of command line tool (CUI mode) and graphical user interface tool (GUI mode). This section explains how to use xfinder in GUI mode.

(G)Download xfinder

You can download xfinder from the following location.

Downloaded xfinder

(G)Use xfinder (GUI mode)

How to use xfinder is the following three steps.

  • Scan the network and find Raspberry Pi etc.
  • Check the Raspberry Pi found by scanning
  • Log in with TeraTerm etc. terminal software and work


When you start xfinder.exe, the following screen will be displayed.

xfinder's GUI screen

First, designate the scanning conditions (interface, board, MAC address pattern etc.) in the upper left pane, start scanning, ② select the list of Raspberry Pi etc found by scanning the next, so select ③ In the lower left pane, specify the login conditions and start the terminal application. After the terminal application starts up, you can log in to the target Raspberry Pi and perform settings, program development and so on.

You can also start the terminal application and log in by double clicking the list of boards displayed in the right pane.

(G)Scan settings

In Scan settings in the upper left corner, set conditions for scanning the network.

(G)Interface address

Select the network interface of the current PC to search for Raspberry Pi. When there are multiple network interfaces, since multiple IP addresses are displayed, it is important to know which network (for example, one is on the global side and the other on the private side network and Raspberry Pi in the private side network If you want to find it, select a private address here) Select whether to scan.

Specify the IP address of the network interface to be scanned with Interface address

Select ALL to scan all network interfaces. If you do not know which IP address corresponds to which network interface, go to Control PanelNetwork and Internet Network and Sharing CenterChange Adapter Settings Click on the adapter icon to see what kind of IP address is assigned.

You can also open the command prompt and execute the ipconfig command to check the interface and assigned IP address.

(G)Board type

Choose which board to look for from the combo box. You can select Raspberry Pi or BeagleBone, by default Raspberry Pi is selected.

Specify board type to be scanned

If you do not have the board you want to find in this list, you need to check the 6 digits above the MAC address of the corresponding network interface and enter it in the next Match Pattern text box to scan.

If you connect Raspberry Pi with a USB wireless LAN adapter and wireless LAN only, you can not find it even if you select Raspberry Pi here. Enter the 6 digits above the MAC address of the MAC address of the wireless LAN adapter (for example, 10: 6 f: 3 f in Buffaro) in the Match Pattern and search for it.

(G)Match pattern

When looking for a board other than Raspberry Pi or BeagleBone, enter the pattern of the MAC address you want to search here.

Specify the MAC address pattern to scan

Also, even if you install a wireless LAN adapter etc. in Raspberry Pi, it is possible to search by entering 6 digits on MAC address unique to the manufacturer. However, there are times when many wireless LAN adapters etc. of major manufacturers are discovered when scanning.

(G)Scan button / Abort button

Press the Scan button to execute the scan. It can not be pressed during scanning. Press the Abort button if you want to quit while scanning is in progress. It can only be pressed during scanning. The progress bar under the button shows the progress of the scan.

Scan execution

(G)Found nodes

The Found nodes pane on the right displays the IP address, MAC address and host name of the board found by scanning.

  • IP address: Displays the IP address of the found board. If you press the header part, sort by IP address order.
  • MAC address: Displays the MAC address of the found board. If you press the header part, sort by MAC address order.
  • Host name: Displays the host name of the found board. If you press the header part, sort by host name.

If you double click on the list displayed here, you can start the terminal application and log in according to the setting of Terminal launcher on the left.

Start terminal applications directly from nodes

(G)Terminal launcher

The Terminal launcher pane on the left is used to log in to the found host using the terminal application.

  • User name: Enter the user name to use when logging in. The value is automatically entered by Board type setting of Scan setting in the upper left.
  • Password: Enter the password to use when logging in. The value is automatically entered by Board type setting of Scan setting in the upper left.
  • Port: Enter the port number to use when logging in. By default, ssh default port number 20 is set.
  • Terminal App: Terminal application to use comes from selecting from the combo box. Available terminal applications are one of TeraTerm, Poderosa, PuTTY on Windows, check if they are installed at startup, only those available are listed I will.
  • Login button: Node to log in with Found nodes on the right Select when you select it. When this button is pushed, the terminal application is started according to the setting above and you can log in to Raspberry Pi.
Board type User name Password
RaspberryPi pi raspberry
BeagleBone root (no password)

Start the terminal application by pressing the Login button

Terminal application started (TeraTerm Pro)


latest Releases

For Begginers

Windows msi(installer) package (only trying samples)


Development environment is required for RT-Component development. See download page for details.

Number of Projects


Motion editor/Dynamics simulator


Dynamics simulator


Integrated Development Platform

AIST RTC collection

RT-Components collection by AIST


Tokyo Opensource Robotics Association


Middleware for DAQ (Data Aquisition) by KEK