Skip to content

Commit

Permalink
add images to instructions (#13)
Browse files Browse the repository at this point in the history
  • Loading branch information
chl33 authored Oct 16, 2024
1 parent bc5330b commit e76f169
Show file tree
Hide file tree
Showing 10 changed files with 42 additions and 16 deletions.
Binary file added images/install-float.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/install-motor-tube.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/install-motor.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/spike-in-soil.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/spike-with-tube.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/tube-aimed-at-soil.jpg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/web-mqtt-config.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/web-water-config.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/web-wifi-config.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
58 changes: 42 additions & 16 deletions instructions.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,21 +4,47 @@ First, hang the EBox on the reservoir and position the plant and reservoir where

Then, for each plant to be watered:

1. Put a pump in the reservoir insert.
2. Connect a soil moisture sensor and pump to the EBox. The connectors should be in a vertical line under 1, 2, 3, or 4 on the EBox. The soil moisture sensor uses a 3-conductor wire with JST connectors.
3. Run a tube from the pump, through the hole in the insert, and then to the soil in the pot.
4. Cut the tube to the right length, and either:
1. Install the float in the reservoir insert.

![install float](images/install-float.jpg)

2. Put a pump in the reservoir insert.

![install motor](images/install-motor.jpg)

3. Connect a soil moisture sensor and pump to the EBox. The connectors should be in a vertical line under 1, 2, 3, or 4 on the EBox. The soil moisture sensor uses a 3-conductor wire with JST connectors.
4. Run a tube from the pump, through the hole in the insert, and then to the soil in the pot.

![install motor-tube](images/install-motor-tube.jpg)

5. Cut the tube to the right length, and either:
- Push the end through the hole in the moisture sensor cap to position it for watering the soil, or

![tube aimed at soil](images/tube-aimed-at-soil.jpg)

- Insert the end of the tube into a soil spike and then insert the soil spike into the soil.
5. Power the EBox with the USB micro cable.
6. Look for the name of the device, and connect your phone or computer to a WiFi network with that name.
7. Open a web browser to http://192.168.4.1, and accept the non-encrypted connection.
8. Use the web interface to configure the device to connect to your home's WiFi network.
9. Look for the IP address of the device on its screen to open its web interface again. If mDNS works in your home, you might be able to connect to it as "http://{device-name}.local" where "{device-name}" is replaced with the name of your device.
9. If you have an MQTT broker in your house, use the web interface to configure the connection to the broker. If you are running Home Assistant and it works with your MQTT broker, the device will automatically show up in Home Assistant.
10. In the device web interface, select the plant to be configured. Select the minimum and maximum soil moisture levels you want, and select the number of seconds you want the pump to run at each iteration of watering. Try 1 second for a small pot and 3 seconds for a medium-sized pot.
11. Enable watering, and enable reservoir water detection.
12. Fill the reservoir with water.
13. Monitor the plant-watering and tweak settings so it works the way you want it to.
14. You get bonus points for setting up Grafana and creating a dashboard to show how well the watering is working.
15. You can even more bonus points for using Home Assistant to send you a phone alert you when the reservoir is out of water.

![spike with tube](images/spike-with-tube.jpg)
![spike in soil](images/spike-in-soil.jpg)
6. Power the EBox with the USB micro cable.
7. Look for the name of the device, and connect your phone or computer to a WiFi network with that name.
8. Open a web browser to http://192.168.4.1, and accept the non-encrypted connection.
9. Use the web interface to configure the device to connect to your home's WiFi network.
- Press "WiFi Config" on the main page, and update the configuration. Press "Save", then "Back", the press "Restart" to reboot the device.

![web WiFi config](images/web-wifi-config.png)

10. Look for the IP address of the device on its screen to open its web interface again. If mDNS works in your home, you might be able to connect to it as "http://{device-name}.local" where "{device-name}" is replaced with the name of your device.
11. If you have an MQTT broker in your house, use the web interface to configure the connection to the broker. If you are running Home Assistant and it works with your MQTT broker, the device will automatically show up in Home Assistant.

![web MQTT config](images/web-mqtt-config.png)

12. In the device web interface, select the plant to be configured, then press "Configure". Select the minimum and maximum soil moisture levels you want, and select the number of seconds you want the pump to run at each iteration of watering. Try 1 second for a small pot and 3 seconds for a medium-sized pot. You can also calibrate the moisture sensor. Put the moisture sensor in a glass of water so that all except the cap is covered by water, and enter the ADC reading as the "max ADC reading". Remove the sensor out of the glass and dry it off, then enter the ADC reading as the "min ADC reading." Confusingly, the counts for the max reading should be less than the counts for the min reading, because max and min here refer to the moisture level not the counts.

![web watering config](images/web-water-config.png)

13. Enable watering, and enable reservoir water detection. Press "Save" and then "Back".
14. Fill the reservoir with water.
15. Monitor the plant-watering and tweak settings so it works the way you want it to.
16. You get bonus points for setting up Grafana and creating a dashboard to show how well the watering is working.
17. You can even more bonus points for using Home Assistant to send you a phone alert you when the reservoir is out of water.

0 comments on commit e76f169

Please sign in to comment.