# Configurações | Totem Sunmi K2

# Instalação Pulsus - Totem Sunmi K2 Mini

# 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 utilitário proprietário da fabricante (`PMUtils`) e o launcher nativo (`com.woyou.launcher`), a implantação deve ser realizada em bancada via cabo USB utilizando comandos ADB para instalar o aplicativo, conceder privilégios e delegar o controle da tela inicial exclusivamente ao Pulsus.

#### <span data-path-to-node="2,0">**1. Objetivo**</span>

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](https://kb.illimitar.pro/uploads/images/gallery/2026-11/scaled-1680-/TYVimage.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-11/TYVimage.png)

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

[![image.png](https://kb.illimitar.pro/uploads/images/gallery/2026-11/scaled-1680-/oXYimage.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-11/oXYimage.png)

<p class="callout danger">**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.**</p>

- **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.

- <span data-path-to-node="5,1,0,0">**Identificação do Equipamento:** </span>

<span data-path-to-node="5,1,0,0">Obtenha o número de série/ID do dispositivo conectado (exemplo: `KM27228Q40039`) através do comando `./adb devices` para direcionar os scripts corretamente</span><span class="" data-path-to-node="5,1,0,1"><sup class="superscript"></sup></span><span data-path-to-node="5,1,0,2">.</span>

<p class="callout warning">**<span data-path-to-node="4,0,0">**Atenção:** Não utilize o comando `pm hide com.woyou.launcher` (bloqueado pelo sistema com erro *SecurityException*)</span><span data-path-to-node="4,0,1"><sup class="superscript"></sup></span><span data-path-to-node="4,0,2">, não ative o Pulsus no menu oculto de hardware **Lab → Kiosk** (gera loop infinito de renderização)</span><span data-path-to-node="4,0,3"><sup class="superscript"></sup></span><span data-path-to-node="4,0,4"> e não mantenha o **Nova Launcher** ativo como intermediário (gera brecha de segurança no botão *Home*)</span><span data-path-to-node="4,0,5"><sup class="superscript"></sup></span><span data-path-to-node="4,0,6">.</span>**</p>

---

#### <span data-path-to-node="6,0"></span><span data-path-to-node="6,0">**3. Comandos via Terminal**</span>

<span data-path-to-node="6,0">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`)</span><span class="" data-path-to-node="6,1"><sup class="superscript"></sup></span><span data-path-to-node="6,2">, execute os comandos abaixo no terminal (substituindo `[ID_DO_TOTEM]` pelo serial do aparelho) conforme a numeração:</span>

<span data-path-to-node="7,0,0,0">**1- **Instalar o pacote base do agente Pulsus MDM:****</span>

<span data-path-to-node="7,0,0,0">**`./adb -s [SERIAL_DO_TOTEM] install latest-pulsus.apk`**</span>

<span data-path-to-node="7,1,0,0">**2- **Instalar o pacote base do agente Pulsus MDM:****</span>

<span data-path-to-node="7,1,0,0">**`./adb -s [SERIAL_DO_TOTEM] install latest-pulsus.apk`**</span>

<span data-path-to-node="7,1,0,0">**3- Injetar o privilégio máximo de Device Owner (D.O.) no agente:**</span>

<span data-path-to-node="7,1,0,0">**`./adb -s [SERIAL_DO_TOTEM] shell dpm set-device-owner mobi.pulsus/.messaging.DeviceAdminReceiver`**</span>

<span data-path-to-node="7,1,0,0">**4- Conceder permissão avançada de sobreposição de tela no Android:**</span>

<span data-path-to-node="7,1,0,0">**`./adb -s [SERIAL_DO_TOTEM] shell pm grant mobi.pulsus android.permission.SYSTEM_ALERT_WINDOW`**</span>

<span data-path-to-node="7,1,0,0">**5- Desativar o launcher de fábrica da Sunmi (congela o pacote nativo)**</span>

<span data-path-to-node="7,1,0,0">**`./adb -s [SERIAL_DO_TOTEM] shell pm disable-user --user 0 com.woyou.launcher`**</span>

<span data-path-to-node="7,1,0,0">**6- <span data-path-to-node="7,2,0,0">**Força o Android a reavaliar e delegar a tela inicial ao Pulsus:**</span>**</span>

<span data-path-to-node="7,1,0,0">**`<span data-path-to-node="7,2,0,2">./adb -s [ID_DO_TOTEM] shell am start -a android.intent.action.MAIN -c android.intent.category.HOME</span>`**</span>

<p class="callout success"><span data-path-to-node="8,0,0">**Sucesso:** O agente do Pulsus assumirá imediatamente o topo da hierarquia do sistema, eliminando o loop de carregamento</span><span data-path-to-node="8,0,1"><sup class="superscript"></sup></span><span data-path-to-node="8,0,2">. 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</span><span data-path-to-node="8,0,3"><sup class="superscript"></sup></span><span data-path-to-node="8,0,4">.</span></p>

---

#### <span data-path-to-node="9,0"></span><span data-path-to-node="9,0">**4. Protocolo Operacional para Manutenções Futuras** </span>

Como o launcher nativo da fabricante foi desativado, 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.

[![Captura de Tela 2026-11-19 às 14.49.24.png](https://kb.illimitar.pro/uploads/images/gallery/2026-11/scaled-1680-/captura-de-tela-2026-11-19-as-14-49-24.png)](https://kb.illimitar.pro/uploads/images/gallery/2026-11/captura-de-tela-2026-11-19-as-14-49-24.png)

- <span data-path-to-node="10,1,0,0">**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</span><span class="" data-path-to-node="10,1,0,1"><sup class="superscript"></sup></span><span data-path-to-node="10,1,0,2">. O totem recuperará o acesso à internet instantaneamente, permitindo liberar o ícone de **Configurações** via nuvem para reconfigurar o Wi-Fi local</span><span class="" data-path-to-node="10,1,0,3"><sup class="superscript"></sup></span><span data-path-to-node="10,1,0,4">.</span>

<p class="callout info"><span data-path-to-node="10,1,0,4"><span data-path-to-node="11,0,0">**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</span><span data-path-to-node="11,0,1"><sup class="superscript"></sup></span><span data-path-to-node="11,0,2">.</span></span></p>

---

#### <span data-path-to-node="12,0"></span><span data-path-to-node="12,0">**5. Conclusão** </span>

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