项目简介
本项目是一个开源的无线控制界面项目,专门为Medialab - Prado数字门面打造,应用于MadPong游戏。项目通过NodeMCU控制器搭配Joystick接口,以UDP协议向Godot游戏的UDP服务器发送数据来实现控制操作。同时,还提供基于Nodejs的解决方案,借助WebSockets与Python服务器通信并转发数据给Godot游戏,能实现手柄间通信或简单的服务器到客户端通信协议。
项目的主要特性和功能
- 无线控制:利用NodeMCU和Joystick接口实现对MadPong游戏的无线控制。
- 多方案选择:提供基于ESP8266直接UDP通信和基于Nodejs、WebSockets与Python服务器中转的两种方案。
- 开源共享:软件设计和硬件实现均开源,方便开发者学习和借鉴,鼓励开发者参与贡献。
安装使用步骤
安装前提
已下载本项目的源码文件。
软件安装
- 安装Arduino IDE。
- 添加NodeMCU Interface libraries和Adafruit GFX libraries到Arduino IDE。
- 安装Git用于复制和更新项目。
- 从Arduino库管理器安装ArduinoJson库。
- 推荐使用Linux环境,也可使用Mac OS的Brew环境或Windows的WSL环境。
硬件连接
- 准备好1个NodeMCU控制器、1个Analog Joystick、1个Small Breadboard、1个Micro - B USB Data cable、1个e - InkPaper 2.9" BW以及1个4.7k电阻。
- 按照以下引脚映射连接e - InkPaper到NodeMcu:BUSY -> D2,RST -> D4,DC -> D3,CS -> D8,CLK -> D5,DIN -> D7,GND -> GND,3.3V -> 3.3V。
项目使用
- 检查是否安装了适合自己操作系统的NodeMCU驱动。
- 按照教程在Arduino IDE上连接和配置NodeMCU。
- 若要测试不同功能,可前往
arduino/testers
文件夹。 - NodeMCU会向Godot游戏的IP和端口“33333”发送格式为
("idJoystick"/"X or Click"/"Float")
的字符串,如1/X/1.0
(手柄1向右最大移动)等。
下载地址
点击下载 【提取码: 4003】【解压密码: www.makuang.net】