Gerenciamento de Firmware de Telefones IP

Introdução

A Versão 20, Update 10, centraliza o gerenciamento do firmware dos telefones IP no Console de Admin 3CX. Na página “Telefones”, é possível verificar o firmware informado por cada telefone, atribuir o firmware que ele deve usar e executar ações comuns nos dispositivos.

A biblioteca de Firmware armazena tanto o firmware da 3CX quanto o firmware do fabricante, carregados por um administrador. O firmware da 3CX é o pacote mais recente validado pela 3CX para um determinado modelo, o que pode não corresponder à versão mais recente publicada pelo fabricante.

Um único arquivo de firmware é marcado como Preferido para cada fabricante e modelo. Esse é o destino padrão para o provisionamento inicial e para atualizações programadas e iniciadas manualmente. Você também pode atribuir um arquivo de firmware disponível diferente a um telefone específico.

Pré-requisitos

Antes de começar, certifique-se de que você tenha:

• 3CX versão 20, update 10 ou posterior.
• Telefones IP compatíveis provisionados no 3CX. Consulte a lista de telefones IP compatíveis.
• Acesso de Administrador às páginas “Telefones” e “Firmware”.

Observação: A maioria dos Telefones IP não compatíveis é incompatível com o recurso de gerenciamento de firmware.

Entenda o Status e a Atribuição do Firmware

Os termos a seguir são utilizados pela 3CX ao se referir ao status do telefone e do firmware:

• Firmware Atual – a versão informada por um telefone registrado. Este campo fica em branco quando o telefone não está registrado.
• Firmware Atribuído — o firmware selecionado para um telefone. A 3CX o fornece durante o provisionamento inicial ou imediatamente quando um telefone registrado é reprovisionado.
• Preferido — o firmware selecionado como destino de atualização para um fabricante e um modelo. É utilizado para atualizações no provisionamento inicial, atualizações programadas e para a função “Atualizar Firmware”.
• Firmware 3CX — firmware fornecido e validado pela 3CX.
• Firmware do Fabricante — um arquivo do fabricante enviado por um administrador. A versão exibida é extraída do nome do arquivo, sempre que possível.
• Desatualizado — um telefone IP gerenciável para o qual há uma atualização de firmware aplicável disponível.
• Atualizado — o telefone informa o firmware atual esperado e nenhuma atualização é necessária.

Observações:

• Um celular sem atribuição de firmware mantém o firmware já instalado no aparelho.
• As ações relacionadas ao firmware não estão disponíveis para telefones não provisionados, nem para dispositivos DECT e FXS que o 3CX não gerencia individualmente.

Gerenciar Telefones

Acesse Admin > Telefones e filtre a lista para Telefones IP. A página inclui telefones registrados e não registrados; terminais de aplicativos, como o Discador 3CX e o Agente do 3CX Teams, estão excluídos.

Consultar as Informações do Telefone

A página “Telefones” exibe:

• Usuário — nome, ramal e departamento. Selecione o usuário para abrir a aba “Telefone IP”; selecione um departamento para filtrar a página.
• MAC — o endereço MAC do telefone, com controle de cópia.
• IP – o endereço IP registrado no momento. Este campo fica em branco quando o telefone não está registrado.
• Conexão - 3CX, Local, SBC, Roteador, STUN, Túnel, Hot Desking ou Não provisionado. As conexões DECT têm um prefixo, por exemplo, DECT Local.
• Modelo - o fabricante e o modelo definidos pelo template do telefone.
• Firmware Atual - a versão informada por um telefone registrado. Uma versão desatualizada é exibida em vermelho.
• Firmware Atribuído - o arquivo selecionado, com um selo de origem 3CX ou Fabricante.
• Ação - Atualizar Firmware, Atualizado ou em branco quando as ações de firmware não se aplicam.

Um indicador de status verde significa que o telefone está registrado. Vermelho significa que não está registrado. Um telefone não registrado não exibe um endereço IP desatualizado nem o valor do Firmware Atual.

Um dispositivo não provisionado não exibe nada na seção “Ação”, pois o gerenciamento do firmware só começa depois que o telefone é provisionado.

Pesquisar e Filtrar Telefones

A pesquisa encontra resultados que correspondam ao ramal, nome de usuário, endereço MAC, endereço IP, modelo, nome do arquivo de firmware, versão do firmware, descrição e telefone roteador.

Os filtros disponíveis incluem:

• Status - Qualquer, Registrado ou Não registrado.
• Fonte de Firmware - Qualquer, Nenhum Atribuído, 3CX ou Fabricante. Ao selecionar uma fonte específica, também são selecionados Telefones IP em Mostrar Apenas.
• Departamento - Qualquer, um departamento nomeado ou Todo o Sistema.
• SBC - Qualquer, ou um SBC ou telefone roteador específico.
• Mostrar Apenas - FW Desatualizado, Telefones Roteador, Telefones IP ou Telefones DECT.

Você também pode acessar a página Telefones (com alguns filtros já aplicados) a partir de outras seções do Console de Admin:

• Em Admin > Painel, ao clicar em “Desatualizado” na linha “Firmware do Telefone IP”, são exibidos apenas os telefones com firmware desatualizado.
• Em Admin > Telefones > Firmware > (número de) Telefones Atribuídos, são exibidos os telefones atribuídos ao firmware selecionado.
• Em Admin > Voz e Chat > SBC > Estatísticas > (número de) Telefones Online, são exibidos os telefones conectados ao SBC ou roteador selecionado.

Avisos e Ações do Dispositivo

Um telefone remoto cujo SBC ou telefone roteador tenha sido excluído exibe um aviso na coluna Conexão. Selecione o aviso para restaurar a associação.

Se o modelo informado por um telefone diferir do modelo configurado, a mensagem Modelo incompatível será exibida abaixo do nome do modelo. Selecione-a para abrir a configuração de Telefone IP do usuário. O aviso também aparece em Detalhes do Telefone IP.

Dependendo do(s) dispositivo(s) selecionado(s), a barra de ferramentas oferece:

• Reiniciar
• Reprovisionar
• Atualizar Firmware
• Escolher Firmware Diferente
• Limpar Firmware

O menu de três pontos também pode exibir (quando aplicável):

• Editar Usuário
• Mover Telefone
• Alterar Modelo
• Visualizar Configuração
• Detalhes do Telefone IP

Ver Detalhes do Telefone IP

No menu com os três pontos do telefone, selecione “Detalhes do Telefone IP” para verificar:

• Telefone IP - Status, Usuário, Modelo, MAC e IP.
• Informações de Autenticação - Nome de Usuário e Senha do Console Web, com controles para exibir, ocultar e copiar.
• Status do Provisionamento Remoto - o estado atual do RPS, além das funções Reenviar RPS e Revogar RPS, quando aplicável.

Para desativar o RPS do 3CX, acesse Admin > Telefones > Opções. Consulte “Configurando telefones IP”.

Gerenciar a Biblioteca de Firmware

Acesse Admin > Telefones e abra a seção Firmware. A biblioteca agrupa os firmwares por fabricante e modelo e armazena o Firmware da 3CX e o Firmware dos Fabricantes juntos.

A biblioteca exibe Fornecedor, Modelo, Preferido, Versão, Arquivo, Tamanho, Origem, Descrição e Telefones Atribuídos. Clique em Telefones Atribuídos (número) para abrir a página Telefones, filtrada para os aparelhos atribuídos a esse arquivo.

Ações de Firmware

O firmware selecionado como destino “Preferencial” é marcado com uma estrela preenchida. Clique no menu de três pontos do firmware para:

• Atualizar Telefones - atribuir o firmware selecionado aos telefones correspondentes desse modelo.
• Preferido - definir o firmware selecionado como o destino da atualização para o modelo.

• Você também pode clicar no ícone de estrela para selecionar o arquivo de firmware “Preferido” para esse modelo.

• Excluir Firmware - exclua o arquivo de firmware. Só é possível excluir arquivos de firmware quando não houver telefones atribuídos a ele.

Adicionar Firmware do Fabricante

O firmware do fabricante só pode ser carregado para modelos para os quais exista um modelo no seu Sistema Telefônico 3CX.

• Abra Firmware e selecione + Adicionar Firmware.

• Selecione o Modelo do Telefone, insira uma Descrição (se desejar) e, em seguida, escolha Novo Arquivo ou Arquivo Existente.

• Arquivo Existente permite selecionar um arquivo binário de firmware compatível que já esteja na biblioteca.

• Para criar um novo arquivo, faça o upload do firmware fornecido pelo fabricante, confirme se ele é compatível com o modelo selecionado e selecione “Salvar”.

Para os modelos compatíveis em que a estrutura do nome do arquivo do firmware é conhecida, a versão exibida é extraída do nome do arquivo. O 3CX aceita apenas as seguintes extensões de arquivo: bin, img, ld, rom, swu, z, zip.

Você é responsável por verificar a compatibilidade do firmware do fornecedor. Encaminhe as dúvidas sobre compatibilidade de firmware ao fabricante do telefone.

Selecione o Firmware Preferido

Exatamente um arquivo de firmware é selecionado como Preferido para cada fabricante e modelo:

• O firmware 3CX é selecionado por padrão quando está disponível.
• O primeiro Firmware enviado para um modelo é automaticamente definido como Preferido.
• Ao selecionar Preferido em outro arquivo, a designação é transferida para esse arquivo.

O arquivo selecionado é usado para novos aparelhos quando as atualizações de provisionamento inicial estão habilitadas, quando ocorrem atualizações programadas e quando a Atualização do Firmware é forçada.

Atribuir Firmware aos Telefones

Atualizar para o Destino da Atualização

Se for atribuído a um telefone um firmware que não seja o arquivo de firmware Preferencial, a ação “Atualizar Firmware” fica disponível.

• Na página Telefones, selecione um ou mais telefones e selecione Atualizar Firmware, ou use Atualizar Firmware em uma linha específica.
• Confirme a ação; o 3CX atribui o firmware Preferido a cada modelo e reprovisiona os telefones.

Um telefone registrado é reativado imediatamente e pode reiniciar. Um telefone não registrado mantém a atribuição e a aplica na próxima vez que se conectar e for configurado.

Se um telefone não informar a versão esperada após a atribuição do firmware, Atualizado não será exibido e Atualizar Firmware permanecerá disponível para permitir uma nova tentativa.

Escolha um Firmware Diferente

Use a opção “Escolher Firmware Diferente” para atribuir um arquivo de firmware específico a um telefone, incluindo um firmware 3CX ou do Fabricante mais antigo, em vez do arquivo Preferencial do modelo.

A caixa de diálogo exibe Ramal, Fabricante, Modelo, Firmware Atual, Usuário, MAC, IP e Firmware Disponível. Cada arquivo de firmware disponível é identificado como 3CX ou Fabricante.

Um telefone registrado é reconfigurado imediatamente e pode reiniciar. Um telefone não registrado armazena a atribuição e a aplica na próxima vez que se conectar e for reconfigurado.

A opção “Escolher Firmware Diferente” fica desativada quando não há firmware alternativo disponível para o modelo.

Limpar uma Atribuição de Firmware

A opção Limpar Firmware remove apenas a associação entre o telefone e o firmware. Ela não exclui o firmware da biblioteca nem remove a versão já instalada no telefone.

Depois que uma atribuição for cancelada, o 3CX não atribui automaticamente o firmware a esse telefone novamente. Use essa ação quando for necessário impedir que um telefone receba um arquivo de firmware durante o provisionamento, por exemplo, se ele estiver tentando aplicar o firmware repetidamente e falhando.

Como as Atribuições São Aplicadas

• Os novos telefones, incluindo aqueles criados por meio da importação de usuários, seguem o arquivo de firmware Preferencial quando são provisionados pela primeira vez.
• Após uma atualização do PABX para o Update 10, um telefone já registrado será associado a um arquivo de firmware correspondente quando a versão informada já existir na biblioteca; isso não força uma atualização.

Configurar Atualizações Automáticas

Acesse Admin > Telefones > Opções > Firmware do Telefone IP.

Atualizar Telefones no Primeiro Provisionamento

Ative Atualizar telefones na primeira configuração para atualizar cada novo telefone com o firmware Preferencial para seu modelo. A mesma configuração se aplica aos telefones criados por meio da importação de usuários.

Quando essa configuração estiver desativada, um novo telefone ficará sem um firmware atribuído. Você poderá atribuir o firmware posteriormente na página “Telefones”.

Manter os Telefones Existentes Atualizados

Ative a configuração Manter os telefones existentes atualizados de acordo com uma programação e escolha a frequência, o dia e o horário desejados. A cada execução, o 3CX verifica os telefones IP compatíveis e gerenciáveis existentes e aplica o arquivo de firmware Preferencial.

A programação se aplica tanto ao firmware do 3CX quanto ao firmware do Fornecedor marcado como Preferencial. As operações com falha são repetidas durante a próxima execução elegível.

A hora programada utiliza o fuso horário do departamento principal do ramal (mesmo que ele pertença a vários departamentos). Os dispositivos de Todo o Sistema (por exemplo, telefones de Hot-Desking) seguirão o fuso horário do sistema.

O Update 10 remove a opção global anterior de alternar entre o firmware 3CX e o firmware personalizado, bem como a opção de limpeza automática do firmware.

Monitorar o Status do Firmware

O painel de controle apresenta os seguintes relatórios:

• Atualizado quando nenhum telefone IP gerenciado tem uma atualização de firmware aplicável.
• Desatualizado quando um ou mais telefones IP gerenciados têm uma atualização aplicável.

Selecione Desatualizado para abrir a página Telefones com o filtro Mostrar Apenas: FW Desatualizado aplicado.

Mover um Telefone

A função “Mover Telefone” transfere um telefone provisionado para outro usuário, mantendo sua configuração, a atribuição do firmware, o modelo selecionado e quaisquer telefones que dependam dele como telefone roteador.

• Em Telefones, abra o menu de três pontos do telefone e selecione Mover Telefone.
• Selecione o usuário de destino.
• Clique no botão OK para confirmar.

O 3CX atualiza simultaneamente as relações de propriedade e as relações entre telefones roteadores e telefones dependentes. Se uma atualização necessária dessas relações falhar, a operação é revertida.

O recurso “Mover Telefone” não está disponível para dispositivos DECT ou FXS que pertençam a mais de um ramal.

Limitações

• As ações relacionadas ao firmware não são exibidas para telefones não provisionados, nem para dispositivos DECT e FXS que o 3CX não gerencia individualmente.
• Os modelos Grandstream e Htek utilizam um nome de arquivo de firmware fixo. Um arquivo 3CX e um arquivo do fabricante que exijam o mesmo nome não podem estar ativos ao mesmo tempo. Para utilizar o firmware do fabricante em um modelo afetado:

• limpar todas as tarefas do telefone
• exclua o firmware conflitante
• fazer o upload do arquivo do fornecedor
• selecione-o para receber atualizações
• aplicá-lo aos telefones

Veja Também

• Configuração de Telefones IP
• Telefones IP Compatíveis
• Hot Desking

O conteúdo se aplica à Versão: A partir da V20 U10 - Edição: IA, Pro, Basic - Implantação: Todas

Última atualização
Este documento foi atualizado pela última vez em 9 de setembro de 2026
https://www.3cx.com.br/docs/ip-phone-firmware-management/