LEIAME.md 2.05 KB
Newer Older
1 2
# Pygame Sample

3
Contém um pequeno projeto demonstração escrito em Python + Pygame para um jogo simples onde o player é controlado por um elemento de hardware: sensor na placa Arduino. A posição do player é atualizada com base na resposta do sensor lida pela porta serial.
4

5 6 7
O arquivo Makefile presente neste diretório contém diversos comandos para manutenção do software, descrita a seguir. 

ATENÇÃO: Os comandos `make` devem ser executados no diretório onde está o `Makefile`!
8 9 10 11


## Firmware

12
Além do código Python, este diretório inclui também um firmware minimalista para ser instalado na placa Arduino e utilizado em conjunto com o jogo. 
13

14
`/firmware/pot/pot.ino`
15

16
Pode ser instalado via IDE do Arduino ou pelo terminal como segue:
17 18 19 20

* Primeiramente, certifique-se de ter Ino Tools no sistema. Caso não tenha, instale-o:

    ```
21
    make install-ino
22 23 24 25 26
    ```

* Verifique o nome do modelo da Arduino que você deseja compilar:

    ```
27
    make list-inomodels
28 29 30 31 32 33 34
    ```
    
* Edite a variável INOMODEL no topo do Makefile para conter o nome correto da placa para a qual será feito o build e upload. 

* Tendo uma vez tudo preparado, basta fazer build e upload com:

    ```
35
    make firmware
36 37 38 39
    ```

## Dependências Python

40
Este software requer as seguintes bibliotecas de Python:
41

42
* [pyserial](https://pythonhosted.org/pyserial/)
43
* [pygame](http://pygame.org)
44

45
Ambas suportam Python 2 e Python 3, mas este projeto busca utilizar Python 3 por padrão. Caso opte por Python 2, substitua o "3" por "2" nos comandos seguintes.
46 47 48 49

* Certifique-se de ter o gerenciador de packages pip instalado no sistema:

    ```
50
    make install-pip3
51 52 53 54 55 56 57
    ```

    OBS: Requer o programa `curl` presente no sistema. Instale com `$ sudo apt-get install curl`.
    
* Instale dependencias possíveis via pip3:

    ```
58
    make install-py3-deps
59 60 61 62 63
    ```

* Instale Pygame para Python 3 (requer compilação de submódulos C):

    ```
64
    make install-pygame-py3
65 66 67 68 69
    ```


## Execução

70
Escolha o interpretador a utilizar na variável PYBIN do Makefile e simplesmente execute com:
71

72
```
73
make run
74
```
75