Team Red Miner Dual Coin ETH Mining

===================================

TL;DR
-----
To mine ETH+TON (which is the only supported dual algo at the moment),
take a working TRM ethash command line and add a TON section in the
middle or at the end:

--ton -o stratum+tcp://ton.hashrate.to:4002 -u <ton wallet>.<worker> -p x --ton_end

If you don't want to dual mine on all devices, you can add a device
selection argument inside the --ton .. --ton_end clause. If you only
want to dual mine on gpu 0 and gpu 3 you would use:

--ton -d 0,3 -o stratum+tcp://ton.hashrate.to:4002 -u <ton wallet>.<worker> -p x --

ton_end

TRM's dual mining setup let's the user split the capacity between
ethash and the second algo using the standard --eth_config
argument. The higher intensity, the more capacity for ethash and less
for the dual algo. Therefore, you SHOULD remove any existing
--eth_config arguments in your ethash command line. They're not
applicable. Let the miner run the dual algo tuner once, then you can
add back a static config. The dual tuner will output a list of the
probed results.

Power draw will often be HIGH, especially on Vegas and Polaris

gpus. It depends on what clocks you're coming from for ethash. Use
core clock adjustments and the argument --dual_intensity (see --help
or USAGE.txt) to keep power draw in check.

Last, see the TON dual mining section in USAGE.txt or the miner's
--help output for additional arguments.

Overview
--------
From v0.9.2, TRM includes support for true dual mining together with
ethash. All AMD gpus are now supported. Subsequent releases might add
support more dual mining algos - the single supported dual algo
currently is TON.

TRM's dual mining is configurable in the sense that the user decides
how the gpu capacity should be split between the two algos. This is
done with the normal --eth_config argument that decides how much gpu
capacity will be used by ethash. The remaining capacity is available
for the dual algo. The eth config intensities used for single algo
ethash should _NOT_ be carried over to a dual mining setup. The dual
mining ethash kernel is designed differently and does not target the
absolute max possible ethash hashrate. It rather tries to provide a
good trade-off between running a very competitive ethash hashrate
close to the max possible while also providing room for the dual algo
to operate.

Dual mining ETH+TON

--------------------
To dual mine ethash and TON, do as follows:
1) Start with a working ethash configuration for TRM.

2) If you have an --eth_config argument, remove the intensities. You

can keep the A/B-mode setting.

3) Add a TON argument section that contains the pool(s) you want to
use for dual TON mining. This follows the same principle as TRM's
dual ZIL mining setup. This added argument will enable dual TON
mining on the Icemining pool:

--ton -o stratum+tcp://ton.hashrate.to:4002 -u <ton wallet>.<worker> -p x --

ton_end

It's fully possible to insert the --ton ... --ton_end arguments

into e.g. a Hive flight sheet's custom miner arguments section to
enable dual mining, while still using Hive's builtin support for
configuring the ethash mining.

4) If you only want to dual mine on a smaller selection of gpus, you

can add a device selection argument inside the ton argument
list. For example, if you want to dual mine on gpu 0, 1 and 4 in
the rig but just do plain ethash on the rest you would use:

--ton -d 0,1,4 -o stratum+tcp://ton.hashrate.to:4002 -u <ton wallet>.<worker> -p

x --ton_end

5) If power draw is too high, or your card end up with strange low
hashrates for either eth or ton, use the --dual_intensity argument
to use less power and avoid being power throttled. This argument
will limit the gpu capacity used for the dual algo. Accepted values
are 0.0-1.0, where 0.6 means 60% capacity is used. You can provide
individual values per gpu in a comma-separate list. See USAGE.txt
or the miner's --help output for more info. Note that this argument
is now available for all gpus, not just Vega and Polaris as was the
case in the first releases.

Tuning
------
Dual mining will inevitably pull significantly more power than single
algo ethash. The user is advised to tune a single gpu by itself first
to assess power draw. Especially Vega and Polaris gpus need to be
handled delicately at first when testing.

Monitor gpus
All gpus with display(s) connected will have its dual intensity
throttled down to 0.65 automatically. This is the best way to avoid
sluggish behavior. If you want to override this, pass your own
--dual_intensity=X argument overriding the default choice.

Navi/Big Navi
Standard ethash clocks with a slight core voltage increase is a good
starting point for dual mining. After that, tuning is mostly a
function of achieving stability and how much power you want to
consume. Increasing core clk will increase the dual algo performance,
but at the cost of more power. Navis can now also use the
--dual_intensity=X argument to throttle the dual algo. Using
--dual_intensity=0.6 means the dual algo runs using 60% of the gpu
capacity available to it.
Vega
Test on a single gpu and be prepared for a 30-40% increase in power
draw. We suggest lowering the core clk as well. If the power draw is
too high for your setup, you can either throttle the whole gpu by
lower the core clk, or use the argument --dual_intensity=X to reduce
the gpu capacity used by the dual ton. By using
e.g. --dual_intensity=0.5 the dual algo will only use 50% of the
available gpu resources after ethash. This is a way of keeping power
draw lower by still keeping core clk high, which is necessary on an
aggressively tuned Vega to keep up ethash hashrate.

We _strongly_ suggest using Vegas B-mode when running a lower core clk
and dual mining, this will make it easier to keep your eth hashrate
relatively high. B-mode is the default mode chosen for Vegas when dual
mining (or C-mode for Radeon VIIs if available).

Polaris
Polaris gpus run dual mining quite well. You can often use your
standard eth clocks, and gain 600-750 MH/s ton for an additional power
draw of 35-45W at the wall per gpu. Use clocks/voltages or the
--dual_intensity argument to lower power draw at the cost of either
lower hashrates for both algos, or just lower the dual algo using
--dual_intensity.

Dual Mining Ethash Modes and Intensity

--------------------------------------
All ethash mining modes (A/B/C) are available in dual mining as well,
and behave like they do for single algo ethash mining. The B/C-modes
are often very helpful when dual mining on Vegas and Navis since they
help keep a higher eth hashrate even when lowering the core clk in
order to keep power draw in check. For Polaris gpus, the mode does not
have the same effect as for Navis and Vegas.

For choosing the intensity, TRM includes a dual mining tuner that,
unless a static eth config intensity has been provided, scans through
a range of eth config intensities at startup and selects the optimal
one based on a scoring model. There are built-in weights for each pair
of algos that can be dual mined, but over time you might want to tweak
the optimization target function using the argument
--dual_tuner_weights=X:Y:Z. This argument is described in detail in
USAGE.txt and the miner's --help output.

As mentioned above, ethash config intensities from single algo ethash

mining should _NOT_ be used in a dual mining setting. We recommend
that you at least do one dual tuner run and inspect the output, or
always let the dual tuner run at startup. The process takes 3-4
minutes to complete.

It should be noted that the dual tuner is somewhat crude and can
sometimes produce skewed results. This is mainly because we don't want
the process to take 10-15 minutes. The tuner outputs the results for
all scanned configurations after completing the scan, and the user can
pick a static config from there to add to the command line.

Last, there is an additional tuning parameter called

--dual_intensity=X,Y,Z,... It is now available for all supported
gpus. The argument limits the gpu resources that the dual algo mining
will use. The argument is passed in a list of either a single value
for all gpus, or a list of values per gpu. The range is 0.0-1.0, and
0.7 means that the dual mining will use 70% of the available resources
after ethash.