diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..96e8663 --- /dev/null +++ b/.gitignore @@ -0,0 +1,4 @@ + +Language/Variables/.DS_Store +Language/.DS_Store +.DS_Store diff --git a/Language/Functions/Advanced IO/noTone.adoc b/Language/Functions/Advanced IO/noTone.adoc index 414911a..8caba89 100644 --- a/Language/Functions/Advanced IO/noTone.adoc +++ b/Language/Functions/Advanced IO/noTone.adoc @@ -2,7 +2,7 @@ title: noTone() title_expanded: "" categories: [ "Functions" ] -subCategories: [ "I/O Avanzato" ] +subCategories: [ "Advanced I/O" ] aliases: [ /language/functions/advanced-io/noTone/ ] --- diff --git a/Language/Functions/Advanced IO/pulseIn.adoc b/Language/Functions/Advanced IO/pulseIn.adoc index 2d4f1b1..a4174da 100644 --- a/Language/Functions/Advanced IO/pulseIn.adoc +++ b/Language/Functions/Advanced IO/pulseIn.adoc @@ -1,7 +1,7 @@ --- title: pulseIn() categories: [ "Functions" ] -subCategories: [ "I/O Avanzato" ] +subCategories: [ "Advanced I/O" ] --- diff --git a/Language/Functions/Advanced IO/pulseInLong.adoc b/Language/Functions/Advanced IO/pulseInLong.adoc index d4a7fef..06ef6b8 100644 --- a/Language/Functions/Advanced IO/pulseInLong.adoc +++ b/Language/Functions/Advanced IO/pulseInLong.adoc @@ -1,7 +1,7 @@ --- title: pulseInLong() categories: [ "Functions" ] -subCategories: [ "I/O Avanzato" ] +subCategories: [ "Advanced I/O" ] --- @@ -16,7 +16,7 @@ subCategories: [ "I/O Avanzato" ] -- [float] -=== Description +=== Descrizione Legge un impulso (sia di tipo HIGH oppure LOW) su un pin. Per esempio, se *valore* = *HIGH*, `pulseInLong()` aspetta che il pin vada nello stato *HIGH*, incomincia a contare, quindi aspetta che il pin vada nello stato *LOW* e smette di contare. Restituisce la durata dell'impulso in microsecondi. Si interrompe e restituisce 0 se nessun impulso parte entro il timeout specificato. La temporizzazione di questa funzione è stata determinata empiricamente e probabilmente produrrà errori con gli impulsi più lunghi. Funziona sugli impulsi di lunghezza compresa tra 10 microsecondi e 3 minuti. Nota anche che se il pin è gia nello stato *HIGH* quando la funzione viene chiamata, essa aspetterà che il pin vada nello stato *LOW* e poi *HIGH* prima di iniziare a contare. Questa routine può essere usata solo se gli interrupt sono attivati. Inoltre, la risoluzione più alta è ottenuta con intervalli lunghi. @@ -52,7 +52,7 @@ la durata dell'impulso ( in microsecondi ) oppure 0 se nessun impulso è partito [float] === Codice di esempio -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ Questo programma di esempio calcola il tempo di durata di un impulso sul pin 7. [source,arduino] diff --git a/Language/Functions/Advanced IO/shiftIn.adoc b/Language/Functions/Advanced IO/shiftIn.adoc index 6dbfbd8..92e6dd4 100644 --- a/Language/Functions/Advanced IO/shiftIn.adoc +++ b/Language/Functions/Advanced IO/shiftIn.adoc @@ -1,7 +1,7 @@ --- title: shiftIn() categories: [ "Functions" ] -subCategories: [ "I/O Avanzato" ] +subCategories: [ "Advanced I/O" ] --- diff --git a/Language/Functions/Advanced IO/shiftOut.adoc b/Language/Functions/Advanced IO/shiftOut.adoc index 250e428..63d3039 100644 --- a/Language/Functions/Advanced IO/shiftOut.adoc +++ b/Language/Functions/Advanced IO/shiftOut.adoc @@ -1,7 +1,7 @@ --- title: shiftOut() categories: [ "Functions" ] -subCategories: [ "I/O Avanzato" ] +subCategories: [ "Advanced I/O" ] --- = shiftOut() @@ -53,7 +53,7 @@ Nulla [float] === Codice di esempio -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ Per il circuito di accompagnamento, vedi il http://arduino.cc/en/Tutorial/ShiftOut[tutorial su come controllare un registro a scorrimento 74HC595]. [source,arduino] diff --git a/Language/Functions/Advanced IO/tone.adoc b/Language/Functions/Advanced IO/tone.adoc index 8158294..face279 100644 --- a/Language/Functions/Advanced IO/tone.adoc +++ b/Language/Functions/Advanced IO/tone.adoc @@ -1,13 +1,11 @@ --- title: tone() categories: [ "Functions" ] -subCategories: [ "I/O Avanzato" ] +subCategories: [ "Advanced I/O" ] --- - - = tone() diff --git a/Language/Functions/Analog IO/analogRead.adoc b/Language/Functions/Analog IO/analogRead.adoc index 9628eaa..e5a81ee 100644 --- a/Language/Functions/Analog IO/analogRead.adoc +++ b/Language/Functions/Analog IO/analogRead.adoc @@ -5,8 +5,6 @@ subCategories: [ "Analog I/O" ] --- - - = analogRead() @@ -52,7 +50,7 @@ int( 0 to 1023 ) [float] === Codice di Esempio -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ Il codice legge la tensione su analogPin e la visualizza. [source,arduino] diff --git a/Language/Functions/Analog IO/analogWrite.adoc b/Language/Functions/Analog IO/analogWrite.adoc index 4d81f66..f8ee00b 100644 --- a/Language/Functions/Analog IO/analogWrite.adoc +++ b/Language/Functions/Analog IO/analogWrite.adoc @@ -1,7 +1,7 @@ --- title: analogWrite() categories: [ "Functions" ] -subCategories: [ "I/O Analogico" ] +subCategories: [ "Analog I/O" ] --- diff --git a/Language/Functions/Bits and Bytes/bit.adoc b/Language/Functions/Bits and Bytes/bit.adoc index 7679477..c640047 100644 --- a/Language/Functions/Bits and Bytes/bit.adoc +++ b/Language/Functions/Bits and Bytes/bit.adoc @@ -1,13 +1,10 @@ --- title: bit() categories: [ "Functions" ] -subCategories: [ "Bit e Byte" ] +subCategories: [ "Bits and Bytes" ] --- - - - = bit() diff --git a/Language/Functions/Bits and Bytes/bitClear.adoc b/Language/Functions/Bits and Bytes/bitClear.adoc index 67d80fa..f7ed204 100644 --- a/Language/Functions/Bits and Bytes/bitClear.adoc +++ b/Language/Functions/Bits and Bytes/bitClear.adoc @@ -1,7 +1,7 @@ --- title: bitClear() categories: [ "Functions" ] -subCategories: [ "Bit e Byte" ] +subCategories: [ "Bits and Bytes" ] --- @@ -22,7 +22,7 @@ Resetta ( imposta a 0 ) un bit di una variabile numerica. [float] -=== Sintasi +=== Sintassi `bitClear( var, n )` diff --git a/Language/Functions/Bits and Bytes/bitRead.adoc b/Language/Functions/Bits and Bytes/bitRead.adoc index 231efe1..34dc8ef 100644 --- a/Language/Functions/Bits and Bytes/bitRead.adoc +++ b/Language/Functions/Bits and Bytes/bitRead.adoc @@ -16,26 +16,28 @@ subCategories: [ "Bits and Bytes" ] -- [float] -=== Description -Reads a bit of a number. +=== Descrizione +Legge i bit di un numero. [%hardbreaks] [float] -=== Syntax +=== Sintassi `bitRead(x, n)` [float] -=== Parameters -`x`: the number from which to read +=== Parametri +`x`: il numero da cui leggere + +`n`: quale bit leggere, a partire da 0 per il bit meno significativo (più a destra) -`n`: which bit to read, starting at 0 for the least-significant (rightmost) bit [float] -=== Returns -the value of the bit (0 or 1). +=== Restituisce +Il valore del bit (0 o 1). + -- // OVERVIEW SECTION ENDS \ No newline at end of file diff --git a/Language/Functions/Bits and Bytes/bitSet.adoc b/Language/Functions/Bits and Bytes/bitSet.adoc index f16072f..7402527 100644 --- a/Language/Functions/Bits and Bytes/bitSet.adoc +++ b/Language/Functions/Bits and Bytes/bitSet.adoc @@ -17,24 +17,24 @@ Sets (writes a 1 to) a bit of a numeric variable. -- [float] -=== Description +=== Descrizione [%hardbreaks] [float] -=== Syntax +=== Sintassi `bitSet(x, n)` [float] -=== Parameters -`x`: the numeric variable whose bit to set +=== Parametri +`x`: la variabile numerica della quale impostare il bit -`n`: which bit to set, starting at 0 for the least-significant (rightmost) bit +`n`: Quale bit da impostare, a partire da 0 per il bit meno significativo (più a destra) [float] -=== Returns -Nothing +=== Restituisce +Nulla -- // OVERVIEW SECTION ENDS \ No newline at end of file diff --git a/Language/Functions/Bits and Bytes/bitWrite.adoc b/Language/Functions/Bits and Bytes/bitWrite.adoc index bdcd6f6..79c1b8f 100644 --- a/Language/Functions/Bits and Bytes/bitWrite.adoc +++ b/Language/Functions/Bits and Bytes/bitWrite.adoc @@ -16,27 +16,27 @@ subCategories: [ "Bits and Bytes" ] -- [float] -=== Description -Writes a bit of a numeric variable. +=== Descrizione +Scrive un bit di una variabile numerica. [%hardbreaks] [float] -=== Syntax +=== Sintassi `bitWrite(x, n, b)` [float] -=== Parameters -`x`: the numeric variable to which to write +=== Parametri +`x`: la variabile numerica dove scrive -`n`: which bit of the number to write, starting at 0 for the least-significant (rightmost) bit +`n`: quale bit del numero che deve essere scritto, a partire da 0 per il bit meno significativo (più a destra) -`b`: the value to write to the bit (0 or 1) +`b`: il valore da scrivere (0 o 1) [float] -=== Returns -Nothing +=== Restituisce +Nulla -- // OVERVIEW SECTION ENDS \ No newline at end of file diff --git a/Language/Functions/Bits and Bytes/highByte.adoc b/Language/Functions/Bits and Bytes/highByte.adoc index a30945f..6a5deab 100644 --- a/Language/Functions/Bits and Bytes/highByte.adoc +++ b/Language/Functions/Bits and Bytes/highByte.adoc @@ -16,22 +16,22 @@ subCategories: [ "Bits and Bytes" ] -- [float] -=== Description -Extracts the high-order (leftmost) byte of a word (or the second lowest byte of a larger data type). +=== Descrizione +Estrae il byte di ordine superiore (più a sinistra) di una parola (o il secondo byte più basso di un tipo di dati più grande). [%hardbreaks] [float] -=== Syntax +=== Sintassi `highByte(x)` [float] -=== Parameters -`x`: a value of any type +=== Parametri +`x`: un valore di ogni tipo [float] -=== Returns +=== Restituisce byte -- @@ -43,7 +43,7 @@ byte -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../../../variables/data-types/word[word()] diff --git a/Language/Functions/Bits and Bytes/lowByte.adoc b/Language/Functions/Bits and Bytes/lowByte.adoc index 9055f6a..97446dc 100644 --- a/Language/Functions/Bits and Bytes/lowByte.adoc +++ b/Language/Functions/Bits and Bytes/lowByte.adoc @@ -16,22 +16,22 @@ subCategories: [ "Bits and Bytes" ] -- [float] -=== Description -Extracts the low-order (rightmost) byte of a variable (e.g. a word). +=== Descrizione +Estrae il byte di ordine inferiore (più a destra) di una variabile (ad esempio una parola). [%hardbreaks] [float] -=== Syntax +=== Sintassi `lowByte(x)` [float] -=== Parameters -`x`: a value of any type +=== Parametri +`x`: Un valore di ogni tipo [float] -=== Returns +=== Restituisce byte -- // OVERVIEW SECTION ENDS @@ -42,7 +42,7 @@ byte -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../../../variables/data-types/word[word()] diff --git a/Language/Functions/Characters/isAlphaNumeric.adoc b/Language/Functions/Characters/isAlphaNumeric.adoc index 5e7da2c..cb69ffa 100644 --- a/Language/Functions/Characters/isAlphaNumeric.adoc +++ b/Language/Functions/Characters/isAlphaNumeric.adoc @@ -16,25 +16,25 @@ subCategories: [ "Characters" ] -- [float] -=== Description -Analyse if a char is alphanumeric (that is a letter or a numbers). Returns true if thisChar contains either a number or a letter. +=== Descrizione +Analizza se un carattere è alfanumerico (che sia una lettera o un numero). Restituisce true se thisChar contiene o un carattere o una lettera. [%hardbreaks] [float] -=== Syntax +=== Sintassi [source,arduino] ---- `isAlphaNumeric(thisChar)` ---- [float] -=== Parameters -`thisChar`: variable. *Allowed data types:* char +=== Parametri +`thisChar`: variabile. *Tipi di dati consentiti:* char [float] -=== Returns -`true`: if thisChar is alphanumeric. +=== Restituisce +`true`: se thisChar è alfanumerico -- // OVERVIEW SECTION ENDS @@ -46,11 +46,11 @@ Analyse if a char is alphanumeric (that is a letter or a numbers). Returns true -- [float] -=== Example Code +=== Codice di Esempio [source,arduino] ---- -if (isAlphaNumeric(this)) // tests if this isa letter or a number +if (isAlphaNumeric(this)) // Testa se è una lettera o un numero { Serial.println("The character is alphanumeric"); } @@ -70,13 +70,13 @@ else -- [float] -=== See also +=== Vedi anche [role="language"] -* #LANGUAGE# link:../../../variables/data-types/char[char] -* #LANGUAGE# link:../../../structure/control-structure/if[if (conditional operators)] -* #LANGUAGE# link:../../../structure/control-structure/while[while (conditional operators)] -* #LANGUAGE# link:../../communication/serial/read[read()] +* #LINGUAGGIO# link:../../../variables/data-types/char[char] +* #LINGUAGGIO# link:../../../structure/control-structure/if[if (conditional operators)] +* #LINGUAGGIO# link:../../../structure/control-structure/while[while (conditional operators)] +* #LINGUAGGIO# link:../../communication/serial/read[read()] -- -// SEE ALSO SECTION ENDS \ No newline at end of file +// SEE ALSO SECTION ENDS diff --git a/Language/Functions/Characters/isAscii.adoc b/Language/Functions/Characters/isAscii.adoc index d97ef70..cd6aa82 100644 --- a/Language/Functions/Characters/isAscii.adoc +++ b/Language/Functions/Characters/isAscii.adoc @@ -16,25 +16,25 @@ subCategories: [ "Characters" ] -- [float] -=== Description -Analyse if a char is Ascii. Returns true if thisChar contains an Ascii character. +=== Descrizione +Analizza se un carattere è Ascii. Restituisce 'true' se thisChar contiene un carattere Ascii. [%hardbreaks] [float] -=== Syntax +=== Sintassi [source,arduino] ---- `isAscii(thisChar)` ---- [float] -=== Parameters -`thisChar`: variable. *Allowed data types:* char +=== Parametri +`thisChar`: variabili. *Tipi di dati accettati:* char [float] -=== Returns -`true`: if thisChar is Ascii. +=== Restituisce +`true`: se thisChar è Ascii. -- // OVERVIEW SECTION ENDS @@ -46,7 +46,7 @@ Analyse if a char is Ascii. Returns true if thisChar contains an Ascii character -- [float] -=== Example Code +=== Codice di esempio [source,arduino] ---- @@ -70,7 +70,7 @@ else -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../../../variables/data-types/char[char] diff --git a/Language/Functions/Characters/isControl.adoc b/Language/Functions/Characters/isControl.adoc index b09c390..e475c02 100644 --- a/Language/Functions/Characters/isControl.adoc +++ b/Language/Functions/Characters/isControl.adoc @@ -16,25 +16,25 @@ subCategories: [ "Characters" ] -- [float] -=== Description -Analyse if a char is a control character. Returns true if thisChar is a control character. +=== Descrizione +Analizza se un carattere è un carattere di controllo. Restituisce 'true' se thisChar è un carattere di controllo. [%hardbreaks] [float] -=== Syntax +=== Sintassi [source,arduino] ---- `isControl(thisChar)` ---- [float] -=== Parameters -`thisChar`: variable. *Allowed data types:* char +=== Parametri +`thisChar`: variabile. *Tipi di dato accettati:* char [float] -=== Returns -`true`: if thisChar is a control character. +=== Restituisce +`true`: se thisChar è un carattere di controllo. -- // OVERVIEW SECTION ENDS @@ -46,7 +46,7 @@ Analyse if a char is a control character. Returns true if thisChar is a control -- [float] -=== Example Code +=== Codice di esempio [source,arduino] ---- @@ -70,7 +70,7 @@ else -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../../../variables/data-types/char[char] diff --git a/Language/Functions/Characters/isDigit.adoc b/Language/Functions/Characters/isDigit.adoc index 2cb65a8..3d1045e 100644 --- a/Language/Functions/Characters/isDigit.adoc +++ b/Language/Functions/Characters/isDigit.adoc @@ -16,25 +16,25 @@ subCategories: [ "Characters" ] -- [float] -=== Description -Analyse if a char is a digit (that is a number). Returns true if thisChar is a number. +=== Descrizione +Analizza se un carattere è un numero. Restituisce 'true' se thisChar è un numero. [%hardbreaks] [float] -=== Syntax +=== Sintassi [source,arduino] ---- isDigit(thisChar) ---- [float] -=== Parameters -`thisChar`: variable. *Allowed data types:* char +=== Parametri +`thisChar`: variabile. *Tipi di dato accettato:* char [float] -=== Returns -`true`: if thisChar is a number. +=== Restituisce +`true`: se thisChar è un numero. -- // OVERVIEW SECTION ENDS @@ -46,7 +46,7 @@ isDigit(thisChar) -- [float] -=== Example Code +=== Codice di esempio [source,arduino] ---- @@ -70,7 +70,7 @@ else -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../../../variables/data-types/char[char] @@ -79,4 +79,4 @@ else * #LANGUAGE# link:../../communication/serial/read[read()] -- -// SEE ALSO SECTION ENDS \ No newline at end of file +// SEE ALSO SECTION ENDS diff --git a/Language/Functions/Characters/isGraph.adoc b/Language/Functions/Characters/isGraph.adoc index ba48774..72050b1 100644 --- a/Language/Functions/Characters/isGraph.adoc +++ b/Language/Functions/Characters/isGraph.adoc @@ -5,9 +5,6 @@ subCategories: [ "Characters" ] --- - - - = isGraph(thisChar) @@ -16,25 +13,25 @@ subCategories: [ "Characters" ] -- [float] -=== Description -Analyse if a char is printable with some content (space is printable but has no content). Returns true if thisChar is printable. +=== Descrizione +Analizza se un carattere è stampabile con qualche contenuto (spazio è stampabile ma non ha contenuto). Restituisce true se thisChar è stampabile. [%hardbreaks] [float] -=== Syntax +=== Sintassi [source,arduino] ---- `isGraph(thisChar)` ---- [float] -=== Parameters -`thisChar`: variable. *Allowed data types:* char +=== Parametri +`thisChar`: variabile. *Tipi di dato accettati:* char [float] -=== Returns -`true`: if thisChar is printable. +=== Restituisce +`true`: se thisChar è stampabile. -- // OVERVIEW SECTION ENDS @@ -46,7 +43,7 @@ Analyse if a char is printable with some content (space is printable but has no -- [float] -=== Example Code +=== Codice di esempio. [source,arduino] ---- @@ -70,7 +67,7 @@ else -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../../../variables/data-types/char[char] diff --git a/Language/Functions/Characters/isHexadecimalDigit.adoc b/Language/Functions/Characters/isHexadecimalDigit.adoc index 6142871..01d6445 100644 --- a/Language/Functions/Characters/isHexadecimalDigit.adoc +++ b/Language/Functions/Characters/isHexadecimalDigit.adoc @@ -5,9 +5,6 @@ subCategories: [ "Characters" ] --- - - - = isHexadecimalDigit(thisChar) @@ -16,24 +13,24 @@ subCategories: [ "Characters" ] -- [float] -=== Description -Analyse if a char is an hexadecimal digit (A-F, 0-9). Returns true if thisChar contains an hexadecimal digit. +=== Descrizione +Analizza se il carattere è esadecimale (A-F, 0-9). Restituisce 'true' se thisChar contiene un carattere esadecimale. [%hardbreaks] [float] -=== Syntax +=== Sintassi [source,arduino] ---- `isHexadecilamDigit(thisChar)` ---- [float] -=== Parameters -`thisChar`: variable. *Allowed data types:* char +=== Parametri +`thisChar`: variabile. *Tipi di dato accettati:* char [float] -=== Returns +=== Restituisce `true`: if thisChar is an hexadecimal digit. -- @@ -46,7 +43,7 @@ Analyse if a char is an hexadecimal digit (A-F, 0-9). Returns true if thisChar c -- [float] -=== Example Code +=== Codice di esempio [source,arduino] ---- @@ -70,7 +67,7 @@ else -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../../../variables/data-types/char[char] diff --git a/Language/Functions/Characters/isLowerCase.adoc b/Language/Functions/Characters/isLowerCase.adoc index e7b0e0b..e6157ac 100644 --- a/Language/Functions/Characters/isLowerCase.adoc +++ b/Language/Functions/Characters/isLowerCase.adoc @@ -5,9 +5,6 @@ subCategories: [ "Characters" ] --- - - - = isLowerCase(thisChar) @@ -16,25 +13,25 @@ subCategories: [ "Characters" ] -- [float] -=== Description -Analyse if a char is lower case (that is a letter in lower case). Returns true if thisChar contains a letter in lower case. +=== Descrizione +Analizza se il carattere è minuscolo. Restituisce 'true' se thisChar contieene un carattere in minuscolo. [%hardbreaks] [float] -=== Syntax +=== Sintassi [source,arduino] ---- `isLowerCase(thisChar)` ---- [float] -=== Parameters -`thisChar`: variable. *Allowed data types:* char +=== Parametri +`thisChar`: variabile. *Tipi di dati accettati:* char [float] -=== Returns -`true`: if thisChar is lower case. +=== Restituisce +`true`: se thisChar è minuscolo. -- // OVERVIEW SECTION ENDS @@ -46,7 +43,7 @@ Analyse if a char is lower case (that is a letter in lower case). Returns true i -- [float] -=== Example Code +=== Codice di esempio [source,arduino] ---- @@ -70,7 +67,7 @@ else -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../../../variables/data-types/char[char] diff --git a/Language/Functions/Characters/isPrintable.adoc b/Language/Functions/Characters/isPrintable.adoc index 71a3a2a..7ad8c17 100644 --- a/Language/Functions/Characters/isPrintable.adoc +++ b/Language/Functions/Characters/isPrintable.adoc @@ -5,9 +5,6 @@ subCategories: [ "Characters" ] --- - - - = isPrintable(thisChar) @@ -16,25 +13,26 @@ subCategories: [ "Characters" ] -- [float] -=== Description -Analyse if a char is printable (that is any character that produces an output, even a blank space). Returns true if thisChar is printable. +=== Descrizione +Analizza se un carattere è stampabile (un carattere che produce un output, anche uno spazio bianco). +Restituisce 'true' se thisChar è stampabile. [%hardbreaks] [float] -=== Syntax +=== Sintassi [source,arduino] ---- `isAlpha(thisChar)` ---- [float] -=== Parameters -`thisChar`: variable. *Allowed data types:* char +=== Parametri +`thisChar`: variabile. *Tipi di dati accettati:* char [float] -=== Returns -`true`: if thisChar is printable. +=== Restituisce +`true`: se thisChar è stampabile. -- // OVERVIEW SECTION ENDS @@ -46,7 +44,7 @@ Analyse if a char is printable (that is any character that produces an output, e -- [float] -=== Example Code +=== Codice di esempio [source,arduino] ---- @@ -70,7 +68,7 @@ else -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../../../variables/data-types/char[char] diff --git a/Language/Functions/Characters/isPunct.adoc b/Language/Functions/Characters/isPunct.adoc index b4bf4ea..bc3db98 100644 --- a/Language/Functions/Characters/isPunct.adoc +++ b/Language/Functions/Characters/isPunct.adoc @@ -16,25 +16,25 @@ subCategories: [ "Characters" ] -- [float] -=== Description -Analyse if a char is punctuation (that is a comma, a semicolon, an exlamation mark and so on). Returns true if thisChar is punctuation. +=== Descrizione +Analizza se il carattere è un segno di interpunzione ( ovvero una virgola, punto e virgola, punto esclamativo). Restituisce 'true' se thisChar è un segno di interpunzione. [%hardbreaks] [float] -=== Syntax +=== Sintassi [source,arduino] ---- `isPunct(thisChar)` ---- [float] -=== Parameters -`thisChar`: variable. *Allowed data types:* char +=== Parametri +`thisChar`: variabile. *Tipi di dato accettati:* char [float] -=== Returns -`true`: if thisChar is a punctuation. +=== Restituisce +`true`: se thisChar è un segno di interpunzione. -- // OVERVIEW SECTION ENDS @@ -46,7 +46,7 @@ Analyse if a char is punctuation (that is a comma, a semicolon, an exlamation ma -- [float] -=== Example Code +=== Codice di esempio [source,arduino] ---- @@ -70,7 +70,7 @@ else -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../../../variables/data-types/char[char] diff --git a/Language/Functions/Characters/isSpace.adoc b/Language/Functions/Characters/isSpace.adoc index fa9cb9b..4ff8aba 100644 --- a/Language/Functions/Characters/isSpace.adoc +++ b/Language/Functions/Characters/isSpace.adoc @@ -16,25 +16,25 @@ subCategories: [ "Characters" ] -- [float] -=== Description -Analyse if a char is the space character. Returns true if thisChar contains the space character. +=== Descrizione +Analizza se un carattere è uno spazio. Restituisce 'true' se thisChar contiene uno spazio. [%hardbreaks] [float] -=== Syntax +=== Sintassi [source,arduino] ---- `isSpace(thisChar)` ---- [float] -=== Parameters -`thisChar`: variable. *Allowed data types:* char +=== Parametri +`thisChar`: variabile. *Tipi di dato accettati:* char [float] -=== Returns -`true`: if thisChar is a space. +=== Restituisce +`true`: se thisChar è uno spazio. -- // OVERVIEW SECTION ENDS @@ -46,7 +46,7 @@ Analyse if a char is the space character. Returns true if thisChar contains the -- [float] -=== Example Code +=== Codice di esempio [source,arduino] ---- @@ -70,7 +70,7 @@ else -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../../../variables/data-types/char[char] diff --git a/Language/Functions/Characters/isUpperCase.adoc b/Language/Functions/Characters/isUpperCase.adoc index 963995b..aa057c0 100644 --- a/Language/Functions/Characters/isUpperCase.adoc +++ b/Language/Functions/Characters/isUpperCase.adoc @@ -16,25 +16,25 @@ subCategories: [ "Characters" ] -- [float] -=== Description -Analyse if a char is upper case (that is a letter in upper case). Returns true if thisChar is upper case. +=== Descrizione +Analizza se un carattere è maiuscolo (ovvero una lettera in maiuscolo). Restituisce 'true' se thisChar è maiuscolo. [%hardbreaks] [float] -=== Syntax +=== Sintassi [source,arduino] ---- `isUpperCase(thisChar)` ---- [float] -=== Parameters -`thisChar`: variable. *Allowed data types:* char +=== Parametri +`thisChar`: variabile. *Tipi di dati supportati:* char [float] -=== Returns -`true`: if thisChar is upper case. +=== Restituisce +`true`: se thisChar è maiuscolo. -- // OVERVIEW SECTION ENDS @@ -46,7 +46,7 @@ Analyse if a char is upper case (that is a letter in upper case). Returns true i -- [float] -=== Example Code +=== Codice di esempio [source,arduino] ---- @@ -70,7 +70,7 @@ else -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../../../variables/data-types/char[char] diff --git a/Language/Functions/Characters/isWhitespace.adoc b/Language/Functions/Characters/isWhitespace.adoc index 7f82cc6..66d8b1b 100644 --- a/Language/Functions/Characters/isWhitespace.adoc +++ b/Language/Functions/Characters/isWhitespace.adoc @@ -16,26 +16,27 @@ subCategories: [ "Characters" ] -- [float] -=== Description -Analyse if a char is a white space, that is space, formfeed ('\f'), newline ('\n'), carriage return ('\r'), horizontal tab ('\t'), and vertical tab ('\v')). -Returns true if thisChar contains a white space. +=== Descrizione +Analizza se un carattere è uno spazio vuoto, cioè spazio, avanzamento ('\f'), nuova linea ('\n'), ritorno a capo ('\r'), tabulazione orizzontale ('\t'), tabulazione verticale ('\v'). + +Restituisce 'true' se thisChar contiene uno spazio vuoto. [%hardbreaks] [float] -=== Syntax +=== Sintassi [source,arduino] ---- `isWhitespace(thisChar)` ---- [float] -=== Parameters -`thisChar`: variable. *Allowed data types:* char +=== Parametri +`thisChar`: variabile. *Tipi di dato accettati:* char [float] -=== Returns -`true`: if thisChar is a white space. +=== Restituisce +`true`: se thisChar è uno spazio vuoto. -- // OVERVIEW SECTION ENDS @@ -47,7 +48,7 @@ Returns true if thisChar contains a white space. -- [float] -=== Example Code +=== Codice di esempio [source,arduino] ---- @@ -71,7 +72,7 @@ else -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../../../variables/data-types/char[char] diff --git a/Language/Functions/Communication/Serial/available.adoc b/Language/Functions/Communication/Serial/available.adoc index 516b26f..e3ee7db 100644 --- a/Language/Functions/Communication/Serial/available.adoc +++ b/Language/Functions/Communication/Serial/available.adoc @@ -13,13 +13,13 @@ title: Serial.available() -- [float] -=== Description +=== Descrizione Get the number of bytes (characters) available for reading from the serial port. This is data that's already arrived and stored in the serial receive buffer (which holds 64 bytes). `available()` inherits from the Stream utility class. [%hardbreaks] [float] -=== Syntax +=== Sintassi `Serial.available()` _Arduino Mega only:_ @@ -30,11 +30,11 @@ _Arduino Mega only:_ [float] -=== Parameters +=== Parametri Nothing [float] -=== Returns +=== Restituisce The number of bytes available to read . -- // OVERVIEW SECTION ENDS @@ -102,7 +102,7 @@ void loop() { -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../begin[begin()] + diff --git a/Language/Functions/Communication/Serial/availableForWrite.adoc b/Language/Functions/Communication/Serial/availableForWrite.adoc index bbef563..7b51515 100644 --- a/Language/Functions/Communication/Serial/availableForWrite.adoc +++ b/Language/Functions/Communication/Serial/availableForWrite.adoc @@ -13,13 +13,13 @@ title: Serial.availableForWrite() -- [float] -=== Description +=== Descrizione Get the number of bytes (characters) available for writing in the serial buffer without blocking the write operation. [%hardbreaks] [float] -=== Syntax +=== Sintassi `Serial.availableForWrite()` _Arduino Mega only:_ @@ -30,11 +30,11 @@ _Arduino Mega only:_ [float] -=== Parameters +=== Parametri Nothing [float] -=== Returns +=== Restituisce The number of bytes available to read . -- // OVERVIEW SECTION ENDS @@ -45,7 +45,7 @@ The number of bytes available to read . -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../begin[begin()] + diff --git a/Language/Functions/Communication/Serial/begin.adoc b/Language/Functions/Communication/Serial/begin.adoc index c60a33e..7c4b27f 100644 --- a/Language/Functions/Communication/Serial/begin.adoc +++ b/Language/Functions/Communication/Serial/begin.adoc @@ -13,7 +13,7 @@ title: Serial.begin() -- [float] -=== Description +=== Descrizione Sets the data rate in bits per second (baud) for serial data transmission. For communicating with the computer, use one of these rates: 300, 600, 1200, 2400, 4800, 9600, 14400, 19200, 28800, 38400, 57600, or 115200. You can, however, specify other rates - for example, to communicate over pins 0 and 1 with a component that requires a particular baud rate. An optional second argument configures the data, parity, and stop bits. The default is 8 data bits, no parity, one stop bit. @@ -21,7 +21,7 @@ An optional second argument configures the data, parity, and stop bits. The defa [float] -=== Syntax +=== Sintassi `Serial.begin(speed)` `Serial.begin(speed, config)` @@ -37,7 +37,7 @@ _Arduino Mega only:_ [float] -=== Parameters +=== Parametri `speed`: in bits per second (baud) - `long` `config`: sets data, parity, and stop bits. Valid values are @@ -68,7 +68,7 @@ _Arduino Mega only:_ `SERIAL_8O2` + [float] -=== Returns +=== Restituisce Nothing -- @@ -82,8 +82,8 @@ Nothing -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ [source,arduino] diff --git a/Language/Functions/Communication/Serial/end.adoc b/Language/Functions/Communication/Serial/end.adoc index ccf49c1..87a7b6d 100644 --- a/Language/Functions/Communication/Serial/end.adoc +++ b/Language/Functions/Communication/Serial/end.adoc @@ -13,13 +13,13 @@ title: Serial.end() -- [float] -=== Description +=== Descrizione Disables serial communication, allowing the RX and TX pins to be used for general input and output. To re-enable serial communication, call link:../begin[Serial.begin()]. [%hardbreaks] [float] -=== Syntax +=== Sintassi `Serial.end()` _Arduino Mega only:_ @@ -30,11 +30,11 @@ _Arduino Mega only:_ [float] -=== Parameters +=== Parametri Nothing [float] -=== Returns +=== Restituisce Nothing -- diff --git a/Language/Functions/Communication/Serial/find.adoc b/Language/Functions/Communication/Serial/find.adoc index 848c272..bf8c541 100644 --- a/Language/Functions/Communication/Serial/find.adoc +++ b/Language/Functions/Communication/Serial/find.adoc @@ -13,7 +13,7 @@ title: Serial.find() -- [float] -=== Description +=== Descrizione Serial.find() reads data from the serial buffer until the target string of given length is found. The function returns true if target string is found, false if it times out. Serial.find() inherits from the link:../../stream[stream] utility class. @@ -21,15 +21,15 @@ Serial.find() inherits from the link:../../stream[stream] utility class. [float] -=== Syntax +=== Sintassi `Serial.find(target)` [float] -=== Parameters +=== Parametri `target` : the string to search for (char) [float] -=== Returns +=== Restituisce `boolean` -- @@ -41,7 +41,7 @@ Serial.find() inherits from the link:../../stream[stream] utility class. -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../../stream[stream] + diff --git a/Language/Functions/Communication/Serial/findUntil.adoc b/Language/Functions/Communication/Serial/findUntil.adoc index e50bfeb..95ae631 100644 --- a/Language/Functions/Communication/Serial/findUntil.adoc +++ b/Language/Functions/Communication/Serial/findUntil.adoc @@ -13,7 +13,7 @@ title: Serial.findUntil() -- [float] -=== Description +=== Descrizione `Serial.findUntil()` reads data from the serial buffer until a target string of given length or terminator string is found. The function returns true if the target string is found, false if it times out. @@ -23,17 +23,17 @@ The function returns true if the target string is found, false if it times out. [float] -=== Syntax +=== Sintassi `Serial.findUntil(target, terminal)` [float] -=== Parameters +=== Parametri `target` : the string to search for (char) `terminal` : the terminal string in the search (char) [float] -=== Returns +=== Restituisce `boolean` -- @@ -47,7 +47,7 @@ The function returns true if the target string is found, false if it times out. -- [float] -=== Notes and Warnings +=== Note e Avvertimenti -- // HOW TO USE SECTION ENDS @@ -58,7 +58,7 @@ The function returns true if the target string is found, false if it times out. -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../../stream[stream] + diff --git a/Language/Functions/Communication/Serial/flush.adoc b/Language/Functions/Communication/Serial/flush.adoc index 993902a..2372ad0 100644 --- a/Language/Functions/Communication/Serial/flush.adoc +++ b/Language/Functions/Communication/Serial/flush.adoc @@ -13,7 +13,7 @@ title: Serial.flush() -- [float] -=== Description +=== Descrizione Waits for the transmission of outgoing serial data to complete. (Prior to Arduino 1.0, this instead removed any buffered incoming serial data.) `flush()` inherits from the link:../flush[Stream] utility class. @@ -21,7 +21,7 @@ Waits for the transmission of outgoing serial data to complete. (Prior to Arduin [float] -=== Syntax +=== Sintassi `Serial.flush()` _Arduino Mega only:_ @@ -32,11 +32,11 @@ _Arduino Mega only:_ [float] -=== Parameters +=== Parametri Nothing [float] -=== Returns +=== Restituisce Nothing -- @@ -48,7 +48,7 @@ Nothing -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../begin[begin()] diff --git a/Language/Functions/Communication/Serial/ifSerial.adoc b/Language/Functions/Communication/Serial/ifSerial.adoc index b4ab3d0..8d75e26 100644 --- a/Language/Functions/Communication/Serial/ifSerial.adoc +++ b/Language/Functions/Communication/Serial/ifSerial.adoc @@ -13,7 +13,7 @@ title: if(Serial) -- [float] -=== Description +=== Descrizione Indicates if the specified Serial port is ready. On the Leonardo, `if (Serial)` indicates whether or not the USB CDC serial connection is open. For all other instances, including `if (Serial1)` on the Leonardo, this will always return true. @@ -23,7 +23,7 @@ This was introduced in Arduino IDE 1.0.1. [float] -=== Syntax +=== Sintassi _All boards:_ `if (Serial)` @@ -39,11 +39,11 @@ _Arduino Mega specific:_ `if (Serial3)` [float] -=== Parameters +=== Parametri Nothing [float] -=== Returns +=== Restituisce `boolean` : returns true if the specified serial port is available. This will only return false if querying the Leonardo's USB CDC serial connection before it is ready. -- @@ -57,8 +57,8 @@ Nothing -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ [source,arduino] diff --git a/Language/Functions/Communication/Serial/parseFloat.adoc b/Language/Functions/Communication/Serial/parseFloat.adoc index bce4edd..87c47a7 100644 --- a/Language/Functions/Communication/Serial/parseFloat.adoc +++ b/Language/Functions/Communication/Serial/parseFloat.adoc @@ -13,7 +13,7 @@ title: Serial.parseFloat() -- [float] -=== Description +=== Descrizione `Serial.parseFloat()` returns the first valid floating point number from the Serial buffer. Characters that are not digits (or the minus sign) are skipped. `parseFloat()` is terminated by the first character that is not a floating point number. `Serial.parseFloat()` inherits from the link:../../stream[Stream] utility class. @@ -21,16 +21,16 @@ title: Serial.parseFloat() [float] -=== Syntax +=== Sintassi `Serial.parseFloat()` [float] -=== Parameters +=== Parametri Nothing [float] -=== Returns +=== Restituisce `float` -- @@ -42,7 +42,7 @@ Nothing -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../../stream[stream()] diff --git a/Language/Functions/Communication/Serial/parseInt.adoc b/Language/Functions/Communication/Serial/parseInt.adoc index d228b19..ec92191 100644 --- a/Language/Functions/Communication/Serial/parseInt.adoc +++ b/Language/Functions/Communication/Serial/parseInt.adoc @@ -13,7 +13,7 @@ title: Serial.parseInt() -- [float] -=== Description +=== Descrizione Looks for the next valid integer in the incoming serial `stream.parseInt()` inherits from the link:../../stream[Stream] utility class. @@ -26,7 +26,7 @@ In particular: [float] -=== Syntax +=== Sintassi `Serial.parseInt()` `Serial.parseInt(char skipChar)` @@ -38,11 +38,11 @@ _Arduino Mega only:_ [float] -=== Parameters +=== Parametri `skipChar`: used to skip the indicated char in the search. Used for example to skip thousands divider. [float] -=== Returns +=== Restituisce `long` : the next valid integer -- @@ -54,7 +54,7 @@ _Arduino Mega only:_ -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../begin[begin()] + diff --git a/Language/Functions/Communication/Serial/peek.adoc b/Language/Functions/Communication/Serial/peek.adoc index f77597b..0aa4c4e 100644 --- a/Language/Functions/Communication/Serial/peek.adoc +++ b/Language/Functions/Communication/Serial/peek.adoc @@ -13,13 +13,13 @@ title: Serial.peek() -- [float] -=== Description +=== Descrizione Returns the next byte (character) of incoming serial data without removing it from the internal serial buffer. That is, successive calls to `peek()` will return the same character, as will the next call to `read()`. `peek()` inherits from the link:../../stream[Stream] utility class. [%hardbreaks] [float] -=== Syntax +=== Sintassi `Serial.peek()` _Arduino Mega only:_ @@ -30,11 +30,11 @@ _Arduino Mega only:_ [float] -=== Parameters +=== Parametri Nothing [float] -=== Returns +=== Restituisce The first byte of incoming serial data available (or -1 if no data is available) - `int` -- @@ -46,7 +46,7 @@ The first byte of incoming serial data available (or -1 if no data is available) -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../begin[begin()] + diff --git a/Language/Functions/Communication/Serial/print.adoc b/Language/Functions/Communication/Serial/print.adoc index 0a20d46..b9dd7be 100644 --- a/Language/Functions/Communication/Serial/print.adoc +++ b/Language/Functions/Communication/Serial/print.adoc @@ -13,7 +13,7 @@ title: Serial.print() -- [float] -=== Description +=== Descrizione Prints data to the serial port as human-readable ASCII text. This command can take many forms. Numbers are printed using an ASCII character for each digit. Floats are similarly printed as ASCII digits, defaulting to two decimal places. Bytes are sent as a single character. Characters and strings are sent as is. For example- * `Serial.print(78) gives "78"` + @@ -40,17 +40,17 @@ To send a single byte, use link:../write[Serial.write()]. [float] -=== Syntax +=== Sintassi `Serial.print(val)` + `Serial.print(val, format)` [float] -=== Parameters +=== Parametri `val`: the value to print - any data type [float] -=== Returns +=== Restituisce `size_t`: `print()` returns the number of bytes written, though reading that number is optional. -- @@ -64,8 +64,8 @@ To send a single byte, use link:../write[Serial.write()]. -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ [source,arduino] @@ -121,7 +121,7 @@ void loop() { [%hardbreaks] [float] -=== Notes and Warnings +=== Note e Avvertimenti As of version 1.0, serial transmission is asynchronous; `Serial.print()` will return before any characters are transmitted. -- @@ -133,7 +133,7 @@ As of version 1.0, serial transmission is asynchronous; `Serial.print()` will re -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../begin[begin()] diff --git a/Language/Functions/Communication/Serial/println.adoc b/Language/Functions/Communication/Serial/println.adoc index 4185a2f..861230d 100644 --- a/Language/Functions/Communication/Serial/println.adoc +++ b/Language/Functions/Communication/Serial/println.adoc @@ -13,25 +13,25 @@ title: Serial.println() -- [float] -=== Description +=== Descrizione Prints data to the serial port as human-readable ASCII text followed by a carriage return character (ASCII 13, or '\r') and a newline character (ASCII 10, or '\n'). This command takes the same forms as link:../print[Serial.print()]. [%hardbreaks] [float] -=== Syntax +=== Sintassi `Serial.println(val)` + `Serial.println(val, format)` [float] -=== Parameters +=== Parametri `val`: the value to print - any data type `format`: specifies the number base (for integral data types) or number of decimal places (for floating point types) [float] -=== Returns +=== Restituisce `size_t`: `println()` returns the number of bytes written, though reading that number is optional -- // OVERVIEW SECTION ENDS @@ -44,8 +44,8 @@ Prints data to the serial port as human-readable ASCII text followed by a carria -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ [source,arduino] diff --git a/Language/Functions/Communication/Serial/read.adoc b/Language/Functions/Communication/Serial/read.adoc index c9ae16a..9c21b58 100644 --- a/Language/Functions/Communication/Serial/read.adoc +++ b/Language/Functions/Communication/Serial/read.adoc @@ -13,13 +13,13 @@ title: Serial.read() -- [float] -=== Description +=== Descrizione Reads incoming serial data. read() inherits from the link:../../stream[Stream] utility class. [%hardbreaks] [float] -=== Syntax +=== Sintassi `Serial.read()` _Arduino Mega only:_ @@ -30,11 +30,11 @@ _Arduino Mega only:_ [float] -=== Parameters +=== Parametri Nothing [float] -=== Returns +=== Restituisce The first byte of incoming serial data available (or -1 if no data is available) - `int`. -- @@ -48,8 +48,8 @@ The first byte of incoming serial data available (or -1 if no data is available) -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ [source,arduino] diff --git a/Language/Functions/Communication/Serial/readBytes.adoc b/Language/Functions/Communication/Serial/readBytes.adoc index dbd25f3..8152f29 100644 --- a/Language/Functions/Communication/Serial/readBytes.adoc +++ b/Language/Functions/Communication/Serial/readBytes.adoc @@ -13,7 +13,7 @@ title: Serial.readBytes() -- [float] -=== Description +=== Descrizione `Serial.readBytes()` reads characters from the serial port into a buffer. The function terminates if the determined length has been read, or it times out (see link:../settimeout[Serial.setTimeout()]). `Serial.readBytes()` returns the number of characters placed in the buffer. A 0 means no valid data was found. @@ -23,18 +23,18 @@ title: Serial.readBytes() [float] -=== Syntax +=== Sintassi `Serial.readBytes(buffer, length)` [float] -=== Parameters +=== Parametri `buffer`: the buffer to store the bytes in (`char[]` or `byte[]`) `length` : the number of bytes to read (`int`) [float] -=== Returns +=== Restituisce The number of bytes placed in the buffer (`size_t`) -- @@ -46,7 +46,7 @@ The number of bytes placed in the buffer (`size_t`) -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../../stream[stream] diff --git a/Language/Functions/Communication/Serial/readBytesUntil.adoc b/Language/Functions/Communication/Serial/readBytesUntil.adoc index b5eca10..fcd810a 100644 --- a/Language/Functions/Communication/Serial/readBytesUntil.adoc +++ b/Language/Functions/Communication/Serial/readBytesUntil.adoc @@ -13,7 +13,7 @@ title: Serial.readBytesUntil() -- [float] -=== Description +=== Descrizione Serial.readBytesUntil() reads characters from the serial buffer into an array. The function terminates if the terminator character is detected, the determined length has been read, or it times out (see link:../settimeout[Serial.setTimeout()]). The function returns the characters up to the last character before the supplied terminator. The terminator itself is not returned in the buffer. `Serial.readBytesUntil()` returns the number of characters read into the buffer. A 0 means no valid data was found. @@ -23,12 +23,12 @@ Serial.readBytesUntil() reads characters from the serial buffer into an array. T [float] -=== Syntax +=== Sintassi `Serial.readBytesUntil(character, buffer, length)` [float] -=== Parameters +=== Parametri `character` : the character to search for (`char`) `buffer`: the buffer to store the bytes in (`char[]` or `byte[]`) @@ -36,7 +36,7 @@ Serial.readBytesUntil() reads characters from the serial buffer into an array. T `length` : the number of bytes to read (`int`) [float] -=== Returns +=== Restituisce `size_t` -- @@ -48,7 +48,7 @@ Serial.readBytesUntil() reads characters from the serial buffer into an array. T -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../../stream[Stream] diff --git a/Language/Functions/Communication/Serial/readString.adoc b/Language/Functions/Communication/Serial/readString.adoc index 02951fa..5010a0e 100644 --- a/Language/Functions/Communication/Serial/readString.adoc +++ b/Language/Functions/Communication/Serial/readString.adoc @@ -13,7 +13,7 @@ title: Serial.readString() -- [float] -=== Description +=== Descrizione `Serial.readString()` reads characters from the serial buffer into a string. The function terminates if it times out (see link:../setTimeout[setTimeout()]). This function is part of the Stream class, and is called by any class that inherits from it (Wire, Serial, etc). See the link:../../stream[Stream class] main page for more information. @@ -22,16 +22,16 @@ This function is part of the Stream class, and is called by any class that inher [float] -=== Syntax +=== Sintassi `Serial.readString()` [float] -=== Parameters +=== Parametri Nothing [float] -=== Returns +=== Restituisce A String read from the serial buffer -- @@ -43,7 +43,7 @@ A String read from the serial buffer -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../../serial[Serial] diff --git a/Language/Functions/Communication/Serial/readStringUntil.adoc b/Language/Functions/Communication/Serial/readStringUntil.adoc index ed55953..cb9fd08 100644 --- a/Language/Functions/Communication/Serial/readStringUntil.adoc +++ b/Language/Functions/Communication/Serial/readStringUntil.adoc @@ -13,7 +13,7 @@ title: Serial.readStringUntil() -- [float] -=== Description +=== Descrizione `readStringUntil()` reads characters from the serial buffer into a string. The function terminates if it times out (see link:../setTimeout[setTimeout()]). This function is part of the Stream class, and is called by any class that inherits from it (Wire, Serial, etc). See the link:../../stream[Stream class] main page for more information. @@ -22,16 +22,16 @@ This function is part of the Stream class, and is called by any class that inher [float] -=== Syntax +=== Sintassi `Serial.readStringUntil(terminator)` [float] -=== Parameters +=== Parametri `terminator` : the character to search for (`char`) [float] -=== Returns +=== Restituisce The entire String read from the serial buffer, until the terminator character is detected -- @@ -43,7 +43,7 @@ The entire String read from the serial buffer, until the terminator character is -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../../serial[Serial] diff --git a/Language/Functions/Communication/Serial/serialEvent.adoc b/Language/Functions/Communication/Serial/serialEvent.adoc index d45b3b6..57bace0 100644 --- a/Language/Functions/Communication/Serial/serialEvent.adoc +++ b/Language/Functions/Communication/Serial/serialEvent.adoc @@ -13,7 +13,7 @@ title: Serial.serialEvent() -- [float] -=== Description +=== Descrizione Called when data is available. Use `Serial.read()` to capture this data. NB : Currently, `serialEvent()` is not compatible with the Esplora, Leonardo, or Micro @@ -21,7 +21,7 @@ NB : Currently, `serialEvent()` is not compatible with the Esplora, Leonardo, or [float] -=== Syntax +=== Sintassi [source,arduino] ---- @@ -46,11 +46,11 @@ void serialEvent3(){ ---- [float] -=== Parameters +=== Parametri `statements`: any valid statements [float] -=== Returns +=== Restituisce Nothing -- @@ -62,7 +62,7 @@ Nothing -- [float] -=== See also +=== Vedi anche [role="example"] * #EXAMPLE# http://arduino.cc/en/Tutorial/SerialEvent[SerialEvent Tutorial] diff --git a/Language/Functions/Communication/Serial/setTimeout.adoc b/Language/Functions/Communication/Serial/setTimeout.adoc index 82aefb4..deccbf7 100644 --- a/Language/Functions/Communication/Serial/setTimeout.adoc +++ b/Language/Functions/Communication/Serial/setTimeout.adoc @@ -13,7 +13,7 @@ title: Serial.setTimeout() -- [float] -=== Description +=== Descrizione `Serial.setTimeout()` sets the maximum milliseconds to wait for serial data when using link:../readbytesuntil[serial.readBytesUntil()] or link:../readbytes[serial.readBytes()]. It defaults to 1000 milliseconds. `Serial.setTimeout()` inherits from the link:../../stream[Stream] utility class. @@ -21,15 +21,15 @@ title: Serial.setTimeout() [float] -=== Syntax +=== Sintassi `Serial.setTimeout(time)` [float] -=== Parameters +=== Parametri `time` : timeout duration in milliseconds (`long`). [float] -=== Returns +=== Restituisce Nothing -- @@ -41,7 +41,7 @@ Nothing -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../../stream[stream] diff --git a/Language/Functions/Communication/Serial/write.adoc b/Language/Functions/Communication/Serial/write.adoc index 79c7427..a50882e 100644 --- a/Language/Functions/Communication/Serial/write.adoc +++ b/Language/Functions/Communication/Serial/write.adoc @@ -13,13 +13,13 @@ title: Serial.write() -- [float] -=== Description +=== Descrizione Writes binary data to the serial port. This data is sent as a byte or series of bytes; to send the characters representing the digits of a number use the link:../print[print()] function instead. [%hardbreaks] [float] -=== Syntax +=== Sintassi `Serial.write(val)` + `Serial.write(str)` + `Serial.write(buf, len)` @@ -30,7 +30,7 @@ _Arduino Mega also supports:_ [float] -=== Parameters +=== Parametri `val`: a value to send as a single byte `str`: a string to send as a series of bytes @@ -38,7 +38,7 @@ _Arduino Mega also supports:_ `buf`: an array to send as a series of bytes [float] -=== Returns +=== Restituisce `size_t` `write()` will return the number of bytes written, though reading that number is optional @@ -53,8 +53,8 @@ _Arduino Mega also supports:_ [#howtouse] -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ [source,arduino] diff --git a/Language/Functions/Communication/Stream/streamAvailable.adoc b/Language/Functions/Communication/Stream/streamAvailable.adoc index 371fb68..d620ac7 100644 --- a/Language/Functions/Communication/Stream/streamAvailable.adoc +++ b/Language/Functions/Communication/Stream/streamAvailable.adoc @@ -12,7 +12,7 @@ title: Stream.available() -- [float] -=== Description +=== Descrizione `available()` gets the number of bytes available in the stream. This is only for bytes that have already arrived. This function is part of the Stream class, and is called by any class that inherits from it (Wire, Serial, etc). See the link:../../stream[Stream class] main page for more information. @@ -20,16 +20,16 @@ This function is part of the Stream class, and is called by any class that inher [float] -=== Syntax +=== Sintassi `stream.available()` [float] -=== Parameters +=== Parametri `stream` : an instance of a class that inherits from Stream. [float] -=== Returns +=== Restituisce `int` : the number of bytes available to read -- diff --git a/Language/Functions/Communication/Stream/streamFind.adoc b/Language/Functions/Communication/Stream/streamFind.adoc index 1487d87..f85e765 100644 --- a/Language/Functions/Communication/Stream/streamFind.adoc +++ b/Language/Functions/Communication/Stream/streamFind.adoc @@ -13,7 +13,7 @@ title: Stream.find() -- [float] -=== Description +=== Descrizione `find()` reads data from the stream until the target string of given length is found The function returns true if target string is found, false if timed out. This function is part of the Stream class, and is called by any class that inherits from it (Wire, Serial, etc). See the link:../../stream[stream class] main page for more information. @@ -21,18 +21,18 @@ This function is part of the Stream class, and is called by any class that inher [float] -=== Syntax +=== Sintassi `stream.find(target)` [float] -=== Parameters +=== Parametri `stream` : an instance of a class that inherits from Stream. `target` : the string to search for (char) [float] -=== Returns +=== Restituisce `boolean` -- diff --git a/Language/Functions/Communication/Stream/streamFindUntil.adoc b/Language/Functions/Communication/Stream/streamFindUntil.adoc index 8a50ee8..5077c51 100644 --- a/Language/Functions/Communication/Stream/streamFindUntil.adoc +++ b/Language/Functions/Communication/Stream/streamFindUntil.adoc @@ -13,7 +13,7 @@ title: Stream.findUntil() -- [float] -=== Description +=== Descrizione `findUntil()` reads data from the stream until the target string of given length or terminator string is found. The function returns true if target string is found, false if timed out @@ -23,16 +23,16 @@ This function is part of the Stream class, and is called by any class that inher [float] -=== Syntax +=== Sintassi `stream.findUntil(target, terminal)` [float] -=== Parameters +=== Parametri `stream.findUntil(target, terminal)` [float] -=== Returns +=== Restituisce `boolean` -- diff --git a/Language/Functions/Communication/Stream/streamFlush.adoc b/Language/Functions/Communication/Stream/streamFlush.adoc index 1658d9f..361beab 100644 --- a/Language/Functions/Communication/Stream/streamFlush.adoc +++ b/Language/Functions/Communication/Stream/streamFlush.adoc @@ -13,7 +13,7 @@ title: Stream.flush() -- [float] -=== Description +=== Descrizione `flush()` clears the buffer once all outgoing characters have been sent. This function is part of the Stream class, and is called by any class that inherits from it (Wire, Serial, etc). See the link:../../stream[stream class] main page for more information. @@ -21,16 +21,16 @@ This function is part of the Stream class, and is called by any class that inher [float] -=== Syntax +=== Sintassi `stream.flush()` [float] -=== Parameters +=== Parametri `stream` : an instance of a class that inherits from Stream. [float] -=== Returns +=== Restituisce `boolean` -- diff --git a/Language/Functions/Communication/Stream/streamParseFloat.adoc b/Language/Functions/Communication/Stream/streamParseFloat.adoc index 40324ce..cc0220d 100644 --- a/Language/Functions/Communication/Stream/streamParseFloat.adoc +++ b/Language/Functions/Communication/Stream/streamParseFloat.adoc @@ -13,7 +13,7 @@ title: Stream.parseFloat() -- [float] -=== Description +=== Descrizione `parseFloat()` returns the first valid floating point number from the current position. Initial characters that are not digits (or the minus sign) are skipped. `parseFloat()` is terminated by the first character that is not a floating point number. This function is part of the Stream class, and is called by any class that inherits from it (Wire, Serial, etc). See the link:../../stream[Stream class] main page for more informatio @@ -21,18 +21,18 @@ This function is part of the Stream class, and is called by any class that inher [float] -=== Syntax +=== Sintassi `stream.parseFloat(list)` [float] -=== Parameters +=== Parametri `stream` : an instance of a class that inherits from Stream. `list` : the stream to check for floats (`char`) [float] -=== Returns +=== Restituisce `float` -- diff --git a/Language/Functions/Communication/Stream/streamParseInt.adoc b/Language/Functions/Communication/Stream/streamParseInt.adoc index ac284be..18b4ae5 100644 --- a/Language/Functions/Communication/Stream/streamParseInt.adoc +++ b/Language/Functions/Communication/Stream/streamParseInt.adoc @@ -13,7 +13,7 @@ title: Stream.parseInt() -- [float] -=== Description +=== Descrizione `parseInt()` returns the first valid (long) integer number from the current position. Initial characters that are not integers (or the minus sign) are skipped. In particular: @@ -27,13 +27,13 @@ This function is part of the Stream class, and is called by any class that inher [float] -=== Syntax +=== Sintassi `stream.parseInt(list)` `stream.parseInt(''list', char skipchar')` [float] -=== Parameters +=== Parametri `stream` : an instance of a class that inherits from Stream. `list` : the stream to check for ints (`char`) @@ -41,7 +41,7 @@ This function is part of the Stream class, and is called by any class that inher `skipChar`: used to skip the indicated char in the search. Used for example to skip thousands divider. [float] -=== Returns +=== Restituisce `long` -- diff --git a/Language/Functions/Communication/Stream/streamPeek.adoc b/Language/Functions/Communication/Stream/streamPeek.adoc index cc1e3f6..9079bce 100644 --- a/Language/Functions/Communication/Stream/streamPeek.adoc +++ b/Language/Functions/Communication/Stream/streamPeek.adoc @@ -13,7 +13,7 @@ title: Stream.peek() -- [float] -=== Description +=== Descrizione Read a byte from the file without advancing to the next one. That is, successive calls to `peek()` will return the same value, as will the next call to `read()`. This function is part of the Stream class, and is called by any class that inherits from it (Wire, Serial, etc). See the link:../../stream[Stream class] main page for more information. @@ -21,16 +21,16 @@ This function is part of the Stream class, and is called by any class that inher [float] -=== Syntax +=== Sintassi `stream.peek()` [float] -=== Parameters +=== Parametri `stream` : an instance of a class that inherits from Stream. [float] -=== Returns +=== Restituisce The next byte (or character), or -1 if none is available. -- @@ -44,8 +44,8 @@ The next byte (or character), or -1 if none is available. -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ -- // HOW TO USE SECTION ENDS \ No newline at end of file diff --git a/Language/Functions/Communication/Stream/streamRead.adoc b/Language/Functions/Communication/Stream/streamRead.adoc index c08e24f..8536be2 100644 --- a/Language/Functions/Communication/Stream/streamRead.adoc +++ b/Language/Functions/Communication/Stream/streamRead.adoc @@ -13,7 +13,7 @@ title: Stream.read() -- [float] -=== Description +=== Descrizione `read()` reads characters from an incoming stream to the buffer. This function is part of the Stream class, and is called by any class that inherits from it (Wire, Serial, etc). See the link:../../stream[stream class] main page for more information. @@ -21,16 +21,16 @@ This function is part of the Stream class, and is called by any class that inher [float] -=== Syntax +=== Sintassi `stream.read()` [float] -=== Parameters +=== Parametri `stream` : an instance of a class that inherits from Stream. [float] -=== Returns +=== Restituisce The first byte of incoming data available (or -1 if no data is available). -- diff --git a/Language/Functions/Communication/Stream/streamReadBytes.adoc b/Language/Functions/Communication/Stream/streamReadBytes.adoc index 28cde0d..0a94220 100644 --- a/Language/Functions/Communication/Stream/streamReadBytes.adoc +++ b/Language/Functions/Communication/Stream/streamReadBytes.adoc @@ -13,7 +13,7 @@ title: Stream.readBytes() -- [float] -=== Description +=== Descrizione `readBytes()` read characters from a stream into a buffer. The function terminates if the determined length has been read, or it times out (see link:../streamSetTimeout[setTimeout()]). `readBytes()` returns the number of bytes placed in the buffer. A 0 means no valid data was found. @@ -23,12 +23,12 @@ This function is part of the Stream class, and is called by any class that inher [float] -=== Syntax +=== Sintassi `stream.readBytes(buffer, length)` [float] -=== Parameters +=== Parametri `stream` : an instance of a class that inherits from Stream. `buffer` : the buffer to store the bytes in (`char[]` or `byte[]`) @@ -36,7 +36,7 @@ This function is part of the Stream class, and is called by any class that inher `length` : the number of bytes to `read(int)` [float] -=== Returns +=== Restituisce The number of bytes placed in the buffer (`size_t`) -- diff --git a/Language/Functions/Communication/Stream/streamReadBytesUntil.adoc b/Language/Functions/Communication/Stream/streamReadBytesUntil.adoc index 5c8b241..6278050 100644 --- a/Language/Functions/Communication/Stream/streamReadBytesUntil.adoc +++ b/Language/Functions/Communication/Stream/streamReadBytesUntil.adoc @@ -13,7 +13,7 @@ title: Stream.readBytesUntil() -- [float] -=== Description +=== Descrizione `readBytesUntil()` reads characters from a stream into a buffer. The function terminates if the terminator character is detected, the determined length has been read, or it times out (see link:../streamsettimeout[setTimeout()]). `readBytesUntil()` returns the number of bytes placed in the buffer. A 0 means no valid data was found. @@ -23,12 +23,12 @@ This function is part of the Stream class, and is called by any class that inher [float] -=== Syntax +=== Sintassi `stream.readBytesUntil(character, buffer, length)` [float] -=== Parameters +=== Parametri `stream` : an instance of a class that inherits from Stream. `character` : the character to search for (`char`) @@ -38,7 +38,7 @@ This function is part of the Stream class, and is called by any class that inher `length : the number of bytes to `read(int)` [float] -=== Returns +=== Restituisce The number of bytes placed in the buffer. -- diff --git a/Language/Functions/Communication/Stream/streamReadString.adoc b/Language/Functions/Communication/Stream/streamReadString.adoc index 7d86ba9..a42eae1 100644 --- a/Language/Functions/Communication/Stream/streamReadString.adoc +++ b/Language/Functions/Communication/Stream/streamReadString.adoc @@ -13,7 +13,7 @@ title: Stream.readString() -- [float] -=== Description +=== Descrizione `readString()` reads characters from a stream into a string. The function terminates if it times out (see link:../streamsettimeout[setTimeout()]). This function is part of the Stream class, and is called by any class that inherits from it (Wire, Serial, etc). See the link:../../stream[Stream class] main page for more information. @@ -21,16 +21,16 @@ This function is part of the Stream class, and is called by any class that inher [float] -=== Syntax +=== Sintassi `stream.readString()` [float] -=== Parameters +=== Parametri Nothing [float] -=== Returns +=== Restituisce A string read from a stream. -- diff --git a/Language/Functions/Communication/Stream/streamReadStringUntil.adoc b/Language/Functions/Communication/Stream/streamReadStringUntil.adoc index bd58b4a..253eef7 100644 --- a/Language/Functions/Communication/Stream/streamReadStringUntil.adoc +++ b/Language/Functions/Communication/Stream/streamReadStringUntil.adoc @@ -13,7 +13,7 @@ title: Stream.readStringUntil() -- [float] -=== Description +=== Descrizione `readStringUntil()` reads characters from a stream into a string. The function terminates if the terminator character is detected or it times out (see link:../streamsettimeout[setTimeout()]). This function is part of the Stream class, and is called by any class that inherits from it (Wire, Serial, etc). See the link:../../stream[Stream class] main page for more information. @@ -21,16 +21,16 @@ This function is part of the Stream class, and is called by any class that inher [float] -=== Syntax +=== Sintassi `stream.readString(terminator)` [float] -=== Parameters +=== Parametri `terminator` : the character to search for (`char`) [float] -=== Returns +=== Restituisce The entire string read from a stream, until the terminator character is detected. -- diff --git a/Language/Functions/Communication/Stream/streamSetTimeout.adoc b/Language/Functions/Communication/Stream/streamSetTimeout.adoc index 39d6235..1f81fec 100644 --- a/Language/Functions/Communication/Stream/streamSetTimeout.adoc +++ b/Language/Functions/Communication/Stream/streamSetTimeout.adoc @@ -13,23 +13,23 @@ title: Stream.setTimeout() -- [float] -=== Description +=== Descrizione `setTimeout()` sets the maximum milliseconds to wait for stream data, it defaults to 1000 milliseconds. This function is part of the Stream class, and is called by any class that inherits from it (Wire, Serial, etc). See the #LANGUAGE# link:../../stream[Stream class] main page for more information. [%hardbreaks] [float] -=== Syntax +=== Sintassi `stream.setTimeout(time)` [float] -=== Parameters +=== Parametri `stream` : an instance of a class that inherits from Stream. `time` : timeout duration in milliseconds (`long`). [float] -=== Returns +=== Restituisce Nothing -- diff --git a/Language/Functions/Communication/serial.adoc b/Language/Functions/Communication/serial.adoc index 453ecd9..325a19a 100644 --- a/Language/Functions/Communication/serial.adoc +++ b/Language/Functions/Communication/serial.adoc @@ -1,6 +1,6 @@ --- title: serial -categories: [ "Functions" ] +categories: [ "Funzioni" ] subCategories: [ "Communication" ] --- @@ -15,17 +15,17 @@ subCategories: [ "Communication" ] -- [float] -=== Description -Used for communication between the Arduino board and a computer or other devices. All Arduino boards have at least one serial port (also known as a UART or USART): Serial. It communicates on digital pins 0 (RX) and 1 (TX) as well as with the computer via USB. Thus, if you use these functions, you cannot also use pins 0 and 1 for digital input or output. + -You can use the Arduino environment's built-in serial monitor to communicate with an Arduino board. Click the serial monitor button in the toolbar and select the same baud rate used in the call to `begin()`. +=== Descrizione +Utilizzato per la comunicazione tra la scheda Arduino e un computer o altri dispositivi. Tutte le schede Arduino hanno almeno una porta seriale (nota anche come UART o USART): Seriale. Comunica sui pin digitali 0 (RX) e 1 (TX) oltre che con il computer tramite USB. Pertanto, se si utilizzano queste funzioni, non è possibile utilizzare anche i pin 0 e 1 per l'ingresso o l'uscita digitale. + +È possibile utilizzare il monitor seriale integrato nell'ambiente Arduino per comunicare con una scheda Arduino. Fare clic sul pulsante del monitor seriale nella barra degli strumenti e selezionare la stessa velocità di trasmissione utilizzata nella chiamata a `begin()`. [%hardbreaks] -Serial communication on pins TX/RX uses TTL logic levels (5V or 3.3V depending on the board). Don't connect these pins directly to an RS232 serial port; they operate at +/- 12V and can damage your Arduino board. +La comunicazione seriale sui pin TX / RX utilizza livelli logici TTL (5V o 3.3V a seconda della scheda). Non collegare questi pin direttamente a una porta seriale RS232; funzionano a +/- 12V e possono danneggiare la tua scheda Arduino. [%hardbreaks] -The *Arduino Mega* has three additional serial ports: `Serial1` on pins 19 (RX) and 18 (TX), `Serial2` on pins 17 (RX) and 16 (TX), `Serial3` on pins 15 (RX) and 14 (TX). To use these pins to communicate with your personal computer, you will need an additional USB-to-serial adaptor, as they are not connected to the Mega's USB-to-serial adaptor. To use them to communicate with an external TTL serial device, connect the TX pin to your device's RX pin, the RX to your device's TX pin, and the ground of your Mega to your device's ground. +*Arduino Mega* ha tre porte seriali aggiuntive: `Serial1` sui pin 19 (RX) e 18 (TX),` Serial2` sui pin 17 (RX) e 16 (TX), `Serial3` sui pin 15 (RX) e 14 (TX). Per utilizzare questi pin per comunicare con il tuo personal computer, avrai bisogno di un ulteriore adattatore da USB a seriale, poiché non sono collegati all'adattatore da USB a seriale di Mega. Per usarli per comunicare con un dispositivo seriale TTL esterno, collega il pin TX al pin RX del tuo dispositivo, l'RX al pin TX del tuo dispositivo e la terra del tuo Mega alla terra del tuo dispositivo. [%hardbreaks] -The *Arduino DUE* has three additional 3.3V TTL serial ports: `Serial1` on pins 19 (RX) and 18 (TX); `Serial2` on pins 17 (RX) and 16 (TX), `Serial3` on pins 15 (RX) and 14 (TX). Pins 0 and 1 are also connected to the corresponding pins of the ATmega16U2 USB-to-TTL Serial chip, which is connected to the USB debug port. Additionally, there is a native USB-serial port on the SAM3X chip, SerialUSB'. +*Arduino DUE* ha tre porte seriali TTL da 3,3 V aggiuntive: `Serial1` sui pin 19 (RX) e 18 (TX); `Serial2` sui pin 17 (RX) e 16 (TX), `Serial3` sui pin 15 (RX) e 14 (TX). I pin 0 e 1 sono anche collegati ai pin corrispondenti del chip seriale da USB a TTL ATmega16U2, che è collegato alla porta di debug USB. Inoltre, c'è una porta seriale USB nativa sul chip SAM3X, SerialUSB '. [%hardbreaks] -The *Arduino Leonardo* board uses `Serial1` to communicate via TTL (5V) serial on pins 0 (RX) and 1 (TX). `Serial` is reserved for USB CDC communication. For more information, refer to the Leonardo getting started page and hardware page. +La scheda *Arduino Leonardo* utilizza `Serial1` per comunicare tramite seriale TTL (5V) sui pin 0 (RX) e 1 (TX). `Serial` è riservato per la comunicazione USB CDC. Per ulteriori informazioni, fare riferimento alla pagina iniziale di Leonardo e alla pagina hardware. -- // OVERVIEW SECTION ENDS @@ -38,7 +38,7 @@ The *Arduino Leonardo* board uses `Serial1` to communicate via TTL (5V) serial o ''' [float] -=== Functions +=== Funzioni link:../serial/ifserial[If] (Serial) + link:../serial/available[available()] + link:../serial/availableforwrite[availableForWrite()] + @@ -70,7 +70,7 @@ link:../serial/serialevent[serialEvent()] -- [float] -=== See also +=== Vedi anche [role="example"] * #EXAMPLE# https://www.arduino.cc/en/Tutorial/ReadASCIIString[ReadASCIIString^] diff --git a/Language/Functions/Communication/stream.adoc b/Language/Functions/Communication/stream.adoc index 18f78be..2c69d80 100644 --- a/Language/Functions/Communication/stream.adoc +++ b/Language/Functions/Communication/stream.adoc @@ -15,12 +15,12 @@ subCategories: [ "Communication" ] -- [float] -=== Description -Stream is the base class for character and binary based streams. It is not called directly, but invoked whenever you use a function that relies on it. +=== Descrizione +Stream è la classe base per flussi basati su caratteri e binari. Non viene chiamato direttamente, ma viene richiamato ogni volta che si utilizza una funzione su cui si basa. -Stream defines the reading functions in Arduino. When using any core functionality that uses a `read()` or similar method, you can safely assume it calls on the Stream class. For functions like `print()`, Stream inherits from the Print class. +Stream definisce le funzioni di lettura in Arduino. Quando si utilizza una funzionalità di base che utilizza un metodo `read()` o simile, si può ragionevolmente presumere che chiami la classe Stream. Per funzioni come `print()`, Stream le eredita dalla classe Print. -Some of the libraries that rely on Stream include : +Alcune delle librerie che si basano su Stream includono: * link:../serial[Serial] * link:https://www.arduino.cc/en/Reference/Wire[Wire] @@ -39,7 +39,7 @@ Some of the libraries that rely on Stream include : ''' [float] -=== Functions +=== Funzioni link:../stream/streamavailable[available()] + link:../stream/streamread[read()] + link:../stream/streamflush[flush()] + diff --git a/Language/Functions/Digital IO/digitalRead.adoc b/Language/Functions/Digital IO/digitalRead.adoc index ceafcc0..7bc15e2 100644 --- a/Language/Functions/Digital IO/digitalRead.adoc +++ b/Language/Functions/Digital IO/digitalRead.adoc @@ -16,22 +16,22 @@ subCategories: [ "Digital I/O" ] -- [float] -=== Description -Reads the value from a specified digital pin, either `HIGH` or `LOW`. +=== Descrizione +Legge il valore da uno specifico pin digitale, sia `HIGH` che `LOW`. [%hardbreaks] [float] -=== Syntax +=== Sintassi `digitalRead(pin)` [float] -=== Parameters +=== Parametri `pin`: the number of the digital pin you want to read [float] -=== Returns +=== Restituisce `HIGH` or `LOW` -- @@ -45,8 +45,8 @@ Reads the value from a specified digital pin, either `HIGH` or `LOW`. -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ Sets pin 13 to the same value as pin 7, declared as an input. //[source,arduino] @@ -70,7 +70,7 @@ void loop() [%hardbreaks] [float] -=== Notes and Warnings +=== Note e Avvertimenti If the pin isn't connected to anything, digitalRead() can return either HIGH or LOW (and this can change randomly). The analog input pins can be used as digital pins, referred to as A0, A1, etc. @@ -84,7 +84,7 @@ The analog input pins can be used as digital pins, referred to as A0, A1, etc. -- [float] -=== See also +=== Vedi anche [role="example"] * #EXAMPLE# Tutorial: (http://arduino.cc/en/Tutorial/DigitalPins[Digital Pins]) diff --git a/Language/Functions/Digital IO/digitalWrite.adoc b/Language/Functions/Digital IO/digitalWrite.adoc index 32fcbca..7102226 100644 --- a/Language/Functions/Digital IO/digitalWrite.adoc +++ b/Language/Functions/Digital IO/digitalWrite.adoc @@ -16,7 +16,7 @@ subCategories: [ "Digital I/O" ] -- [float] -=== Description +=== Descrizione Write a `HIGH` or a `LOW` value to a digital pin. If the pin has been configured as an `OUTPUT` with `pinMode()`, its voltage will be set to the corresponding value: 5V (or 3.3V on 3.3V boards) for `HIGH`, 0V (ground) for `LOW`. @@ -29,18 +29,18 @@ If you do not set the `pinMode()` to `OUTPUT`, and connect an LED to a pin, when [%hardbreaks] [float] -=== Syntax +=== Sintassi `digitalWrite(pin, value)` [float] -=== Parameters +=== Parametri `pin`: the pin number `value`: `HIGH` or `LOW` [float] -=== Returns +=== Restituisce Nothing -- @@ -54,8 +54,8 @@ Nothing -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ The code makes the digital pin 13 an `OUTPUT` and toggles it by alternating between `HIGH` and `LOW` at one second pace. //[source,arduino] @@ -76,7 +76,7 @@ void loop() [%hardbreaks] [float] -=== Notes and Warnings +=== Note e Avvertimenti The analog input pins can be used as digital pins, referred to as A0, A1, etc. -- @@ -88,7 +88,7 @@ The analog input pins can be used as digital pins, referred to as A0, A1, etc. -- [float] -=== See also +=== Vedi anche [role="example"] * #EXAMPLE# http://arduino.cc/en/Tutorial/DigitalPins[Tutorial: Digital Pins] diff --git a/Language/Functions/Digital IO/pinMode.adoc b/Language/Functions/Digital IO/pinMode.adoc index f2d3653..672223c 100644 --- a/Language/Functions/Digital IO/pinMode.adoc +++ b/Language/Functions/Digital IO/pinMode.adoc @@ -16,7 +16,7 @@ subCategories: [ "Digital I/O" ] -- [float] -=== Description +=== Descrizione Configures the specified pin to behave either as an input or an output. See the description of (http://arduino.cc/en/Tutorial/DigitalPins[digital pins]) for details on the functionality of the pins. [%hardbreaks] As of Arduino 1.0.1, it is possible to enable the internal pullup resistors with the mode INPUT_PULLUP. Additionally, the INPUT mode explicitly disables the internal pullups. @@ -24,11 +24,11 @@ As of Arduino 1.0.1, it is possible to enable the internal pullup resistors with [float] -=== Syntax +=== Sintassi `pinMode(pin, mode)` [float] -=== Parameters +=== Parametri `pin`: the number of the pin whose mode you wish to set `mode`: `INPUT`, `OUTPUT`, or `INPUT_PULLUP`. (see the (http://arduino.cc/en/Tutorial/DigitalPins[digital pins]) page for a more complete description of the functionality.) @@ -36,7 +36,7 @@ As of Arduino 1.0.1, it is possible to enable the internal pullup resistors with //Check how to add links [float] -=== Returns +=== Restituisce Nothing -- @@ -50,7 +50,7 @@ Nothing -- [float] -=== Example Code +=== Codice di Esempio The code makes the digital pin 13 `OUTPUT` and Togles it `HIGH` and `LOW` //[source,arduino] @@ -71,7 +71,7 @@ void loop() [%hardbreaks] [float] -=== Notes and Warnings +=== Note e Avvertimenti The analog input pins can be used as digital pins, referred to as A0, A1, etc. -- @@ -83,7 +83,7 @@ The analog input pins can be used as digital pins, referred to as A0, A1, etc. -- [float] -=== See also +=== Vedi anche [role="example"] * #EXAMPLE# http://arduino.cc/en/Tutorial/DigitalPins[Description of the pins on an Arduino board^] diff --git a/Language/Functions/External Interrupts/attachInterrupt.adoc b/Language/Functions/External Interrupts/attachInterrupt.adoc index d5affe4..79631e8 100644 --- a/Language/Functions/External Interrupts/attachInterrupt.adoc +++ b/Language/Functions/External Interrupts/attachInterrupt.adoc @@ -16,7 +16,7 @@ subCategories: [ "External Interrupts" ] -- [float] -=== Description +=== Descrizione *Digital Pins With Interrupts* The first parameter to attachInterrupt is an interrupt number. Normally you should use digitalPinToInterrupt(pin) to translate the actual digital pin to the specific interrupt number. For example, if you connect to pin 3, use digitalPinToInterrupt(3) as the first parameter to attachInterrupt. @@ -36,7 +36,7 @@ The first parameter to attachInterrupt is an interrupt number. Normally you shou [%hardbreaks] [float] -=== Notes and Warnings +=== Note e Avvertimenti *Note* + Inside the attached function, `delay()` won't work and the value returned by `millis()` will not increment. Serial data received while in the function may be lost. You should declare as volatile any variables that you modify within the attached function. See the section on ISRs below for more information. @@ -59,14 +59,14 @@ Typically global variables are used to pass data between an ISR and the main pro For more information on interrupts, see http://gammon.com.au/interrupts[Nick Gammon's notes]. [float] -=== Syntax +=== Sintassi `attachInterrupt(digitalPinToInterrupt(pin), ISR, mode);` (recommended) + `attachInterrupt(interrupt, ISR, mode);` (not recommended) + `attachInterrupt(pin, ISR, mode);` (not recommended Arduino Due, Zero, MKR1000, 101 only) [float] -=== Parameters +=== Parametri `interrupt`: the number of the interrupt (`int`) + `pin`: the pin number _(Arduino Due, Zero, MKR1000 only)_ + `ISR`: the ISR to call when the interrupt occurs; this function must take no parameters and return nothing. This function is sometimes referred to as an interrupt service routine. + @@ -80,7 +80,7 @@ For more information on interrupts, see http://gammon.com.au/interrupts[Nick Gam * *HIGH* to trigger the interrupt whenever the pin is high. [float] -=== Returns +=== Restituisce Nothing -- @@ -91,8 +91,8 @@ Nothing -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ [source,arduino] diff --git a/Language/Functions/External Interrupts/detachInterrupt.adoc b/Language/Functions/External Interrupts/detachInterrupt.adoc index ddd26f0..b6b8438 100644 --- a/Language/Functions/External Interrupts/detachInterrupt.adoc +++ b/Language/Functions/External Interrupts/detachInterrupt.adoc @@ -16,24 +16,24 @@ subCategories: [ "External Interrupts" ] -- [float] -=== Description +=== Descrizione Turns off the given interrupt. [%hardbreaks] [float] -=== Syntax +=== Sintassi `detachInterrupt()` + `detachInterrupt(pin)` (Arduino Due only) [float] -=== Parameters +=== Parametri `interrupt`: the number of the interrupt to disable (see link:../attachinterrupt[attachInterrupt()] for more details). `pin`: the pin number of the interrupt to disable (Arduino Due only) [float] -=== Returns +=== Restituisce Nothing -- diff --git a/Language/Functions/Interrupts/interrupts.adoc b/Language/Functions/Interrupts/interrupts.adoc index a6690d0..612bd22 100644 --- a/Language/Functions/Interrupts/interrupts.adoc +++ b/Language/Functions/Interrupts/interrupts.adoc @@ -16,22 +16,22 @@ subCategories: [ "Interrupts" ] -- [float] -=== Description +=== Descrizione Re-enables interrupts (after they've been disabled by link:../nointerrupts[nointerrupts()]. Interrupts allow certain important tasks to happen in the background and are enabled by default. Some functions will not work while interrupts are disabled, and incoming communication may be ignored. Interrupts can slightly disrupt the timing of code, however, and may be disabled for particularly critical sections of code. [%hardbreaks] [float] -=== Syntax +=== Sintassi `interrupts()` [float] -=== Parameters +=== Parametri Nothing [float] -=== Returns +=== Restituisce Nothing -- @@ -45,8 +45,8 @@ Nothing -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ The code enables Interrupts. [source,arduino] @@ -71,7 +71,7 @@ void loop() -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../../external-interrupts/attachinterrupt[attachInterrupts()] diff --git a/Language/Functions/Interrupts/noInterrupts.adoc b/Language/Functions/Interrupts/noInterrupts.adoc index 3202a9d..68e6680 100644 --- a/Language/Functions/Interrupts/noInterrupts.adoc +++ b/Language/Functions/Interrupts/noInterrupts.adoc @@ -16,22 +16,22 @@ subCategories: [ "Interrupts" ] -- [float] -=== Description +=== Descrizione Disables interrupts (you can re-enable them with `interrupts()`). Interrupts allow certain important tasks to happen in the background and are enabled by default. Some functions will not work while interrupts are disabled, and incoming communication may be ignored. Interrupts can slightly disrupt the timing of code, however, and may be disabled for particularly critical sections of code. [%hardbreaks] [float] -=== Syntax +=== Sintassi `noInterrupts()` [float] -=== Parameters +=== Parametri Nothing [float] -=== Returns +=== Restituisce Nothing -- @@ -45,8 +45,8 @@ Nothing -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ The code shows how to enable interrupts. [source,arduino] diff --git a/Language/Functions/Math/abs.adoc b/Language/Functions/Math/abs.adoc index 6029437..e3d90b9 100644 --- a/Language/Functions/Math/abs.adoc +++ b/Language/Functions/Math/abs.adoc @@ -16,21 +16,21 @@ subCategories: [ "Math" ] -- [float] -=== Description +=== Descrizione Calculates the absolute value of a number. [%hardbreaks] [float] -=== Syntax +=== Sintassi `abs(x)` [float] -=== Parameters +=== Parametri `x`: the number [float] -=== Returns +=== Restituisce `x`: if x is greater than or equal to 0. `-x`: if x is less than 0. @@ -47,7 +47,7 @@ Calculates the absolute value of a number. [float] -=== Notes and Warnings +=== Note e Avvertimenti Because of the way the abs() function is implemented, avoid using other functions inside the brackets, it may lead to incorrect results. [source,arduino] ---- diff --git a/Language/Functions/Math/constrain.adoc b/Language/Functions/Math/constrain.adoc index 8e369f2..560e7f6 100644 --- a/Language/Functions/Math/constrain.adoc +++ b/Language/Functions/Math/constrain.adoc @@ -16,24 +16,24 @@ subCategories: [ "Math" ] -- [float] -=== Description +=== Descrizione Constrains a number to be within a range. [%hardbreaks] [float] -=== Syntax +=== Sintassi `constrain(x, a, b)` [float] -=== Parameters +=== Parametri `x`: the number to constrain, all data types `a`: the lower end of the range, all data types `b`: the upper end of the range, all data types [float] -=== Returns +=== Restituisce x: if x is between a and b a: if x is less than a @@ -51,8 +51,8 @@ b: if x is greater than b -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ The code limits the sensor values to between 10 to 150. [source,arduino] diff --git a/Language/Functions/Math/map.adoc b/Language/Functions/Math/map.adoc index a23b929..1c86ddc 100644 --- a/Language/Functions/Math/map.adoc +++ b/Language/Functions/Math/map.adoc @@ -16,7 +16,7 @@ subCategories: [ "Math" ] -- [float] -=== Description +=== Descrizione Re-maps a number from one range to another. That is, a value of *fromLow* would get mapped to *toLow*, a value of *fromHigh* to *toHigh*, values in-between to values in-between, etc. Does not constrain values to within the range, because out-of-range values are sometimes intended and useful. The `constrain()` function may be used either before or after this function, if limits to the ranges are desired. @@ -36,12 +36,12 @@ The `map()` function uses integer math so will not generate fractions, when the [float] -=== Syntax +=== Sintassi [float] -=== Parameters +=== Parametri `value`: the number to map `fromLow`: the lower bound of the value's current range @@ -53,7 +53,7 @@ The `map()` function uses integer math so will not generate fractions, when the `toHigh`: the upper bound of the value's target range [float] -=== Returns +=== Restituisce The mapped value. -- @@ -67,8 +67,8 @@ The mapped value. -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ [source,arduino] diff --git a/Language/Functions/Math/max.adoc b/Language/Functions/Math/max.adoc index 56280fd..1d303f7 100644 --- a/Language/Functions/Math/max.adoc +++ b/Language/Functions/Math/max.adoc @@ -16,23 +16,23 @@ subCategories: [ "Math" ] -- [float] -=== Description +=== Descrizione Calculates the maximum of two numbers. [%hardbreaks] [float] -=== Syntax +=== Sintassi `max(x, y)` [float] -=== Parameters +=== Parametri `x`: the first number, any data type `y`: the second number, any data type [float] -=== Returns +=== Restituisce The larger of the two parameter values. -- @@ -46,8 +46,8 @@ The larger of the two parameter values. -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ The code ensures that sensVal is at least 20. [source,arduino] @@ -58,7 +58,7 @@ sensVal = max(senVal, 20); // assigns sensVal to the larger of sensVal or 20 [%hardbreaks] [float] -=== Notes and Warnings +=== Note e Avvertimenti Perhaps counter-intuitively, `max()` is often used to constrain the lower end of a variable's range, while `min()` is used to constrain the upper end of the range. Because of the way the `max()` function is implemented, avoid using other functions inside the brackets, it may lead to incorrect results diff --git a/Language/Functions/Math/min.adoc b/Language/Functions/Math/min.adoc index 76acf15..8b0ea1e 100644 --- a/Language/Functions/Math/min.adoc +++ b/Language/Functions/Math/min.adoc @@ -16,24 +16,24 @@ subCategories: [ "Math" ] -- [float] -=== Description +=== Descrizione Calculates the minimum of two numbers. [%hardbreaks] [float] -=== Syntax +=== Sintassi `min(x, y)` [float] -=== Parameters +=== Parametri `x`: the first number, any data type `y`: the second number, any data type [float] -=== Returns +=== Restituisce The smaller of the two numbers. -- @@ -47,8 +47,8 @@ The smaller of the two numbers. -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ The code ensures that it never gets above 100. [source,arduino] @@ -59,7 +59,7 @@ sensVal = min(sensVal, 100); // assigns sensVal to the smaller of sensVal or 100 [%hardbreaks] [float] -=== Notes and Warnings +=== Note e Avvertimenti Perhaps counter-intuitively, `max()` is often used to constrain the lower end of a variable's range, while `min()` is used to constrain the upper end of the range. Because of the way the `min()` function is implemented, avoid using other functions inside the brackets, it may lead to incorrect results diff --git a/Language/Functions/Math/pow.adoc b/Language/Functions/Math/pow.adoc index bf22a9e..6e0f78f 100644 --- a/Language/Functions/Math/pow.adoc +++ b/Language/Functions/Math/pow.adoc @@ -16,24 +16,24 @@ subCategories: [ "Math" ] -- [float] -=== Description +=== Descrizione Calculates the value of a number raised to a power. `Pow()` can be used to raise a number to a fractional power. This is useful for generating exponential mapping of values or curves. [%hardbreaks] [float] -=== Syntax +=== Sintassi `pow(base, exponent)` [float] -=== Parameters +=== Parametri `base`: the number (`float`) `exponent`: the power to which the base is raised (`float`) [float] -=== Returns +=== Restituisce The result of the exponentiation. (`double`) -- @@ -45,8 +45,8 @@ The result of the exponentiation. (`double`) -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ See the (http://arduino.cc/playground/Main/Fscale[fscale]) function in the code library. -- @@ -58,7 +58,7 @@ See the (http://arduino.cc/playground/Main/Fscale[fscale]) function in the code -- [float] -=== See also +=== Vedi anche [role="definition"] * #DEFINITION# link:../../../variables/data-types/float[float] diff --git a/Language/Functions/Math/sq.adoc b/Language/Functions/Math/sq.adoc index 759fec4..63dda6b 100644 --- a/Language/Functions/Math/sq.adoc +++ b/Language/Functions/Math/sq.adoc @@ -16,22 +16,22 @@ subCategories: [ "Math" ] -- [float] -=== Description +=== Descrizione Calculates the square of a number: the number multiplied by itself. [%hardbreaks] [float] -=== Syntax +=== Sintassi `sq(x)` [float] -=== Parameters +=== Parametri `x`: the number, any data type [float] -=== Returns +=== Restituisce The square of the number. (double) -- diff --git a/Language/Functions/Math/sqrt.adoc b/Language/Functions/Math/sqrt.adoc index fbb6940..e32c761 100644 --- a/Language/Functions/Math/sqrt.adoc +++ b/Language/Functions/Math/sqrt.adoc @@ -17,21 +17,21 @@ Calculates the square root of a number. -- [float] -=== Description +=== Descrizione [%hardbreaks] [float] -=== Syntax +=== Sintassi `sqrt(x)` [float] -=== Parameters +=== Parametri `x`: the number, any data type [float] -=== Returns +=== Restituisce The number's square root. (double) -- diff --git a/Language/Functions/Random Numbers/random.adoc b/Language/Functions/Random Numbers/random.adoc index 39d7e25..0086919 100644 --- a/Language/Functions/Random Numbers/random.adoc +++ b/Language/Functions/Random Numbers/random.adoc @@ -16,25 +16,25 @@ subCategories: [ "Random Numbers" ] -- [float] -=== Description +=== Descrizione The random function generates pseudo-random numbers. [%hardbreaks] [float] -=== Syntax +=== Sintassi `random(max)` + `random(min, max)` [float] -=== Parameters +=== Parametri `min` - lower bound of the random value, inclusive (optional) `max` - upper bound of the random value, exclusive [float] -=== Returns +=== Restituisce A random number between min and max-1 (`long`) . -- @@ -48,8 +48,8 @@ A random number between min and max-1 (`long`) . -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ The code generates random numbers and displays them. [source,arduino] @@ -81,7 +81,7 @@ void loop() { [%hardbreaks] [float] -=== Notes and Warnings +=== Note e Avvertimenti If it is important for a sequence of values generated by `random()` to differ, on subsequent executions of a sketch, use `randomSeed()` to initialize the random number generator with a fairly random input, such as `analogRead()` on an unconnected pin. Conversely, it can occasionally be useful to use pseudo-random sequences that repeat exactly. This can be accomplished by calling `randomSeed()` with a fixed number, before starting the random sequence. diff --git a/Language/Functions/Random Numbers/randomSeed.adoc b/Language/Functions/Random Numbers/randomSeed.adoc index 2b3035f..99d59ae 100644 --- a/Language/Functions/Random Numbers/randomSeed.adoc +++ b/Language/Functions/Random Numbers/randomSeed.adoc @@ -16,7 +16,7 @@ subCategories: [ "Random Numbers" ] -- [float] -=== Description +=== Descrizione `randomSeed()` initializes the pseudo-random number generator, causing it to start at an arbitrary point in its random sequence. This sequence, while very long, and random, is always the same. If it is important for a sequence of values generated by `random()` to differ, on subsequent executions of a sketch, use randomSeed() to initialize the random number generator with a fairly random input, such as `analogRead()` on an unconnected pin. @@ -29,11 +29,11 @@ Conversely, it can occasionally be useful to use pseudo-random sequences that re [float] -=== Parameters +=== Parametri `seed` - pass a number to initialize the pseudo-random sequence (long). [float] -=== Returns +=== Restituisce Nothing -- @@ -47,8 +47,8 @@ Nothing -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ The code explanation required. [source,arduino] diff --git a/Language/Functions/Time/delay.adoc b/Language/Functions/Time/delay.adoc index c5eb71f..b9f406f 100644 --- a/Language/Functions/Time/delay.adoc +++ b/Language/Functions/Time/delay.adoc @@ -16,22 +16,22 @@ subCategories: [ "Time" ] -- [float] -=== Description +=== Descrizione Pauses the program for the amount of time (in milliseconds) specified as parameter. (There are 1000 milliseconds in a second.) [%hardbreaks] [float] -=== Syntax +=== Sintassi `delay(ms)` [float] -=== Parameters +=== Parametri `ms`: the number of milliseconds to pause (`unsigned long`) [float] -=== Returns +=== Restituisce Nothing -- @@ -45,8 +45,8 @@ Nothing -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ The code pauses the program for one second before toggling the output pin. [source,arduino] @@ -69,7 +69,7 @@ void loop() [%hardbreaks] [float] -=== Notes and Warnings +=== Note e Avvertimenti While it is easy to create a blinking LED with the `delay()` function, and many sketches use short delays for such tasks as switch debouncing, the use of `delay()` in a sketch has significant drawbacks. No other reading of sensors, mathematical calculations, or pin manipulation can go on during the delay function, so in effect, it brings most other activity to a halt. For alternative approaches to controlling timing see the link:../millis[millis()] function and the sketch sited below. More knowledgeable programmers usually avoid the use of `delay()` for timing of events longer than 10's of milliseconds unless the Arduino sketch is very simple. Certain things do go on while the delay() function is controlling the Atmega chip however, because the delay function does not disable interrupts. Serial communication that appears at the RX pin is recorded, PWM (link:../../analog-io/analogwrite[analogWrite]) values and pin states are maintained, and link:../../external-interrupts/attachinterrupt[interrupts] will work as they should. @@ -83,7 +83,7 @@ Certain things do go on while the delay() function is controlling the Atmega chi -- [float] -=== See also +=== Vedi anche [role="example"] * #EXAMPLE# http://arduino.cc/en/Tutorial/BlinkWithoutDelay[Blink Without Delay] diff --git a/Language/Functions/Time/delayMicroseconds.adoc b/Language/Functions/Time/delayMicroseconds.adoc index 542aaf5..eb2495d 100644 --- a/Language/Functions/Time/delayMicroseconds.adoc +++ b/Language/Functions/Time/delayMicroseconds.adoc @@ -16,7 +16,7 @@ subCategories: [ "Time" ] -- [float] -=== Description +=== Descrizione Pauses the program for the amount of time (in microseconds) specified as parameter. There are a thousand microseconds in a millisecond, and a million microseconds in a second. Currently, the largest value that will produce an accurate delay is 16383. This could change in future Arduino releases. For delays longer than a few thousand microseconds, you should use `delay()` instead. @@ -24,16 +24,16 @@ Currently, the largest value that will produce an accurate delay is 16383. This [float] -=== Syntax +=== Sintassi `delayMicroseconds(us)` [float] -=== Parameters +=== Parametri `us`: the number of microseconds to pause (`unsigned int`) [float] -=== Returns +=== Restituisce Nothing -- @@ -47,8 +47,8 @@ Nothing -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ The code configures pin number 8 to work as an output pin. It sends a train of pulses of approximately 100 microseconds period. The approximation is due to execution of the other instructions in the code. [source,arduino] @@ -71,7 +71,7 @@ void loop() [%hardbreaks] [float] -=== Notes and Warnings +=== Note e Avvertimenti This function works very accurately in the range 3 microseconds and up. We cannot assure that delayMicroseconds will perform precisely for smaller delay-times. As of Arduino 0018, delayMicroseconds() no longer disables interrupts. diff --git a/Language/Functions/Time/micros.adoc b/Language/Functions/Time/micros.adoc index 64798d8..d688402 100644 --- a/Language/Functions/Time/micros.adoc +++ b/Language/Functions/Time/micros.adoc @@ -16,22 +16,22 @@ subCategories: [ "Time" ] -- [float] -=== Description +=== Descrizione Returns the number of microseconds since the Arduino board began running the current program. This number will overflow (go back to zero), after approximately 70 minutes. On 16 MHz Arduino boards (e.g. Duemilanove and Nano), this function has a resolution of four microseconds (i.e. the value returned is always a multiple of four). On 8 MHz Arduino boards (e.g. the LilyPad), this function has a resolution of eight microseconds. [%hardbreaks] [float] -=== Syntax +=== Sintassi `time = micros()` [float] -=== Parameters +=== Parametri Nothing [float] -=== Returns +=== Restituisce Returns the number of microseconds since the Arduino board began running the current program.(unsigned long) -- @@ -45,8 +45,8 @@ Returns the number of microseconds since the Arduino board began running the cur -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ The code returns the number of microseconds since the Arduino board began. [source,arduino] @@ -67,7 +67,7 @@ void loop(){ [%hardbreaks] [float] -=== Notes and Warnings +=== Note e Avvertimenti There are 1,000 microseconds in a millisecond and 1,000,000 microseconds in a second. -- diff --git a/Language/Functions/Time/millis.adoc b/Language/Functions/Time/millis.adoc index 0c08e10..57d2c26 100644 --- a/Language/Functions/Time/millis.adoc +++ b/Language/Functions/Time/millis.adoc @@ -16,22 +16,22 @@ subCategories: [ "Time" ] -- [float] -=== Description +=== Descrizione Returns the number of milliseconds since the Arduino board began running the current program. This number will overflow (go back to zero), after approximately 50 days. [%hardbreaks] [float] -=== Syntax +=== Sintassi `time = millis()` [float] -=== Parameters +=== Parametri Nothing [float] -=== Returns +=== Restituisce Number of milliseconds since the program started (unsigned long) -- @@ -45,8 +45,8 @@ Number of milliseconds since the program started (unsigned long) -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ The code reads the milllisecond since the Arduino board began. [source,arduino] @@ -67,7 +67,7 @@ void loop(){ [%hardbreaks] [float] -=== Notes and Warnings +=== Note e Avvertimenti Please note that the return value for millis() is an unsigned long, logic errors may occur if a programmer tries to do arithmetic with smaller data types such as int's. Even signed long may encounter errors as its maximum value is half that of its unsigned counterpart. -- @@ -79,7 +79,7 @@ Please note that the return value for millis() is an unsigned long, logic errors -- [float] -=== See also +=== Vedi anche [role="example"] * #EXAMPLE# http://arduino.cc/en/Tutorial/BlinkWithoutDelay[Blink Without Delay] diff --git a/Language/Functions/Trigonometry/cos.adoc b/Language/Functions/Trigonometry/cos.adoc index 07c6e86..5342395 100644 --- a/Language/Functions/Trigonometry/cos.adoc +++ b/Language/Functions/Trigonometry/cos.adoc @@ -16,22 +16,22 @@ subCategories: [ "Trigonometry" ] -- [float] -=== Description +=== Descrizione Calculates the cosine of an angle (in radians). The result will be between -1 and 1. [%hardbreaks] [float] -=== Syntax +=== Sintassi `cos(rad)` [float] -=== Parameters +=== Parametri `rad`: The angle in Radians (float). [float] -=== Returns +=== Restituisce The cos of the angle (`double`). -- @@ -43,7 +43,7 @@ The cos of the angle (`double`). -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../../../variables/data-types/float[float] diff --git a/Language/Functions/Trigonometry/sin.adoc b/Language/Functions/Trigonometry/sin.adoc index 3d32378..d82f63e 100644 --- a/Language/Functions/Trigonometry/sin.adoc +++ b/Language/Functions/Trigonometry/sin.adoc @@ -16,22 +16,22 @@ subCategories: [ "Trigonometry" ] -- [float] -=== Description +=== Descrizione Calculates the sine of an angle (in radians). The result will be between -1 and 1. [%hardbreaks] [float] -=== Syntax +=== Sintassi `sin(rad)` [float] -=== Parameters +=== Parametri `rad`: The angle in Radians (`float`). [float] -=== Returns +=== Restituisce The sine of the angle (`double`). -- @@ -43,7 +43,7 @@ The sine of the angle (`double`). -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../../../variables/data-types/float[float] diff --git a/Language/Functions/Trigonometry/tan.adoc b/Language/Functions/Trigonometry/tan.adoc index 277db9f..00efeef 100644 --- a/Language/Functions/Trigonometry/tan.adoc +++ b/Language/Functions/Trigonometry/tan.adoc @@ -16,22 +16,22 @@ subCategories: [ "Trigonometry" ] -- [float] -=== Description +=== Descrizione Calculates the tangent of an angle (in radians). The result will be between negative infinity and infinity. [%hardbreaks] [float] -=== Syntax +=== Sintassi `tan(rad)` [float] -=== Parameters +=== Parametri `rad`: The angle in Radians (`float`). [float] -=== Returns +=== Restituisce The tangent of the angle (`double`). -- @@ -43,7 +43,7 @@ The tangent of the angle (`double`). -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../../../variables/data-types/float[float] diff --git a/Language/Functions/USB/Keyboard.adoc b/Language/Functions/USB/Keyboard.adoc index 27d1ec6..272df9d 100644 --- a/Language/Functions/USB/Keyboard.adoc +++ b/Language/Functions/USB/Keyboard.adoc @@ -15,22 +15,24 @@ subCategories: [ "USB" ] -- [float] -=== Description -The keyboard functions enable a 32u4 or SAMD micro based boards to send keystrokes to an attached computer through their micro's native USB port. +=== Descrizione +La funzione keyboard abilita una scheda basata su microcontrollore 32u4 o SAMD la possibilità di inviare delle combinazioni di tastiera ad un computer collegato attraverso la porta USB. + [%hardbreaks] -*Note: Not every possible ASCII character, particularly the non-printing ones, can be sent with the Keyboard library.* + -The library supports the use of modifier keys. Modifier keys change the behavior of another key when pressed simultaneously. link:../keyboard/keyboardmodifiers[See here] for additional information on supported keys and their use. +*Nota: non tutti i caratteri ASCII, in particolari quelli non stampabili, possono essere inviati con la libreria Keyboard* + +La libreria supporta l'utilizzo dei tasti modificatori. I tasti modificatori cambiano il comportamento di altri tasti quando vengono premiuti insieme (Es. Control, Shift). link:../keyboard/keyboardmodifiers[Guardare qui] per informazioni aggiuntive sui tasti supportati ed il loro utilizzo. -- // OVERVIEW SECTION ENDS [float] -=== Notes and Warnings -These core libraries allow the 32u4 and SAMD based boards (Leonardo, Esplora, Zero, Due and MKR Family) to appear as a native Mouse and/or Keyboard to a connected computer. +=== Note e Avvertimenti +Queste librerie permettono alle schede basate su microcontrollore 32u4 e SAMD (Leonardo, Esplora, Zero, Due e la famiglia MKR) di essere viste dal PC come una tastiera o un mouse nativo. [%hardbreaks] -*A word of caution on using the Mouse and Keyboard libraries*: if the Mouse or Keyboard library is constantly running, it will be difficult to program your board. Functions such as `Mouse.move()` and `Keyboard.print()` will move your cursor or send keystrokes to a connected computer and should only be called when you are ready to handle them. It is recommended to use a control system to turn this functionality on, like a physical switch or only responding to specific input you can control. +*Nota sull'utilizzo delle librerie Mouse e Keyboard*: se le librerie Mouse or Keyboard library sono in costante funzionamento, diventerà difficile la programmazione della scheda. Funzioni come `Mouse.move()` e `Keyboard.print()` sposteranno il cursore e manderanno caratteri al pc connesso. Raccomandiamo quindi di usarle solo quando siete pronti. Raccomandiamo di usare un sistema per l'abilitazione o la disabilitazione della funzione, come la pressione di un pulsante o l'invio di un controllo alla scheda. [%hardbreaks] -When using the Mouse or Keyboard library, it may be best to test your output first using `Serial.print()`. This way, you can be sure you know what values are being reported. Refer to the Mouse and Keyboard examples for some ways to handle this. +Durante l'utilizzo della libreriea Mouse o Keyboard, potrebbe essere meglio di veriricare il funzionamento mediante l'utilizzo di `Serial.print()`. In questo modo potrete essere sicuri di quali valori vengono inviati. Fare riferimento agli esempi di Mouse e Keyboard per capire come poterli gestire. + // FUNCTIONS SECTION STARTS @@ -40,7 +42,7 @@ When using the Mouse or Keyboard library, it may be best to test your output fir ''' [float] -=== Functions +=== Funzioni link:../keyboard/keyboardbegin[Keyboard.begin()] + link:../keyboard/keyboardend[Keyboard.end()] + link:../keyboard/keyboardpress[Keyboard.press()] + @@ -61,14 +63,14 @@ link:../keyboard/keyboardwrite[Keyboard.write()] -- [float] -=== See also +=== Vedi anche [role="example"] -* #EXAMPLE# http://www.arduino.cc/en/Tutorial/KeyboardAndMouseControl[KeyboardAndMouseControl]: Demonstrates the Mouse and Keyboard commands in one program. -* #EXAMPLE# http://www.arduino.cc/en/Tutorial/KeyboardMessage[KeyboardMessage]: Sends a text string when a button is pressed. -* #EXAMPLE# http://www.arduino.cc/en/Tutorial/KeyboardLogout[KeyboardLogout]: Logs out the current user with key commands -* #EXAMPLE# http://www.arduino.cc/en/Tutorial/KeyboardSerial[KeyboardSerial]: Reads a byte from the serial port, and sends back a keystroke. -* #EXAMPLE# http://www.arduino.cc/en/Tutorial/KeyboardReprogram[KeyboardReprogram]: opens a new window in the Arduino IDE and reprograms the board with a simple blink program +* #ESEMPIO# http://www.arduino.cc/en/Tutorial/KeyboardAndMouseControl[KeyboardAndMouseControl]: Demonstrates the Mouse and Keyboard commands in one program. +* #ESEMPIO# http://www.arduino.cc/en/Tutorial/KeyboardMessage[KeyboardMessage]: Sends a text string when a button is pressed. +* #ESEMPIO# http://www.arduino.cc/en/Tutorial/KeyboardLogout[KeyboardLogout]: Logs out the current user with key commands +* #ESEMPIO# http://www.arduino.cc/en/Tutorial/KeyboardSerial[KeyboardSerial]: Reads a byte from the serial port, and sends back a keystroke. +* #ESEMPIO# http://www.arduino.cc/en/Tutorial/KeyboardReprogram[KeyboardReprogram]: opens a new window in the Arduino IDE and reprograms the board with a simple blink program -- // SEE ALSO SECTION ENDS diff --git a/Language/Functions/USB/Keyboard/keyboardBegin.adoc b/Language/Functions/USB/Keyboard/keyboardBegin.adoc index eafd4bd..c831cfe 100644 --- a/Language/Functions/USB/Keyboard/keyboardBegin.adoc +++ b/Language/Functions/USB/Keyboard/keyboardBegin.adoc @@ -13,22 +13,22 @@ title: Keyboard.begin() -- [float] -=== Description +=== Descrizione When used with a Leonardo or Due board, `Keyboard.begin()` starts emulating a keyboard connected to a computer. To end control, use link:../keyboardend[Keyboard.end()]. [%hardbreaks] [float] -=== Syntax +=== Sintassi `Keyboard.begin()` [float] -=== Parameters +=== Parametri Nothing [float] -=== Returns +=== Restituisce Nothing // OVERVIEW SECTION ENDS @@ -41,8 +41,8 @@ Nothing -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ [source,arduino] diff --git a/Language/Functions/USB/Keyboard/keyboardEnd.adoc b/Language/Functions/USB/Keyboard/keyboardEnd.adoc index 4dc0fc7..8422a4e 100644 --- a/Language/Functions/USB/Keyboard/keyboardEnd.adoc +++ b/Language/Functions/USB/Keyboard/keyboardEnd.adoc @@ -13,22 +13,22 @@ title: Keyboard.end() -- [float] -=== Description +=== Descrizione Stops the keyboard emulation to a connected computer. To start keyboard emulation, use link:../keyboardbegin[Keyboard.begin()]. [%hardbreaks] [float] -=== Syntax +=== Sintassi `Keyboard.end()` [float] -=== Parameters +=== Parametri Nothing [float] -=== Returns +=== Restituisce Nothing -- @@ -42,8 +42,8 @@ Nothing -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ [source,arduino] diff --git a/Language/Functions/USB/Keyboard/keyboardModifiers.adoc b/Language/Functions/USB/Keyboard/keyboardModifiers.adoc index 2598e30..04b63a2 100644 --- a/Language/Functions/USB/Keyboard/keyboardModifiers.adoc +++ b/Language/Functions/USB/Keyboard/keyboardModifiers.adoc @@ -13,7 +13,7 @@ title: Keyboard Modifiers -- [float] -=== Description +=== Descrizione The `Keyboard.write()` and `Keyboard.press()` and `Keyboard.release()` commands don’t work with every possible ASCII character, only those that correspond to a key on the keyboard. For example, backspace works, but many of the other non-printable characters produce unpredictable results. For capital letters (and other keys), what’s sent is shift plus the character (i.e. the equivalent of pressing both of those keys on the keyboard). [%hardbreaks] A modifier key is a special key on a computer keyboard that modifies the normal action of another key when the two are pressed in combination. diff --git a/Language/Functions/USB/Keyboard/keyboardPress.adoc b/Language/Functions/USB/Keyboard/keyboardPress.adoc index ec22ca1..a80b167 100644 --- a/Language/Functions/USB/Keyboard/keyboardPress.adoc +++ b/Language/Functions/USB/Keyboard/keyboardPress.adoc @@ -13,7 +13,7 @@ title: Keyboard.press() -- [float] -=== Description +=== Descrizione When called, `Keyboard.press()` functions as if a key were pressed and held on your keyboard. Useful when using link:../keyboardmodifiers[modifier keys]. To end the key press, use link:../keyboardrelease[Keyboard.release()] or link:../keyboardreleaseall[Keyboard.releaseAll()]. It is necessary to call link:../keyboardbegin[Keyboard.begin()] before using `press()`. @@ -21,16 +21,16 @@ It is necessary to call link:../keyboardbegin[Keyboard.begin()] before using `pr [float] -=== Syntax +=== Sintassi `Keyboard.press()` [float] -=== Parameters +=== Parametri `char` : the key to press [float] -=== Returns +=== Restituisce `size_t` : number of key presses sent. -- @@ -44,8 +44,8 @@ It is necessary to call link:../keyboardbegin[Keyboard.begin()] before using `pr -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ [source,arduino] diff --git a/Language/Functions/USB/Keyboard/keyboardPrint.adoc b/Language/Functions/USB/Keyboard/keyboardPrint.adoc index 620f3fe..8b8e7f9 100644 --- a/Language/Functions/USB/Keyboard/keyboardPrint.adoc +++ b/Language/Functions/USB/Keyboard/keyboardPrint.adoc @@ -13,7 +13,7 @@ title: Keyboard.print() -- [float] -=== Description +=== Descrizione Sends a keystroke to a connected computer. `Keyboard.print()` must be called after initiating link:../keyboardbegin[Keyboard.begin()]. @@ -21,16 +21,16 @@ Sends a keystroke to a connected computer. [float] -=== Syntax +=== Sintassi `Keyboard.print(character)` + `Keyboard.print(characters)` [float] -=== Parameters +=== Parametri `character` : a char or int to be sent to the computer as a keystroke characters : a string to be sent to the computer as a keystroke. [float] -=== Returns +=== Restituisce `size_t` : number of bytes sent. -- @@ -44,8 +44,8 @@ Sends a keystroke to a connected computer. -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ [source,arduino] @@ -71,7 +71,7 @@ void loop() { [%hardbreaks] [float] -=== Notes and Warnings +=== Note e Avvertimenti When you use the `Keyboard.print()` command, the Arduino takes over your keyboard! Make sure you have control before you use the command. A pushbutton to toggle the keyboard control state is effective. -- diff --git a/Language/Functions/USB/Keyboard/keyboardPrintln.adoc b/Language/Functions/USB/Keyboard/keyboardPrintln.adoc index 3641bb8..9a2dc3b 100644 --- a/Language/Functions/USB/Keyboard/keyboardPrintln.adoc +++ b/Language/Functions/USB/Keyboard/keyboardPrintln.adoc @@ -13,7 +13,7 @@ title: Keyboard.println() -- [float] -=== Description +=== Descrizione Sends a keystroke to a connected computer, followed by a newline and carriage return. `Keyboard.println()` must be called after initiating link:../keyboardbegin[Keyboard.begin()]. @@ -21,19 +21,19 @@ Sends a keystroke to a connected computer, followed by a newline and carriage re [float] -=== Syntax +=== Sintassi `Keyboard.println()` + `Keyboard.println(character)`+ `Keyboard.println(characters)` [float] -=== Parameters +=== Parametri `character` : a char or int to be sent to the computer as a keystroke, followed by newline and carriage return. `characters` : a string to be sent to the computer as a keystroke, followed by a newline and carriage return. [float] -=== Returns +=== Restituisce `size_t` : number of bytes sent -- @@ -45,8 +45,8 @@ Sends a keystroke to a connected computer, followed by a newline and carriage re -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ [source,arduino] @@ -72,7 +72,7 @@ void loop() { [%hardbreaks] [float] -=== Notes and Warnings +=== Note e Avvertimenti When you use the Keyboard.println() command, the Arduino takes over your keyboard! Make sure you have control before you use the command. A pushbutton to toggle the keyboard control state is effective. -- diff --git a/Language/Functions/USB/Keyboard/keyboardRelease.adoc b/Language/Functions/USB/Keyboard/keyboardRelease.adoc index 0769ec3..a2d265f 100644 --- a/Language/Functions/USB/Keyboard/keyboardRelease.adoc +++ b/Language/Functions/USB/Keyboard/keyboardRelease.adoc @@ -13,22 +13,22 @@ title: Keyboard.release() -- [float] -=== Description +=== Descrizione Lets go of the specified key. See link:../keyboardpress[Keyboard.press()] for more information. [%hardbreaks] [float] -=== Syntax +=== Sintassi `Keyboard.release(key)` [float] -=== Parameters +=== Parametri `key` : the key to release. `char` [float] -=== Returns +=== Restituisce `size_t` : the number of keys released -- @@ -42,8 +42,8 @@ Lets go of the specified key. See link:../keyboardpress[Keyboard.press()] for mo -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ [source,arduino] diff --git a/Language/Functions/USB/Keyboard/keyboardReleaseAll.adoc b/Language/Functions/USB/Keyboard/keyboardReleaseAll.adoc index ce826c4..de58fb9 100644 --- a/Language/Functions/USB/Keyboard/keyboardReleaseAll.adoc +++ b/Language/Functions/USB/Keyboard/keyboardReleaseAll.adoc @@ -13,22 +13,22 @@ title: Keyboard.releaseAll() -- [float] -=== Description +=== Descrizione Lets go of all keys currently pressed. See link:../keyboardpress[Keyboard.press()] for additional information. [%hardbreaks] [float] -=== Syntax +=== Sintassi `Keyboard.releaseAll()` [float] -=== Parameters +=== Parametri Nothing [float] -=== Returns +=== Restituisce Nothing -- @@ -41,8 +41,8 @@ Nothing -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ [source,arduino] diff --git a/Language/Functions/USB/Keyboard/keyboardWrite.adoc b/Language/Functions/USB/Keyboard/keyboardWrite.adoc index daa38e6..d57e038 100644 --- a/Language/Functions/USB/Keyboard/keyboardWrite.adoc +++ b/Language/Functions/USB/Keyboard/keyboardWrite.adoc @@ -13,7 +13,7 @@ title: Keyboard.write() -- [float] -=== Description +=== Descrizione Sends a keystroke to a connected computer. This is similar to pressing and releasing a key on your keyboard. You can send some ASCII characters or the additional link:../keyboardmodifiers[keyboard modifiers and special keys]. Only ASCII characters that are on the keyboard are supported. For example, ASCII 8 (backspace) would work, but ASCII 25 (Substitution) would not. When sending capital letters, Keyboard.write() sends a shift command plus the desired character, just as if typing on a keyboard. If sending a numeric type, it sends it as an ASCII character (ex. Keyboard.write(97) will send 'a'). @@ -23,12 +23,12 @@ For a complete list of ASCII characters, see http://www.asciitable.com/[ASCIITab [float] -=== Syntax +=== Sintassi `Keyboard.write(character)` [float] -=== Parameters +=== Parametri `character` : a char or int to be sent to the computer. Can be sent in any notation that's acceptable for a char. For example, all of the below are acceptable and send the same value, 65 or ASCII A: [source,arduino] ---- @@ -39,7 +39,7 @@ Keyboard.write(0b01000001); // same thing in binary (weird choice, but it works) ---- [float] -=== Returns +=== Restituisce `size_t` : number of bytes sent. -- @@ -53,8 +53,8 @@ Keyboard.write(0b01000001); // same thing in binary (weird choice, but it works) -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ [source,arduino] @@ -80,7 +80,7 @@ void loop() { [%hardbreaks] [float] -=== Notes and Warnings +=== Note e Avvertimenti When you use the Keyboard.write() command, the Arduino takes over your keyboard! Make sure you have control before you use the command. A pushbutton to toggle the keyboard control state is effective. -- diff --git a/Language/Functions/USB/Mouse.adoc b/Language/Functions/USB/Mouse.adoc index b2e4603..fa3dd50 100644 --- a/Language/Functions/USB/Mouse.adoc +++ b/Language/Functions/USB/Mouse.adoc @@ -17,7 +17,7 @@ subCategories: [ "USB" ] -- [float] -=== Description +=== Descrizione The mouse functions enable a 32u4 or SAMD micro based boards to to control cursor movement on a connected computer through their micro's native USB port. When updating the cursor position, it is always relative to the cursor's previous location. [%hardbreaks] -- @@ -25,7 +25,7 @@ The mouse functions enable a 32u4 or SAMD micro based boards to to control curso [float] -=== Notes and Warnings +=== Note e Avvertimenti These core libraries allow the 32u4 and SAMD based boards (Leonardo, Esplora, Zero, Due and MKR Family) to appear as a native Mouse and/or Keyboard to a connected computer. [%hardbreaks] *A word of caution on using the Mouse and Keyboard libraries*: if the Mouse or Keyboard library is constantly running, it will be difficult to program your board. Functions such as `Mouse.move()` and `Keyboard.print()` will move your cursor or send keystrokes to a connected computer and should only be called when you are ready to handle them. It is recommended to use a control system to turn this functionality on, like a physical switch or only responding to specific input you can control. @@ -59,7 +59,7 @@ link:../mouse/mouseispressed[Mouse.isPressed()] -- [float] -=== See also +=== Vedi anche [role="example"] * #EXAMPLE# http://www.arduino.cc/en/Tutorial/KeyboardAndMouseControl[KeyboardAndMouseControl]: Demonstrates the Mouse and Keyboard commands in one program. diff --git a/Language/Functions/USB/Mouse/mouseBegin.adoc b/Language/Functions/USB/Mouse/mouseBegin.adoc index f4820aa..97d83f9 100644 --- a/Language/Functions/USB/Mouse/mouseBegin.adoc +++ b/Language/Functions/USB/Mouse/mouseBegin.adoc @@ -14,22 +14,22 @@ title: Mouse.begin() -- [float] -=== Description +=== Descrizione Begins emulating the mouse connected to a computer. `begin()` must be called before controlling the computer. To end control, use link:../mouseend[Mouse.end()]. [%hardbreaks] [float] -=== Syntax +=== Sintassi `Mouse.begin()` [float] -=== Parameters +=== Parametri Nothing [float] -=== Returns +=== Restituisce Nothing -- @@ -43,8 +43,8 @@ Nothing -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ [source,arduino] @@ -74,7 +74,7 @@ void loop(){ -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../mouseclick[Mouse.click()] diff --git a/Language/Functions/USB/Mouse/mouseClick.adoc b/Language/Functions/USB/Mouse/mouseClick.adoc index f54a532..70ffe0f 100644 --- a/Language/Functions/USB/Mouse/mouseClick.adoc +++ b/Language/Functions/USB/Mouse/mouseClick.adoc @@ -13,7 +13,7 @@ title: Mouse.click() -- [float] -=== Description +=== Descrizione Sends a momentary click to the computer at the location of the cursor. This is the same as pressing and immediately releasing the mouse button. `Mouse.click()` defaults to the left mouse button. @@ -21,13 +21,13 @@ Sends a momentary click to the computer at the location of the cursor. This is t [float] -=== Syntax +=== Sintassi `Mouse.click();` + `Mouse.click(button);` [float] -=== Parameters +=== Parametri `button`: which mouse button to press - `char` * `MOUSE_LEFT` (default) @@ -35,7 +35,7 @@ Sends a momentary click to the computer at the location of the cursor. This is t * `MOUSE_MIDDLE` [float] -=== Returns +=== Restituisce Nothing -- @@ -49,8 +49,8 @@ Nothing -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ [source,arduino] @@ -73,7 +73,7 @@ void loop(){ [%hardbreaks] [float] -=== Notes and Warnings +=== Note e Avvertimenti When you use the `Mouse.click()` command, the Arduino takes over your mouse! Make sure you have control before you use the command. A pushbutton to toggle the mouse control state is effective. -- @@ -85,7 +85,7 @@ When you use the `Mouse.click()` command, the Arduino takes over your mouse! Mak -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../mouseend[Mouse.end()] diff --git a/Language/Functions/USB/Mouse/mouseEnd.adoc b/Language/Functions/USB/Mouse/mouseEnd.adoc index b9514d6..997bc2b 100644 --- a/Language/Functions/USB/Mouse/mouseEnd.adoc +++ b/Language/Functions/USB/Mouse/mouseEnd.adoc @@ -13,22 +13,22 @@ title: Mouse.end() -- [float] -=== Description +=== Descrizione Stops emulating the mouse connected to a computer. To start control, use link:../mousebegin[Mouse.begin()]. [%hardbreaks] [float] -=== Syntax +=== Sintassi `Mouse.end()` [float] -=== Parameters +=== Parametri Nothing [float] -=== Returns +=== Restituisce Nothing -- @@ -42,8 +42,8 @@ Nothing -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ [source,arduino] @@ -76,7 +76,7 @@ void loop(){ -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../mouseclick[Mouse.click()] diff --git a/Language/Functions/USB/Mouse/mouseIsPressed.adoc b/Language/Functions/USB/Mouse/mouseIsPressed.adoc index b26bc0b..c1924e9 100644 --- a/Language/Functions/USB/Mouse/mouseIsPressed.adoc +++ b/Language/Functions/USB/Mouse/mouseIsPressed.adoc @@ -13,18 +13,18 @@ title: Mouse.isPressed() -- [float] -=== Description +=== Descrizione Checks the current status of all mouse buttons, and reports if any are pressed or not. [%hardbreaks] [float] -=== Syntax +=== Sintassi `Mouse.isPressed();` + `Mouse.isPressed(button);` [float] -=== Parameters +=== Parametri When there is no value passed, it checks the status of the left mouse button. `button`: which mouse button to check - `char` @@ -36,7 +36,7 @@ When there is no value passed, it checks the status of the left mouse button. * `MOUSE_MIDDLE` [float] -=== Returns +=== Restituisce `boolean` : reports whether a button is pressed or not. -- @@ -50,8 +50,8 @@ When there is no value passed, it checks the status of the left mouse button. -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ [source,arduino] @@ -97,7 +97,7 @@ void loop(){ -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../mouseclick[Mouse.click()] diff --git a/Language/Functions/USB/Mouse/mouseMove.adoc b/Language/Functions/USB/Mouse/mouseMove.adoc index 461caa1..5f7192a 100644 --- a/Language/Functions/USB/Mouse/mouseMove.adoc +++ b/Language/Functions/USB/Mouse/mouseMove.adoc @@ -13,25 +13,25 @@ title: Mouse.move() -- [float] -=== Description +=== Descrizione Moves the cursor on a connected computer. The motion onscreen is always relative to the cursor's current location. Before using `Mouse.move()` you must call link:../mousebegin[Mouse.begin()] [%hardbreaks] [float] -=== Syntax +=== Sintassi `Mouse.move(xVal, yPos, wheel);` [float] -=== Parameters +=== Parametri `xVal`: amount to move along the x-axis - `signed char` `yVal`: amount to move along the y-axis - `signed char` `wheel`: amount to move scroll wheel - `signed char` [float] -=== Returns +=== Restituisce Nothing -- @@ -45,8 +45,8 @@ Nothing -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ [source,arduino] @@ -126,7 +126,7 @@ int readAxis(int axisNumber) { [%hardbreaks] [float] -=== Notes and Warnings +=== Note e Avvertimenti When you use the `Mouse.move()` command, the Arduino takes over your mouse! Make sure you have control before you use the command. A pushbutton to toggle the mouse control state is effective. -- @@ -138,7 +138,7 @@ When you use the `Mouse.move()` command, the Arduino takes over your mouse! Make -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../mouseclick[Mouse.click()] diff --git a/Language/Functions/USB/Mouse/mousePress.adoc b/Language/Functions/USB/Mouse/mousePress.adoc index a4738ec..fb0456c 100644 --- a/Language/Functions/USB/Mouse/mousePress.adoc +++ b/Language/Functions/USB/Mouse/mousePress.adoc @@ -13,7 +13,7 @@ title: Mouse.press() -- [float] -=== Description +=== Descrizione Sends a button press to a connected computer. A press is the equivalent of clicking and continuously holding the mouse button. A press is cancelled with link:../mouserelease[Mouse.release()]. Before using `Mouse.press()`, you need to start communication with link:../mousebegin[Mouse.begin()]. @@ -23,13 +23,13 @@ Before using `Mouse.press()`, you need to start communication with link:../mouse [float] -=== Syntax +=== Sintassi `Mouse.press();` + `Mouse.press(button)` [float] -=== Parameters +=== Parametri `button`: which mouse button to press - `char` * `MOUSE_LEFT (default)` @@ -39,7 +39,7 @@ Before using `Mouse.press()`, you need to start communication with link:../mouse * `MOUSE_MIDDLE` [float] -=== Returns +=== Restituisce Nothing -- @@ -53,8 +53,8 @@ Nothing -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ [source,arduino] @@ -84,7 +84,7 @@ void loop(){ [%hardbreaks] [float] -=== Notes and Warnings +=== Note e Avvertimenti When you use the `Mouse.press()` command, the Arduino takes over your mouse! Make sure you have control before you use the command. A pushbutton to toggle the mouse control state is effective. -- @@ -96,7 +96,7 @@ When you use the `Mouse.press()` command, the Arduino takes over your mouse! Mak -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../mouseclick[Mouse.click()] diff --git a/Language/Functions/USB/Mouse/mouseRelease.adoc b/Language/Functions/USB/Mouse/mouseRelease.adoc index a92b9fa..e112b54 100644 --- a/Language/Functions/USB/Mouse/mouseRelease.adoc +++ b/Language/Functions/USB/Mouse/mouseRelease.adoc @@ -13,18 +13,18 @@ title: Mouse.release() -- [float] -=== Description +=== Descrizione Sends a message that a previously pressed button (invoked through link:../mousepress[Mouse.press()]) is released. Mouse.release() defaults to the left button. [%hardbreaks] [float] -=== Syntax +=== Sintassi `Mouse.release();` + `Mouse.release(button);` [float] -=== Parameters +=== Parametri `button`: which mouse button to press - char * `MOUSE_LEFT` (default) @@ -34,7 +34,7 @@ Sends a message that a previously pressed button (invoked through link:../mousep * `MOUSE_MIDDLE` [float] -=== Returns +=== Restituisce Nothing -- @@ -48,8 +48,8 @@ Nothing -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ [source,arduino] @@ -79,7 +79,7 @@ void loop(){ [%hardbreaks] [float] -=== Notes and Warnings +=== Note e Avvertimenti When you use the `Mouse.release()` command, the Arduino takes over your mouse! Make sure you have control before you use the command. A pushbutton to toggle the mouse control state is effective. -- @@ -91,7 +91,7 @@ When you use the `Mouse.release()` command, the Arduino takes over your mouse! M -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../mouseclick[Mouse.click()] diff --git a/Language/Functions/Zero, Due, MKR Family/analogReadResolution.adoc b/Language/Functions/Zero, Due, MKR Family/analogReadResolution.adoc index fbf41db..9170f6d 100644 --- a/Language/Functions/Zero, Due, MKR Family/analogReadResolution.adoc +++ b/Language/Functions/Zero, Due, MKR Family/analogReadResolution.adoc @@ -15,7 +15,7 @@ subCategories: [ "Zero, Due & MKR Family" ] -- [float] -=== Description +=== Descrizione analogReadResolution() is an extension of the Analog API for the Arduino Due, Zero and MKR Family. Sets the size (in bits) of the value returned by `analogRead()`. It defaults to 10 bits (returns values between 0-1023) for backward compatibility with AVR based boards. @@ -25,16 +25,16 @@ The *Due, Zero and MKR Family* boards have 12-bit ADC capabilities that can be a [float] -=== Syntax +=== Sintassi `analogReadResolution(bits)` [float] -=== Parameters +=== Parametri `bits`: determines the resolution (in bits) of the value returned by the `analogRead()` function. You can set this between 1 and 32. You can set resolutions higher than 12 but values returned by `analogRead()` will suffer approximation. See the note below for details. [float] -=== Returns +=== Restituisce Nothing -- @@ -48,8 +48,8 @@ Nothing -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ The code shows how to use ADC with different resolutions. [source,arduino] @@ -88,7 +88,7 @@ void loop() { [%hardbreaks] [float] -=== Notes and Warnings +=== Note e Avvertimenti If you set the `analogReadResolution()` value to a value higher than your board's capabilities, the Arduino will only report back at its highest resolution, padding the extra bits with zeros. For example: using the Due with `analogReadResolution(16)` will give you an approximated 16-bit number with the first 12 bits containing the real ADC reading and the last 4 bits *padded with zeros*. @@ -106,7 +106,7 @@ Using a 16 bit resolution (or any resolution *higher* than actual hardware capab -- [float] -=== See also +=== Vedi anche [role="example"] * #EXAMPLE# http://arduino.cc/en/Tutorial/AnalogInputPins[Description of the analog input pins] diff --git a/Language/Functions/Zero, Due, MKR Family/analogWriteResolution.adoc b/Language/Functions/Zero, Due, MKR Family/analogWriteResolution.adoc index 7c6b3e5..43c803a 100644 --- a/Language/Functions/Zero, Due, MKR Family/analogWriteResolution.adoc +++ b/Language/Functions/Zero, Due, MKR Family/analogWriteResolution.adoc @@ -15,7 +15,7 @@ subCategories: [ "Zero, Due & MKR Family" ] -- [float] -=== Description +=== Descrizione `analogWriteResolution()` is an extension of the Analog API for the Arduino Due. `analogWriteResolution()` sets the resolution of the `analogWrite()` function. It defaults to 8 bits (values between 0-255) for backward compatibility with AVR based boards. @@ -46,16 +46,16 @@ By setting the write resolution to 12 bits, you can use `analogWrite()` with val [float] -=== Syntax +=== Sintassi `analogWriteResolution(bits)` [float] -=== Parameters +=== Parametri `bits`: determines the resolution (in bits) of the values used in the `analogWrite()` function. The value can range from 1 to 32. If you choose a resolution higher or lower than your board's hardware capabilities, the value used in `analogWrite()` will be either truncated if it's too high or padded with zeros if it's too low. See the note below for details. [float] -=== Returns +=== Restituisce Nothing -- @@ -69,8 +69,8 @@ Nothing -- [float] -=== Example Code -// Describe what the example code is all about and add relevant code ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ +=== Codice di Esempio +// Descrivi di quale argomento tratta il codice di esempio e aggiungi il codice relativo ►►►►► THIS SECTION IS MANDATORY ◄◄◄◄◄ Explain Code [source,arduino] @@ -117,7 +117,7 @@ void loop(){ [%hardbreaks] [float] -=== Notes and Warnings +=== Note e Avvertimenti If you set the `analogWriteResolution()` value to a value higher than your board's capabilities, the Arduino will discard the extra bits. For example: using the Due with `analogWriteResolution(16)` on a 12-bit DAC pin, only the first 12 bits of the values passed to `analogWrite()` will be used and the last 4 bits will be discarded. If you set the `analogWriteResolution()` value to a value lower than your board's capabilities, the missing bits will be *padded with zeros* to fill the hardware required size. For example: using the Due with analogWriteResolution(8) on a 12-bit DAC pin, the Arduino will add 4 zero bits to the 8-bit value used in `analogWrite()` to obtain the 12 bits required. @@ -131,7 +131,7 @@ If you set the `analogWriteResolution()` value to a value lower than your board' -- [float] -=== See also +=== Vedi anche [role="language"] * #LANGUAGE# link:../../analog-io/analogwrite[analogWrite()] diff --git a/Language/Variables/Constants/constants.adoc b/Language/Variables/Constants/constants.adoc index dd43ad3..a7761aa 100644 --- a/Language/Variables/Constants/constants.adoc +++ b/Language/Variables/Constants/constants.adoc @@ -1,13 +1,10 @@ --- -title: constants -categories: [ "Variables" ] +title: costanti +categories: [ "Variabili" ] subCategories: [ "Constants" ] --- - - - = Constants @@ -16,99 +13,108 @@ subCategories: [ "Constants" ] -- [float] -== Description -Constants are predefined expressions in the Arduino language. They are used to make the programs easier to read. We classify constants in groups: +== Descrizione +Le constanti in Arduino sono espressioni predefinite. Vengono usate per permettere una lettura più agile del codice. Vengono classificate in gruppi: [float] -== Defining Logical Levels: true and false (Boolean Constants) -There are two constants used to represent truth and falsity in the Arduino language: `true`, and `false`. +== Definizione dei livelli logici: true e false (Costanti Booleane) +Ci sono due costanti utilizzate per rappresentare Vero e Falso nel linguaggio Arduino: `true`, e `false`. [float] === false -`false` is the easier of the two to define. false is defined as 0 (zero). +`false` è il modo migliore delle due opzioni per la definizione. false è definitno come 0 (zero) . [%hardbreaks] [float] === true -`true` is often said to be defined as 1, which is correct, but true has a wider definition. Any integer which is non-zero is true, in a Boolean sense. So -1, 2 and -200 are all defined as true, too, in a Boolean sense. +`true` è spesso e correttamente definito come 1, ma true ha una definizione più ampia. Qualsiasi intero che non è zero (0) è `true` (vero) in ambito booleano. quindi -1, 2 e -200 sono tutti dichiarabili come `true` (vero). [%hardbreaks] -Note that the `true` and `false` constants are typed in lowercase unlike `HIGH`, `LOW`, `INPUT`, and `OUTPUT`. +Notare che le costanti `true` and `false` sono scritte in minuscolo, non come `HIGH`, `LOW`, `INPUT`, e `OUTPUT`. [%hardbreaks] [float] -== Defining Pin Levels: HIGH and LOW -When reading or writing to a digital pin there are only two possible values a pin can take/be-set-to: `HIGH` and `LOW`. +== Definizione dei livelli dei Pin: HIGH e LOW +Quando bisogna leggere o scrivere un pin digitale ci sono solo due valori possibili che un pin può assumere : `HIGH` e `LOW`. [float] === HIGH -The meaning of `HIGH` (in reference to a pin) is somewhat different depending on whether a pin is set to an `INPUT` or `OUTPUT`. When a pin is configured as an `INPUT` with link:../../../functions/digital-io/pinmode[pinMode()], and read with link:../../../functions/digital-io/digitalread[digitalRead()], the Arduino (ATmega) will report `HIGH` if: +Il significato di `HIGH` (riferito ad un pin) è in qualche modo differente se il pin è impostato come `INPUT` o `OUTPUT`. quando il pin è impostato come `INPUT` link:../../../functions/digital-io/pinmode[pinMode()], e read with link:../../../functions/digital-io/digitalread[digitalRead()], Arduino (ATmega) riporterà `HIGH` se: - - a voltage greater than 3.0V is present at the pin (5V boards) - - a voltage greater than 2.0V volts is present at the pin (3.3V boards) + - la tensione presente nel pin è maggiore di 3.0V (su una scheda che funziona a 5 Volt ) + - la tensione presente nel pin è maggiore di 2.0V (su una scheda che funziona a 3.3 Volt ) [%hardbreaks] -A pin may also be configured as an INPUT with `pinMode()`, and subsequently made HIGH with link:../../../functions/digital-io/digitalwrite[digitalWrite()]. This will enable the internal 20K pullup resistors, which will _pull up_ the input pin to a `HIGH` reading unless it is pulled `LOW` by external circuitry. This is how `INPUT_PULLUP` works and is described below in more detail. +Un pin può essere impostato come un INPUT usando `pinMode()`, e successivamente impostato come HIGH usando link:../../../functions/digital-io/digitalwrite[digitalWrite()]. Questo comando abilita la resistenza di pullup da 20K, che rimarrà dale fino a quando non verrà impostata nuovamente su `LOW` da un circuito esterno. Questo è come `INPUT_PULLUP` funziona, ed è descritto di seguito in dettaglio. + [%hardbreaks] -When a pin is configured to OUTPUT with `pinMode()`, and set to `HIGH` with `digitalWrite()`, the pin is at: +Quando un pin è configurato come OUTPUT usando `pinMode()`, e impostato a `HIGH` usando `digitalWrite()`, il pin risulta essere: + + - 5 volts (su schede a 5V ) + - 3.3 volts (su schede a 3.3V) - - 5 volts (5V boards) - - 3.3 volts (3.3V boards) +In questo stato può fornire corrente, per esempio accendere un LED connesso ad una serie di resistenze verso terra (ground). -In this state it can source current, e.g. light an LED that is connected through a series resistor to ground. [%hardbreaks] [float] === LOW -The meaning of `LOW` also has a different meaning depending on whether a pin is set to `INPUT` or `OUTPUT`. When a pin is configured as an `INPUT` with `pinMode()`, and read with `digitalRead()`, the Arduino (ATmega) will report LOW if: +La definizione di `LOW` ha un significato differente a seconda se un pin è impostato su `INPUT` o `OUTPUT`. Quando un pin è impostato come `INPUT` usando `pinMode()`, e letto con `digitalRead()`, Arduino (ATmega) risulterà LOW se: + - sul pin c'è una tensione minore di 1.5V (su schede a 5V) + - sul pin c'è una tensione minore di approssimativamente 1.0V (su schede a 3.3V) - - a voltage less than 1.5V is present at the pin (5V boards) - - a voltage less than 1.0V (Approx) is present at the pin (3.3V boards) When a pin is configured to `OUTPUT` with `pinMode()`, and set to `LOW` with `digitalWrite()`, the pin is at 0 volts (both 5V and 3.3V boards). In this state it can sink current, e.g. light an LED that is connected through a series resistor to +5 volts (or +3.3 volts). [%hardbreaks] [float] -== Defining Digital Pins modes: INPUT, INPUT_PULLUP, and OUTPUT -Digital pins can be used as `INPUT`, `INPUT_PULLUP`, or `OUTPUT`. Changing a pin with `pinMode()` changes the electrical behavior of the pin. +== Definizione di Pin mode digitali: INPUT, INPUT_PULLUP, and OUTPUT +I pin digitali possono essere usati come `INPUT`, `INPUT_PULLUP`, or `OUTPUT`. Cambiando i pin usando `pinMode()` viene cambiato il comportamento elettrico. [float] -=== Pins Configured as INPUT -Arduino (ATmega) pins configured as `INPUT` with `pinMode()` are said to be in a _high-impedance_ state. Pins configured as `INPUT` make extremely small demands on the circuit that they are sampling, equivalent to a series resistor of 100 Megohms in front of the pin. This makes them useful for reading a sensor. +=== Pin configurati come INPUT +I pin delle schede Arduino basate su ATMEGA, configurate come `INPUT` usando `pinMode()`, sono in uno stato di _alta impedenza_. I Pin configurati come `INPUT` hanno pochissime necessità dal circuito che stanno campionando, equivalente ad una serie di resistenze da 100 Megohms davanti al pin. Questa condizione risulta utile quando bisogna leggere un sensore. + [%hardbreaks] -If you have your pin configured as an `INPUT`, and are reading a switch, when the switch is in the open state the input pin will be "floating", resulting in unpredictable results. In order to assure a proper reading when the switch is open, a pull-up or pull-down resistor must be used. The purpose of this resistor is to pull the pin to a known state when the switch is open. A 10 K ohm resistor is usually chosen, as it is a low enough value to reliably prevent a floating input, and at the same time a high enough value to not not draw too much current when the switch is closed. See the http://arduino.cc/en/Tutorial/DigitalReadSerial[Digital Read Serial^] tutorial for more information. + +Se il pin configurato come un `INPUT`, e si sta leggendo un interruttore, quando lo switch è nello stato aperto il pin di input sarà "fluttuante", con risultati imprevedibili. Per garantire una lettura corretta quando l'interruttore è aperto, è necessario utilizzare una resistenza di pull-up o pull-down. Lo scopo di questo resistore è portare il pin in uno stato noto quando l'interruttore è aperto. Di solito viene scelta una resistenza da 10 K ohm, in quanto è un valore abbastanza basso da impedire in modo affidabile un ingresso flottante e allo stesso tempo un valore abbastanza alto da non assorbire troppa corrente quando l'interruttore è chiuso. Leggi il tutorial http://arduino.cc/en/Tutorial/DigitalReadSerial[Digital Read Serial^] per maggiori infomazioni. [%hardbreaks] -If a pull-down resistor is used, the input pin will be `LOW` when the switch is open and `HIGH` when the switch is closed. + +Se viene utilizzata una resistenza pull-down, il pin di ingresso sarà `LOW` quando l'interruttore è aperto e `HIGH` quando l'interruttore è chiuso. [%hardbreaks] -If a pull-up resistor is used, the input pin will be `HIGH` when the switch is open and `LOW` when the switch is closed. +Se viene utilizzata una resistenza di pull-up, il pin di ingresso sarà `HIGH` quando l'interruttore è aperto e `LOW` quando l'interruttore è chiuso. [%hardbreaks] + [float] -=== Pins Configured as INPUT_PULLUP -The ATmega microcontroller on the Arduino has internal pull-up resistors (resistors that connect to power internally) that you can access. If you prefer to use these instead of external pull-up resistors, you can use the `INPUT_PULLUP` argument in `pinMode()`. + + +=== Pin configurati come INPUT_PULLUP +Il microcontrollore ATmega su Arduino ha resistenze interne di pull-up (resistenze che si collegano internamente all'alimentazione ) a cui si può accedere. Se si preferisce usarli al posto di resistenze di pull-up esterne, si può l'argomento `INPUT_PULLUP` in `pinMode()`. [%hardbreaks] -See the http://arduino.cc/en/Tutorial/InputPullupSerial[Input Pullup Serial^] tutorial for an example of this in use. +Guarda il tutorial http://arduino.cc/en/Tutorial/InputPullupSerial[Input Pullup Serial^] per vedere un esempio di utilizzo. [%hardbreaks] -Pins configured as inputs with either `INPUT` or `INPUT_PULLUP` can be damaged or destroyed if they are connected to voltages below ground (negative voltages) or above the positive power rail (5V or 3V). +I pin configurati come ingressi con "INPUT" o "INPUT_PULLUP" possono essere danneggiati o distrutti se sono collegati a tensioni negative o sopra la soglia di alimentazione positiva (5V o 3V). [%hardbreaks] [float] -=== Pins Configured as OUTPUT -Pins configured as `OUTPUT` with `pinMode()` are said to be in a _low-impedance_ state. This means that they can provide a substantial amount of current to other circuits. ATmega pins can source (provide current) or sink (absorb current) up to 40 mA (milliamps) of current to other devices/circuits. This makes them useful for powering LEDs because LEDs typically use less than 40 mA. Loads greater than 40 mA (e.g. motors) will require a transistor or other interface circuitry. +=== Pin configurati come OUTPUT +I pin configurati come `OUTPUT` con `pinMode()` sono in uno stato di _ bassa impedenza_. Ciò significa che possono fornire una notevole quantità di corrente ad altri circuiti. I pin ATmega possono generare (fornire corrente) o assorbire (assorbire corrente) fino a 40 mA (milliampere) di corrente ad altri dispositivi / circuiti. Ciò li rende utili per alimentare i LED perché i LED in genere utilizzano meno di 40 mA. Carichi superiori a 40 mA (ad esempio motori) richiederanno un transistor o altri circuiti esterni di interfacciamento. [%hardbreaks] -Pins configured as outputs can be damaged or destroyed if they are connected to either the ground or positive power rails. +I pin configurati come uscite possono essere danneggiati o distrutti se sono collegati a terra o a sistemi di alimentazione positivi. [%hardbreaks] [float] -== Defining built-ins: LED_BUILTIN -Most Arduino boards have a pin connected to an on-board LED in series with a resistor. The constant `LED_BUILTIN` is the number of the pin to which the on-board LED is connected. Most boards have this LED connected to digital pin 13. +== Definizione di built-in: LED_BUILTIN +La maggior parte delle schede Arduino ha un pin collegato a un LED integrato in serie con un resistore. La costante `LED_BUILTIN` è il numero del pin a cui è collegato il LED di bordo. La maggior parte delle schede ha questo LED collegato al pin digitale 13. + -- // OVERVIEW SECTION ENDS @@ -127,7 +133,7 @@ Most Arduino boards have a pin connected to an on-board LED in series with a res -- [float] -=== See also +=== Vedi anche [role="language"]