Skip to main content

Instalação Pulsus - Totem Sunmi K2 Mini

Essa é uma opção que permite configurar e estabilizar o agente Pulsus MDM em modo Kiosk (Device Owner) no Totem Sunmi K2 Mini rodando Android 7.1.2 (Sunmi OS Custom). Devido a disputas de privilégios com o launcher nativo da fabricante (com.woyou.launcher), é necessário aplicar comandos via protocolo de depuração ADB para forçar o sistema operacional a delegar o controle da tela inicial exclusivamente ao Pulsus.

1. Objetivo Orientar na execução dos comandos via ADB para eliminar o loop de inicialização ("Tentando aplicar o launcher" / "Demorando muito?") e estabelecer o protocolo padrão de manutenção remota no Totem Sunmi K2 Mini. Este procedimento garante a blindagem total da interface em Modo Quiosque e impede brechas de saída pelo botão Home.

2. Pré-requisitos e Restrições do Sistema

[BLOCO DE AVISO - LARANJA] Atenção (Abordagens Incompatíveis): Não utilize o comando pm hide com.woyou.launcher (bloqueado pelo sistema com erro SecurityException), não ative o Pulsus no menu oculto de hardware Lab → Kiosk (gera loop infinito de renderização) e não mantenha o Nova Launcher ativo como intermediário (gera brecha de segurança no botão Home).

  • Ambiente no Computador: Certifique-se de que o SDK Platform-Tools (ADB) esteja configurado e que o totem esteja conectado via cabo de depuração USB.

  • Identificação do Equipamento: Obtenha o número de série/ID do dispositivo conectado (exemplo: KM27228Q40039) através do comando ./adb devices para direcionar os scripts corretamente.

3. Sequência de Comandos no Terminal (Solução Definitiva) Para interromper a interceptação do utilitário proprietário PMUtils e remover alternativas de interface que impedem o registro da tela inicial (HOME intent), execute os comandos abaixo no terminal (substituindo [ID_DO_TOTEM] pelo serial do aparelho) conforme a numeração:

  1. Desativar o launcher de fábrica da Sunmi (congela o pacote nativo no usuário padrão): ./adb -s [ID_DO_TOTEM] shell pm disable-user --user 0 com.woyou.launcher

  2. Desativar o Nova Launcher (caso tenha sido instalado como contingência inicial, zerando prioridades anteriores): ./adb -s [ID_DO_TOTEM] shell pm disable-user --user 0 com.teslacoilsw.launcher

  3. Invocar a intenção de inicialização primária (força o Android a reavaliar e delegar a tela inicial ao Pulsus): ./adb -s [ID_DO_TOTEM] shell am start -a android.intent.action.MAIN -c android.intent.category.HOME

[BLOCO DE SUCESSO - VERDE] Sucesso: O agente do Pulsus assumirá imediatamente o topo da hierarquia do sistema, eliminando o loop de carregamento. O acionamento repetido do botão Home físico ou virtual apenas atualizará a tela do quiosque, sem permitir o vazamento para a área de trabalho.

4. Protocolo Operacional para Manutenções Futuras Como os launchers de retaguarda foram desativados, o acionamento local do "Modo Manutenção" por senha não exibirá uma área de trabalho tradicional. Utilize os procedimentos abaixo sempre que precisar realizar ajustes no totem:

  • Manutenção Padrão (Via Nuvem): Acesse o painel web da Pulsus, edite temporariamente o layout do grupo do totem e adicione o aplicativo nativo Configurações (com.android.settings). O ícone aparecerá na tela em segundos. Após concluir os ajustes locais, remova o pacote do layout web para ocultá-lo novamente do usuário final.

  • Manutenção de Rede (Sem Wi-Fi): Caso o totem perca a conexão Wi-Fi ou seja movido de loja, conecte um cabo de rede físico na entrada nativa Ethernet (RJ45) do equipamento. O totem recuperará o acesso à internet instantaneamente, permitindo liberar o ícone de Configurações via nuvem para reconfigurar o Wi-Fi local.

[BLOCO DE INFORMAÇÃO - AZUL] Informação: Graças à entrada nativa RJ45 do Totem Sunmi K2 Mini, manutenções de rede em loja não exigem o uso de cabo ADB ou a reativação de launchers de terceiros.

5. Conclusão Com essas etapas concluídas, o Totem Sunmi K2 Mini estará devidamente estabilizado, livre do conflito de launchers do Sunmi OS e operando em Modo Quiosque blindado pelo Pulsus MDM. O equipamento está homologado e pronto para operar de forma contínua e segura no ambiente de loja.