Ferramentas

Comandos AT para módems celulares

Uma folha de consulta dos comandos AT mais usados para arrancar e depurar um módulo celular, cada um com o seu fragmento pronto a copiar e a cláusula da norma que o define (3GPP TS 27.007 e 27.005). Em baixo, um gerador de AT+CGDCONT a partir do seu APN e um descodificador do estado de registo na rede.

Identificação

Verifica que o módem responde (deve devolver OK).

↳ OKITU-T V.250

ATI

Mostra fabricante, modelo e revisão de firmware.

ITU-T V.250

AT+CGMI

Devolve o fabricante do módulo.

3GPP TS 27.007 §5.1

AT+CGMM

Devolve o modelo do módulo.

3GPP TS 27.007 §5.2

AT+CGMR

Devolve a versão de firmware.

3GPP TS 27.007 §5.3

AT+CGSN

Devolve o IMEI do equipamento.

↳ 4901542032375183GPP TS 27.007 §5.4

SIM / cartão

AT+CPIN?

Verifica se o SIM pede PIN (READY se já estiver pronto).

↳ +CPIN: READY3GPP TS 27.007 §8.3

AT+CIMI

Lê o IMSI do assinante (identifica país e operador).

↳ 2140700000000003GPP TS 27.007 §5.6

AT+CCID

Lê o ICCID do SIM (comando de fornecedor: +CCID, +QCCID ou +ICCID conforme o módulo).

↳ +CCID: 8934...ETSI TS 131.101 (vendor +CCID/+QCCID/+ICCID)

Rede e registo

AT+COPS?

Mostra o operador registado e a tecnologia de acesso.

↳ +COPS: 0,0,"Operator",73GPP TS 27.007 §7.3

AT+COPS=?

Pesquisa as redes disponíveis (demora; o módem cancela o registo por instantes).

3GPP TS 27.007 §7.3

AT+CREG?

Estado de registo em rede 2G/3G com comutação de circuitos.

↳ +CREG: 0,13GPP TS 27.007 §7.2

AT+CGREG?

Estado de registo do serviço de dados GPRS/UMTS.

↳ +CGREG: 0,13GPP TS 27.007 §7.2

AT+CEREG?

Estado de registo EPS (LTE, NB-IoT e LTE-M).

↳ +CEREG: 0,13GPP TS 27.007 §7.2

Sinal

AT+CSQ

Qualidade de sinal: índice CSQ e taxa de erro de bit.

↳ +CSQ: 17,993GPP TS 27.007 §8.5

Contexto PDP / APN

AT+CGDCONT=1,"IP","<apn>"

Define o contexto PDP com o APN antes de ligar.

3GPP TS 27.007 §10.1.1

AT+CGAUTH=1,1,"<user>","<pass>"

Define utilizador, palavra-passe e protocolo de autenticação do APN.

3GPP TS 27.007 §10.1.31

AT+CGACT=1,1

Ativa (ou desativa) o contexto PDP definido.

3GPP TS 27.007 §10.1.10

AT+CGPADDR=1

Mostra o endereço IP atribuído ao contexto.

↳ +CGPADDR: 1,"10.0.0.2"3GPP TS 27.007 §10.1.14

Energia / rádio

AT+CFUN=1

Controla o nível de funcionalidade: desliga ou liga o rádio.

3GPP TS 27.007 §8.2

SMS

AT+CMGF=1

Seleciona o modo de SMS (1 = texto, 0 = PDU).

3GPP TS 27.005 §3.2.3

AT+CMGS="<number>"

Envia um SMS para o número indicado.

3GPP TS 27.005 §3.5.1

Gerador de AT+CGDCONT

Componha o comando que define o contexto PDP a partir do seu APN.

CID (identificador de contexto)

Tipo de PDP

APN

AT+CGDCONT=1,"IP","internet"

Descodificador de estado de registo

Introduza o valor <stat> da resposta +CREG / +CGREG / +CEREG.

Valor <stat> (0–5)

Por onde começar a depurar

A ordem de arranque de quase qualquer módulo é a mesma: primeiro AT para confirmar que responde, depois AT+CPIN? para descartar que o SIM peça PIN, a seguir AT+CSQ para ver se há sinal e AT+CEREG? (ou +CREG em 2G/3G) para verificar o registo na rede. Só quando o estado de registo é 1 (rede própria) ou 5 (roaming) faz sentido definir o contexto de dados com AT+CGDCONT, ativá-lo com AT+CGACT e confirmar o IP com AT+CGPADDR. Se o registo fica em 2, o módem continua a procurar rede: é quase sempre um problema de cobertura, de banda ou de perfil de operador, e não da configuração do APN. Se fica em 3, a rede recusou o registo, o que costuma ser uma questão do SIM ou da subscrição, e não do firmware.

Ferramentas relacionadas

Gerador de APN Interpretador de sinal (AT+CSQ)Descodificador ICCID Todas as ferramentas

Perguntas frequentes

Qual é a diferença entre AT+CREG, AT+CGREG e AT+CEREG?

As três consultam o estado de registo, mas em domínios distintos: +CREG cobre o registo com comutação de circuitos de 2G/3G (voz e SMS), +CGREG o registo do serviço de dados por pacotes GPRS/UMTS, e +CEREG o registo EPS do LTE, que é também o que o NB-IoT e o LTE-M usam. Num dispositivo IoT sobre LTE a consulta relevante é AT+CEREG?.

O que significa a resposta +CEREG: 0,1?

O primeiro número é o modo de notificação (0 = sem notificações automáticas) e o segundo é o estado de registo <stat>. Um 1 significa registado na rede própria e um 5 registado em itinerância; ambos indicam que o dispositivo está ligado. Um 2 significa que continua a procurar rede e um 3 que a rede recusou o registo. O descodificador desta página traduz cada valor.

Como configuro o APN por comandos AT?

Com AT+CGDCONT define-se o contexto PDP indicando o CID, o tipo de PDP (IP, IPV6, IPV4V6 ou Non-IP) e o APN, por exemplo AT+CGDCONT=1,"IP","internet.iot". Se o APN exigir utilizador e palavra-passe, acrescenta-se AT+CGAUTH com o protocolo (PAP ou CHAP). O gerador desta página compõe ambas as linhas por si; para mais destinos (ModemManager, Android) use o gerador de APN.

Os comandos AT são iguais em todos os módulos?

Os comandos da 3GPP TS 27.007 e 27.005 (CREG, CEREG, CSQ, CGDCONT, CIMI…) são padrão e comportam-se de igual forma na maioria dos módulos. O que varia são as extensões de cada fabricante, que começam por um prefixo próprio: a leitura do ICCID, por exemplo, é AT+CCID, AT+QCCID ou AT+ICCID conforme o módulo. Na dúvida, consulte o manual AT do fabricante para as extensões.