git.piffa.net Git - rover/blob - README.html

   1 <!DOCTYPE html>
   2 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   3 <head>
   4 <meta charset="utf-8"/>
   5 <meta name="generator" content="Docutils 0.13.1: http://docutils.sourceforge.net/" />
   6 <title>Rover</title>
   7 <style type="text/css">
   8
   9 /* Minimal style sheet for the HTML output of Docutils.                    */
  10 /*                                                                         */
  11 /* :Author: Günter Milde, based on html4css1.css by David Goodger          */
  12 /* :Id: $Id: minimal.css 7952 2016-07-26 18:15:59Z milde $               */
  13 /* :Copyright: © 2015 Günter Milde.                                        */
  14 /* :License: Released under the terms of the `2-Clause BSD license`_,      */
  15 /*    in short:                                                            */
  16 /*                                                                         */
  17 /*    Copying and distribution of this file, with or without modification, */
  18 /*    are permitted in any medium without royalty provided the copyright   */
  19 /*    notice and this notice are preserved.                                */
  20 /*                                                                         */
  21 /*    This file is offered as-is, without any warranty.                    */
  22 /*                                                                         */
  23 /* .. _2-Clause BSD license: http://www.spdx.org/licenses/BSD-2-Clause     */
  24
  25 /* This CSS2.1_ stylesheet defines rules for Docutils elements without    */
  26 /* HTML equivalent. It is required to make the document semantic visible. */
  27 /*                                                                        */
  28 /* .. _CSS2.1: http://www.w3.org/TR/CSS2                                  */
  29 /* .. _validates: http://jigsaw.w3.org/css-validator/validator$link       */
  30
  31 /* alignment of text and inline objects inside block objects*/
  32 .align-left   { text-align: left; }
  33 .align-right  { text-align: right; }
  34 .align-center { clear: both; text-align: center; }
  35 .align-top    { vertical-align: top; }
  36 .align-middle { vertical-align: middle; }
  37 .align-bottom { vertical-align: bottom; }
  38
  39 /* titles */
  40 h1.title, p.subtitle {
  41   text-align: center;
  42 }
  43 p.admonition-title,
  44 p.topic-title,
  45 p.sidebar-title,
  46 p.rubric,
  47 p.system-message-title {
  48   font-weight: bold;
  49 }
  50 h1 + p.subtitle,
  51 h1 + p.section-subtitle {
  52   font-size: 1.6em;
  53 }
  54 h2 + p.section-subtitle { font-size: 1.28em; }
  55 p.subtitle,
  56 p.section-subtitle,
  57 p.sidebar-subtitle {
  58   font-weight: bold;
  59   margin-top: -0.5em;
  60 }
  61 p.sidebar-title,
  62 p.rubric {
  63   font-size: larger;
  64 }
  65 p.rubric { color: maroon; }
  66 a.toc-backref {
  67   color: black;
  68   text-decoration: none; }
  69
  70 /* Warnings, Errors */
  71 div.caution p.admonition-title,
  72 div.attention p.admonition-title,
  73 div.danger p.admonition-title,
  74 div.error p.admonition-title,
  75 div.warning p.admonition-title,
  76 div.system-messages h1,
  77 div.error,
  78 span.problematic,
  79 p.system-message-title {
  80   color: red;
  81 }
  82
  83 /* inline literals */
  84 span.docutils.literal {
  85   font-family: monospace;
  86   white-space: pre-wrap;
  87 }
  88 /* do not wraph at hyphens and similar: */
  89 .literal > span.pre { white-space: nowrap; }
  90
  91 /* Lists */
  92
  93 /* compact and simple lists: no margin between items */
  94 .simple  li, .compact li,
  95 .simple  ul, .compact ul,
  96 .simple  ol, .compact ol,
  97 .simple > li p, .compact > li p,
  98 dl.simple > dd, dl.compact > dd {
  99   margin-top: 0;
 100   margin-bottom: 0;
 101 }
 102
 103 /* Table of Contents */
 104 div.topic.contents { margin: 0; }
 105 ul.auto-toc {
 106   list-style-type: none;
 107   padding-left: 1.5em; }
 108
 109 /* Enumerated Lists */
 110 ol.arabic     { list-style: decimal }
 111 ol.loweralpha { list-style: lower-alpha }
 112 ol.upperalpha { list-style: upper-alpha }
 113 ol.lowerroman { list-style: lower-roman }
 114 ol.upperroman { list-style: upper-roman }
 115
 116 dt span.classifier { font-style: italic }
 117 dt span.classifier:before {
 118   font-style: normal;
 119   margin: 0.5em;
 120   content: ":";
 121 }
 122
 123 /* Field Lists and drivatives */
 124 /* bold field name, content starts on the same line */
 125 dl.field-list > dt,
 126 dl.option-list > dt,
 127 dl.docinfo > dt,
 128 dl.footnote > dt,
 129 dl.citation > dt {
 130   font-weight: bold;
 131   clear: left;
 132   float: left;
 133   margin: 0;
 134   padding: 0;
 135   padding-right: 0.5em;
 136 }
 137 /* Offset for field content (corresponds to the --field-name-limit option) */
 138 dl.field-list > dd,
 139 dl.option-list > dd,
 140 dl.docinfo > dd {
 141   margin-left:  9em; /* ca. 14 chars in the test examples */
 142 }
 143 /* start field-body on a new line after long field names */
 144 dl.field-list > dd > *:first-child,
 145 dl.option-list > dd > *:first-child
 146 {
 147   display: inline-block;
 148   width: 100%;
 149   margin: 0;
 150 }
 151 /* field names followed by a colon */
 152 dl.field-list > dt:after,
 153 dl.docinfo > dt:after {
 154   content: ":";
 155 }
 156
 157 /* Bibliographic Fields (docinfo) */
 158 pre.address { font: inherit; }
 159 dd.authors > p { margin: 0; }
 160
 161 /* Option Lists */
 162 dl.option-list { margin-left: 40px; }
 163 dl.option-list > dt { font-weight: normal; }
 164 span.option { white-space: nowrap; }
 165
 166 /* Footnotes and Citations  */
 167 dl.footnote.superscript > dd {margin-left: 1em; }
 168 dl.footnote.brackets > dd {margin-left: 2em; }
 169 dl > dt.label { font-weight: normal; }
 170 a.footnote-reference.brackets:before,
 171 dt.label > span.brackets:before { content: "["; }
 172 a.footnote-reference.brackets:after,
 173 dt.label > span.brackets:after { content: "]"; }
 174 a.footnote-reference.superscript,
 175 dl.footnote.superscript > dt.label {
 176   vertical-align: super;
 177   font-size: smaller;
 178 }
 179 dt.label > span.fn-backref { margin-left: 0.2em; }
 180 dt.label > span.fn-backref > a { font-style: italic; }
 181
 182 /* Line Blocks */
 183 div.line-block { display: block; }
 184 div.line-block div.line-block {
 185   margin-top: 0;
 186   margin-bottom: 0;
 187   margin-left: 40px;
 188 }
 189
 190 /* Figures, Images, and Tables */
 191 .figure.align-left,
 192 img.align-left,
 193 object.align-left,
 194 table.align-left {
 195   margin-right: auto;
 196 }
 197 .figure.align-center,
 198 img.align-center,
 199 object.align-center {
 200   margin-left: auto;
 201   margin-right: auto;
 202   display: block;
 203 }
 204 table.align-center {
 205   margin-left: auto;
 206   margin-right: auto;
 207 }
 208 .figure.align-right,
 209 img.align-right,
 210 object.align-right,
 211 table.align-right {
 212   margin-left: auto;
 213 }
 214 /* reset inner alignment in figures and tables */
 215 div.align-left, div.align-center, div.align-right,
 216 table.align-left, table.align-center, table.align-right
 217 { text-align: inherit }
 218
 219 /* Admonitions and System Messages */
 220 div.admonition,
 221 div.system-message,
 222 div.sidebar{
 223   margin: 40px;
 224   border: medium outset;
 225   padding-right: 1em;
 226   padding-left: 1em;
 227 }
 228
 229 /* Sidebar */
 230 div.sidebar {
 231   width: 30%;
 232   max-width: 26em;
 233   float: right;
 234   clear: right;
 235 }
 236
 237 /* Text Blocks */
 238 div.topic,
 239 pre.literal-block,
 240 pre.doctest-block,
 241 pre.math,
 242 pre.code {
 243   margin-right: 40px;
 244   margin-left: 40px;
 245 }
 246 pre.code .ln { color: gray; } /* line numbers */
 247
 248 /* Tables */
 249 table { border-collapse: collapse; }
 250 td, th {
 251   border-style: solid;
 252   border-color: silver;
 253   padding: 0 1ex;
 254   border-width: thin;
 255 }
 256 td > p:first-child, th > p:first-child { margin-top: 0; }
 257 td > p, th > p { margin-bottom: 0; }
 258
 259 table > caption {
 260   text-align: left;
 261   margin-bottom: 0.25em
 262 }
 263
 264 table.borderless td, table.borderless th {
 265   border: 0;
 266   padding: 0;
 267   padding-right: 0.5em /* separate table cells */
 268 }
 269
 270 </style>
 271 <style type="text/css">
 272
 273 /* CSS31_ style sheet for the output of Docutils HTML writers.             */
 274 /* Rules for easy reading and pre-defined style variants.                  */
 275 /*                                                                         */
 276 /* :Author: Günter Milde, based on html4css1.css by David Goodger          */
 277 /* :Id: $Id: plain.css 7952 2016-07-26 18:15:59Z milde $               */
 278 /* :Copyright: © 2015 Günter Milde.                                        */
 279 /* :License: Released under the terms of the `2-Clause BSD license`_,      */
 280 /*    in short:                                                            */
 281 /*                                                                         */
 282 /*    Copying and distribution of this file, with or without modification, */
 283 /*    are permitted in any medium without royalty provided the copyright   */
 284 /*    notice and this notice are preserved.                                */
 285 /*                                                                         */
 286 /*    This file is offered as-is, without any warranty.                    */
 287 /*                                                                         */
 288 /* .. _2-Clause BSD license: http://www.spdx.org/licenses/BSD-2-Clause     */
 289 /* .. _CSS3: http://www.w3.org/TR/CSS3                                     */
 290
 291
 292 /* Document Structure */
 293 /* ****************** */
 294
 295 /* "page layout" */
 296 body {
 297   padding: 0 5%;
 298   margin: 8px 0;
 299 }
 300 div.document {
 301   line-height:1.3;
 302   counter-reset: table;
 303   /* counter-reset: figure; */
 304   /* avoid long lines --> better reading */
 305   /* OTOH: lines should not be too short because of missing hyphenation, */
 306   max-width: 50em;
 307   margin: auto;
 308 }
 309
 310 /* Sections */
 311
 312 /* Transitions */
 313
 314 hr.docutils {
 315   width: 80%;
 316   margin-top: 1em;
 317   margin-bottom: 1em;
 318   clear: both;
 319 }
 320
 321 /* Paragraphs               */
 322 /* ==========               */
 323
 324 /* vertical space (parskip) */
 325 p, ol, ul, dl,
 326 div.line-block,
 327 table{
 328   margin-top: 0.5em;
 329   margin-bottom: 0.5em;
 330 }
 331 h1, h2, h3, h4, h5, h6,
 332 dl > dd {
 333   margin-bottom: 0.5em;
 334 }
 335
 336 /* Lists                    */
 337 /* ==========               */
 338
 339 /* Definition Lists         */
 340
 341 dl > dd p:first-child { margin-top: 0; }
 342 /* :last-child is not part of CSS 2.1 (introduced in CSS 3) */
 343 /* dl > dd p:last-child  { margin-bottom: 0; } */
 344
 345 /* lists nested in definition lists */
 346 /* :only-child is not part of CSS 2.1 (introduced in CSS 3) */
 347 dd > ul:only-child, dd > ol:only-child { padding-left: 1em; }
 348
 349 /* Description Lists */
 350 /* styled like in most dictionaries, encyclopedias etc. */
 351 dl.description > dt {
 352   font-weight: bold;
 353   clear: left;
 354   float: left;
 355   margin: 0;
 356   padding: 0;
 357   padding-right: 0.5em;
 358 }
 359
 360 /* Field Lists */
 361
 362 /* example for custom field-name width */
 363 dl.field-list.narrow > dd {
 364   margin-left: 5em;
 365 }
 366 /* run-in: start field-body on same line after long field names */
 367 dl.field-list.run-in > dd p {
 368   display: block;
 369 }
 370
 371 /* Bibliographic Fields */
 372
 373 /* generally, bibliographic fields use special definition list dl.docinfo */
 374 /* but dedication and abstract are placed into "topic" divs */
 375 div.abstract p.topic-title {
 376   text-align: center;
 377 }
 378 div.dedication {
 379   margin: 2em 5em;
 380   text-align: center;
 381   font-style: italic;
 382 }
 383 div.dedication p.topic-title {
 384   font-style: normal;
 385 }
 386
 387 /* Citations */
 388 dl.citation dt.label {
 389   font-weight: bold;
 390 }
 391 span.fn-backref {
 392   font-weight: normal;
 393 }
 394
 395 /* Text Blocks           */
 396 /* ============          */
 397
 398 /* Literal Blocks           */
 399 pre.literal-block, pre.doctest-block,
 400 pre.math, pre.code {
 401   margin-left: 1.5em;
 402   margin-right: 1.5em
 403 }
 404
 405 /* Block Quotes             */
 406
 407 blockquote,
 408 div.topic {
 409   margin-left: 1.5em;
 410   margin-right: 1.5em
 411 }
 412 blockquote > table,
 413 div.topic > table {
 414   margin-top: 0;
 415   margin-bottom: 0;
 416 }
 417 blockquote p.attribution,
 418 div.topic p.attribution {
 419   text-align: right;
 420   margin-left: 20%;
 421 }
 422
 423 /* Tables                   */
 424 /* ======                   */
 425
 426 /* th { vertical-align: bottom; } */
 427
 428 table tr { text-align: left; }
 429
 430 /* "booktabs" style (no vertical lines) */
 431 table.booktabs {
 432   border: 0;
 433   border-top: 2px solid;
 434   border-bottom: 2px solid;
 435   border-collapse: collapse;
 436 }
 437 table.booktabs * {
 438   border: 0;
 439 }
 440 table.booktabs th {
 441   border-bottom: thin solid;
 442 }
 443
 444 /* numbered tables (counter defined in div.document) */
 445 table.numbered > caption:before {
 446   counter-increment: table;
 447   content: "Table " counter(table) ": ";
 448   font-weight: bold;
 449 }
 450
 451 /* Explicit Markup Blocks   */
 452 /* ======================   */
 453
 454 /* Footnotes and Citations  */
 455 /* -----------------------  */
 456
 457 /* line on the left */
 458 dl.footnote {
 459   padding-left: 1ex;
 460   border-left: solid;
 461   border-left-width: thin;
 462 }
 463
 464 /* Directives               */
 465 /* ----------               */
 466
 467 /* Body Elements            */
 468 /* ~~~~~~~~~~~~~            */
 469
 470 /* Images and Figures */
 471
 472 /* let content flow to the side of aligned images and figures */
 473 .figure.align-left,
 474 img.align-left,
 475 object.align-left {
 476   display: block;
 477   clear: left;
 478   float: left;
 479   margin-right: 1em
 480 }
 481 .figure.align-right,
 482 img.align-right,
 483 object.align-right {
 484   display: block;
 485   clear: right;
 486   float: right;
 487   margin-left: 1em
 488 }
 489 /* Stop floating sidebars, images and figures at section level 1,2,3 */
 490 h1, h2, h3 { clear: both; }
 491
 492 /* Sidebar */
 493
 494 /* Move into the margin. In a layout with fixed margins, */
 495 /* it can be moved into the margin completely.           */
 496 div.sidebar {
 497   width: 30%;
 498   max-width: 26em;
 499   margin-left: 1em;
 500   margin-right: -5.5%;
 501   background-color: #ffffee ;
 502 }
 503
 504 /* Code                     */
 505
 506 pre.code, code { background-color: #eeeeee }
 507 pre.code .ln { color: gray; } /* line numbers */
 508 /* basic highlighting: for a complete scheme, see */
 509 /* http://docutils.sourceforge.net/sandbox/stylesheets/ */
 510 pre.code .comment, code .comment { color: #5C6576 }
 511 pre.code .keyword, code .keyword { color: #3B0D06; font-weight: bold }
 512 pre.code .literal.string, code .literal.string { color: #0C5404 }
 513 pre.code .name.builtin, code .name.builtin { color: #352B84 }
 514 pre.code .deleted, code .deleted { background-color: #DEB0A1}
 515 pre.code .inserted, code .inserted { background-color: #A3D289}
 516
 517 /* Math                     */
 518 /* styled separately (see math.css for math-output=HTML) */
 519
 520 /* Epigraph                 */
 521 /* Highlights               */
 522 /* Pull-Quote               */
 523 /* Compound Paragraph       */
 524 /* Container                */
 525
 526 /* can be styled in a custom stylesheet */
 527
 528 /* Document Header and Footer */
 529
 530 div.footer, div.header {
 531   clear: both;
 532   font-size: smaller;
 533 }
 534
 535 /* Inline Markup            */
 536 /* =============            */
 537
 538 /* Emphasis                 */
 539 /*   em                     */
 540 /* Strong Emphasis          */
 541 /*   strong                 */
 542 /* Interpreted Text         */
 543 /*   span.interpreted       */
 544 /* Title Reference          */
 545 /*   cite                   */
 546 /* Inline Literals          */
 547 /* possible values: normal, nowrap, pre, pre-wrap, pre-line */
 548 /*   span.docutils.literal { white-space: pre-wrap; } */
 549
 550 /* Hyperlink References     */
 551 a { text-decoration: none; }
 552
 553 /* External Targets         */
 554 /*   span.target.external   */
 555 /* Internal Targets         */
 556 /*   span.target.internal   */
 557 /* Footnote References      */
 558 /*   a.footnote-reference   */
 559 /* Citation References      */
 560 /*   a.citation-reference   */
 561
 562 </style>
 563 </head>
 564 <body>
 565 <div class="document" id="rover">
 566 <h1 class="title">Rover</h1>
 567
 568 <p>Sketches e librerie per la gestione di un mini rover con sensore a ultrasuoni per evitare ortacoli.</p>
 569 <div class="section" id="setup">
 570 <h1>Setup</h1>
 571 <p>Gli sketch utilizzano la libreria common presente nella cartella
 572 <span class="docutils literal">libraries/common/</span>: questa deve essere quindi inclusa tra le librerie
 573 utilizzate. Un modo rapido per farlo e' settare nelle preferences dell'Arduino
 574 IDE l'intero repo <span class="docutils literal">rover</span> come cartella degli sketchbook, oppure
 575 copiare la cartella <span class="docutils literal">libraries/common</span> dentro <span class="docutils literal">libraries</span> dello sketchbook
 576 attuale.</p>
 577 </div>
 578 <div class="section" id="download">
 579 <h1>Download</h1>
 580 <dl class="simple">
 581 <dt>Download tramite git:</dt>
 582 <dd><p>git clone git://git.andreamanni.com/rover</p>
 583 </dd>
 584 </dl>
 585 <p>Per aggiornare all'ultima versione:</p>
 586 <pre class="literal-block">cd ~/rover
 587 git pull</pre>
 588 <ul class="simple">
 589 <li><p><a class="reference external" href="https://git.andreamanni.com/web?p=rover;a=snapshot;h=HEAD;sf=tgz">Download manuale archivio</a></p></li>
 590 <li><p><a class="reference external" href="https://git.andreamanni.com/web?p=rover">Interfaccia git Web</a></p></li>
 591 <li><p><a class="reference external" href="http://wiki.piffa.net/index.php/Mini_Rover">Wiki</a></p></li>
 592 <li><p><a class="reference external" href="https://forum.piffa.net/viewtopic.php?f=5&amp;t=431">Foum di Discussione</a></p></li>
 593 </ul>
 594 </div>
 595 <div class="section" id="links">
 596 <h1>Links</h1>
 597 <p>Risorse utili:</p>
 598 <ul class="simple">
 599 <li><p>Per poter programmare le schede Arduino: <a class="reference external" href="https://www.arduino.cc/en/Main/Software#">Arduino IDE</a></p></li>
 600 <li><p>Testi consigliati: <a class="reference external" href="https://lab.piffa.net/testi.html">https://lab.piffa.net/testi.html</a></p></li>
 601 <li><p>Risorse online: <a class="reference external" href="http://wiki.piffa.net/index.php/Guide">http://wiki.piffa.net/index.php/Guide</a></p></li>
 602 </ul>
 603 </div>
 604 </div>
 605 </body>
 606 </html>