blob: ac703b74d4fbbc9645b05b91ce56e5053afd0c0b (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
|
# Puzzle box
This repository contains the source code for the puzzle framework designed and
implemented during the 2023-2024 run of the Puzzlebox project. This year's run
of the project consists of only software students, and was developed using the
hardware from the 21-22 run of the project.
Improved hardware was designed but not realised during the 22-23 run of the
project. This hardware is recommended for future groups participating in the
project. The software in this repository should be easily portable to various
other microcontrollers, and a recommendation is made in the [design
document](docs/design.adoc).
## Tidyness
Please keep this repository tidy by being aware of the following conventions!
### Folder structure
|folder|contains|
|-|-|
|`/client`|Desktop PC application for controlling the puzzle box
|`/docs`|Project documentation in AsciiDoc(tor) format
|`/i2ctcp`|I<sup>2</sup>C over TCP protocol functions (used by main and client)
|`/lib`|Libraries (tracked as [submodules](#submodules))
|`/main`|Main controller (RPi pico) software
|`/puzzle/<name>`|Puzzle sources, each puzzle has its own subdirectory
|`/shared`|Shared code
|`/test`|Unit test framework (currently unutilized)
### Code style
An `.editorconfig` file is provided in this repository. Please install the
[EditorConfig](https://editorconfig.org/) plugin for your text editor of choice
to automatically use these.
Currently, no linter/formatter is configured for maintaining consistent code
style.
## Submodules
This repository tracks (most) dependencies via git submodules.
If something is complaining about missing files
```
git submodule update --init --recursive --depth 1
```
until your problems go away.
<!--
## Tests
```
mkdir -p test/build
cd test/build
cmake ..
make
make test
```
-->
## ESP SDK setup
1. Install ESP-IDF extension in Visual Studio Code
2. Install using 'express' option
3. Install ESP-IDF v5.2.1 (release version)
Additional help:
- [For windows](https://docs.espressif.com/projects/esp-idf/en/stable/esp32/get-started/windows-setup.html#get-started-windows-first-steps)
- [For Linux](https://docs.espressif.com/projects/esp-idf/en/stable/esp32/get-started/linux-macos-setup.html#get-started-linux-macos-first-steps)
|