diff --git a/docs/ptBR/flashing.md b/docs/ptBR/flashing.md new file mode 100644 index 0000000..1ccc3eb --- /dev/null +++ b/docs/ptBR/flashing.md @@ -0,0 +1,40 @@ +# Instruções para Gravação + +Em geral nós recomendamos seguir as instruções no `README.md`, porém, +majoritariamente como artefato de desenvolvimento, outro método de gravar o KMK +existe. Este método é testado e suportado apenas no Linux, porém ele deve +funcionar no MacOS, BSDs e outros Unix-likes. Pode ser que funcione também em +Cygwin e no Windows Subsystem for Linux. + +Dado que se tenham disponíveis o `make` e `rsync` no seu sistema (via `$PATH`), +o seguinte copiará a árvore `kmk` para seu dispositivo CircuitPython, bem como o +arquivo definido como `USER_KEYMAP` como seu `main.py`. Ele também copiará o +`boot.py`, que aloca um tamanho de pilha maior que o padrão do CircuitPython +(simplificando - mais RAM do seu dispositivo ficará disponível para o KMK e para +a configuração do seu teclado). Se qualquer destes arquivos já existir no seu +dispositivo CircuitPython, ele será sobrescrito sem aviso algum. + +Se você estiver tendo problemas com erros de permissão aqui, **não execute make +como root ou via sudo. Leia a seção a seguir sobre resolução de problemas. + +```sh +make MOUNTPOINT=/media/CIRCUITPY USER_KEYMAP=user_keymaps/nameofyourkeymap.py BOARD=board/nameofyourboard/kb.py +``` + +# Resolvendo Problemas + +## Linux/BSD + +Confira se seu drive foi montado em algum lugar mediante um aplicativo gráfico +ou algum sistema de auto-montagem. A maioria destas ferramentas monta os +dispositivos em pastas `/media` ou `/run/media`, provavelmente como +`/media/CIRCUITPY`. Se o dispositivo não está montado, você pode ler sobre como +montar um drive manualmente [na +ArchWiki](https://wiki.archlinux.org/index.php/File_systems#Mount_a_file_system). + +Por exemplo: + +`sudo mount -o uid=$(id -u),gid=$(id -g) /dev/disk/by-label/CIRCUITPY ~/mnt` + +Se você ainda está tendo algum problema, confira nossa página de suporte para +saber aonde você pode entrar em contato, e a comunidade irá te ajudar.