Getting Started

Getting Started

This guide walks through setting up the complete InfraFi system: the Linux daemon on your server, the Flipper Zero app, and (optionally) the Arduino transceiver.

---

Prerequisites

Item	Notes
Flipper Zero	Running firmware with external app support
Linux server	With IR receiver hardware (see Hardware Setup)
IR line of sight	Flipper to server IR window

---

Step 1 - Install the Linux Daemon

The daemon (infrafid) runs on the Linux server and handles receiving IR, parsing credentials, and connecting to WiFi.

Build and install:

cd daemon
make
sudo ./install.sh

install.sh will:

1. Configure the IR receiver for RC-6 and NEC protocols (writes a udev rule so it survives reboots)
2. Build the binary
3. Install and enable the infrafid systemd service

Verify it's running:

systemctl status infrafid
journalctl -u infrafid -f

See Linux Daemon for full configuration options.

---

Step 2 - Install the Flipper App

Build from source (requires ufbt):

# From the project root
ufbt

This produces a .fap file. Copy it to your Flipper via qFlipper or the SD card.

Install location on Flipper:

SD:/apps/Infrared/infrafi.fap

The app appears under Apps > Infrared on the Flipper menu.

---

Step 3 - (Optional) Arduino Transceiver

If your server has no built-in CIR receiver, you can use an Arduino Pro Micro as a USB IR transceiver bridge. See Arduino Firmware for wiring and flashing instructions.

Once flashed and connected, start the daemon with the serial flag:

sudo infrafid -s /dev/ttyACM0 -f -v

---

Step 4 - First Transmission

1. Open InfraFi on your Flipper Zero.
2. Select New Credentials from the main menu.
3. Enter your WiFi SSID, password, and security type.
4. Point the Flipper IR port at the server and press Transmit.
5. Watch the daemon logs:

infrafid: received credentials: WIFI:T:WPA;S:MyNetwork;P:mypassword;H:false;;
infrafid: parsed: SSID=MyNetwork, security=1, hidden=0
infrafid: successfully connected to MyNetwork

---

Step 5 - Enable ACK (Optional)

The ACK feature sends a confirmation IR signal back from the server to the Flipper after a connection attempt. This requires IR TX hardware on the server side.

On the Flipper, go to Settings and set Wait for ACK to On.

On the server, if using a separate LIRC TX device:

sudo infrafid -d /dev/lirc0 -a /dev/lirc1 -f -v

If using the Arduino (which handles both RX and TX through the same serial connection):

sudo infrafid -s /dev/ttyACM0 -f -v

The Flipper will display the result: Connected: 192.168.1.x or Failed.

---

Typical Deployment Topologies

Intel NUC with ITE8708 CIR (no TX emitter):

sudo infrafid -f -v          # RX only, ACK disabled

Intel NUC + USB IR blaster for ACK TX:

sudo infrafid -d /dev/lirc0 -a /dev/lirc1 -f -v

Arduino Pro Micro (RX + TX via USB serial):

sudo infrafid -s /dev/ttyACM0 -f -v

Squeezebox Touch or similar evdev device:

sudo infrafid -e /dev/input/event1 -f -v