You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

80 lines
3.0 KiB

8 years ago
# ethminer
11 years ago
8 years ago
The ethminer is an Ethereum GPU mining worker. It origins in [cpp-ethereum]
project (where GPU mining has been discontinued). Then hugely improved in
[Genoil's fork].
8 years ago
### Features
8 years ago
- Nvidia CUDA mining
9 years ago
- realistic benchmarking against arbitrary epoch/DAG/blocknumber
8 years ago
- on-GPU DAG generation (no more DAG files on disk)
9 years ago
- stratum mining without proxy
- OpenCL devices picking
- farm failover (getwork + stratum)
8 years ago
## Community
10 years ago
8 years ago
[![Gitter](https://img.shields.io/gitter/room/nwjs/nw.js.svg)][Gitter]
8 years ago
Chat in [ethminer channel on Gitter][Gitter].
8 years ago
## Usage
8 years ago
ethminer is a command line program. This means you launch it either from a
Windows command prompt or Linux console, or create shortcuts to predefined
command lines using a Linux Bash script or Windows batch/cmd file.
For a full list of available command, please run
8 years ago
```
8 years ago
ethminer --help
8 years ago
```
8 years ago
## F.A.Q
8 years ago
8 years ago
1. Why is my hashrate with Nvidia cards on Windows 10 so low?
8 years ago
8 years ago
The new WDDM 2.x driver on Windows 10 uses a different way of addressing the GPU. This is good for a lot of things, but not for ETH mining.
For Kepler GPUs: I actually don't know. Please let me know what works best for good old Kepler.
For Maxwell 1 GPUs: Unfortunately the issue is a bit more serious on the GTX750Ti, already causing suboptimal performance on Win7 and Linux. Apparently about 4MH/s can still be reached on Linux, which, depending on ETH price, could still be profitable, considering the relatively low power draw.
For Maxwell 2 GPUs: There is a way of mining ETH at Win7/8/Linux speeds on Win10, by downgrading the GPU driver to a Win7 one (350.12 recommended) and using a [build that was created using CUDA 6.5](releases/cuda-6.5).
For Pascal GPUs: You have to use the latest WDDM 2.1 compatible drivers in combination with Windows 10 Anniversary edition in order to get the full potential of your Pascal GPU.
8 years ago
8 years ago
2. Why is a GTX1080 slower than a GTX1070?
8 years ago
8 years ago
Because of the GDDR5X memory, which can't be fully utilized for ETH mining (yet).
8 years ago
8 years ago
3. Are AMD cards also affected by slowdowns with increasing DAG size?
8 years ago
Only GCN 1.0 GPUs (78x0, 79x0, 270, 280), but in a different way. You'll see that on each new epoch (30K blocks), the hashrate will go down a little bit.
9 years ago
8 years ago
4. Can I still mine ETH with my 2GB GPU?
9 years ago
8 years ago
No.
8 years ago
5. What are the optimal launch parameters?
8 years ago
The default parameters are fine in most scenario's (CUDA). For OpenCL it varies a bit more. Just play around with the numbers and use powers of 2. GPU's like powers of 2.
8 years ago
## Building from source
8 years ago
This project uses [CMake] and [Hunter] package manager.
11 years ago
8 years ago
```sh
mkdir build; cd build
cmake ..
cmake --build .
10 years ago
```
9 years ago
8 years ago
### CMake build options
8 years ago
- `-DETHASHCL=ON` - enable OpenCL mining, `ON` by default,
- `-DETHASHCUDA=ON` - enable CUDA mining, `OFF` by default,
8 years ago
- `-DETHSTRATUM=ON` - build with Stratum protocol support, `ON` by default.
8 years ago
[CMake]: https://cmake.org
[cpp-ethereum]: https://github.com/ethereum/cpp-ethereum
[Genoil's fork]: https://github.com/Genoil/cpp-ethereum
[Gitter]: https://gitter.im/ethereum-mining/ethminer
[Hunter]: https://docs.hunter.sh