Rabbit feeder

IoT enabled rabbit feeder, automatic and controllable via Internet.

Github repository: https://github.com/conejoninja/home_food

rabbit feeder

Idea and motivation

The main idea was to be able to feed these two little rascals even when I’m not at home. Twice a day, a small quantity at breakfast and a bigger one for dinner (non-spoiled rabbits are supposed to eat timothy during the day when they are not sleeping). I would like to also measure the temperature in case it gets too hot, since rabbits don’t do well on hot weather.

The feeder will wake up each 15 minutes, send the temperature and humidity to a server and check if it’s time to feed the monsters. It’s as autonomous as possible (it will feed them if it’s time, even if there’s no internet connection). The feeder will notify if there’s a problem with the temperature and humidity readings or if it’s jammed. It could receive a command to dispense extra food even if it’s not the time to.

little rascals

Components

  • ESP12F (or any other similar board)
  • DS1307 AT24C32 (DS1307 module with 32K EEPROM)
  • Temperature & humidity DTH11 sensor (or any DHTXX)
  • L293B / L293D half-bridge
  • DC motor (one of those cheap geared yellow motors)
  • Rotary encoder
  • DC-DC buck converter with 3.3V output (YL-46, AMS1117 based) * see note at motor section
  • 2x 10K ohm resistors
  • 4x 1N4007
  • 3D printed parts from STL files
  • 6V-12 power source
  • 6x M3 screws and nuts
  • Some wire
  • Some glue

The circuit

the circuit

The DC motor and the L293D/L293B are powered by the 6V-12V, any phone charger rated at 5V will work too without any issue, but the motor could definitely use that extra power in case there’s a jam in the feeder. From there, the voltage is converted to 3.3V to feed the ESP12F and the rest of components with a DC-DC cheap converter.

Note: I used a L293B instead of the pictured L293D. I also used a DS1307 module with 32k EEPROM memory from ebay, that works at 3.3v instead of the 5v depicted in the image. The DC motor is different too (see more in the motor section). I couldn’t find Fritzing components for them.

Note: I initially use a 6V power source and it worked fine for a while, but recently I started to get some issues at the motor not being powerful enough. I switched to 12V (which is in the range of the motor) and didn’t have any issue with it yet.

Connections

In case the diagram is not clear enough, here are the connections of the ESP12F.

ESP12F pins Component
RST ESP12F GPIO16 (to be able to deepsleep)
ADC -
CH_PD / EN 3.3V
GPIO16 ESP12F RST
GPIO14 DHT11 data pin
GPIO12 Rotary encoder pin A
GPIO13 Rotary encoder pin B
VCC 3.3V (from DC-DC converter)
GND GND
GPIO15 GND
GPIO2 L293B IN2
GPIO0 3.3V
GPIO4 RTC SDA
GPIO5 RTC SCL
RXD L293B IN1
TXD -

Due to the limitations of the ESP12F, the RXD pin is used to drive the motor. This will cause some issues is using the Serial to debug the code (it’s always on). I tried using pins GPIO9 and GPIO10 that are usually not in the adapter plate, but there are additional limitation using them, and I couldn’t make them work. I added a flag in the code to enable/disable the motor/Serial. You can not use the Serial and the motor at the same time, unless you change the pins.

Motor

For the first design I used a 360 servo motor I had lying around, it turns out it didn’t have enough force and jams from time to time. I ended up using one of the famously cheap yellow dc motors used in several robot kits. These motors take from 3V to 12V, and have enough force for our purpose*.

dc motor

There’s a small bump on one side of the motor enclosure, that side is the good one. The other is attached via a smooth rod and can get loose after a while.

dc motor

At code level, to avoid jams we move forward the motor a few miliseconds and then a little bit backwards, we repeat this a few times each time we need to dispense some food. In the case a jam happens (very rare, but it does) and avoid overheating of the motor, we limit the number of times we try to move the motor. If it failed to dispense the desired amount of food, we emit an alert and try to dispense next time we wake up (we don’t change the alarm). If we succeed with our task, we set a new alarm for the next day.

To control the motor we use a H-bridge with the L293B, you could use a L293D or any other similar component.

h bridge

Note: After some months of use, the motor seems to not have enough force anymore (probably something got stuck or moved). I changed the DC-DC converter and the power source, now feed 12V to the motor, seems to work fine.

Rotary encoder

rotary encoder

To control if the feeder is jammed or how much food is already served we’ll use a rotary encoder. One without a PCB and with the one-side flat knob. The rotary encoder uses interrupts to know when it has moved from one position to another. Check which of the pins on your board support interrupts, in the ESP12F, only the GPIO16 doesn’t support them, but it doesn’t matter to us since we’re using GPIO16 to wake from deepsleep. On regular Arduino boards, only a few pins support them, check this table for more information.

DHT11 - Temperature and humidity sensor

dht11

DHT11, DHT22 or DHT21, any of them will work fine. They are cheap, being the DHT11 the cheapest among them, work well on 3.3V and 5V. We’ll take 10 readings and calculate the average of both, temperature and humidity, to minimize wrong readings. Some of those readings, the first ones, may fail because the sensor needs to warm up, waiting 1 second between readings allow use to have at least a few good samples.

DS1307 AT24C32 - RTC Clock with EEPROM memory

rtc clock

We want to keep track of the time to be able to use the alarms and serve food whenever it’s time to. We’ll use the memory to know if the last time we failed and need to serve food again. Another possibility is to use the network time, but if the wifi is down for whatever reason we’ll end up without a valid time.

There could be delays while connecting to the wifi network, or take more time to serve food for whatever reason. With the RTC it’s possible to calculate the exact amount of time needed to wake up at the exactly* wanted time (at :00, :15, :30 and :45).

*the deepsleep of the ESP12F is a little bit imprecise, it will wake up a few seconds earlier than it should

STL/3D files

rabbit feeder

STL files for 3D printing could be found in the project repository. They are quite printer-friendly, but supports are needed for a few of them. For everything food-related you should use PLA instead of ABS, as PLA is Generally Recognized As Safe (GRAS) when used in contact with food by some studies, but there are a few things to have in mind.

Looking back, there are a few things I would change from the model. Printing takes some time and I don’t like wasting plastic, I made improvements and small modifications using existing parts when possible. For example, the rotary encoder wires are visible, which could be a problem with animals that bite most things at their reach.

Assembling is very easy and straight forward, but I made a video of the disassembling/exploding the model.


Note: file dish.stl is a bowl/dish for the food, to be use in place of front.cover.stl

Discovery JSON

During discovery, food01 will send the following description message:

{
    "id":"food01",
    "name":"Dulicomida 3000",
    "version":"1.0.0",
    "out":[
        {"id":"t1","name":"temperature"},
        {"id":"h1","name":"humidity"},
        {"id":"m1","name":"memory1"},
        {"id":"m2","name":"memory2"},
        {"id":"m3","name":"alarm1"},
        {"id":"m4","name":"alarm2"},
        {"id":"m5","name":"bigqty"},
        {"id":"m6","name":"smallqty"}
    ],
    "methods":[
        {"name":"food"},
        {"name":"ping"},
        {"name":"setmem","params":[{"name":"id"},{"name":"value"}]},
        {"name":"getmem"}
    ]
}

There are 8 output values. m1-m6 are explained in the section below and are only updated on request (by a getmem call). t1 (temperature) and h1 (humidity), are sensor data that are update every 15 minutes if an internet connection is available and the MQTT server is working. You could make 4 different request to the device. ping will reply with pong just to check the device is still alive. A food request will dispense a small amount of food. You could change the configuration of the device with setmem and get the actual values in memory with getmem. Since the device is mostly deepsleeping, it will execute the commands the next time it wakes up as long as the MQTT message was marked as persistent. You could send several commands at the same time in the same request, but if you make several request before it wakes up, only the last one will be executed.

Memory

The rabbit feeder stores some settings (and other data) in a non-volatile memory chip, thanks to the DS1307 AT24C32. It can be configured remotely with the setmem function call, more information in the protocol page (method-calling-messages). There are six different settings:

  • memory1: unix timestamp (from Jan 1st 2000) for next alarm1 to be executed. Example value: 553291190
  • memory2: unix timestamp (from Jan 1st 2000) for next alarm2 to be executed. Example value: 553330790
  • alarm1: time for the first alarm (big amount of food) in 24h format without symbols. Example value: 2030 (2030 = 20:30 = 8:30pm)
  • alarm2: time for the second alarm (small amount of food) in 24h format without symbols. Example value: 2030 (745 = 7:45 = 7:45am)
  • bigqty: minimum number of steps of the rotary encoder to dispense food for the first alarm
  • smallqty: minimum number of steps of the rotary encoder to dispense food for the second alarm

Note: memory1 and memory2 are the timestamp from the Jan 1st of 2000, you need to substract 946684800 from the real timestamp. 07/13/2017 @ 7:59pm (UTC) is equivalent to 1499975990 and for the device, it’s 553291190.

rabbit feeder