Skip to main content

Instalação Pulsus - Totem Sunmi K2 Mini

Essa é uma opção que permite instalar, 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 launcherutilitário nativoproprietário da fabricante (PMUtils) e o launcher nativo (com.woyou.launcher), éa necessárioimplantação aplicardeve comandosser realizada em bancada via protocolocabo deUSB depuraçãoutilizando comandos ADB para forçarinstalar o sistemaaplicativo, operacionalconceder aprivilégios e delegar o controle da tela inicial exclusivamente ao Pulsus.

1. Objetivo

Orientar na configuração preventiva no painel web, preparação do equipamento, instalação do agente Pulsus e execução dos comandos via ADB no Totem Sunmi K2 Mini. Este procedimento elimina o loop de carregamento inicial ("Tentando aplicar o launcher" / "Demorando muito?"), blinda o botão Home e estabelece o protocolo padrão de manutenção remota.

 


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

    Acesse o menu lateral "Configurações" e selecione o perfil de configuração que será aplicado ao totem.

    image.png

      Mantenha desabilitada a opção "DESABILITAR RECURSOS DE DEPURAÇÃO" ("Não").

      image.png

       

      Perigo: Mantenha esta opção sempre desativada ("Não"). Caso ela esteja ativa quando o dispositivo sincronizar com o grupo, o acesso via ADB será bloqueado pela política. Em caso de looping de interface onde seja necessário ativar a depuração para manutenção, a única solução será resetar o aparelho pelo Pulsus.

       

        Ambiente no Computador:

        Certifique-se de que o SDK Platform-Tools (ADB) esteja configurado e aloque o arquivo APK do agente Pulsus (latest-pulsus.apk) no mesmo diretório do terminal.

          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. 

          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):Atenção: 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 novia 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- Instalar o pacote base do agente Pulsus MDM:

              ./adb -s [SERIAL_DO_TOTEM] install latest-pulsus.apk

              2- Instalar o pacote base do agente Pulsus MDM:

              ./adb -s [SERIAL_DO_TOTEM] install latest-pulsus.apk

              3- Injetar o privilégio máximo de Device Owner (D.O.) no agente:

              ./adb -s [SERIAL_DO_TOTEM] shell dpm set-device-owner mobi.pulsus/.messaging.DeviceAdminReceiver

              4- Conceder permissão avançada de sobreposição de tela no Android:

              ./adb -s [SERIAL_DO_TOTEM] shell pm grant mobi.pulsus android.permission.SYSTEM_ALERT_WINDOW

              5- Desativar o launcher de fábrica da Sunmi (congela o pacote nativo no usuário padrão):nativo)

               ./adb -s [ID_DO_TOTEM]SERIAL_DO_TOTEM] shell pm disable-user --user 0 com.woyou.launcher 

              Desativar6- 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 

              Invocar a intenção de inicialização primária (forçaForça o Android a reavaliar e delegar a tela inicial ao Pulsus):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 oso launcherslauncher denativo retaguardada foramfabricante desativados,foi desativado, o acionamento local do "Modo Manutenção" por senha não exibirá uma área de trabalho tradicional.tradicional. Utilize os procedimentos abaixo sempre que precisar realizar ajustes no totem: 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.segundos. Após concluir os ajustes locais, remova o pacote do layout web para ocultá-lo novamente do usuário final. final.

              Captura de Tela 2026-11-19 às 14.49.24.png

              • 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,provisionado como Device Owner, livre do conflito de launchers do Sunmi OS e operando em Modo Quiosque blindado pelo Pulsus MDM.MDM. O equipamento está homologado e pronto para operar de forma contínua e segura no ambiente de loja.loja.