Metadata-Version: 2.1
Name: pm2hw
Version: 0.0.5
Summary: Utility to read and write to all Pokemon mini hardware
Author: Sapphire Becker
Author: Sapphire Becker
Keywords: flash cart,flasher,linker,Pokemon mini
Home-page: https://github.com/logicplace/pm2hw
Project-URL: repository, https://github.com/logicplace/pm2hw
Project-URL: documentation, https://github.com/logicplace/pm2hw
Platform: Windows
Platform: macOS
Platform: Linux
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)
Classifier: Natural Language :: English
Classifier: Natural Language :: Japanese
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: System :: Emulators
Requires-Python: >=3.7
Requires-Dist: appdirs
Requires-Dist: ftd2xx
Requires-Dist: mistune
Requires-Dist: pyusb
Description-Content-Type: text/markdown


# pm2hw

[![PyPI version](https://img.shields.io/pypi/v/pm2hw.svg)](https://pypi.python.org/pypi/pm2hw/)
[![PyPI status](https://img.shields.io/pypi/status/pm2hw.svg)](https://pypi.python.org/pypi/pm2hw/)
[![PyPI pyversions](https://img.shields.io/pypi/pyversions/pm2hw.svg)](https://pypi.python.org/pypi/pm2hw/)
![Platforms](https://img.shields.io/badge/platforms-windows%20linux%20macOS-green.svg)
[![GitHub license](https://img.shields.io/github/license/logicplace/pm2hw.svg)](https://github.com/logicplace/pm2hw/blob/master/LICENSE)
[![Discord](https://img.shields.io/discord/549770771963314216.svg?color=7289da&label=Pokemon-mini.net&logo=discord)](https://discord.gg/rAgt26Wknw)

A flasher for all Pokemon mini Flash Cards (that I can actually test).

This is a work in progress, PokeUSB will come soon.

## Installation

It would be best to install this via `pipx` rather than plain pip; but of course, both are possible.

### Windows

The system has been tested on Windows 10 with Python 3.9

1. Download and install the [FTD2XX drivers](https://ftdichip.com/drivers/d2xx-drivers/) for Windows (Desktop).
2. Install pipx if it's not installed: `py -m pip install pipx --user`
   Note you will very likely need to add the folder to your PATH variable (it will warn you post-install).
3. Install pm2hw: `pipx install pm2hw`

### Linux/MacOS X

The system has not been tested on these OSes, but it should work.

1. Download and install the [FTD2XX drivers](https://ftdichip.com/drivers/d2xx-drivers/) for Linux or Mac OS X as appropriate.
2. Install pipx if it's not installed: `python3 -m pip install pipx --user`
3. Install pm2hw: `pipx install pm2hw`

## Usage

* CLI: `pm2hw --help`
* Open GUI: `pm2hw-gui`
  * Navigate to Help -> How to Use

## Comparison

All pm2hw tests run on Python 3.9.6

### PokeCard 512 v2

| Utility           | Read   | Write  |
| ----------------- | ------:| ------:|
| PokeFlash (Win10) | 1.883s | 4.509s |
| pm2hw (Win10)     | 2.529s | 6.031s |

### Ditto mini

| Utility           | Read    | Write    |
| ----------------- | -------:| --------:|
| pm2hw (Win10)     | 33.732s | 191.411s |

Note: times are faster now! But I don't have the data or my card on me right now
