Como acender o teclado retroiluminado do MacBook Air no Ubuntu

Se você instalou o Ubuntu no MacBook Air 7,2 e percebeu que o teclado retroiluminado não acende, isso não significa necessariamente defeito no hardware. Em muitos casos, o controle da iluminação do teclado existe no Linux, mas depende do driver correto, do carregamento do módulo certo e da presença do caminho adequado no sistema. O controle costuma ser feito pelo driver applesmc, que no kernel Linux inclui suporte a keyboard backlight control em Macs Intel.

No caso dos MacBooks Intel compatíveis, o Linux normalmente expõe esse controle pelo caminho /sys/class/leds/smc::kbd_backlight, e a própria documentação comunitária para Macs no Linux aponta esse diretório como referência para ajustar o brilho do teclado.

Neste tutorial, você vai aprender como verificar se o suporte está presente no seu sistema, como acender manualmente o teclado retroiluminado, como carregar o módulo necessário e como deixar isso automático ao iniciar o Ubuntu.

Por que o teclado retroiluminado não acende no Ubuntu

No macOS, esse ajuste é gerenciado de forma transparente pelo sistema da Apple. Já no Linux, especialmente em Macs Intel, esse controle costuma depender da interface fornecida pelo Apple SMC, acessada pelo módulo applesmc. O código do driver no kernel identifica explicitamente suporte a sensores, ventoinhas e também ao controle da retroiluminação do teclado.

Isso significa que o teclado pode ficar apagado mesmo funcionando perfeitamente, apenas porque o módulo não carregou, o brilho está em zero ou o sistema não aplicou nenhum valor de iluminação após a inicialização.

Como verificar se o Ubuntu reconhece o controle do teclado

Abra o terminal e execute:

JavaScriptls /sys/class/leds/

Se aparecer algo como:

JavaScriptsmc::kbd_backlight

isso é um ótimo sinal. Significa que o sistema expôs o controle do teclado retroiluminado e você já pode tentar ajustar o brilho manualmente. Esse é justamente o caminho recomendado para Macs compatíveis no Linux.

Agora veja o brilho máximo suportado:

JavaScriptcat /sys/class/leds/smc::kbd_backlight/max_brightness

Em muitos casos, o valor máximo é 255.

Como acender o teclado retroiluminado manualmente

Para definir o brilho manualmente, use:

JavaScriptecho 255 | sudo tee /sys/class/leds/smc::kbd_backlight/brightness

Esse comando força o brilho máximo do teclado.

Se quiser testar um nível intermediário:

JavaScriptecho 128 | sudo tee /sys/class/leds/smc::kbd_backlight/brightness

Para apagar completamente:

JavaScriptecho 0 | sudo tee /sys/class/leds/smc::kbd_backlight/brightness

O princípio é simples: o arquivo brightness recebe um valor entre zero e o valor definido em max_brightness. Isso segue o modelo padrão do subsistema de LEDs exposto pelo kernel para esse controlador.

O que fazer se a pasta smc::kbd_backlight não aparecer

Se o diretório não existir, o primeiro teste é verificar se o módulo applesmc foi carregado:

JavaScriptlsmod | grep applesmc

Se não houver retorno, tente carregar manualmente:

JavaScriptsudo modprobe applesmc

Depois repita:

JavaScriptls /sys/class/leds/

Se smc::kbd_backlight aparecer após isso, o problema era apenas o módulo não carregado.

O driver applesmc é justamente o responsável pela interface do SMC da Apple no Linux, incluindo o controle da retroiluminação do teclado em Macs Intel compatíveis.

Como confirmar se o módulo foi carregado corretamente

Você também pode checar mensagens do kernel:

JavaScriptdmesg | grep -i applesmc

Isso ajuda a identificar se o módulo foi inicializado, se houve erro no reconhecimento do hardware ou se o suporte carregou parcialmente.

Se o módulo carregar sem erro, mas o diretório do backlight continuar ausente, pode haver três cenários:

1. o modelo não está expondo esse controle no kernel atual
2. algum ajuste de ACPI ou firmware está interferindo
3. o kernel/distribuição usada está com comportamento diferente daquele esperado em outros sistemas Linux

Há relatos recentes de diferenças de comportamento entre kernels e distribuições no suporte ao backlight de teclado em Macs, então esse tipo de variação realmente pode acontecer.

Como fazer o teclado acender automaticamente ao iniciar o Ubuntu

Se o comando manual funcionou, você pode automatizar isso com um serviço do systemd.

Crie o arquivo:

JavaScriptsudo nano /etc/systemd/system/macbook-kbd-backlight.service

Cole isto:

JavaScript[Unit] Description=Acende o teclado retroiluminado do MacBook [Service] Type=oneshot ExecStart=/bin/sh -c 'echo 255 > /sys/class/leds/smc::kbd_backlight/brightness' [Install] WantedBy=multi-user.target

Salve o arquivo e ative:

JavaScriptsudo systemctl daemon-reload sudo systemctl enable macbook-kbd-backlight.service sudo systemctl start macbook-kbd-backlight.service

Depois reinicie o notebook para testar.

Como deixar o módulo applesmc carregando automaticamente

Para evitar ter que usar modprobe manualmente após cada boot, você pode garantir o carregamento automático do módulo:

JavaScriptecho applesmc | sudo tee /etc/modules-load.d/applesmc.conf

Isso instrui o sistema a carregar o módulo durante a inicialização.

Como criar comandos práticos para aumentar ou diminuir o brilho

Você pode criar dois comandos simples no shell.

Para aumentar:

JavaScriptecho 255 | sudo tee /sys/class/leds/smc::kbd_backlight/brightness

Para reduzir:

JavaScriptecho 64 | sudo tee /sys/class/leds/smc::kbd_backlight/brightness

Ou criar scripts para alternar entre níveis diferentes, como 0, 64, 128, 192 e 255. Isso é útil quando as teclas físicas de brilho do teclado não estão mapeadas corretamente no Ubuntu.

O que fazer se o teclado acender, mas apagar de novo

Se ele acende com comando manual, mas apaga depois do login ou após suspender o sistema, o mais comum é que algum serviço, ambiente gráfico ou rotina de economia de energia esteja sobrescrevendo o valor.

Nesses casos, os testes mais úteis são:

• repetir o comando manual após o login
• testar após sair da suspensão
• deixar o serviço do systemd ativo
• verificar logs com dmesg | grep -i applesmc

Se o comportamento mudar após atualização de kernel, o problema pode estar ligado ao kernel em uso, não ao hardware. Há relatos recentes de diferenças entre kernels no comportamento do backlight de teclado em Macs.

Conclusão

No MacBook Air 7,2 com Ubuntu, o teclado retroiluminado geralmente depende do módulo applesmc e da interface /sys/class/leds/smc::kbd_backlight. Quando esse caminho existe, normalmente basta escrever um valor em brightness para acender o teclado. Se ele não existir, o primeiro passo é carregar o módulo applesmc e conferir novamente.

Em muitos casos, o ajuste manual resolve. Depois disso, você pode automatizar o processo com systemd para que o teclado já inicie iluminado sempre que ligar o notebook.