GOSTSec/sgminer
1
0
Fork 0
mirror of https://github.com/GOSTSec/sgminer synced 2025-01-11 07:17:58 +00:00
Code Issues Releases Wiki Activity

API-README break all lines at most 80 characters

Browse Source
This commit is contained in:
Kano 2013-08-23 16:46:03 +10:00
parent febcc53d99
commit 93d73a8a9a
1 changed files with 92 additions and 64 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

156
API-README
View File

@ -46,7 +46,8 @@ To give an IP address/subnet access to a group you use the group letter
in front of the IP address instead of W: e.g. P:192.168.0/32 in front of the IP address instead of W: e.g. P:192.168.0/32
An IP address/subnet can only be a member of one group An IP address/subnet can only be a member of one group
A sample API group would be: A sample API group would be:
--api-groups P:switchpool:enablepool:addpool:disablepool:removepool:poolpriority:* --api-groups
P:switchpool:enablepool:addpool:disablepool:removepool:poolpriority:*
This would create a group 'P' that can do all current pool commands and all This would create a group 'P' that can do all current pool commands and all
non-priviliged commands - the '*' means all non-priviledged commands non-priviliged commands - the '*' means all non-priviledged commands
Without the '*' the group would only have access to the pool commands Without the '*' the group would only have access to the pool commands
@ -110,7 +111,7 @@ The STATUS section is:
For API version 1.10 and later: For API version 1.10 and later:
The list of requests - a (*) means it requires privileged access - and replies are: The list of requests - a (*) means it requires privileged access - and replies:
Request Reply Section Details Request Reply Section Details
------- ------------- ------- ------- ------------- -------
@ -126,7 +127,8 @@ The list of requests - a (*) means it requires privileged access - and replies a
ADL in use=X, <- Y or N if any GPU has ADL ADL in use=X, <- Y or N if any GPU has ADL
Strategy=Name, <- the current pool strategy Strategy=Name, <- the current pool strategy
Log Interval=N, <- log interval (--log N) Log Interval=N, <- log interval (--log N)
Device Code=GPU ICA , <- spaced list of compiled devices Device Code=GPU ICA , <- spaced list of compiled
device drivers
OS=Linux/Apple/..., <- operating System OS=Linux/Apple/..., <- operating System
Failover-Only=true/false, <- failover-only setting Failover-Only=true/false, <- failover-only setting
ScanTime=N, <- --scan-time setting ScanTime=N, <- --scan-time setting
@ -136,15 +138,15 @@ The list of requests - a (*) means it requires privileged access - and replies a
summary SUMMARY The status summary of the miner summary SUMMARY The status summary of the miner
e.g. Elapsed=NNN,Found Blocks=N,Getworks=N,...| e.g. Elapsed=NNN,Found Blocks=N,Getworks=N,...|
pools POOLS The status of each pool pools POOLS The status of each pool e.g.
e.g. Pool=0,URL=http://pool.com:6311,Status=Alive,...| Pool=0,URL=http://pool.com:6311,Status=Alive,...|
devs DEVS Each available GPU, PGA and ASC with their details devs DEVS Each available GPU, PGA and ASC with their details
e.g. GPU=0,Accepted=NN,MHS av=NNN,...,Intensity=D| e.g. GPU=0,Accepted=NN,MHS av=NNN,...,Intensity=D|
Last Share Time=NNN, <- standand long time in seconds Last Share Time=NNN, <- standand long time in sec
(or 0 if none) of last accepted share (or 0 if none) of last accepted share
Last Share Pool=N, <- pool number (or -1 if none) Last Share Pool=N, <- pool number (or -1 if none)
Last Valid Work=NNN, <- standand long time in seconds Last Valid Work=NNN, <- standand long time in sec
of last work returned that wasn't an HW: of last work returned that wasn't an HW:
Will not report PGAs if PGA mining is disabled Will not report PGAs if PGA mining is disabled
Will not report ASCs if ASC mining is disabled Will not report ASCs if ASC mining is disabled
@ -155,7 +157,8 @@ The list of requests - a (*) means it requires privileged access - and replies a
pga|N PGA The details of a single PGA number N in the same pga|N PGA The details of a single PGA number N in the same
format and details as for DEVS format and details as for DEVS
This is only available if PGA mining is enabled This is only available if PGA mining is enabled
Use 'pgacount' or 'config' first to see if there are any Use 'pgacount' or 'config' first to see if there
are any
gpucount GPUS Count=N| <- the number of GPUs gpucount GPUS Count=N| <- the number of GPUs
@ -210,19 +213,23 @@ The list of requests - a (*) means it requires privileged access - and replies a
gpuintensity|N,I (*) gpuintensity|N,I (*)
none There is no reply section just the STATUS section none There is no reply section just the STATUS section
stating the results of setting GPU N intensity to I stating the results of setting GPU N intensity
to I
gpumem|N,V (*) gpumem|N,V (*)
none There is no reply section just the STATUS section none There is no reply section just the STATUS section
stating the results of setting GPU N memoryclock to V MHz stating the results of setting GPU N memoryclock
to V MHz
gpuengine|N,V (*) gpuengine|N,V (*)
none There is no reply section just the STATUS section none There is no reply section just the STATUS section
stating the results of setting GPU N clock to V MHz stating the results of setting GPU N clock
to V MHz
gpufan|N,V (*) gpufan|N,V (*)
none There is no reply section just the STATUS section none There is no reply section just the STATUS section
stating the results of setting GPU N fan speed to V% stating the results of setting GPU N fan speed
to V%
gpuvddc|N,V (*) gpuvddc|N,V (*)
none There is no reply section just the STATUS section none There is no reply section just the STATUS section
@ -230,23 +237,25 @@ The list of requests - a (*) means it requires privileged access - and replies a
save|filename (*) save|filename (*)
none There is no reply section just the STATUS section none There is no reply section just the STATUS section
stating success or failure saving the cgminer config stating success or failure saving the cgminer
to filename config to filename
The filename is optional and will use the cgminer The filename is optional and will use the cgminer
default if not specified default if not specified
quit (*) none There is no status section but just a single "BYE" quit (*) none There is no status section but just a single "BYE"
reply before cgminer quits reply before cgminer quits
notify NOTIFY The last status and history count of each devices problem notify NOTIFY The last status and history count of each devices
This lists all devices including those not supported problem
by the 'devs' command This lists all devices including those not
e.g. NOTIFY=0,Name=GPU,ID=0,Last Well=1332432290,...| supported by the 'devs' command e.g.
NOTIFY=0,Name=GPU,ID=0,Last Well=1332432290,...|
privileged (*) privileged (*)
none There is no reply section just the STATUS section none There is no reply section just the STATUS section
stating an error if you do not have privileged access stating an error if you do not have privileged
to the API and success if you do have privilege access to the API and success if you do have
privilege
The command doesn't change anything in cgminer The command doesn't change anything in cgminer
pgaenable|N (*) pgaenable|N (*)
@ -264,25 +273,28 @@ The list of requests - a (*) means it requires privileged access - and replies a
none There is no reply section just the STATUS section none There is no reply section just the STATUS section
stating the results of the identify request stating the results of the identify request
This is only available if PGA mining is enabled This is only available if PGA mining is enabled
and currently only BFL singles support this command and currently only BFL singles support this
command
On a BFL single it will flash the led on the front On a BFL single it will flash the led on the front
of the device for appoximately 4s of the device for appoximately 4s
All other non BFL PGA devices will return a warning All other non BFL PGA devices will return a
status message stating that they dont support it warning status message stating that they dont
This adds a 4s delay to the BFL share being processed support it
so you may get a message stating that procssing took This adds a 4s delay to the BFL share being
longer than 7000ms if the request was sent towards processed so you may get a message stating that
the end of the timing of any work being worked on procssing took longer than 7000ms if the request
was sent towards the end of the timing of any work
being worked on
e.g.: BFL0: took 8438ms - longer than 7000ms e.g.: BFL0: took 8438ms - longer than 7000ms
You should ignore this You should ignore this
devdetails DEVDETAILS Each device with a list of their static details devdetails DEVDETAILS Each device with a list of their static details
This lists all devices including those not supported This lists all devices including those not
by the 'devs' command supported by the 'devs' command
e.g. DEVDETAILS=0,Name=GPU,ID=0,Driver=opencl,...| e.g. DEVDETAILS=0,Name=GPU,ID=0,Driver=opencl,...|
restart (*) none There is no status section but just a single "RESTART" restart (*) none There is no status section but just a single
reply before cgminer restarts "RESTART" reply before cgminer restarts
stats STATS Each device or pool that has 1 or more getworks stats STATS Each device or pool that has 1 or more getworks
with a list of stats regarding getwork times with a list of stats regarding getwork times
@ -307,12 +319,13 @@ The list of requests - a (*) means it requires privileged access - and replies a
debug|setting (*) debug|setting (*)
DEBUG Debug settings DEBUG Debug settings
The optional commands for 'setting' are the same as The optional commands for 'setting' are the same
the screen curses debug settings as the screen curses debug settings
You can only specify one setting You can only specify one setting
Only the first character is checked (case insensitive): Only the first character is checked - case
Silent, Quiet, Verbose, Debug, RPCProto, PerDevice, insensitive:
WorkTime, Normal Silent, Quiet, Verbose, Debug, RPCProto,
PerDevice, WorkTime, Normal
The output fields are (as above): The output fields are (as above):
Silent=true/false, Silent=true/false,
Quiet=true/false, Quiet=true/false,
@ -334,34 +347,39 @@ The list of requests - a (*) means it requires privileged access - and replies a
pgaset|N,opt[,val] (*) pgaset|N,opt[,val] (*)
none There is no reply section just the STATUS section none There is no reply section just the STATUS section
stating the results of setting PGA N with opt[,val] stating the results of setting PGA N with
opt[,val]
This is only available if PGA mining is enabled This is only available if PGA mining is enabled
If the PGA does not support any set options, it will If the PGA does not support any set options, it
always return a WARN stating pgaset isn't supported will always return a WARN stating pgaset isn't
supported
If opt=help it will return an INFO status with a If opt=help it will return an INFO status with a
help message about the options available help message about the options available
The current options are: The current options are:
MMQ opt=clock val=160 to 230 (and a multiple of 2) MMQ opt=clock val=160 to 230 (a multiple of 2)
zero|Which,true/false (*) zero|Which,true/false (*)
none There is no reply section just the STATUS section none There is no reply section just the STATUS section
stating that the zero, and optional summary, was done stating that the zero, and optional summary, was
If Which='all', all normal cgminer and API statistics done
will be zeroed other than the numbers displayed by the If Which='all', all normal cgminer and API
usbstats and stats commands statistics will be zeroed other than the numbers
displayed by the usbstats and stats commands
If Which='bestshare', only the 'Best Share' values If Which='bestshare', only the 'Best Share' values
are zeroed for each pool and the global 'Best Share' are zeroed for each pool and the global
The true/false option determines if a full summary is 'Best Share'
shown on the cgminer display like is normally displayed The true/false option determines if a full summary
on exit. is shown on the cgminer display like is normally
displayed on exit.
hotplug|N (*) none There is no reply section just the STATUS section hotplug|N (*) none There is no reply section just the STATUS section
stating that the hotplug setting succeeded stating that the hotplug setting succeeded
If the code is not compiled with hotplug in it, the If the code is not compiled with hotplug in it,
the warning reply will be 'Hotplug is not available' the the warning reply will be
'Hotplug is not available'
If N=0 then hotplug will be disabled If N=0 then hotplug will be disabled
If N>0 && <=9999, then hotplug will check for new If N>0 && <=9999, then hotplug will check for new
devices every N seconds devices every N seconds
@ -399,24 +417,27 @@ The list of requests - a (*) means it requires privileged access - and replies a
ascset|N,opt[,val] (*) ascset|N,opt[,val] (*)
none There is no reply section just the STATUS section none There is no reply section just the STATUS section
stating the results of setting ASC N with opt[,val] stating the results of setting ASC N with
opt[,val]
This is only available if ASC mining is enabled This is only available if ASC mining is enabled
If the ASC does not support any set options, it will If the ASC does not support any set options, it
always return a WARN stating ascset isn't supported will always return a WARN stating ascset isn't
supported
If opt=help it will return an INFO status with a If opt=help it will return an INFO status with a
help message about the options available help message about the options available
The current options are: The current options are:
AVA+BTB opt=freq val=256 to 450 - chip frequency AVA+BTB opt=freq val=256 to 450 - chip frequency
BTB opt=millivolts val=1000 to 1310 - core voltage BTB opt=millivolts val=1000 to 1310 - corevoltage
When you enable, disable or restart a GPU, PGA or ASC, you will also get When you enable, disable or restart a GPU, PGA or ASC, you will also get
Thread messages in the cgminer status window Thread messages in the cgminer status window
The 'poolpriority' command can be used to reset the priority order of multiple The 'poolpriority' command can be used to reset the priority order of multiple
pools with a single command - 'switchpool' only sets a single pool to first priority pools with a single command - 'switchpool' only sets a single pool to first
priority
Each pool should be listed by id number in order of preference (first = most Each pool should be listed by id number in order of preference (first = most
preferred) preferred)
Any pools not listed will be prioritised after the ones that are listed, in the Any pools not listed will be prioritised after the ones that are listed, in the
@ -584,8 +605,9 @@ Modified API commands:
'pga|N' - add 'Diff1 Work', 'Difficulty Accepted', 'pga|N' - add 'Diff1 Work', 'Difficulty Accepted',
'Difficulty Rejected', 'Last Share Difficulty' 'Difficulty Rejected', 'Last Share Difficulty'
'notify' - add '*Dev Throttle' (for BFL Singles) 'notify' - add '*Dev Throttle' (for BFL Singles)
'pools' - add 'Proxy Type', 'Proxy', 'Difficulty Accepted', 'Difficulty Rejected', 'pools' - add 'Proxy Type', 'Proxy', 'Difficulty Accepted',
'Difficulty Stale', 'Last Share Difficulty' 'Difficulty Rejected', 'Difficulty Stale',
'Last Share Difficulty'
'config' - add 'Queue', 'Expiry' 'config' - add 'Queue', 'Expiry'
'stats' - add 'Work Diff', 'Min Diff', 'Max Diff', 'Min Diff Count', 'stats' - add 'Work Diff', 'Min Diff', 'Max Diff', 'Min Diff Count',
'Max Diff Count' to the pool stats 'Max Diff Count' to the pool stats
@ -1017,7 +1039,8 @@ the last one
So an example for 3 rigs would be: So an example for 3 rigs would be:
$rigs = array('192.168.0.100:4028:A', '192.168.0.102:4028:B', '192.168.0.110:4028:C'); $rigs = array('192.168.0.100:4028:A', '192.168.0.102:4028:B',
'192.168.0.110:4028:C');
Of course each of the rigs listed would also have to have the API Of course each of the rigs listed would also have to have the API
running and be set to allow the web server to access the API - as running and be set to allow the web server to access the API - as
@ -1392,11 +1415,14 @@ Looking at the Mobile example:
'DEVS.Temperature=Temp', 'DEVS.MHS av=MHS av', 'DEVS.Temperature=Temp', 'DEVS.MHS av=MHS av',
'DEVS.Accepted=Accept', 'DEVS.Rejected=Rej', 'DEVS.Accepted=Accept', 'DEVS.Rejected=Rej',
'DEVS.Utility=Utility', 'NOTIFY.Last Not Well=Not Well'), 'DEVS.Utility=Utility', 'NOTIFY.Last Not Well=Not Well'),
'POOL' => array('POOL', 'Status', 'Accepted', 'Rejected=Rej', 'Last Share Time')); 'POOL' => array('POOL', 'Status', 'Accepted', 'Rejected=Rej',
'Last Share Time'));
$mobilesum = array( $mobilesum = array(
'SUMMARY' => array('MHS av', 'Found Blocks', 'Accepted', 'Rejected', 'Utility'), 'SUMMARY' => array('MHS av', 'Found Blocks', 'Accepted', 'Rejected',
'DEVS+NOTIFY' => array('DEVS.MHS av', 'DEVS.Accepted', 'DEVS.Rejected', 'DEVS.Utility'), 'Utility'),
'DEVS+NOTIFY' => array('DEVS.MHS av', 'DEVS.Accepted', 'DEVS.Rejected',
'DEVS.Utility'),
'POOL' => array('Accepted', 'Rejected')); 'POOL' => array('Accepted', 'Rejected'));
$customsummarypages = array('Mobile' => array($mobilepage, $mobilesum)); $customsummarypages = array('Mobile' => array($mobilepage, $mobilesum));
@ -1483,8 +1509,10 @@ $poolsext = array(
'POOL.Stratum Active', 'POOL.Has GBT'), 'POOL.Stratum Active', 'POOL.Has GBT'),
'calc' => array('POOL.Difficulty Accepted' => 'sum', 'calc' => array('POOL.Difficulty Accepted' => 'sum',
'POOL.Difficulty Rejected' => 'sum', 'POOL.Difficulty Rejected' => 'sum',
'STATS.Times Sent' => 'sum', 'STATS.Bytes Sent' => 'sum', 'STATS.Times Sent' => 'sum',
'STATS.Times Recv' => 'sum', 'STATS.Bytes Recv' => 'sum'), 'STATS.Bytes Sent' => 'sum',
'STATS.Times Recv' => 'sum',
'STATS.Bytes Recv' => 'sum'),
'having' => array(array('STATS.Bytes Recv', '>', 0))) 'having' => array(array('STATS.Bytes Recv', '>', 0)))
); );
@ -1534,5 +1562,5 @@ The first 4 are as expected - the numerical sum, average, minimum or maximum
'count' is the number of rows in the section specified in the calc e.g. 'count' is the number of rows in the section specified in the calc e.g.
('DEVS.Name' => 'count') would be the number of DEVS selected in the 'where' ('DEVS.Name' => 'count') would be the number of DEVS selected in the 'where'
of course any valid 'DEVS.Xyz' would give the same 'count' value of course any valid 'DEVS.Xyz' would give the same 'count' value
'any' is effectively random: the field value in the first row of the grouped data 'any' is effectively random: the field value in the 1st row of the grouped data
An unrecognised 'function' uses 'any' An unrecognised 'function' uses 'any'