From 18e532b8407c564942185e618b3becb6b75af234 Mon Sep 17 00:00:00 2001 From: joan2937 Date: Mon, 4 May 2020 20:46:45 +0100 Subject: [PATCH] updated pigs.def for WVCAP and download.html for download version --- .gitignore | 6 ++++++ DOC/dbase/pigpio.sqlite | Bin 1433600 -> 1433600 bytes DOC/src/defs/pigs.def | 27 +++++++++++++-------------- DOC/src/html/download.html | 14 ++++++++------ pigs.1 | 34 ++++++++++++++++++---------------- 5 files changed, 45 insertions(+), 36 deletions(-) diff --git a/.gitignore b/.gitignore index 140d796..39331b5 100644 --- a/.gitignore +++ b/.gitignore @@ -13,4 +13,10 @@ build dist *.egg-info wavepad_jitter.py +# DOC files +DOC/dbase/pigpio.sqlite.* +DOC/tmp +DOC/MAN/* +!DOC/MAN/README* +DOC/HTML/*.html diff --git a/DOC/dbase/pigpio.sqlite b/DOC/dbase/pigpio.sqlite index 531ccfdfd27ef10f9bcf37d19363c790d85c0e4e..22ceb98d1881a04d738f5577804bc7869e75672a 100644 GIT binary patch delta 2429 zcmZvee{d7W6~}eDlXbf*olaOL2FG}X9f|?llErU~kTEVlLWu`R43uD>&DpqPOG1*J zA8iMdWK8*OL1$jlW*XC`F@c8K5WFq6tpxmJ32GOn`kV7sZhw|i{Qs!`%4evee66am+ zl%!?1ds%U@lY~o(N`E?E)VbYbQc0(gG1D2|W2Vv_iFi#*Dq2&uClaMKt%==cltP%e zLkqi%bjD0oKHibE9B6kONBk?3t-E=$qdnP?sF*asVd5@z)0!$P(Sb|EEiMuD{+`eG z;2cmT-L7{~9#!?P-&v79D91?be<5Tlge1Q{k|G zArCNT(yeqklrHa??B4a_LETfR=m)Q)1D=8cCn+c{37$Ml1fA~rl)$calnGx>enL_l z4k^~hJ$>BU$F)B0>*M+e_tVi`ju-Jn$B@4xA0pS0TgXSq8RTQ+1LS?=ugExZ4Y`Tj zz_iX9wTLF5o}1UZHrNBWU0 zasoMt{1ABt`4RFg@;vf$DKjxHbMS3qissTOfVsP!WngmBEMQd9~tYgKpGdeVo1ve@@b8 zEM@P5;iz;H?(UG>!n>K?@d~AxCL|e6B2`O|X)qq63Y>d@YH+zJuW;&7#2RQsBIx*y zmUME(QV165`QnpONhJ_%R~JGd|tufh^)+q%VnhWV8)g|KGZFRE-UAt%zjMh=_#RX)oohJm>$JF)W)f?&>O{reCBn({>>O4_Bq1M{= zut>k7qDpX8-69&t)qCyPYS{Z@vIa`dt4zExtVT7s`B^#9Xdmdin5UMfbG9rWc^A)gPk|!rJ{x_4@x6L_NG^etYjI^)GH;TR9E7*`%00$ zE#vG#S@FP-q$n2y%J(N*q5p=Q)Zjmgi^4-Um(??JX!K8k$ndPo$+=UzAA45 z&vxpCC;uYn!@za<9&vbF&a)R-4cQ%Z7JO@lmx*Uj(cK#Sa=u(3W{lDuw!IF9$4G@3 zc%3$DLdjttTK}#!c(hh?-~XCY1rr&c=i(~1(6-dW{&!gjo_m#0@sh;0Xt31H=7~z3 z)k_*iezSttrA)klxBmF zQ?r#ECJNb3iDThxo*k|6L>tfSF?lADF*-RkT~UH?dIr{V@ru$2RWn%yw7jP-hgcK7 zJo=}xt%{K{Ioz7YnlR6P!Ajvf`D_KeEf|51pZ84{xgwV5gxni!j=TO*qbu2I!v2qx zMItnd<)jP8-}2ZyUMut~J8iagcTzOAPM(jIA#I5|B|GNXm*B~i*<&qlFVU7V+Pm<{uwHt6?jw85 zlu7XzP+Ch~)GVHP%*rxVOG|f##}gSWqSHvVo7{{iy4&~g)C);L6lWpQs58FTnoudI1rV%fB_L)yO#{~wb5_vLGU>Z_?x F|1YPg&Vm2{ delta 1835 zcmYk7du&s66vz9!ZP(}S+WY%W9)s<&&B0`kjyeZ2N(bXH5vUTJyvD{TFhka|6%<8R zLNWqju*(Q1fI=}S-~%@XJ&1{!OpJjrDv61Y1nLWXL|pVgf$6zdWBlWjoPN*wo%1{A z{F)mdsE-fScjvHtZQN{czNu_nZ>Gs)l4QS0)?|Nwg=a8xhhN_5ml+|UUpA*cVly$4 z>+WLG^hbf^xySZ|3f)*T%;(7#Iva$V`+PB88sPy3YP}?*lIBgagIqOpTQ$gu;tLqKZu5u0cY}V*StL)o!%8F;Lwl=24y|Okx(=~p)` z*_cVsR8dwc)_?>%%d)F53$HM7aaBlTi9;YTIt%jXSX?K#S-wo z!(h^HR*qHme7Q{@!yeQc^oBzX87_FRir3+@K|W1RChTSp+l$&F-Kq8~wa}|_7cNnG zKu!+m&V8tr8O{TW8$BMr-56juYPq@^9nI^`FXXj`sG%n7;&U$Ugge7Z1mfdi=BBo!?KN|zxVLTyM7^9?F) zuwUZ&&@iYJ^lWQ!V^go3DH!##|eYpUl2u5Lj=26o!I| z9UHeQ6;^$`Z_>NbkN1S^<4|o>HW|fE(pq%&`U%@%JQ`B|$kby`(JG8m#ThlQtevJE z3Mw_mfwyT9dNqrWnnso~n^pEMY5_ew9aqMl&lT-*ve!u$K0~t>BquP-23JbWMKJW2 z(+P2ZmIHoSnt2+3^@tNjy*^r%9+^8)&;nJlT~4N*l=v(yR@X<4yL^yXC9>euHP@(~ z#Mx>*=o9yhv;9<@Vw|Pw?6z=IEUY%cZzUoJi-Tf{O)6C(F;C=KjVBHt%@Zr3;d6@< zCe9ZVa-!k3=5T9FjjU5+kyz74wJqEp*-ToQ6FTOLxy%Wl%ojW0)=VV_9t6b;mZr9_ z6K>Us)euKlA>OMIwG8Txa2d}n5Hf>LFS(Y%fS(rk$U9ai7zwb&j!xbTM$QU5P z!ly(DsH;V~XU|yyuZ`heEN&E6>3O)Q=L-Gg$HX1Dzrb#XYo`<$$M%XYEA}VFVuxh9 zh?bNX$wH|yn|aWja7j^{^-q)a&&;>9O?9}`;~s74i+3^4t{dxwJ3Cu)WRK6A&~qY! zFAMkY4!x~Fr|RxhGdoqeQ_bpBJxSH;9B5!clZib>_z55J1W`y#Au5PUqLg@?m_}3) zPZHCKsl>CyGGaNgf>=qcA|58{VME$m-th%h|B|>#+#=G%H^jHZcf|L^55#Ta4)G)L z6Y(?g3#BP09w8U61sG+295vR!x z(6{P_d{P?r22Yw(<~Vv%=07^LP!|1JI8B>0DT=0) is returned. On error a negative status -code will be returned. +Upon success a wave id (>=0) is returned. On error a negative status code will be returned. -The data provided by the [*WVAG*] and [*WVAS*] commands are -consumed by this command. +The data provided by the [*WVAG*] and [*WVAS*] commands are consumed by this command. -As many waveforms may be created as there is space available. -The wave id is passed to [*WVTX*] or [*WVTXR*] to specify the -waveform to transmit. +As many waveforms may be created as there is space available. The wave id is passed to [*WVTX*] or [*WVTXR*] to specify the waveform to transmit. Normal usage would be @@ -2813,8 +2806,9 @@ Step 4. [*WVTX*] or [*WVTXR*] with the id of the waveform to transmit. Repeat steps 2 - 4 as needed. -Step 5. Any wave id can now be deleted and another wave of the same size - can be created in its place. +Step 5. Any wave id can now be deleted and another wave of the same size can be created in its place. + +Example ... # Create a wave that consumes 50% of the total resource: @@ -3200,6 +3194,11 @@ must match an entry in /opt/pigpio/access. pdc :: hardware PWM dutycycle (0-1000000) The command expects a dutycycle. +percent :: percent (1-100) +The percent of wave resources to allocate to a wave. It can be useful +to create waves of fixed sizes to prevent wave fragmentation (where +there are plenty of resources but not a large enough contiguous space). + pf :: hardware PWM frequency (1-125M, 1-187.5M for the BCM2711) The command expects a frequency. diff --git a/DOC/src/html/download.html b/DOC/src/html/download.html index 8c2c7be..740a3c8 100644 --- a/DOC/src/html/download.html +++ b/DOC/src/html/download.html @@ -1,7 +1,7 @@ - + download @@ -14,12 +14,14 @@ pigpiod).
compilation of pigpio.c, takes 100 seconds on early model Pis.  Be patient.  The overall install takes just over 3 minutes.
-

Download and install (V75)

-wget https://github.com/joan2937/pigpio/archive/v75.zip
-unzip v75.zip
-cd pigpio-75
+

Download and install latest version

+ +wget https://github.com/joan2937/pigpio/archive/master.zip
+unzip master.zip
+cd pigpio-master
make
-sudo make install

+sudo make install
+
If the Python part of the install fails it may be because you need the setup tools.
diff --git a/pigs.1 b/pigs.1 index 9b6192c..b315910 100644 --- a/pigs.1 +++ b/pigs.1 @@ -548,8 +548,8 @@ Add serial data to waveform .B WVCRE Create a waveform .P -.B WVCAP -Create a waveform of fixed size +.B WVCAP percent +Create a waveform of fixed size .P .B WVDEL wid Delete selected waveform @@ -5142,27 +5142,20 @@ ERROR: attempt to create an empty waveform .br -.IP "\fBWVCAP \fP - Create a waveform of fixed size" +.IP "\fBWVCAP percent\fP - Create a waveform of fixed size" .IP "" 4 .br -Similar to \fBWVCRE\fP, this command creates a waveform but pads the consumed -resources to a fixed size, specified as a percent of total resource. -Padded waves of equal size can be re-cycled efficiently allowing newly -created waves to re-use the resources of deleted waves of the same dimension. +Create a waveform of fixed size. Similar to \fBWVCRE\fP, this command creates a waveform but pads the consumed resources to a fixed size, specified as a \fBpercent\fP of the total resources. Padded waves of equal size can be re-cycled efficiently allowing newly created waves to re-use the resources of deleted waves of the same dimension. .br -Upon success a wave id (>=0) is returned. On error a negative status -code will be returned. +Upon success a wave id (>=0) is returned. On error a negative status code will be returned. .br -The data provided by the \fBWVAG\fP and \fBWVAS\fP commands are -consumed by this command. +The data provided by the \fBWVAG\fP and \fBWVAS\fP commands are consumed by this command. .br -As many waveforms may be created as there is space available. -The wave id is passed to \fBWVTX\fP or \fBWVTXR\fP to specify the -waveform to transmit. +As many waveforms may be created as there is space available. The wave id is passed to \fBWVTX\fP or \fBWVTXR\fP to specify the waveform to transmit. .br Normal usage would be @@ -5183,8 +5176,10 @@ Step 4. \fBWVTX\fP or \fBWVTXR\fP with the id of the waveform to transmit. Repeat steps 2 - 4 as needed. .br -Step 5. Any wave id can now be deleted and another wave of the same size - can be created in its place. +Step 5. Any wave id can now be deleted and another wave of the same size can be created in its place. + +.br +Example .br @@ -5881,6 +5876,13 @@ The command expects a dutycycle. .br +.IP "\fBpercent\fP - percent (1-100)" 0 +The percent of wave resources to allocate to a wave. It can be useful +to create waves of fixed sizes to prevent wave fragmentation (where +there are plenty of resources but not a large enough contiguous space). + +.br + .IP "\fBpf\fP - hardware PWM frequency (1-125M, 1-187.5M for the BCM2711)" 0 The command expects a frequency.