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:
ls /sys/class/leds/Se aparecer algo como:
smc::kbd_backlightisso é 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:
cat /sys/class/leds/smc::kbd_backlight/max_brightnessEm muitos casos, o valor máximo é 255.
Como acender o teclado retroiluminado manualmente
Para definir o brilho manualmente, use:
echo 255 | sudo tee /sys/class/leds/smc::kbd_backlight/brightnessEsse comando força o brilho máximo do teclado.
Se quiser testar um nível intermediário:
echo 128 | sudo tee /sys/class/leds/smc::kbd_backlight/brightnessPara apagar completamente:
echo 0 | sudo tee /sys/class/leds/smc::kbd_backlight/brightnessO 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:
lsmod | grep applesmcSe não houver retorno, tente carregar manualmente:
sudo modprobe applesmcDepois repita:
ls /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:
dmesg | grep -i applesmcIsso 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:
- o modelo não está expondo esse controle no kernel atual
- algum ajuste de ACPI ou firmware está interferindo
- 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:
sudo nano /etc/systemd/system/macbook-kbd-backlight.serviceCole isto:
[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.targetSalve o arquivo e ative:
sudo systemctl daemon-reload
sudo systemctl enable macbook-kbd-backlight.service
sudo systemctl start macbook-kbd-backlight.serviceDepois 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:
echo applesmc | sudo tee /etc/modules-load.d/applesmc.confIsso 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:
echo 255 | sudo tee /sys/class/leds/smc::kbd_backlight/brightnessPara reduzir:
echo 64 | sudo tee /sys/class/leds/smc::kbd_backlight/brightnessOu 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.
