Description

TamaFi is a modern, WiFi-aware virtual pet.TamaFi是一款现代化、支持WiFi的虚拟宠物。
V2 rebuilds the original project with new hardware, smarter logic, and a clean, compact PCB that actually feels like a finished device.V2采用全新硬件、更智能的逻辑以及简洁紧凑的PCB，重新打造了原版项目，整机质感宛如成品。

The pet lives on an ESP32-S3, eats nearby WiFi, evolves over time, and makes its own decisions based on the environment around it.这只宠物运行在ESP32-S3上，以附近的WiFi为食，随时间不断进化，并根据周围环境自主做出决策。

✨ Highlights (V2)✨ 亮点（V2）
⚙ ESP32-S3 based – more performance, native USB, better room for future features基于ESP32-S3——性能更强、原生支持USB、为未来功能预留更多空间
🖥 TFT ST7789 240×240 – full-color UI, custom sprites, status bars, menus TFT ST7789 240×240 – 全彩UI、自定义精灵、状态栏、菜单
🧠 Autonomous behavior engine – the pet hunts, explores, rests, and reacts on its own 自主行为引擎 – 宠物会自行狩猎、探索、休息并作出反应
📶 WiFi-fed – nearby networks affect hunger, happiness, and health Wi‑Fi驱动 – 周围网络会影响饥饿度、幸福感和健康状况
🎛 Full menu system – Pet Status, Environment, System Info, Controls, Settings, Diagnostics 完整菜单系统——宠物状态、环境、系统信息、控制、设置、诊断
💾 Persistent state – age, stats, stage, settings stored in flash (Preferences) 持久化状态——年龄、属性、等级、设置均存储于闪存（偏好设置）
🌈 4× WS2812-2020 NeoPixels – mood & activity feedback (happy/sad/wifi/rest patterns) 4× WS2812-2020 NeoPixels – 情绪与活动反馈（开心/难过/WiFi/休息模式）
🔊 Retro sound engine – non-blocking chiptune-style beeps and sequences 复古音效引擎 – 非阻塞的芯片音乐风格提示音与序列
🖱 6 soft tactile switches – three on each side for navigation and shortcuts 6个柔软触控开关 – 每侧各3个，用于导航与快捷操作
🛠 DisplayKit-ready UI workflow – UI graphics can be designed/exported via DisplayKit支持 DisplayKit 的 UI 工作流——UI 图形可通过 DisplayKit 进行设计与导出

🧩 How TamaFi V2 Behaves
TamaFi isn’t just a sprite animation loop. It runs a small decision engine that constantly evaluates:TamaFi 不仅仅是一个精灵动画循环。它运行着一个小型决策引擎，不断评估：

Pet stats: , , hungerhappinesshealth
Traits: curiosity, activity, stress
Environment: number of nearby networks, open/hidden networks, average RSSI
Time: age (minutes → hours → days)
From that, it decides whether to:

🍖 Hunt – use WiFi scan results to “feed” and adjust hunger/happiness/health
👁 Explore – react to open/hidden networks and network diversity
😴 Rest – enter a sleep cycle with special egg animation and recovery stats
😐 Idle – chill on the home screen with mood-based idle animations
Mood system
The pet mood changes based on stats + environment:

HUNGRY – low hunger
HAPPY – good stats + decent WiFi
CURIOUS – hidden/open networks nearby
BORED – no WiFi for too long
SICK – low health or bad conditions
EXCITED / CALM – good conditions & variety
Mood affects:

Idle animation speed
LED patterns
How often it wants to hunt / explore / rest
Evolution
Age is tracked in minutes, hours, and days:

BABY → → → TEENADULTELDER
Evolution depends on:

Time alive
Average of hunger / happiness / health
Environment quality
Reaching a new stage triggers special SFX + animations.

🖥 UI & Menu System
All rendering goes through a 240×240 framebuffer ( + ) to avoid flicker.TFT_eSPITFT_eSprite

Home Screen
Pet sprite (idle / hunt / rest / special states)
Background image
Stats bars: Hunger, Happiness, Health
Mood + Stage text
Activity label in the top bar (, , , etc.)IdleHunting…Resting…
Overlays for special effects (e.g. hunger effect)
Menus
Navigation is done using the left 3 buttons (UP / OK / DOWN).

Main Menu:

Pet Status – stats, mood, age, stage, short description
Environment – WiFi network counts, hidden/open, “signal mood”
System Info – firmware version, uptime, battery (if implemented), etc.
Controls – brightness, LED level, sound on/off, NeoPixel on/off
Settings – auto-sleep, auto-save interval, soft reset options
Diagnostics – debug info, test modes (non-destructive)
Back to Home
Changes in Controls/Settings are saved to NVS via , so they persist across reboots.Preferences

🔌 Hardware Overview
This is a summary of the V2 hardware stack.
Check the and directories for full details.PCB/Schematic/

Core
MCU: ESP32-S3 module
Display: 1.3–1.54″ TFT ST7789 @ 240×240
Buttons: 6× soft tactile switches
LEDs: 4× WS2812-2020 addressable RGB
Buzzer: driven with PWM (LEDc) for retro SFX
Power
Charger: TP4056 (single-cell Li-ion/Li-Po)
Backlight control: MOSFET on TFT LED pin, driven by PWM for brightness levels
Power input: USB-C (on PCB)
Connectivity / Dev
ESP32-S3 native USB for firmware upload
Optional CP2102 USB-to-TTL on the board for easier flashing / serial during development

Package Includes:
1 x Acrylic Housing
1 x Finished TamaFi Virtual Pet
This product does not include a battery. Customers can DIY a battery power supply on their own if needed.