Irrduino 开源项目搭建与使用教程
1. 项目目录结构及介绍
Irrduino 的项目目录结构如下:
Irrduino/
├── IrrduinoController/ // 控制器代码,运行在Arduino硬件上
│ └── ...
├── IrrduinoDroid/ // Android 应用,用于远程控制
│ ├── IrrduinoRemote/ // 客户端应用代码
│ └── ...
├── IrrduinoServer/ // Python服务器,提供Web控制和报告功能
│ ├── static/
│ │ └── dart/ // Dart游戏Lawnville
│ └── ...
├── .gitignore // 忽略文件列表
├── AUTHORS // 作者列表
├── COPYING // 许可证文件
└── README.md // 项目说明文档
IrrduinoController
: 项目的核心控制器部分,用C语言编写,直接在Arduino板上运行。IrrduinoDroid
: 包含Android应用程序,可以远程控制灌溉系统。IrrduinoRemote
: 客户端应用的具体代码。
IrrduinoServer
: 使用Python构建的Google App Engine应用程序,用于远程控制、报告和交互。static/dart
: 内含一个名为Lawnville的Dart游戏。
2. 项目的启动文件介绍
-
IrrduinoController 的启动文件通常是主函数入口点,位于工程中的特定文件(如
main.c
或Sketch.ino
),具体取决于编程环境。你需要在Arduino IDE中打开这个文件并上传到Arduino硬件以运行。 -
IrrduinoDroid 的启动文件是Android应用的主Activity,通常命名为
MainActivity.java
。此文件位于IrrduinoDroid/IrrduinoRemote
文件夹内,当应用启动时,Android系统将调用此Activity。 -
IrrduinoServer 的启动文件可能是一个名为
app.yaml
的配置文件,它告诉Google App Engine如何设置和运行Python应用。此外,你还需要在Python环境中运行特定的启动脚本来启动服务器,如dev_appserver.py
。
3. 项目的配置文件介绍
-
app.yaml
: 在IrrduinoServer
中,这是Google App Engine的应用配置文件,定义了服务端口、应用版本、路由规则以及资源限制等。 -
.gitignore
: Git忽略文件,列出不应被Git版本控制系统跟踪的文件或目录。 -
AUTHORS
: 列出项目贡献者的文件。 -
COPYING
: 记录项目许可证的信息,这里是Apache-2.0许可证。 -
README.md
: 项目简介,包括项目目的、安装指南和其他重要信息。
为了运行 Irrduino 系统,你需要设置 Arduino 控制器,安装Android应用,以及配置和部署服务器应用程序。确保按顺序完成这些步骤,并参考项目文档了解详细配置信息。如果你遇到任何问题,可以查阅项目的GitHub页面上的其他文档或社区讨论。