41 lines
1.9 KiB
Markdown
41 lines
1.9 KiB
Markdown
|
# 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.
|