psout.1.html 4.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110
  1. <?xml version='1.0' encoding='iso-8859-1'?>
  2. <!doctype html public '-//W3C//DTD XHTML 1.0 Strict//EN' 'http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd'>
  3. <html xmlns='http://www.w3c.org/1999/xhtml' lang='en-us'>
  4. <head>
  5. <title>
  6. psout.1
  7. </title>
  8. <meta http-equiv='content-type' content='text/html;iso-8859-1'/>
  9. <meta name='generator' content='motley-tools 1.9.4 13:40:33 Feb 18 2015'/>
  10. <meta name='author' content='cmaier@cmassoc.net'/>
  11. <meta name='robots' content='noindex,nofollow'/>
  12. <link href='toolkit.css' rel='stylesheet' type='text/css'/>
  13. </head>
  14. <body>
  15. <div class='headerlink'>
  16. [<a href='psnotch.1.html' title=' psnotch.1 '>PREV</a>]
  17. [<a href='toolkit.html' title=' Index '>HOME</a>]
  18. [<a href='ptsctl.1.html' title=' ptsctl.1 '>NEXT</a>]
  19. </div>
  20. <pre>
  21. psout(1) Qualcomm Atheros Open Powerline Toolkit psout(1)
  22. NAME
  23. psout - Export PIB Prescalers
  24. SYNOPSIS
  25. psout [options] file [&gt;stdout]
  26. DESCRIPTION
  27. Export the prescaler section of a PIB file as an amplitude map suitable for input to program psin or the Qualcomm Atheros
  28. Windows Device Manager. Prescalers are stored in the PIB in binary format but the amplitude map is in text format so
  29. that values may be changed using an ordinary text editor. Program psin can be used to import an amplitude map into the
  30. original or another PIB file.
  31. This program is part of the Qualcomm Atheros Powerline Toolkit. See the AMP man page for an overview and installation
  32. instructions.
  33. OPTIONS
  34. None.
  35. ARGUMENTS
  36. file The name of an Atheros Parameter Information Block (PIB) file. This file is not modified. By convention, PIB
  37. files have a .pib extension but this program does not enforce that convention and does not make any assumption
  38. based on filename or extension but the program will reject invalid PIB files. Only one filename is permitted on
  39. the command line.
  40. FILES
  41. An amplitude map consists of 1155 frequency-amplitude pairs. Each pair consists of a decimal index and a hexadecimal
  42. scaler. The index represents a frequecy from 1.8 mhz through 30 mhz. The scaler represents the amplitude attenuation
  43. applied at that frequency. The frequency and attenuation are computed as follows.
  44. frequency = 40.96 * (index + 74)
  45. index = (frequency / 40.96) - 74
  46. decibels = 20 * log10 (scaler / 256)
  47. scaler = 256 * pow (decibels / 20)
  48. EXAMPLES
  49. The following example prints the prescaler section of file abc.pib on stdout as an amplitude map. The output has been
  50. abbreviated here to save space. A single comment line identifies the prescaler source file. Output may be directed to a
  51. text file, edited using a text editor and read into the same or another PIB file with program psin.
  52. # psout abc.pib
  53. # file: abc.pib
  54. 00000000 00000000
  55. 00000001 00000000
  56. 00000002 00000000
  57. 00000003 00000000
  58. ...
  59. 00000027 000000D0
  60. 00000028 000000D0
  61. 00000029 000000D1
  62. 00000030 000000D1
  63. ...
  64. 00000214 00000000
  65. 00000215 00000000
  66. 00000216 00000000
  67. ...
  68. 00001155 00000000
  69. The next example copies prescalers from file abc.pib to def.pib using a command line pipe.
  70. # psout abc.pib | psin def.pib
  71. DISCLAIMER
  72. PIB file structure and content is proprietary to Qualcomm Atheros, Ocala FL USA. Consequently, public information is not
  73. available. Qualcomm Atheros reserves the right to modify PIB file structure or content in future firmware releases with‐
  74. out any obligation to notify or compensate users of this program.
  75. Tampering with prescaler settings may violate national or international electo-magnetic emission standards and lead to
  76. fines or penalties. Qualcomm Atheros shall not be held responsible for any consequences of modifications made to
  77. prescaler sets provided to their customers.
  78. SEE ALSO
  79. psgraph(1), pskey(1), psin(1)
  80. CREDITS
  81. Charles Maier &lt;cmaier@qca.qualcomm.com&gt;
  82. open-plc-utils-0.0.3 Mar 2014 psout(1)
  83. </pre>
  84. <div class='footerlink'>
  85. [<a href='psnotch.1.html' title=' psnotch.1 '>PREV</a>]
  86. [<a href='toolkit.html' title=' Index '>HOME</a>]
  87. [<a href='ptsctl.1.html' title=' ptsctl.1 '>NEXT</a>]
  88. </div>
  89. </body>
  90. </html>