diff --git a/API-README b/API-README index 5ab1c72f..d4efaf6c 100644 --- a/API-README +++ b/API-README @@ -42,7 +42,7 @@ 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 An IP address/subnet can only be a member of one group 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 non-priviliged commands - the '*' means all non-priviledged commands Without the '*' the group would only have access to the pool commands @@ -339,7 +339,7 @@ miner.php - an example web page to access the API Feature Changelog for external applications using the API: -API V1.17 +API V1.17 (cgminer v2.7.1) Added API commands: 'coin' @@ -754,6 +754,31 @@ Below is each variable that can be changed and an explanation of each --------- +Default: + $dfmt = 'H:i:s j-M-Y \U\T\CP'; + +Define the date format used to print full length dates +If you get the string 'UTCP' on the end of your dates shown, that +means you are using an older version of PHP and you can instead use: + $dfmt = 'H:i:s j-M-Y \U\T\CO'; + +The PHP documentation on the date format is here: + http://us.php.net/manual/en/function.date.php + +--------- + +Default: + $title = 'Mine'; + +Web page title +If you know PHP you can of course use code to define it e.g. + $title = 'My Rig at: '.date($dfmt); + +Which would set the web page title to something like: + My Rig at: 10:34:00 22-Aug-2012 UTC+10:00 + +--------- + Default: $readonly = false; @@ -957,7 +982,7 @@ The section defines what data you want in the summary table and the Fields define what data you want shown from that section Standard sections are: - SUMMARY, POOL, PGA, GPU, NOTIFY, CONFIG, DEVDETAILS, DEVS, STATS + SUMMARY, POOL, PGA, GPU, NOTIFY, CONFIG, DEVDETAILS, DEVS, STATS, COIN Fields are the names as shown on the headers on the normal pages @@ -966,6 +991,7 @@ Fields can be 'name=new name' to display 'name' with a different heading There are also now joined sections: SUMMARY+POOL, SUMMARY+DEVS, SUMMARY+CONFIG, DEVS+NOTIFY, DEVS+DEVDETAILS + SUMMARY+COIN These sections are an SQL join of the two sections and the fields in them are named section.field where section. is the section the field comes from @@ -976,11 +1002,11 @@ Also note: - empty columns (e.g. an unknown field) are not shown - missing field data shows as blank - the field name '*' matches all fields except in joined sections - (useful for STATS) + (useful for STATS and COIN) There are 2 hard coded sections: - DATE - displays a date table like 'Summary' - RIGS - displays a rig table like 'Summary' + DATE - displays a date table like at the start of 'Summary' + RIGS - displays a rig table like at the start of 'Summary' Each custom summary requires a second array, that can be empty, listing fields to be totaled for each section @@ -1037,7 +1063,7 @@ Each table will have the chosen details for all the rigs specified in $rigs section.fieldname, not just fieldname The join code automatically adds 2 fields to each GPU device: 'Name' and 'ID' - They don't exist in the API 'devs' output but you can correctly calculate + They don't exist in the API 'devs' output but I can correctly calculate them from the GPU device data These two fields are used to join DEVS to NOTIFY i.e. find the NOTIFY record that has the same Name and ID as the DEVS record and join them diff --git a/miner.php b/miner.php index 52d2d14d..198f0cf5 100644 --- a/miner.php +++ b/miner.php @@ -762,6 +762,7 @@ function fmt($section, $name, $value, $when, $alldata) $class = $warnclass; break; case 'STATUS.When': + case 'COIN.Current Block Time': $ret = date($dfmt, $value); break; case 'BUTTON.Rig': @@ -1457,7 +1458,8 @@ $sectionmap = array( 'NOTIFY' => 'notify', 'DEVDETAILS' => 'devdetails', 'STATS' => 'stats', - 'CONFIG' => 'config'); + 'CONFIG' => 'config', + 'COIN' => 'coin'); # function joinfields($section1, $section2, $join, $results) { @@ -1592,6 +1594,7 @@ function joinsections($sections, $results, $errors) case 'POOL': case 'DEVS': case 'CONFIG': + case 'COIN': $sectionmap[$section] = $section; $results[$section] = joinall($both[0], $both[1], $results); break;