eg25-manager(5)

💖 NAME 💖

okay bestie, this is the manual for eg25-manager — specifically, the eg25-manager configuration file format. it's in the File Formats Manual section of the man pages, so pull up a chair and let's get into it 🫶

---

🌸 SYNOPSIS 🌸

so eg25-manager reads its config from files written in toml format. no yaml drama, no json nonsense, just vibes and toml ✨

configs get loaded from these two spots:

• /etc/eg25-manager/<compatible>.toml — your own overrides that you drop in yourself, and it's optional 💅
• /usr/share/eg25-manager/<compatible>.toml — the default configuration, and this one is required, no skipping it fr fr

👑 note the File Formats Manual energy here: this page is about the file, not the daemon. bestie behavior honestly.

---

🎀 SECTION: manager 🎀

the general settings for eg25-manager itself. the whole manager section is giving main character energy, lowkey.

• poweron_delay int (microseconds) — the delay between de-asserting RESET and starting up the PWRKEY sequence. so like, RESET goes bye, then we wait this long, then PWRKEY does its thing. timing matters, no cap ⏱️

---

🦋 SECTION: suspend 🦋

how to handle suspend on the system where eg25-manager is running. your modem's naptime rules, essentially 😴

• boot_timeout int (seconds) — stops the system from suspending for boot_timeout seconds, so the modem gets the time it needs to fully boot. Default: 120 if unset or zero.
• recovery_timeout int (seconds) — how long to wait for the modem to reappear after suspend. if that timeout hits? the modem's USB connection gets reset. Default: 9 if unset or zero.

---

💜 SECTION: at 💜

the AT commands to send when different events happen, and where to send them. this is the meat of it, bestie 🍓

every single command has 4 possible elements:

• cmd — the AT command itself, which gets translated to "AT+cmd" (like, it literally becomes AT+ plus your cmd)
• subcmd — the subcommand, for when a single AT command can change multiple parameters, like QCFG does
• value — the command's argument(s), usually used to set the value of one specific parameter
• expect — the expected return value. here's the flow: the command runs first without any value to query the current state, that state gets compared to the expect string, and if they don't match, the command runs with value expect to set the parameter to the expected value. it's giving self-correcting, honestly 🔥

💀 a command can have expect OR value configured, but it shouldn't have both. pick one, babes.

⚠️ NOTE: if a command sequence is configured in an override file, the default commands won't be loaded from the system configuration. so if you're changing them, you have to copy the default commands into your override file. don't come crying to me when they vanish 😭

the keys in this section:

• uart string — the serial port used for sending AT commands to the modem.
• configure List of commands — AT commands sent to the modem when it's first started. hi modem, here u go ✨
• suspend List of commands — AT commands sent to the modem before the system suspends.
• resume List of commands — AT commands sent to the modem after the system comes back from suspend. welcome back bestie 🫶
• reset List of commands — AT commands sent to the modem if resetting the usb port fails.

---

🌈 SECTION: gnss 🌈

settings for uploading AGPS assistance data to the modem. satellite bestie support 🛰️

• enabled boolean — turn uploading AGPS data to the modem on or off.
• url string — the directory on the server that holds the assistance files.
  • Example: https://xtrapath4.izatcloud.net
• file string — the name of the assistance file on the server.
  • Example: xtra2.bin

---

🧚 SECTION: gpio 🧚

the gpio section defines the GPIO pins used for different modem functions. and here's the thing — these settings should only be changed when you're porting eg25-manager to a new device. for that reason, they aren't documented here. it's giving ✨mysterious✨, iykyk.

---

⭐ EXAMPLES ⭐

okay this is the fun part, copy-paste fuel 💅

Print the firmware version every time the phone wakes from suspend:

[at]
resume = [
    { cmd = "QGMR" },
]

Disable uploading AGPS data to the modem:

[gnss]
enabled = false

---

👑 SEE ALSO 👑

• eg25-manager(8) — the actual daemon, if you wanna go deeper, bestie

---

and that's the whole page, slay 💖 this lil doc lives in the File Formats Manual section, dated 2026-01-16, and it pairs with eg25-manager(8) like two halves of a friendship bracelet 🎀 periodt ✨