Main Application - Main Application - UG1614

XRF4 RF Accessory Kit User Guide (UG1614)

Document ID
UG1614
Release Date
2025-12-02
Revision
1.3 English

The main application of the xrf4 (xrf4-startup) runs on boot-up and it starts the Python based server. When using the XRF4 with previous DFE versions (which used C based XRF4 TCP application), refer to the addendum after reading the application options in this section.

To run this application, the user must connect to the XRF4 terminal over serial (USB) and open the relevant COM port with 115200 baud. In the Linux terminal, login using PetaLinux as user and plnx as password. Due to the nature of the application, root access is requested. The user can provide plnx as password if unchanged from default.

Execute the xrf4-startup command to get the usage details.

Table 1. xrf4-startup Command
Command Syntax Description When to Execute
xrf4-startup start
This is the default command that is run by the startup script, and this starts python server on bootup. In ideal cases, this is not required for user to run.
xrf4-startup start c
This command starts C application if it's not already running. If the Python application is running, the user needs to use the 'switch' option to switch to C. When the user wants to use the XRF4 system with previous DFE systems (older to v10.1) and has stopped all applications using the stop option or applications have crashed.
xrf4-startup start py
This command starts the Python based application if it's not already running. In the event that the C application is running, the user needs to use the switch option to switch to Python. If all XRF4 applications have crashed or stopped, use the stop option to run the Python based application.
xrf4-startup stop
This command stops both C and Python based XRF4 applications. When all XRF4 applications have crashed or stopped, use the stop option to run the Python based application.
xrf4-startup restart
This command restarts the XRF4 application. When the user wants to restart the XRF4 application.
xrf4-startup switch
This command switches the XRF4 application to an alternate application. For example, if the Python based application is currently running and the user wants to run C based application, or vice versa. If the user wants to use the XRF4 system with previous DFE systems (older to v10.1) and has just rebooted/started XRF4, execute the switch option. This will start the C based application, which is compatible with previous DFE versions. This needs to be done on every XRF4 reboot. This is also useful when user is using the C application (with 10.0 and older DFE) and wants to move to a new DFE (v10.1+) version. This command can be issued to switch to python. The XRF4 can be rebooted by default Python application runs.
xrf4-startup info
This command prints which XRF4 application is currently running (C, Python, or None). When the user wants to know which XRF4 application is currently running.