Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
rigelminer authored Nov 30, 2022
1 parent 887186f commit a41421c
Showing 1 changed file with 201 additions and 1 deletion.
202 changes: 201 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,8 @@
# Rigel
This is a cryptocurrency miner for Nvidia GPUs

![rigel](https://user-images.githubusercontent.com/119491468/204774245-a26bcf43-247f-40ee-8aee-b49982aeac69.png)

## Supported algorithms
* ethash (Ethereum PoW, Zilliqa)
* etchash (Ethereum Classic)
Expand All @@ -20,4 +22,202 @@ Currently there is no developer fee, but it will be added in one of the future r
* Temperature limits and fan control
* HTTP API

![rigel](https://user-images.githubusercontent.com/119491468/204774245-a26bcf43-247f-40ee-8aee-b49982aeac69.png)
## Usage
```
-a, --algorithm <ALGORITHM>
Selects the mining algorithm
Currently supported:
etchash (ETC)
ethash (ETHW)
kheavyhash (Kaspa)
zil (Zilliqa)
-o, --url <URL>
Sets the pool URL
Format:
<mining protocol>+<transport protocol>://<pool hostname>:<port number>
Mining protocols: stratum, ethproxy, zmp (zil only)
Transport protocols: tcp, ssl
When dual or triple mining the value should be prepended with
the algorithm index `[<index>]`. Primary algorithm has index 1.
Failover pools are set by using `-o` multiple times.
Examples:
-o stratum+ssl://pool.woolypooly.com:3112
-o zmp+tcp://zil.flexpool.io:9486
mine Zilliqa to flexpool using ZMP protocol
-o [1]stratum+tcp://eth.f2pool.com:6688 -o [2]stratum+ssl://pool.woolypooly.com:3112
mine the primary algorithm to f2pool and the second algorithm to woolypooly
-u, --user <USER>
Sets the username for pool authorisation
When dual or triple mining the value should be prepended with
the algorithm index `[<index>]`. Primary algorithm has index 1.
-w, --worker <WORKER>
Sets the worker name
When dual or triple mining the value should be prepended with
the algorithm index `[<index>]`. Primary algorithm has index 1.
-d, --devices <D1,D2,...>
Sets GPU devices to use for mining
Must be a comma-separated list of device indices. If not specified,
all detected devices will be used. Devices are ordered by their
PCI bus addresses. First GPU has index of 0.
To display all available devices, use --list-devices.
Example:
-d 0,2,4,5
--list-devices
List available mining devices and exit
--dual-mode <MODE1,MODE2,...>
Controls GPU behaviour in dual mining mode
Format: <algo>:<dual ratio>
`<algo>` must be one of the following:
a1 - first algorithm
a2 - second algorithm,
a12 - both
`<dual ratio>` is optional, and, if present,
must be `rXX` (`dual ratio` coefficient set to `XX`)
Comma-separated list of values can be used to set values per-GPU
To skip a GPU, set the corresponding value to underscore `_`
Examples:
--dual-mode a1,_,a12:r5,a2
GPU#0 will mine the primary algorithm
GPU#1 will dual mine with default settings
GPU#1 will dual mine, dual ratio set to 5
GPU#2 will mine the second algorithm
--temp-limit <LIMIT1,LIMIT2,...>
Sets GPU thermal limits
Sets the temperatures of GPU core and memory upon reaching which the miner
stops the overheated GPU and waits for it to cool down before resuming.
Comma-separated list of values can be used to set values per-GPU
To skip a GPU, set the corresponding value to underscore `_`
Examples:
--temp-limit tc[60-70]
stops the GPU when its core temperature reaches 70 degrees celsius
and resumes mining when it cools down to 60 degrees
--temp-limit tm[105-115]
stops the GPU when its memory temperature reaches 115 degrees celsius
and resumes mining when it cools down to 60 degrees
--temp-limit tc[60-70]tm[105-115]
enables both core and memory temperature limits
--cpu-check
Enables CPU verification of found shares before sending them to the pool
--cclock <FREQ1,FREQ2,...>
Sets GPU core clock frequency offset in MHz
Comma-separated list of values can be used to set values per-GPU
To skip a GPU, set the corresponding value to underscore `_`
When dual or triple mining the value may be prepended with
the algorithm index `[<index>]`. Primary algorithm has index 1.
--mclock <FREQ1,FREQ2,...>
Sets GPU memory clock frequency offset in MHz
Comma-separated list of values can be used to set values per-GPU
To skip a GPU, set the corresponding value to underscore `_`
When dual or triple mining the value may be prepended with
the algorithm index `[<index>]`. Primary algorithm has index 1.
--lock-cclock <FREQ1,FREQ2,...>
Locks GPU core clock frequency to the given value in MHz
Comma-separated list of values can be used to set values per-GPU
To skip a GPU, set the corresponding value to underscore `_`
When dual or triple mining the value may be prepended with
the algorithm index `[<index>]`. Primary algorithm has index 1.
--lock-mclock <FREQ1,FREQ2,...>
Locks GPU memory clock frequency to the given value in MHz
Comma-separated list of values can be used to set values per-GPU
To skip a GPU, set the corresponding value to underscore `_`
When dual or triple mining the value may be prepended with
the algorithm index `[<index>]`. Primary algorithm has index 1.
--pl <PL1,PL2,...>
Set GPU power limit to the given value in Watts
Comma-separated list of values can be used to set values per-GPU
To skip a GPU, set the corresponding value to underscore `_`
When dual or triple mining the value may be prepended with
the algorithm index `[<index>]`. Primary algorithm has index 1.
--fan-control <FAN1,FAN2,...>
Sets GPU fan control mode
Can either force the GPU fans to work at a given static speed in %,
or adjust the fan speed to keep the GPU temperature (core, memory, or both)
at a desired level (auto-fan mode)
Format:
--fan-control N
set fan speed to `N`%
--fan-control t:[Tc,Tm][Finit;Fmin-Fmax]
enables auto-fan with `Tc` and `Tm` core and memory temperatures
respectively, set initial fan speed to `Finit`% and limit the
fan speed range to [`Fmin`%,`Fmax`%] range.
every value is optional and can be set to underscore `_`
meaning the default value should be used.
Comma-separated list of values can be used to set values per-GPU
To skip a GPU, set the corresponding value to underscore `_`
Examples:
--fan-control 30
sets GPU fan speed to 30%
--fan-control t:[60;_][50;30-95]
target core temp is 60 degrees, initial fan speed is 50%, 30%-95% range
--fan-control t:[_;90][_;_-95]
target memory temp is 90 degrees, max fan speed 95%
--fan-control t:[70;100][_;_-_]
adjust fan so that core temperature <= 70, memory temperature <= 100,
with no restrictions on the fan speed
-l, --log-file <LOG_FILE>
Enables logging output of the miner to the specified log file
--api-bind <IP:PORT>
Enables HTTP API and binds it to the specified socket address
Examples:
--api-bind 127.0.0.1:5000
--api-bind 0.0.0.0:5000
--long-timestamps
Enables milliseconds timestamps in the miner output
--no-tui
Disables terminal user interface (TUI)
--no-watchdog
Disables miner watchdog
-h, --help
Print help information (use `-h` for a summary)
-V, --version
Print version information
```

0 comments on commit a41421c

Please sign in to comment.