group__simcom__sim800

---

title: SIMCom SIM800, SIM900 and variants

SIMCom SIM800, SIM900 and variants (group)

Module: Supported Modules / SIMCom / SIMCom SIM800, SIM900 and variants

Manufacturer: SIMCom. Models: SIM800 series, SIM900.

Connection Information

• TCP sockets:
  • 8
• SSL sockets:
  • 5
• Socket Buffering:
  • The modem has an internal buffer for incoming data.
• Socket Numbering:
  • The modem respects user-specified multiplexing channel numbers/identifiers for socket connections.

Supported Public Functions

• TinyGsmSim800
  • GSM Modem Constructor
    • TinyGsmSim800(Stream& stream)
  • Basic functions (TinyGsmModem.tpp)
    • begin(const char* pin = nullptr)
    • init(const char* pin = nullptr)
    • sendAT(Args... cmd)
    • setBaud(uint32_t baud)
    • forceModemBaud(StreamObject& at_serial, uint32_t targetBaud)
    • testAT(uint32_t timeout_ms = 10000L)
    • waitResponse(uint32_t timeout_ms, String& data, GsmConstStr r1 = GFP(ModemConfig::GSM_OK), GsmConstStr r2 = GFP(ModemConfig::GSM_ERROR), GsmConstStr r3 = nullptr, GsmConstStr r4 = nullptr, GsmConstStr r5 = nullptr, GsmConstStr r6 = nullptr, GsmConstStr r7 = nullptr, GsmConstStr r8 = nullptr)
    • waitResponse(uint32_t timeout_ms, GsmConstStr r1 = GFP(ModemConfig::GSM_OK), GsmConstStr r2 = GFP(ModemConfig::GSM_ERROR), GsmConstStr r3 = nullptr, GsmConstStr r4 = nullptr, GsmConstStr r5 = nullptr, GsmConstStr r6 = nullptr, GsmConstStr r7 = nullptr, GsmConstStr r8 = nullptr)
    • waitResponse(GsmConstStr r1 = GFP(ModemConfig::GSM_OK), GsmConstStr r2 = GFP(ModemConfig::GSM_ERROR), GsmConstStr r3 = nullptr, GsmConstStr r4 = nullptr, GsmConstStr r5 = nullptr, GsmConstStr r6 = nullptr, GsmConstStr r7 = nullptr, GsmConstStr r8 = nullptr)
    • getConfiguredModem()
    • getModemInfo()
    • getModemName()
    • getModemManufacturer()
    • getModemModel()
    • getModemRevision()
    • getModemSerialNumber()
    • factoryDefault()
  • Power functions (TinyGsmModem.tpp)
    • restart(const char* pin = nullptr)
    • powerOff()
    • radioOff()
    • sleepEnable(bool enable = true)
    • setPhoneFunctionality(uint8_t fun, bool reset = false)
  • Generic network functions (TinyGsmModem.tpp)
    • getRegistrationStatus()
    • isNetworkConnected()
    • waitForNetwork(uint32_t timeout_ms = 60000L, bool check_signal = false)
    • getSignalQuality()
    • getLocalIP()
    • localIP()
  • SIM card functions (TinyGsmGPRS.tpp)
    • simUnlock(const char* pin)
    • getSimCCID()
    • getIMEI()
    • getIMSI()
    • getSimStatus(uint32_t timeout_ms = 10000L)
  • GPRS functions (TinyGsmGPRS.tpp)
    • gprsConnect(const char* apn, const char* user = nullptr, const char* pwd = nullptr)
    • gprsDisconnect()
    • isGprsConnected()
    • getOperator()
    • getProvider()
  • Socket listening functions (TinyGsmTCP.tpp)
    • maintain()
  • Phone call functions (TinyGsmCalling.tpp)
    • callAnswer()
    • callNumber(const String& number)
    • callHangup()
    • dtmfSend(char cmd, int duration_ms = 100)
  • Phone call functions
    • setGsmBusy(bool busy = true)
  • Audio functions
    • setVolume(uint8_t volume = 50)
    • getVolume()
    • setMicVolume(uint8_t channel, uint8_t level)
    • setAudioChannel(uint8_t channel)
    • playToolkitTone(uint8_t tone, uint32_t duration)
  • Text messaging (SMS) functions (TinyGsmSMS.tpp)
    • sendUSSD(const String& code)
    • sendSMS(const String& number, const String& text)
    • sendSMS_UTF16(const char* const number, const void* text, size_t len)
  • GSM location functions (TinyGsmGSMLocation.tpp)
    • getGsmLocationRaw()
    • getGsmLocation()
    • getGsmLocation(float* lat, float* lon, float* accuracy = 0, int* year = 0, int* month = 0, int* day = 0, int* hour = 0, int* minute = 0, int* second = 0)
    • getGsmLocationTime(int* year, int* month, int* day, int* hour, int* minute, int* second)
  • NTP server functions (TinyGsmNTP.tpp)
    • NTPServerSync(const char* server =pool.ntp.org", int TimeZone = 0)"
    • NTPServerSync(const String& server, int TimeZone = 0)
    • waitForTimeSync(uint16_t timeout_s = 120)
  • Time functions (TinyGsmTime.tpp)
    • getGSMDateTime(TinyGSMDateTimeFormat format)
    • getNetworkTime(int* year, int* month, int* day, int* hour, int* minute, int* second, float* timezone)
    • getNetworkEpoch(TinyGSM_EpochStart epoch = TinyGSM_EpochStart::UNIX)
  • Battery functions (TinyGsmBattery.tpp)
    • getBattVoltage()
    • getBattPercent()
    • getBattChargeState()
    • getBattStats(int8_t& chargeState, int8_t& percent, int16_t& milliVolts)
  • Utilities (TinyGsmModem.tpp)
    • streamWrite(T last)
    • streamWrite(T head, Args... tail)
    • streamClear()
    • streamDump(int16_t expected_len)
• GsmClientSim800
  • Arduino Client interface (TinyGsmTCP.tpp)
    • connect(const char* host, uint16_t port, int timeout_s)
    • connect(IPAddress ip, uint16_t port, int timeout_s)
    • connect(const char* host, uint16_t port)
    • connect(IPAddress ip, uint16_t port)
    • stop(uint32_t maxWaitMs)
    • stop()
    • write(const uint8_t* buf, size_t size)
    • write(uint8_t c)
    • available()
    • read(uint8_t* buf, size_t size)
    • read()
    • peek()
    • flush()
    • connected()
  • Extended Client API (TinyGsmTCP.tpp)
    • getMux()
    • getConnectionID()
    • beginWrite(uint16_t size)
    • endWrite(uint16_t expected_size = 0)
• GsmClientSecureSim800
  • Client constructors and initialization
    • GsmClientSecureSim800()
    • GsmClientSecureSim800(TinyGsmSim800& modem, uint8_t mux = 0)
  • Arduino Client interface (TinyGsmTCP.tpp)
    • connect(const char* host, uint16_t port, int timeout_s)
    • connect(IPAddress ip, uint16_t port, int timeout_s)
    • connect(const char* host, uint16_t port)
    • connect(IPAddress ip, uint16_t port)
    • stop(uint32_t maxWaitMs)
    • stop()
    • write(const uint8_t* buf, size_t size)
    • write(uint8_t c)
    • available()
    • read(uint8_t* buf, size_t size)
    • read()
    • peek()
    • flush()
    • connected()
  • Extended Client API (TinyGsmTCP.tpp)
    • getMux()
    • getConnectionID()
    • beginWrite(uint16_t size)
    • endWrite(uint16_t expected_size = 0)

Classes

	Name
struct	TinyGsmSim800ModemConfig Basic modem configurations for SIMCom SIM800 variants.
struct	TinyGsmSim800TcpConfig TCP behavior and limits for SIMCom SIM800 variants.
class	TinyGsmSim800 Class for the SIMCOM SIM800 and SIM900 (with some limitations).
class	TinyGsmSim800::GsmClientSim800 Inner client.
class	TinyGsmSim800::GsmClientSecureSim800 Inner secure client.

Types

	Name
enum class	Sim800RegStatus { REG_NO_RESULT = -1, REG_UNREGISTERED = 0, REG_SEARCHING = 2, REG_DENIED = 3, REG_OK_HOME = 1, REG_OK_ROAMING = 5, REG_UNKNOWN = 4 } Registration status.

Sim800RegStatus

Enumerator	Value	Description
REG_NO_RESULT	-1	No registration result.
REG_UNREGISTERED	0	Not registered on the network.
REG_SEARCHING	2	Searching for network.
REG_DENIED	3	Registration denied.
REG_OK_HOME	1	Registered on the home network.
REG_OK_ROAMING	5	Registered on a roaming network.
REG_UNKNOWN	4	Unknown registration status.

---

Generated by Doxygen and m.css with templates from doxybook2 Updated on 2026-09-11