# TamaLIB: emulating first-generation Tamagotchi firmware

> TamaLIB emulates first-generation Tamagotchi devices built around Epson E0C6S46 and E0C6S48 microcontrollers, allowing their program ROMs to run on other hardware. A host implements its hardware abstraction layer for buttons, timing, audio and the 32×16 display.

- Type: Case study
- Targets: Firmware
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-09
- Original resource: <https://github.com/jcrona/tamalib>
- Primary source: <https://github.com/jcrona/tamalib/blob/ce304d55f9a73c60232ce3f552e7983db3fa399c/README.md>
- Catalog page: <https://awesomerea.org/resources/tamalib-tamagotchi-case/>
- Record JSON: <https://awesomerea.org/resources/tamalib-tamagotchi-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/tamalib-tamagotchi-case/index.md)

## Requirements & limits

- **Prerequisites:** An appropriate Tamagotchi program ROM is needed as input.
- **Prerequisites:** The host project must supply hal_types.h and implement the hal_t interface.
- **License:** GPL-2.0.

## Primary sources

1. <https://github.com/jcrona/tamalib/blob/ce304d55f9a73c60232ce3f552e7983db3fa399c/README.md>

## More in Firmware and hardware

- [Quansheng UV-K5 Hardware Reverse Engineering Project: V1.4 radio PCB reconstruction](https://awesomerea.org/resources/quansheng-uv-k5-hardware-case/index.md) · Case study
- [orsala_hack: reconstructing IKEA ORSALA lamp controls](https://awesomerea.org/resources/orsala-hack-case/index.md) · Case study
- [stf-sharc: reconstructing Sega Model 2 SHARC microcode](https://awesomerea.org/resources/stf-sharc-case/index.md) · Case study
- [F3DEX2: matching disassemblies of Nintendo 64 RSP microcode](https://awesomerea.org/resources/f3dex2-disasm/index.md) · Case study
- [B3603: reconstructing control-board behavior for replacement firmware](https://awesomerea.org/resources/b3603-case/index.md) · Case study
- [SmartClock-OSS: rebuilding SD Pro Smart Weather Clock firmware](https://awesomerea.org/resources/smartclock-oss-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.
