From 89400b7db9a4df72e8035625d2f4a25de95e5931 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micha=C3=ABl=20Mordefroy?=
 <42770997+Mick3DIY@users.noreply.github.com>
Date: Wed, 24 Apr 2024 15:53:57 +0200
Subject: [PATCH] Update README.md

Remove Markdown autodocs
---
 joystickXL/README.md | 93 +++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 91 insertions(+), 2 deletions(-)

diff --git a/joystickXL/README.md b/joystickXL/README.md
index 4d53d33..8d6e365 100644
--- a/joystickXL/README.md
+++ b/joystickXL/README.md
@@ -34,8 +34,97 @@ Then create a new file *code.py* in the Pico board with Thonny IDE with the code
 
 ![](assets/EasyPicoPCB_joystickXL_directories.png)
 
-<!-- MARKDOWN-AUTO-DOCS:START (CODE:src=https://github.com/Mick3DIY/EasyPicoPCB/blob/9bdf7d77696d0fcb04d4879ffee31a63a1c57967/joystickXL/EasyPicoPCB_JoystickXL.py) -->
-<!-- MARKDOWN-AUTO-DOCS:END -->
+```python
+# EasyPicoPCB code example in CircuitPython and JoystickXL (2024-02-16)
+# Original project : https://github.com/Mick3DIY/EasyPicoPCB
+# Raspberry Pi Pico : https://www.raspberrypi.com/products/raspberry-pi-pico/
+# Documentation, tutorials : https://projects.raspberrypi.org
+# CircuitPython : https://learn.adafruit.com/welcome-to-circuitpython
+# JoystickXL : https://circuitpython-joystickxl.readthedocs.io
+# Thonny IDE : https://thonny.org
+import board
+import time
+import digitalio
+import analogio
+
+from joystick_xl.inputs import Axis, Button
+from joystick_xl.joystick import Joystick
+
+# External button S1 (GPIO16, pin 21)
+buttonS1 = digitalio.DigitalInOut(board.GP16)
+buttonS1.direction = digitalio.Direction.INPUT
+buttonS1.pull = digitalio.Pull.DOWN
+# External button S2 (GPIO17, pin 22)
+buttonS2 = digitalio.DigitalInOut(board.GP17)
+buttonS2.direction = digitalio.Direction.INPUT
+buttonS2.pull = digitalio.Pull.DOWN
+# External button S3 (GPIO18, pin 24)
+buttonS3 = digitalio.DigitalInOut(board.GP18)
+buttonS3.direction = digitalio.Direction.INPUT
+buttonS3.pull = digitalio.Pull.DOWN
+
+# External LED LED1 (GPIO15, pin 20)
+led1 = digitalio.DigitalInOut(board.GP15)
+led1.direction = digitalio.Direction.OUTPUT
+# External LED LED2 (GPIO14, pin 19)
+led2 = digitalio.DigitalInOut(board.GP14)
+led2.direction = digitalio.Direction.OUTPUT
+# External LED LED3 (GPIO13, pin 17)
+led3 = digitalio.DigitalInOut(board.GP13)
+led3.direction = digitalio.Direction.OUTPUT
+# Pico on-board LED (GPIO25)
+ledOnboard = digitalio.DigitalInOut(board.GP25)
+ledOnboard.direction = digitalio.Direction.OUTPUT
+
+# Potentiometer P1 (ADC0, GPIO26, pin31)
+pot1 = analogio.AnalogIn(board.GP26)
+# Potentiometer P2 (ADC1, GPIO27, pin32)
+pot2 = analogio.AnalogIn(board.GP27)
+# Potentiometer P3 (ADC2, GPIO28, pin34)
+pot3 = analogio.AnalogIn(board.GP28)
+# https://docs.circuitpython.org/en/latest/shared-bindings/analogio/index.html#analogio.AnalogIn
+conversionFactor = pot1.reference_voltage / (65535)
+
+js = Joystick()
+
+js.add_input(
+    Button(buttonS1, active_low=False), Button(buttonS2, active_low=False), Button(buttonS3, active_low=False),
+    Axis(pot1), Axis(pot2), Axis(pot3),
+)
+
+# Pico Status
+ledOnboard.value = True
+
+# Show axis values or graphic lines in Thonny plotter with text values
+while True:
+    # External button S1
+    if js.button[0].is_pressed:
+        led1.value = True
+    else:
+        led1.value = False
+    # External button S2
+    if js.button[1].is_pressed:
+        led2.value = True
+    else:
+        led2.value = False
+    # External button S3
+    if js.button[2].is_pressed:
+        led3.value = True
+    else:
+        led3.value = False
+
+    # Values from axis
+    #print("Min:0", js.axis[0].value, js.axis[1].value, js.axis[2].value, "Max:255")
+    
+    # https://mkaz.blog/code/python-string-format-cookbook/
+    valueP1 = "pot1:{:.2f}".format(pot1.value * conversionFactor)
+    valueP2 = "pot2:{:.2f}".format(pot2.value * conversionFactor)
+    valueP3 = "pot3:{:.2f}".format(pot3.value * conversionFactor)
+    print("Min:0", valueP1, valueP2, valueP3, "Max:3.5")
+
+    js.update()
+    time.sleep(0.3) #Important !
+```
 
 Finally run this code to see some values :