Added details about USB serial communication

Author: chrisws

_build/pages/android.markdown

@@ -223,6 +223,84 @@ wend
 
 The code snippet demonstrates how to use REQUEST to interact with a specified endpoint, providing necessary data and token for authentication.
 
+## IoT Device Communication
+
+### USB Serial Support
+
+These functions allow you to connect, send, and receive data over a USB serial connection.
+
+🔌 Open a USB Serial Connection
+
+```smallbasic
+const usb = android.openUsbSerial(vendorId, [baud], [timeout])
+```
+
+Parameters:
+
+- `vendorId`: (required) The USB device's Vendor ID.
+- `baud`: (optional) The baud rate for communication (default: 19200).
+- `timeout`: (optional) imeout in milliseconds for receive operations (default: 5000 ms).
+
+Returns:
+
+- A USB serial object to be used with other USB functions.
+
+❌ Close the USB Connection
+
+```smallbasic
+usb.close()
+```
+
+Closes the current USB connection. Always call this when you're done using the device.
+
+📋 Get Device Description
+
+```smallbasic
+usb.description()
+```
+
+Returns a string with details about the connected USB device, such as product name or manufacturer info (if available).
+
+📥 Receive Data
+
+```smallbasic
+dat = usb.receive()
+```
+
+Reads incoming data from the connected USB device.
+
+Returns:
+
+A string containing the received data, or an empty string if no data is received before timeout.
+
+📤 Send Data
+
+```smallbasic
+n = usb.send(dat)
+```
+
+Sends data to the connected USB device.
+
+Parameters:
+
+dat – The data to send as a string.
+
+Returns:
+
+The number of bytes successfully sent.
+
+📝 Example
+
+```
+import android
+usb = android.openUsbSerial(0x16C0)
+while 1
+  input k
+  n = usb.send(k);
+  print "sent "; n
+  print usb.receive()
+wend
+```
 
 ## How to edit and run a program
 

index.html

@@ -140,7 +140,7 @@ <h2 id="more-information">More information</h2>
 articles in the <a href="/pages/articles.html">article section</a>.</p>
 </div>
     <div class="pagefooter">
-      This page was last edited on Thu, 20 Feb 2025 21:34:29 +0100
+      This page was last edited on Thu, 13 Mar 2025 20:29:49 +0100
  |
       <a href="https://en.wikipedia.org/wiki/Markdown" target="_blank" rel="nofollow">Markdown</a>
       processed with

pages/android.html

@@ -52,10 +52,10 @@ <h2 id="getting-started">Getting started</h2>
 </iframe>
 </div>
 <p>Please note, that at the first start of the Android version of
-SmallBASIC, the editor is turned off. A mouse click on a program name
-will start it immediately. If you want to edit the file, please turn on
-the editor by clicking on the three dots in the lower right corner and
-choosing the entry <code>Editor [OFF]</code> to enable the editor.</p>
+SmallBASIC, the editor is turned off. A tap on a program name will start
+it immediately. If you want to edit the file, please turn on the editor
+by tapping on the three dots in the lower right corner and choosing the
+entry <code>Editor [OFF]</code> to enable the editor.</p>
 <h2 id="step-by-step-guide">Step-by-Step Guide</h2>
 <p><img src="/images/android_menu1.png"
 title="System Menu button" /></p>
@@ -235,6 +235,59 @@ <h2 id="https-web-request">HTTPS Web request</h2>
 <p>The code snippet demonstrates how to use REQUEST to interact with a
 specified endpoint, providing necessary data and token for
 authentication.</p>
+<h2 id="iot-device-communication">IoT Device Communication</h2>
+<h3 id="usb-serial-support">USB Serial Support</h3>
+<p>These functions allow you to connect, send, and receive data over a
+USB serial connection.</p>
+<p>🔌 Open a USB Serial Connection</p>
+<div class="sourceCode" id="cb15"><pre
+class="sourceCode smallbasic"><code class="sourceCode smallbasic"><span id="cb15-1"><a href="#cb15-1" aria-hidden="true" tabindex="-1"></a><span class="dt">const</span> usb = android.openUsbSerial(vendorId, [baud], [timeout])</span></code></pre></div>
+<p>Parameters:</p>
+<ul>
+<li><code>vendorId</code>: (required) The USB device’s Vendor ID.</li>
+<li><code>baud</code>: (optional) The baud rate for communication
+(default: 19200).</li>
+<li><code>timeout</code>: (optional) imeout in milliseconds for receive
+operations (default: 5000 ms).</li>
+</ul>
+<p>Returns:</p>
+<ul>
+<li>A USB serial object to be used with other USB functions.</li>
+</ul>
+<p>❌ Close the USB Connection</p>
+<div class="sourceCode" id="cb16"><pre
+class="sourceCode smallbasic"><code class="sourceCode smallbasic"><span id="cb16-1"><a href="#cb16-1" aria-hidden="true" tabindex="-1"></a>usb.<span class="fu">close</span>()</span></code></pre></div>
+<p>Closes the current USB connection. Always call this when you’re done
+using the device.</p>
+<p>📋 Get Device Description</p>
+<div class="sourceCode" id="cb17"><pre
+class="sourceCode smallbasic"><code class="sourceCode smallbasic"><span id="cb17-1"><a href="#cb17-1" aria-hidden="true" tabindex="-1"></a>usb.description()</span></code></pre></div>
+<p>Returns a string with details about the connected USB device, such as
+product name or manufacturer info (if available).</p>
+<p>📥 Receive Data</p>
+<div class="sourceCode" id="cb18"><pre
+class="sourceCode smallbasic"><code class="sourceCode smallbasic"><span id="cb18-1"><a href="#cb18-1" aria-hidden="true" tabindex="-1"></a>dat = usb.receive()</span></code></pre></div>
+<p>Reads incoming data from the connected USB device.</p>
+<p>Returns:</p>
+<p>A string containing the received data, or an empty string if no data
+is received before timeout.</p>
+<p>📤 Send Data</p>
+<div class="sourceCode" id="cb19"><pre
+class="sourceCode smallbasic"><code class="sourceCode smallbasic"><span id="cb19-1"><a href="#cb19-1" aria-hidden="true" tabindex="-1"></a>n = usb.send(dat)</span></code></pre></div>
+<p>Sends data to the connected USB device.</p>
+<p>Parameters:</p>
+<p>dat – The data to send as a string.</p>
+<p>Returns:</p>
+<p>The number of bytes successfully sent.</p>
+<p>📝 Example</p>
+<pre><code>import android
+usb = android.openUsbSerial(0x16C0)
+while 1
+  input k
+  n = usb.send(k);
+  print &quot;sent &quot;; n
+  print usb.receive()
+wend</code></pre>
 <h2 id="how-to-edit-and-run-a-program">How to edit and run a
 program</h2>
 <h3 id="internal-editor">Internal editor:</h3>
@@ -304,7 +357,7 @@ <h2 id="privacy-policy">Privacy Policy <a
 <p><a href="privacy.html">Privacy Policy</a></p>
 </div>
     <div class="pagefooter">
-      This page was last edited on Mon, 7 Apr 2025 22:04:07 +0200
+      This page was last edited on Mon, 7 Apr 2025 22:40:38 +0200
  |
       <a href="https://en.wikipedia.org/wiki/Markdown" target="_blank" rel="nofollow">Markdown</a>
       processed with

pages/android_changelog.html

@@ -450,7 +450,7 @@ <h1 id="android-changelog">Android Changelog</h1>
 </ul>
 </div>
     <div class="pagefooter">
-      This page was last edited on Fri, 26 Apr 2024 06:53:31 +0930
+      This page was last edited on Sat, 22 Mar 2025 21:01:31 +1030
  |
       <a href="https://en.wikipedia.org/wiki/Markdown" target="_blank" rel="nofollow">Markdown</a>
       processed with

pages/android_file_transfer.html

@@ -60,7 +60,8 @@ <h2 id="step-by-step-guide">Step-by-Step Guide</h2>
 </div>
 </div>
     <div class="pagefooter">
-      This page was last edited on  |
+      This page was last edited on Wed, 16 Apr 2025 21:04:07 +0200
+ |
       <a href="https://en.wikipedia.org/wiki/Markdown" target="_blank" rel="nofollow">Markdown</a>
       processed with
       <a href="https://pandoc.org/MANUAL.html#pandocs-markdown" target="_blank" rel="nofollow">pandoc 3.1.12.1</a>

pages/articles.html

@@ -100,7 +100,7 @@ <h2 id="miscellaneous">Miscellaneous</h2>
 </ul>
 </div>
     <div class="pagefooter">
-      This page was last edited on Thu, 20 Feb 2025 21:34:29 +0100
+      This page was last edited on Wed, 16 Apr 2025 21:04:07 +0200
  |
       <a href="https://en.wikipedia.org/wiki/Markdown" target="_blank" rel="nofollow">Markdown</a>
       processed with

pages/guide.html

@@ -1636,7 +1636,7 @@ <h2 id="ExceptionHandling">Exception Handling</h2>
 href="https://smallbasic.github.io/reference/1425.html">TRY</a>.</p>
 </div>
     <div class="pagefooter">
-      This page was last edited on Mon, 7 Apr 2025 22:04:07 +0200
+      This page was last edited on Wed, 16 Apr 2025 21:04:07 +0200
  |
       <a href="https://en.wikipedia.org/wiki/Markdown" target="_blank" rel="nofollow">Markdown</a>
       processed with