Files
2026-11-19 16:51:20 +03:00

25 KiB
Raw Permalink Blame History

SIM800

Drives a SIM800 GSM module from the Flipper over the GPIO UART: voice calls, SMS, a phonebook, and the module's own network, inbox, USSD, DTMF, audio and power commands.

App location: Apps → GPIO → SIM800.

Wiring

Flipper pin SIM800L pin Note
11 or 18 GND GND also tie the module supply ground here
13 TX RXD default UART (USART)
14 RX TXD default UART (USART)
— VCC 3.4–4.4 V, see Powering below

If you switch the app to LPUART in Settings, use pin 15 for TX and pin 16 for RX instead.

The Flipper 3V3 pin is the wrong voltage for a bare SIM800L, not too weak. Pin 9 is rated 1.2 A, which is plenty — but the modem's VBAT minimum is 3.4 V, so at 3.3 V it never starts. See Powering below for what to use instead.

A 2G SIM is required. Insert it before powering the module, and disable the SIM PIN on a phone first — the app does not enter one.

Which board do you have?

SIM800C and SIM800L are the same modem to this app. Same AT command set, so every screen works identically on both and there is nothing to configure. What differs is the board around the modem, and only one question matters:

Your board Supply
Has a regulator (SIM800L V2.0, SIM800C HAT, most SIM800C breakouts) Flipper pin 1, direct
Bare module (SIM800L core board, bare SIM800C) ~4 V — drop pin 1 with diodes, or use a LiPo

A regulator is the big 8-pin chip plus inductor/caps near the power input, and the board will be labelled with a wide input range (5V, or 5-20V). No regulator means the supply pin goes almost straight to the modem's VBAT.

One caveat for SIM800C: SIMCom's hardware design gives VBAT as 3.4–4.4 V, but some vendor sheets for SIM800C boards print a narrower 3.6–4.2 V. Aim for 4.0 V and both are satisfied.

Bare module, no regulator (SIM800L core board, ~25 x 23 mm)

Pins are labelled NET VCC RST RXD TXD GND along one edge and GND MIC+ MIC- SPK+ SPK- DTR RING along the other. NET is the antenna pad, not a signal.

Flipper pin Board pin Note
11 or 18 GND GND share with the supply ground
13 TX RXD through a divider, see below
14 RX TXD direct
— VCC 3.4–4.4 V external only, 4.0 V is ideal
— NET antenna

This board has no regulator and no level shifter. Two things follow:

  • VCC is 3.4–4.4 V. 5 V kills it and the Flipper's 3.3 V is under the 3.4 V minimum, so it will not start. Feed it from a LiPo cell or a 4 V supply, and see Powering below for the capacitor it needs.

  • Its logic sits in a 2.8 V domain (VDD_EXT). The module's TXD reads fine on the Flipper, but the Flipper's 3.3 V TX is mildly over spec on the module's RXD — VIH max is about 3.1 V. Three ways to wire it, loosest first:

    Wiring TX level Notes
    Direct 3.3 V over spec, what most people run, works
    1 kΩ series 3.3 V clamp current-limited, good middle ground
    1 kΩ + 2.2 kΩ to GND 2.27 V in spec, but only ~0.3 V over VIH min

    Start direct. The divider lands close enough to the module's VIH min (~1.96 V) that tolerances can push it under, and it is simply wrong for a board that already level-shifts — there the 2.2 kΩ to GND fights the board's own driver. Only the Flipper's TX ever needs this; the module's TXD into Flipper RX never needs a resistor.

Large red board with regulator (SIM800L V2.0, ~40 x 28 mm)

Labelled SIM800L V2.0 on the silkscreen, with a voltage regulator and an on-board antenna connector. Pins are named 5V, VDD, GND, SIM_TXD, SIM_RXD, RST plus an audio header.

Flipper pin Board pin Note
11 or 18 GND GND share with the supply ground
13 TX SIM_RXD direct, the board shifts levels
14 RX SIM_TXD direct
— 5V 5 V — Flipper pin 1 works, see Powering

No divider is needed here — the board handles 3.3 V and 5 V logic, and the regulator makes the 4 V rail the modem wants from the 5 V input.

Everything together, bare module

FLIPPER                                   SIM800C / SIM800L (bare)

pin 1  5V --[1N5401]--[1N5401]--+---------  VCC   3.8-4.1 V
                                |
                            +  ===  4700uF low-ESR
                                |
pin 11 GND ---------------------+---------  GND

pin 13 TX --[ 1k ]--+---------------------  RXD
                    |
                 [ 2.2k ]
                    |
                   GND

pin 14 RX -------------------------------- TXD

pin 4  PA4 -[ 1k ]------------------------  BOOT / PWRKEY

A regulated board needs none of it: pin 1 to 5V, pin 13 to SIM_RXD, pin 14 to SIM_TXD, GND to GND. Most SIM800C breakouts are this kind of board; some, like the Waveshare SIM800C HAT, have a level-translator jumper for 3.3 V or 5 V logic — leave it on 3.3 V for the Flipper.

Powering

The "2 A" everyone quotes is a burst, not a load: 577 µs of transmit every 4.615 ms, so 12.5% duty. What a supply actually has to hold is the average, and SIMCom gives that per power-control level — about 250 mA on a voice call at full transmit power, down to ~110 mA with good signal. The burst comes out of a capacitor at the module, not out of the supply.

Size the capacitor, not the supply. One burst moves 2 A x 577 µs = 1.15 mC. With the supply holding the 250 mA average, the cap covers about 1.0 mC, so for SIMCom's 350 mV droop limit:

C = 1.0 mC / 0.35 V = ~2900 uF

Use 2200–4700 µF of low-ESR electrolytic right at the VCC/GND pads. The 1000 µF figure that circulates gives roughly 1 V of droop, which from 4.0 V lands on the module's 3.0 V absolute floor — it survives on a full cell and resets on a half-empty one.

From the Flipper 5V pin

The app switches pin 1 on by itself. On launch it requests the 5 V rail through the Power service and retries up to five times with a delay between tries, because a few thousand microfarads of bulk capacitance browns the boost converter out on inrush and a single request loses that race. It drops the rail again on exit — unless something else already had 5 V requested when the app started, in which case it leaves it alone.

It also parks pin 7 low on launch. That pin keys the power amp on an external CC1101 module, and a SubGHz session that ended badly can leave it high; low is RX, amp off. The pin returns to high-impedance when the app exits.

Pin 1 is rated 1.2 A, and this firmware sets the charger's boost limit to 1.4 A (BOOST_LIM = BoostLim_1400) with a fault shutdown if it trips. A V2.0 board at full transmit pulls ~250 mA at 4.1 V through its own regulator, so about 240 mA off pin 1 — five times inside the limit. This works, it is not just a bench trick.

Two things to get right:

  • Plug the module in with the Flipper powered off. Flipper's own docs say to connect large capacitive loads only when the device is off — the inrush charging your bulk cap is what trips the boost, not the transmit burst.
  • Expect the battery cost: ~1.2 W continuous on a call is a couple of hours off a full Flipper.

Never put pin 1 straight on a bare module. 5 V is over the 4.4 V VBAT maximum and will kill it. Drop it first.

Dropping 5 V to 4 V without a regulator

Two silicon rectifiers in series, pin 1 → diode → diode → bulk cap → VBAT. This works for one reason: the cap supplies the transmit burst, so the diodes only ever carry the average current, and their forward drop stays in a narrow band.

                      1N5401  1N5401
Flipper pin 1 (5V) -----|>|-----|>|-----+------ module VCC   (~4.0 V)
                                        |
                                      __|__  + side  <- plus goes HERE, not to 5 V
                                      _____  electrolytic, 2200-4700uF
                                        |    - side
Flipper pin 11/18 (GND) ----------------+------ module GND

The stripe on the can marks the minus lead, and it is the shorter one. Minus to GND, plus to the module's VCC pad. Backwards, an electrolytic heats up and vents.

Pick the rating by the drop you need across the real current range — ~20 mA registered and idle, 110–250 mA on a call:

Diodes At 20 mA At 250 mA Verdict
2x 1N4001 (1 A) ~3.8 V ~3.44 V too low on a call, no margin
1x 1N5401 (3 A) ~4.55 V ~4.4 V over the 4.4 V max at idle
2x 1N5401 (3 A) ~4.1 V ~3.8 V inside spec at both ends

So: two 3 A silicon rectifiers — 1N5401, 1N5404 and 1N5408 are all the same body and all work. The 3 A rating also means the diodes survive a 2 A burst if your cap turns out undersized.

Diodes are not interchangeable. Small signal diodes (1N4148 and friends) drop far more than a 3 A rectifier at the same current — two of them can cost you 1.8 V and land VBAT near 3.2 V, under the 3.4 V minimum and a hair above the 3.0 V shutdown. The module then runs fine until it first transmits at full power and dies during network search. If two diodes put you under 3.6 V, use one, and check the idle reading has not gone over 4.4 V.

Choosing the capacitor

Two numbers decide it, and the 350 mV droop budget has to cover both:

  • Capacitance — the charge droop. 1.0 mC / C, so 4700 µF gives 210 mV, 2200 µF gives 450 mV.
  • ESR — an instant step the moment the burst starts, 1.75 A x ESR. A general-purpose can at 0.1 Ω costs you 175 mV on its own, which alone eats half the budget.

So reach for low-ESR, not just big. Best cheap answer: two 2200 µF low-ESR in parallel — 4400 µF of capacitance and half the ESR, about 230 mV total. One 4700 µF low-ESR is equally fine.

Rate it 10 V or 16 V, not 6.3 V. It only sees 4 V, but electrolytics lose capacitance as they age and a 2-3x voltage rating is what makes them last. Mount it right at the module's VCC/GND pads and add a 100 nF ceramic beside it if you have one.

Four things that bite:

  1. Measure VBAT at both ends of the load range. Those table figures are typical curve values, not datasheet guarantees. Status → Power reads it out of the module's own ADC (AT+CBC), so no multimeter is needed: idle must stay under 4.4 V, and under load it must stay above 3.4 V. Anything near 3.2 V will power the module off the moment it transmits.
  2. Check your board for diodes already fitted. Some bare boards ship with two in series on the supply pin. Add two more and you brown out.
  3. Never use a resistor divider. It is not a voltage source — the drop moves with the load, so a transmit burst collapses it. Diodes hold roughly the same drop across two decades of current; resistors do not.
  4. The cap goes after the diodes. On the 5 V side it is useless — the diodes would be left passing the full burst, which is the thing you are trying to avoid.

A single LiPo cell (3.7 V nominal, 4.2 V full) needs no dropper at all and is the easier answer if you are not tied to the Flipper's rail.

From a separate supply

A LiPo cell, a 4 V bench supply or a dedicated buck converter, with the bulk cap above. Tie its ground to a Flipper GND pin so both sides share a reference.

Settings

  • UART — USART (pins 13/14) or LPUART (pins 15/16).
  • Baud — must match the module, from 1200 to 230400. The default is 2400, which is what SIM800C boards are shipping fixed at; plenty of other modules are on 115200 or autobaud. If you do not know it, use Advanced → Detect baud rather than guessing.
  • PWRKEY pin — which pin pulses BOOT/PWRKEY to start a module that does not auto-start. Off by default. See Bring-up without a SIM below.
  • Notify — green LED and a beep when an action finishes, red when it fails, and the ring on an incoming call: four notes, a short buzz over the first two and one backlight nudge, repeated every two seconds while it rings. No screen flashing. Nothing else makes a sound.
  • Echo — leaves the module's command echo on so the AT terminal shows what was sent.

Settings are saved to apps_data/sim800/sim800.conf and loaded on start. Changing the UART or the baud rate reopens the port once, as you leave the screen, and reports whether the module answered — the screen itself never stalls while you scroll through the values.

If the Status screen says No module on the UART, check the baud rate first, then the wiring, then the module's power supply.

At launch

Three things happen before the menu is usable:

  1. The 5 V rail is switched on and pin 7 is parked low, as described under Powering.
  2. The port opens and syncs. A Connecting screen shows the rate and a progress bar while the app sends AT a few times, sets text-mode SMS and caller ID, and reads the carrier and signal once so later screens open with them already filled in.
  3. PWRKEY is pulsed if nothing answers and a pin is assigned, then the sync is retried.

The screen clears itself either way, and nothing is blocked while it runs.

The module also reports its own brownouts. When it sends UNDER-VOLTAGE the app beeps once and Status → Power shows the voltage with LOW! after it for the rest of the session. That is the module telling you the supply is sagging, and it is the usual reason a call drops or the carrier disappears mid-session.

Nothing on the UART

Work down this list; each step rules out a whole half of the problem.

  1. Loopback the Flipper. Short pin 13 to pin 14 with nothing else attached, open Advanced → AT terminal and send anything. Text coming back means the Flipper side and your Settings are right, so the fault is the wiring or the module. Nothing coming back means Settings → UART does not match the pins you are on (USART is 13/14, LPUART is 15/16).
  2. Check TX/RX are not swapped. Flipper 13 TX → module RXD, Flipper 14 RX → module TXD.
  3. Take the TX divider off and wire pin 13 straight to RXD. 3.3 V into the module's RXD is over spec but works; a divider that is slightly off does not.
  4. Run Advanced → Detect baud. It tries every rate from 1200 to 230400 and saves the one that answers. A module fixed with AT+IPR keeps whatever rate it was given, and that can be as low as 2400 — guessing from the usual 115200 will never find it.
  5. Check ground is shared between the Flipper, the module and its supply.

Once it answers, Advanced → Power & reset → Store settings writes the working rate into the module so it comes back the same way.

Bring-up without a SIM

Leave the SIM out for the first power-up. The module boots and answers AT commands with no card in it, so you can prove the wiring, the baud rate and the supply before anything else is in play. Status will show SIM: No SIM, carrier --, Not registered and no signal bars — that is the correct reading with no card, not a fault.

Two rows still tell you what you need:

  • Device info fills in Maker, Model, Firmware and IMEI. If those read back, your TX/RX pair and baud rate are right. (ICCID and IMSI show --; they live on the card.)
  • Status → Power is AT+CBC, the module reporting VBAT from its own ADC at its own pads. On a bare module that is a direct readout of what your diode dropper delivers — 3.8–4.1 V is what you want. On a regulated board it reads after the regulator and always shows ~4 V, so it says nothing about the input there.

Insert the SIM with the module powered down, and disable its PIN on a phone first.

If nothing answers at all: PWRKEY

On SIM800C breakouts the pin silkscreened BOOT is the module's PWRKEY, and some boards do not start without it. Many others have an auto-start circuit and need nothing — so test before wiring anything: power up with BOOT unconnected and read Device info. IMEI coming back means your board starts itself and BOOT stays unconnected.

If it is dead, pull BOOT to GND for 1–1.5 seconds and release. A momentary push button between BOOT and GND does it by hand — or let the app do it:

  1. Wire BOOT to a free pin with a 1 kΩ resistor in series — see the table below for which one.

    Flipper pin 4 (PA4) --[ 1k ]---- BOOT / PWRKEY
    Flipper pin 11 GND  ------------ GND
    

    Series only — nothing goes to GND on this one. The module holds PWRKEY high through its own internal pull-up, so a resistor to GND here would be a permanent partial pull-down, which is the hard-grounded failure below. This is not the same wiring as the TX divider, whose 1 kΩ does need its 2.2 kΩ leg to GND because it is cutting a driven 3.3 V down to 2.8 V logic. Current limiting and voltage division look alike and are not.

  2. Settings → PWRKEY pin — pick the one you wired. Off is the default and drives nothing.

  3. Advanced → Power & reset → Power on (PWRKEY). It holds the pin low for 1.2 s, waits 3 s for the module to boot, then checks whether it answers AT and reports back.

Which pin to use

The offered pins are 2, 3, 4, 5, 6, 13, 14, 15, 16. Two things are already spoken for:

Pin Taken by
2, 3, 4, 5 external CC1101 — MOSI, MISO, CS, SCK
6 external CC1101 — G0
7 external CC1101 — E07 amp (the app parks this one low)
13, 14 this app's UART, on USART
15, 16 this app's UART, on LPUART

So with an external CC1101 module attached, use the UART pair this app is not using: pin 15 or 16 when the app is set to USART, pin 13 or 14 when it is set to LPUART. Those are the only pins neither device claims.

With no CC1101 attached, 2–6 are all free and any of them is fine.

The app refuses to pulse a pin its own UART is driving and says Pin in use — but it cannot see a CC1101, so picking 2–6 with one attached is on you.

The app drives that pin open-drain — low asserts, high is high-impedance — and hands it back when the app exits. That is the only safe way to do it: PWRKEY idles at VBAT (~4 V) through the module's own internal pull-up, so a push-pull output driven high would be fighting a 4 V rail from a 3.3 V pin. Pulled low, the module's pull-up is also what limits current into the Flipper pin to tens of microamps, which is why no level shifting is needed here.

Do not tie it to GND permanently. SIMCom's FAQ warns that a hard-grounded PWRKEY makes the module power on and off by itself whenever VBAT falls under 3.3 V. On the diode dropper that sits at ~3.8 V with 350 mV of burst droop, that is close enough to matter: a brownout stops being a glitch and becomes a power-cycle loop.

Typing

Every text screen in the app uses a two-page keyboard. The key at the bottom left switches between letters and symbols: + * # @ ! ? & ( ) on the first symbol row, " ' , . : ; = - on the second, / \ $ % ~ on the third. Hold OK on a letter for its capital, hold it on _ for a space, and hold Back to delete.

+ for numbers, * and # for USSD codes, and " and = for hand-typed AT commands all live on the symbol page.

Basic

Call — choose the number, then the call screen opens.

SMS — choose the number, then the message, then the app sends it.

Both ask where the number comes from, once the phonebook has anything in it: Type a number, or Saved numbers to pick from the phonebook browser. The message is the same question — Type new text, or Use a preset when any preset is saved. With nothing saved yet the keyboard opens straight away, so neither menu is in the way on a fresh install.

The call screen shows the carrier, signal bars, the number and the call timer:

Key Does
OK ends the call, or Re-dial once it is over
← saves the number to the phonebook
→ Tones, once the call is connected
Back leaves the screen and hangs up

Tones opens a 12-key DTMF pad. Arrows move, OK sends that digit into the call immediately, and what has been sent so far runs along the top. Back returns to the call without ending it, and the pad closes itself if the other side hangs up while it is open.

The SMS result screen has Save No. to add the number to the phonebook and Preset to store the message text for reuse.

Status — carrier, signal strength in dBm, network registration, SIM state and the module's own supply voltage, refreshed once a second. OK refreshes immediately.

Saved

A file browser over /ext/phonebook. Picking an entry opens its quick-launch screen: carrier and signal updating live, ← SMS (preset or typed, as in Basic), OK Call (Re-dial after a call to it ended) and → Edit.

Edit holds the three things you can do to an entry:

  • Change number — keeps the name, writes the new number.
  • Rename — the file name and the Name: field inside the file are the same string, so one rename changes both: the app writes the entry under the new name and removes the old file.
  • Delete — asks first.

Add number on the main menu stores a number without calling or texting it first: type the number, then the name.

The same entries appear in the Flipper Archive under the Phone tab, and opening one there launches the app straight on that screen. Pin an entry to Favorites for one-press dialing.

SMS presets

Message texts kept in apps_data/sim800/presets, so they do not show up in the phonebook or in the Archive. New preset at the top of the list writes one from scratch; the SMS result screen can also save the message you just sent.

Picking a preset gives Send to number, View text, Edit text, Rename and Delete. Send to number asks for the number the way Basic does — typed or from the phonebook — and sends as soon as it has one. Renaming works the same way as in the phonebook: new file written, old one removed.

Saved presets also show up wherever the app asks for a message, under Use a preset.

Advanced

  • Device info — maker, model, firmware, IMEI, ICCID, IMSI, SIM state, supply.

  • Network info — carrier, signal, registration, network time, own number, SMS centre.

  • SMS inbox — reads the messages on the SIM. Open one to read it, reply or delete it.

  • History — incoming calls and messages as they arrived, split into Incoming calls and Incoming SMS, with Clear history to wipe both. Entries are appended to apps_data/sim800/history.log the moment the module announces them and are only read back when you open the screen, so nothing is held in RAM between visits. The file trims its own oldest half once it passes 8 KB.

    Calls log the caller ID as they ring, deduplicated so one call does not write a line per RING. Messages log their text, but only when you open one in the SMS inbox — the arrival notice carries nothing but a storage index, and reading the body needs AT+CMGR, which cannot be sent from the UART reader. Opening the same message again does not log it twice.

  • USSD code — sends a code such as *100# and shows the network's reply.

  • DTMF tones — types a string of digits and plays them into an active call. For single digits during a call, the keypad on the call screen (→ Tones) is quicker.

  • Audio — speaker volume, ringer volume, mic gain and audio channel. These only set the module's own analog audio path: voice never travels over the UART, so they do nothing unless a speaker and an electret mic are soldered to the module's SPK+/SPK- and MIC+/MIC- pads.

  • AT terminal — the last few received lines with a prompt to send any AT command by hand. ← Log opens the whole scrollback, up and down to scroll, opening on the newest line. The live tail keeps refreshing; the scrollback stays where you left it.

  • Detect baud — sweeps every rate from 1200 to 230400 and keeps the one the module answers on. The fastest way out of a silent UART.

  • Set module baud — moves the module itself with AT+IPR, follows the port over to the new rate and stores it with AT&W so it comes back that way. Use it to get off 2400, which is slow enough that a full-length SMS takes most of a second just to clock across. If the module does not answer at the new rate, the old one is put back and nothing is written.

  • Power & reset — power on (PWRKEY), reset, flight mode on/off, power off, factory defaults, store settings.

File formats

Phonebook entry, /ext/phonebook/<name>.phone:

Filetype: Flipper SIM800 Phonebook Entry
Version: 1
Name: Alice
Number: +15551234567

SMS preset, apps_data/sim800/presets/<name>.smspr:

Filetype: Flipper SIM800 SMS Preset
Version: 1
Text: On my way

History log, apps_data/sim800/history.log — plain text, not a Flipper format:

11-19 14:32  CALL  +15551234567
11-19 14:35  SMS   +15559876543  24/11/19,14:35:02+00
  Message body, indented so it stays with its header line

Only call and text numbers you are allowed to call and text, on a SIM you own, and follow the rules your network and your country set for it.