Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/happybono/koreatransitcardbalancechecker
Tapping the 'Tmoney' card to the NFC module displays the remaining balance on the OLED screen, offers the most intuitive way to check the balance on the card.
https://github.com/happybono/koreatransitcardbalancechecker
arduino bus cardbalance cplusplus esp12-e esp12e esp8266-esp-12e iot-platform metrocard nfc pn532 rfid ssd1306 ssd1306-oled subway tmoney-card transportation
Last synced: about 6 hours ago
JSON representation
Tapping the 'Tmoney' card to the NFC module displays the remaining balance on the OLED screen, offers the most intuitive way to check the balance on the card.
- Host: GitHub
- URL: https://github.com/happybono/koreatransitcardbalancechecker
- Owner: happybono
- License: mit
- Created: 2021-01-02T01:45:30.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2025-02-11T12:30:08.000Z (about 24 hours ago)
- Last Synced: 2025-02-11T13:36:01.739Z (about 23 hours ago)
- Topics: arduino, bus, cardbalance, cplusplus, esp12-e, esp12e, esp8266-esp-12e, iot-platform, metrocard, nfc, pn532, rfid, ssd1306, ssd1306-oled, subway, tmoney-card, transportation
- Language: C++
- Homepage: https://vimeo.com/672699790
- Size: 10.3 MB
- Stars: 12
- Watchers: 3
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# KoreaTransitCardBalanceChecker (후불 교통 카드 [티머니, 이즐] 잔액 확인기)
Tapping the '[Tmoney](https://www.tmoney.co.kr/)' or '[Ezl (as known as CashBee)](https://www.cashbee.co.kr/)' card to the NFC module displays the remaining balance on the OLED screen, offers the most intuitive way to check the balance on the card.
## What's New
Click to Expand
### v1.0
#### January 03, 2021
>[Initial release.](https://github.com/happybono/KoreaTransitCardBalanceChecker/commit/fec9bfa518c8a4e4afe6bc7d3de6c8143084da48)
#### January 05, 2021
>[Added README.md](https://github.com/happybono/KoreaTransitCardBalanceChecker/commit/ea930c71896c7cd582c2e9f4dfeed69acf5db815)
>[Comments have added to each function in the source code.](https://github.com/happybono/KoreaTransitCardBalanceChecker/commit/74afa73fddc93052ed60340b95d96530603bea3d#diff-87f942957af3e245df937cc59e8e84242eb4c3a3b22ce052b06e2693e99a277e)
#### January 11, 2021
>[Updated README.md](https://github.com/happybono/KoreaTransitCardBalanceChecker/commit/187703a582d8e7e7d24195178be22c34e3c03d52)
### v2.0
#### January 19, 2021
>[Displays more information (Serial number, Date issued, Card type) on the OLED Screen.](https://github.com/happybono/KoreaTransitCardBalanceChecker/blob/main/K-TransitCardBalance.ino)
#### December 16, 2021
>[Bugs fixed related to the classification of cards.](https://github.com/happybono/KoreaTransitCardBalanceChecker/blob/main/K-TransitCardBalance.ino)
### v3.0
#### February 3, 2022
> [Supports beep sound using the piezo buzzer.](https://github.com/happybono/KoreaTransitCardBalanceChecker/blob/main/K-TransitCardBalance.ino)
> [Supports notification lights using the dedicated LED on the ESP8266 chipset.](https://github.com/happybono/KoreaTransitCardBalanceChecker/blob/main/K-TransitCardBalance.ino)
> [Displays error messages about undetectable cards on the OLED display.](https://github.com/happybono/KoreaTransitCardBalanceChecker/blob/main/K-TransitCardBalance.ino)
#### February 8, 2022
> [Bugs fixed.](https://github.com/happybono/KoreaTransitCardBalanceChecker/blob/main/K-TransitCardBalance.ino)
#### May 15, 2024
> [Added various beep sounds depending on different situations.](https://github.com/happybono/KoreaTransitCardBalanceChecker/blob/main/K-TransitCardBalance.ino)
## Specifications
### Scenarios
- Tapping the card to the NFC module displays the remaining balance and other information retrieved from it on the OLED screen.
### Cards Supported
- T-Money Cards
- EZL Card (Cash-Bee) Cards
### Cards Not Supported
- RailPlus Cards
- Hanpay Cards
### Connections
- 1 x Micro-USB
### Wireless
#### Wi-Fi
- IEEE 802.11 b/g/n Wi-Fi technology.
- **Not required to use the Wi-Fi capability** for this project.
#### NFC (Near Field Communication)
- MIFARE 1k, 4k, Ultra light, and DESFIRE cards, **ISO/IEC 14443-4 cards such as CD97BX**, CD light, DESFIRE, P5CN072 (SMX), INNOVISION Jewel cards such as IRT5001 card, FELICA cards such as RCS_860 and RCS_854
- **Built-in PCB Antenna, with 5 cm to 7 cm communication distance.**
- Host communication : **SPI Interface**
- Operating temperature : **-30ºC to +85ºC**
- **Contactless communication at 13.56MHz**
### Battery life
* **Up to 9.5 hours (9 hours and 30 minutes)** of typical device usage.
* Testing consisted of **full-time active use** until complete battery discharge.
* **Wi-Fi** was **not connected to any network**.
* **Dedicated LED indicators on the ESP8266 chipset have been disabled** until the battery is completely exhausted.
* Battery life may vary significantly with settings, usage and other factors.
## Schematics
## Apparatus (Equipment)
### Platform
* NodeMCU ESP8266-12E
### PN532 NFC / RFID Controller
* Soldering required.
* Connection Type : SPI
* D4 : SS of PN532
* D5 : TX of PN532
* D6 : MISO of PN532
* D7 : MOSI of PN532
* GND : GND of PN532
* VIN : VCC of PN532
### 0.96" SSD1306 I2C OLED Display
* Soldering required
* D2 : Data, D1 : Clock
### A-song Y25 Portable Battery
* USB Port : Power
* Micro-USB : Charging Port
* Dimension : 63.3 mm (W) × 90.7 mm (D) × 13.0 mm (H)
* Input : DC-5V / 2A (Micro 5-pin)
* Output : DC-5V / 2A (2 USB ports)
* Capacity : 5,000 mAh
## Features
* Tapping the 'Tmoney' or 'Ezl (as known as CashBee)' card to the NFC module displays the remaining balance on the OLED screen.
> The 'Tmoney' or 'Ezl' card is a rechargeable smart card that can be used to pay public transit fares in the Seoul-Gyeonggi areas as well in other cities around Korea (bus, underground/metro, taxi) as well as purchases in designated areas. The 'Tmoney' card can be used to pay subway and bus and taxi travel.
## Outcome Demonstration
[](https://vimeo.com/672699790 "Outcome Demonstration - Click to Watch!")
## Libraries Used
### Adafruit-PN532
This is a library for the Adafruit-PN532 NFC / RFID breakout boards This library works with the Adafruit NFC breakout.
https://github.com/adafruit/Adafruit-PN532
### SSD1306 (0.96") OLED Display
This is a driver for SSD1306 128x64, 128x32, 64x48 and 64x32 OLED displays running on the Arduino/ESP8266 & ESP32 and mbed-os platforms. Can be used with either the I2C or SPI version of the display.
https://www.github.com/ThingPulse/esp8266-oled-ssd1306
## Copyright
Copyright ⓒ HappyBono 2021 - 2025. All rights Reserved.
## License
This project is licensed under the MIT License. See the `LICENSE` file for details.
## References
* Hyunwoo Nam, Byunggeun Jang, Youngwook Park, 2012, A Design of Card Processing Method based on Script File for AFC Terminal, KoreaScience, Journal of The Korea Society of Computer and Information (JKSCI), viewed 5 January 2021, https://www.koreascience.or.kr/article/CFKO201202135240043.pdf.
* Chaeum Co., Ltd. (주식회사 채움씨앤아이), 2014, A study on adding the function of a national compatible transportation card to the Book Yieum Pass (Public Library Cards), Ministry of Culture, Sports and Tourism, 공공누리 자료집, viewed 7 January 2021, http://www.codil.or.kr/filebank/original/RK/OTKCRK170036/OTKCRK170036.pdf.