https://github.com/marak/eplaying-cards
Software and hardware project for e-paper based playing card deck.
https://github.com/marak/eplaying-cards
Last synced: about 1 year ago
JSON representation
Software and hardware project for e-paper based playing card deck.
- Host: GitHub
- URL: https://github.com/marak/eplaying-cards
- Owner: Marak
- Created: 2021-05-24T01:02:54.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2019-12-13T07:08:22.000Z (over 6 years ago)
- Last Synced: 2024-10-29T11:12:38.212Z (over 1 year ago)
- Homepage:
- Size: 1.01 MB
- Stars: 5
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Anycard ePlaying-cards
Software and hardware project for e-paper based playing card deck.
## Anycard Product Mission
Fun and new card game product that provides users the flexibility to play as many games as they wish with the use of just one digital card deck.
## Target Users
Anyone that might enjoy a card game from ages 4-99+
## User Stories
* As a player, I want to be able to hold at least 4 digital cards in my hand.
* As a player, I want to be able to refresh a card without any latency.
* As a player, I want the ecard controller to keep track of my game score.
* As a player, I want the ecard controller to keep a history of game play.
* As a player, I want the ability to save an ongoing game state.
* As a player, I want the ecards to update to a different game in less than 5 seconds.
* As a player, I want to be able to play games of up to four people.
* As a player, I want to have an interface to setup games.
# System Design
The implementation of this product will be mainly through the use of e-paper displays to display each card value. This technology is the ideal candidate for this implementation as it is very low power and it mimics the look of ink on paper. The system will need a central computer to manage and store the card games, which will be implemented with the use of a small microcontroller or a single board computer enabled with a wifi, bluetooth or RFID module in order to communicate with the ecards. Please see the system design diagram below and a description of the product flow and of each component:
## Product Flow
At the start of a game, each player will have a number of cards that will initially be flushed or wiped out from any content. The player must then select a game to play using the user interface integrated into the Deck Dock, the player must place their cards within the card ports to shuffle their hand and the Deck Dock should provide the players with a unique set of cards according to the chosen game. As the players begin to play and a card needs to be drawn, players shall place the played card in the card port to refresh the card value to an unused card in the game.
## Deck Dock Controller
The application will have a Deck Dock controller which will be tasked with game management. The operations for game management are the following:
* Shuffle cards
* Deal cards
* Point calculations and distribution
* Game rules
* Game selection
* Score management
* Keep memory of card distribution and card graveyard
* Display information
### Card Port
The card port is the main interface between the ecards and the game Deck Dock controller. This interface will server as a power supply and I/O interface for the ecards in order to give each card a new value.
### User Interface
The UI will be implemented through a touch screen integrated within the Deck Dock. The interface first servers as a means for the user to select their game, game preferences, player selection and other game settings.
## Players
In the system design below notice Player 1 and Player 2 are shown with ecards representing the hand for each player. The ecards will be equipped with an RFID tag which will be used by the Anycard Deck Dock to identify the card that was played and what card value it contains. The players will need to interface with the card port in order to refresh the cards and continue game play.
## Software Design
The software within the application will be tasked with managing the game while at the same time communicating with the ecard interface in order to properly account for game score and card values.The software implementation will consist of two main components as shown below: the GUI and the eCard driver.
### GUI
The GUI component will be implemented initially as a touch screen interface integrated with the Deck Dock, allowing the user to select games and game settings. The interface will be implemented as a simple python application. The application will be directly communicating with both the game engine and the Deck Dock.
### eCard Driver
The software for this component will handle the interaction between the ecards and the game engine.
### Game Engine
The game engine component will be resposible for all tasks related to game play and game rules. It will be the base framework for the system and will implement the functionalities specified section:
[Deck Dock Controller](#Deck-Dock-Controller)
### Games
Each game rule set will be a separate component in order have the ability to scale up each game and the game engine component simultaneously. Each game should be easy integrated into the application.
# MVP
The basic and minimum need for this product is to have a method of refreshing cards without latency and update the digital deck of at least 4 electronic cards without latency. The functionality shall be seamless as it would be when using a normal paper card deck. For game play, the goal is to create a simple prototype game which will show case the functionality of each of the components listed above.
# Prototype
### Raspberry Pi and RFID Wireup
# E Cards Techonology
The electronic cards would be implemented using electronic paper, a technology that uses very low power consumption, is flexible and mimics the look of real paper. Electronic paper uses electronic ink which is comprised of millions of microcapsules that contain a positive or negative charge, when provided a charge, the microcapsules move through a microscopic liquid towards the face of the card.
* Source: https://www.smartcity-displays.com/wp-content/uploads/2017/07/how-does-e-paper-work-1.gif