SYSTEM INTEGRATION

MediBee

Mood Board

Image Credits

• Image 1
• Image 2
• Image 3
• Image 4
• Image 5
• Image 6
• Image 7
• Image 8
• Image 9
• Image 10

User Flow Diagram

Functionality Diagram

The hardware is a custom PCB built around a XIAO ESP32C6, driving a 28BYJ-48 stepper motor (rotating a medication disc), a servo (controlling the dispensing gate), a solenoid lock, a passive buzzer, and an SSD1306 OLED display.

On the software side, a React Native Android app communicates with the device over WiFi via a REST API hosted on the ESP32.

Each subsystem had been developed separately across previous weeks. System integration meant wiring them into a single enclosure, resolving hardware conflicts, and validating end-to-end behaviour from the phone app down to physical actuation.

System Architecture

The full system has four layers:

• Mechanical layer — the 3D-printed enclosure, the medication disc, the gate mechanism, and the solenoid lock housing
• Electronics layer — the custom PCB carrying the XIAO ESP32C6, motor drivers, and all peripheral connections
• Firmware layer — Arduino C++ running on the ESP32, managing hardware state and the HTTP REST API
• Application layer — the React Native Android app communicating with the device over local WiFi

Integration Order

1. Mechanical assembly — build the pill wheel, gate, solenoid-locked door, and enclosure, and check that they move freely by hand before any motor is attached.
2. Electronics bring-up — power the PCB and test the stepper driver, servo, solenoid, OLED, buzzer, and Hall sensors one at a time, off the bench, before combining them into one sketch.
3. Firmware bring-up — flash the combined firmware and check WiFi connection, NTP time sync, and every REST endpoint with a plain HTTP client (browser or curl), before the app is involved at all.
4. App integration — point the React Native app at the device's IP and walk through each screen (Home, Schedule, History, Settings) against the real device.
5. End-to-end validation — run full day-long dispense cycles and repeated manual dispenses to check timing accuracy, missed-dose detection, and mechanical reliability.

Mechanical Integration

The enclosure was designed in Fusion 360 and printed in PLA..

Disc and Motor Alignment

The medication disc was designed to rotate on a 8 mm steel rod. But there was a worry that it'll slip under the load. So I made a hole to put nails into the disc. So the disc is securely attached to the motor shaft. Under the same hole, I put another one to attch a magnet. This magnet is used for homing the disc.

The Stepper motor will rotate only once during the day. Preferable in the morning, right before the first dose.

Then I made a mokeup in 3D printer.

Initial Mechanism designing and testing

This was the cardboard mokeup I made first. This made me decide that the diameter of the pill case was too large.

Servo Gate Mechanism

The servo controls the dispensing gate, a hinged flap that opens to drop a pill into the output chute.

With this mechanism, I can control which slot must dispense at one time. From the image, you can see that the compartment at the center is not covered. This dispenses the morning dose.

At noon, the servo rotated the door to the center, which opens the compartment at the side, and the noon dose dispenses.

Solenoid Mounting

The solenoid lock is mounted to the enclosure using two M2 screws through a printed bracket. Getting the angle right was important. If the solenoid was even slightly off, the plunger would catch on the latch instead of sliding through cleanly.

When the solenoid is activated, the plunger retracts and releases the door. The servo rotates the other door to the center. Then rotates back to the original position, which opens the compartment at the side, and the noon dose dispenses.

This is possible by attaching magnets to the side of the doors.

Wire Routing

This was the hard part. The PCB, stepper motor, servo, solenoid, buzzer, OLED, and Hall sensors together produce about 30 cm of wiring inside the enclosure.

I added slots in the side of the lower half to mount the main PCB.

I imported the 3D design from Kicad and added it to the enclosure.

Enclosure

The enclosure is a two-part 3D-printed shell in PLA, split into an upper half housing the disc and gate mechanism, and a lower half housing the PCB, wiring, and solenoid. The two halves are held together with Magnets.

Electronics Integration

I designed the circuit boards in Kicad.

I needed two boards. One was the main board that connects to the Stepper and Servo motors, the solenoid and the buzzer. The second was the board for the Hall Effect sensors. This board will be placed close to the magnets in the enclosure.

Bill of Materials

Firmware Integration

Electronics Flowchart

Firmware Flow

This is how the firmware behaves from power-on: it connects to WiFi and NTP once, then runs a loop that simultaneously serves the app's REST requests, keeps the OLED updated, and checks every ten seconds whether a dose is due.

Mobile App

The companion app is a React Native app with four tabs — Home, Schedule, History, and Settings — that all talk to the ESP32 over the same REST API described above. It stores the device's IP address (and, optionally, WiFi credentials to push to the device) locally on the phone using AsyncStorage, so it reconnects automatically the next time the app opens.

• Home — shows the current time, today's dose schedule, whether the device is online, and lets you trigger a manual dispense for any slot.
• Schedule — lets you add, remove, enable/disable, and retime dose slots using a simple up/down time picker, then pushes the whole schedule to the device in one go.
• History — pulls the dispense log from the device and shows each entry as taken or missed.
• Settings — sets the device's IP address, pushes new WiFi credentials to the device, toggles the buzzer, tests the connection, and can remotely reboot the device.

The app polls /status every 15 seconds in the background to show an online/offline badge, independent of whichever tab is open.