update peripheral demo for MaixCAM2

Neutree · Neutree · commit 115645e816f9 · 2025-08-07T21:30:42.000+08:00
diff --git a/examples/peripheral/adc/adc_read.py b/examples/peripheral/adc/adc_read.py
@@ -1,5 +1,12 @@
 from maix.peripheral import adc
-from maix import time
+from maix import time, sys
+
+device_id = sys.device_id()
+if device_id == "maixcam2":
+    raise Exception("MaixCAM2 don't have ADC")
+else:
+    pin_name = "A19"
+
 
 a = adc.ADC(0, adc.RES_BIT_12)
 
diff --git a/examples/peripheral/gpio/gpio_board_led.py b/examples/peripheral/gpio/gpio_board_led.py
@@ -1,7 +1,18 @@
-from maix import gpio, pinmap, time
+from maix import gpio, pinmap, time, sys
 
-pinmap.set_pin_function("A14", "GPIOA14")
-led = gpio.GPIO("GPIOA14", gpio.Mode.OUT)
+# get pin and GPIO number according to device id
+device_id = sys.device_id()
+if device_id == "maixcam2":
+    pin_name = "IO0_A6"
+    gpio_id = "GPIO0_A6"
+else:
+    pin_name = "A14"
+    gpio_id = "GPIOA14"
+
+# set pinmap
+pinmap.set_pin_function(pin_name, gpio_id)
+
+led = gpio.GPIO(gpio_id, gpio.Mode.OUT)
 led.value(0)
 
 while 1:
diff --git a/examples/peripheral/gpio/gpio_board_led_light.py b/examples/peripheral/gpio/gpio_board_led_light.py
@@ -1,7 +1,19 @@
-from maix import gpio, pinmap, time
+from maix import gpio, pinmap, time, sys
 
-pinmap.set_pin_function("B3", "GPIOB3")
-led = gpio.GPIO("GPIOB3", gpio.Mode.OUT)
+# get pin and GPIO number according to device id
+device_id = sys.device_id()
+if device_id == "maixcam2":
+    pin_name = "IO1_A25"
+    gpio_id = "GPIO1_A25"
+else:
+    pin_name = "B3"
+    gpio_id = "GPIOB3"
+
+# set pinmap
+pinmap.set_pin_function(pin_name, gpio_id)
+
+# Init GPIO
+led = gpio.GPIO(gpio_id, gpio.Mode.OUT)
 led.value(0)
 
 while 1:
diff --git a/examples/peripheral/gpio/gpio_input.py b/examples/peripheral/gpio/gpio_input.py
@@ -1,7 +1,19 @@
-from maix import gpio, pinmap, time
+from maix import gpio, pinmap, time, sys
 
-pinmap.set_pin_function("A19", "GPIOA19")
-led = gpio.GPIO("GPIOA19", gpio.Mode.IN)
+# get pin and GPIO number according to device id
+device_id = sys.device_id()
+if device_id == "maixcam2":
+    pin_name = "IO0_A2"
+    gpio_id = "GPIO0_A2"
+else:
+    pin_name = "A19"
+    gpio_id = "GPIOA19"
+
+# set pinmap
+pinmap.set_pin_function(pin_name, gpio_id)
+
+# Init GPIO
+led = gpio.GPIO(gpio_id, gpio.Mode.IN)
 
 while 1:
     print(led.value())
diff --git a/examples/peripheral/i2c/i2c_master.py b/examples/peripheral/i2c/i2c_master.py
@@ -1,9 +1,26 @@
-from maix import i2c, pinmap
+from maix import i2c, pinmap, sys
 
-pinmap.set_pin_function("A15", "I2C5_SCL")
-pinmap.set_pin_function("A27", "I2C5_SDA")
 
-bus = i2c.I2C(5, i2c.Mode.MASTER)
+# get pin and i2c number according to device id
+device_id = sys.device_id()
+if device_id == "maixcam2":
+    scl_pin_name = "IO0_A1"
+    scl_i2c_id = "I2C6_SCL"
+    sda_pin_name = "IO0_A0"
+    sda_i2c_id = "I2C6_SDA"
+    i2c_id = 6
+else:
+    scl_pin_name = "A15"
+    scl_i2c_id = "I2C5_SCL"
+    sda_pin_name = "A27"
+    sda_i2c_id = "I2C5_SDA"
+    i2c_id = 5
+
+# set pinmap
+pinmap.set_pin_function(scl_pin_name, scl_i2c_id)
+pinmap.set_pin_function(sda_pin_name, sda_i2c_id)
+
+bus = i2c.I2C(i2c_id, i2c.Mode.MASTER)
 slaves = bus.scan()
 print("find slaves:")
 for s in slaves:
diff --git a/examples/peripheral/pinmap/pinmap_gpio.py b/examples/peripheral/pinmap/pinmap_gpio.py
@@ -0,0 +1,37 @@
+from maix.peripheral import pinmap, gpio
+from maix import sys, time
+
+# get pin and GPIO number according to device id
+device_id = sys.device_id()
+if device_id == "maixcam2":
+    pin_name = "IO1_A25"
+else:
+    pin_name = "B3"
+
+# Every Pin may have multiple functions
+print(f"Pin {pin_name} functions:")
+funcs = pinmap.get_pin_functions(pin_name)
+print(funcs)
+
+# Find GPIO function id and set pin function to it
+print(f"Set pin function to GPIO")
+gpio_id = None
+for func_id in funcs:
+    if "GPIO" in func_id:
+        print(f"set function as {func_id}")
+        pinmap.set_pin_function(pin_name, func_id)
+        gpio_id = func_id
+        break
+
+if not gpio_id:
+    print(f"Pin {pin_name} not support GPIO function")
+else:
+    # Now we can use GPIO normally
+    # Init GPIO
+    led = gpio.GPIO(gpio_id, gpio.Mode.OUT)
+    led.value(0)
+
+    while 1:
+        led.toggle()
+        time.sleep_ms(500)
+
diff --git a/examples/peripheral/pinmap/pinmap_gpio_a28.py b/examples/peripheral/pinmap/pinmap_gpio_a28.py
diff --git a/examples/peripheral/pinmap/pinmap_info.py b/examples/peripheral/pinmap/pinmap_info.py
@@ -0,0 +1,13 @@
+from maix.peripheral import pinmap
+
+print("All pins of MaixCAM:")
+print(pinmap.get_pins())
+
+print("All pin's functions:")
+for pin in pinmap.get_pins():
+    funcs = pinmap.get_pin_functions(pin)
+    print(f"{pin:10s}: {', '.join(funcs)}")
+
+# set pinmap
+# pinmap.set_pin_function("A28", "GPIOA28")
+
diff --git a/examples/peripheral/pwm/pwm_led.py b/examples/peripheral/pwm/pwm_led.py
@@ -0,0 +1,29 @@
+from maix import pwm, time, pinmap, sys
+
+
+# get pin and pwm number according to device id
+device_id = sys.device_id()
+if device_id == "maixcam2":
+    pin_name = "IO0_A30"
+    pwm_id = 6
+else:
+    pin_name = "A18"
+    pwm_id = 6
+
+# set pinmap
+pinmap.set_pin_function(pin_name, f"PWM{pwm_id}")
+
+
+SERVO_PERIOD = 100000     # 100kHz 0.01ms
+
+out = pwm.PWM(pwm_id, freq=SERVO_PERIOD, duty=0, enable=True)
+
+for i in range(100):
+    print(i)
+    out.duty(i)
+    time.sleep_ms(100)
+
+for i in range(100):
+    print(i)
+    out.duty(100 - i)
+    time.sleep_ms(100)
diff --git a/examples/peripheral/pwm/pwm_servo.py b/examples/peripheral/pwm/pwm_servo.py
@@ -4,10 +4,18 @@
 SERVO_MIN_DUTY = 2.5  # 2.5% -> 0.5ms
 SERVO_MAX_DUTY = 12.5  # 12.5% -> 2.5ms
 
-# Use PWM7
-pwm_id = 7
-# !! set pinmap to use PWM7
-pinmap.set_pin_function("A19", "PWM7")
+
+# get pin and pwm number according to device id
+device_id = sys.device_id()
+if device_id == "maixcam2":
+    pin_name = "IO0_A31"
+    pwm_id = 7
+else:
+    pin_name = "A19"
+    pwm_id = 7
+
+# set pinmap
+pinmap.set_pin_function(pin_name, f"PWM{pwm_id}")
 
 
 
diff --git a/examples/peripheral/spi/spi_loopback.py b/examples/peripheral/spi/spi_loopback.py
@@ -1,19 +1,29 @@
-from maix import spi, pinmap
+from maix import spi, pinmap, sys, err
 
-pin_function = {
-    "A24": "SPI4_CS",
-    "A23": "SPI4_MISO",
-    "A25": "SPI4_MOSI",
-    "A22": "SPI4_SCK"
-}
+# get pin and SPI number according to device id
+device_id = sys.device_id()
+if device_id == "maixcam2":
+    pin_function = {
+        "IO1_A21": "SPI2_CS1",
+        "IO1_A19": "SPI2_MISO",
+        "IO1_A18": "SPI2_MOSI",
+        "IO1_A20": "SPI2_SCK"
+    }
+    spi_id = 2
+else:
+    pin_function = {
+        "A24": "SPI4_CS",
+        "A23": "SPI4_MISO",
+        "A25": "SPI4_MOSI",
+        "A22": "SPI4_SCK"
+    }
+    spi_id = 4
 
 for pin, func in pin_function.items():
-    if 0 != pinmap.set_pin_function(pin, func):
-        print(f"Failed: pin{pin}, func{func}")
-        exit(-1)
+    err.check_raise(pinmap.set_pin_function(pin, func), f"Failed set pin{pin} function to {func}")
 
 
-spidev = spi.SPI(4, spi.Mode.MASTER, 1250000)
+spidev = spi.SPI(spi_id, spi.Mode.MASTER, 1250000)
 
 ### Example of full parameter passing.
 # spidev = spi.SPI(id=4,                  # SPI ID
diff --git a/examples/peripheral/spi/spi_st7789.py b/examples/peripheral/spi/spi_st7789.py
@@ -23,7 +23,7 @@
 import numbers
 import numpy as np
 
-from maix import spi, gpio, pinmap, time
+from maix import spi, gpio, pinmap, time, err
 
 __version__ = '0.0.4'
 
@@ -102,26 +102,43 @@ def __init__(self, port:int, dc:str, soft_cs:None|str=None, backlight:None|str=N
         # print(f"use spi{port}")
 
         ### pinmap
-        if port == 4:
-            spi_pin_function = {
-                "A24": "SPI4_CS",
-                "A23": "SPI4_MISO", # MISO
-                "A25": "SPI4_MOSI", # MOSI
-                "A22": "SPI4_SCK",  # SCK
-            }
-        elif port == 2:
-            spi_pin_function = {
-                "P18": "SPI2_CS",
-                "P21": "SPI2_MISO", # MISO
-                "P22": "SPI2_MOSI", # MOSI
-                "P23": "SPI2_SCK",  # SCK
-            }
+        device_id = sys.device_id()
+        if device_id == "maixcam2":
+            if port == 1:
+                spi_pin_function = {
+                    "IO0_A2": "SPI1_CS0",
+                    "IO0_A1": "SPI1_MISO",
+                    "IO0_A0": "SPI1_MOSI",
+                    "IO0_A4": "SPI1_SCK"
+                }
+            elif port == 2:
+                spi_pin_function = {
+                    "IO1_A21": "SPI2_CS1",
+                    "IO1_A19": "SPI2_MISO",
+                    "IO1_A18": "SPI2_MOSI",
+                    "IO1_A20": "SPI2_SCK"
+                }
+            else:
+                raise ValueError("Only support spi2 and spi4")
         else:
-            raise ValueError("Only support spi2 and spi4")
+            if port == 4:
+                spi_pin_function = {
+                    "A24": "SPI4_CS",
+                    "A23": "SPI4_MISO", # MISO
+                    "A25": "SPI4_MOSI", # MOSI
+                    "A22": "SPI4_SCK",  # SCK
+                }
+            elif port == 2:
+                spi_pin_function = {
+                    "P18": "SPI2_CS",
+                    "P21": "SPI2_MISO", # MISO
+                    "P22": "SPI2_MOSI", # MOSI
+                    "P23": "SPI2_SCK",  # SCK
+                }
+            else:
+                raise ValueError("Only support spi2 and spi4")
         for pin, func in spi_pin_function.items():
-            if 0 != pinmap.set_pin_function(pin, func):
-                print(f"Failed: pin{pin}, func{func}")
-                exit(-1)
+            err.check_raise(pinmap.set_pin_function(pin, func), f"Failed set pin{pin} function to {func}")
 
         ### soft cs
         if soft_cs != None:
@@ -395,10 +412,17 @@ def image_to_data(self, image, rotation=0):
     ### Select a picture.
     image_file = "/maixapp/share/icon/detector.png"
 
+    # get pin and spi number according to device id
+    device_id = sys.device_id()
+    if device_id == "maixcam2":
+        spi_id = 2
+    else:
+        spi_id = 4
+
     disp = ST7789(
             height=135,
             rotation=0,
-            port=4,
+            port=spi_id,
             dc="A14",
             backlight=None,
             spi_speed_hz=1250000,
diff --git a/examples/peripheral/uart/comm_uart.py b/examples/peripheral/uart/comm_uart.py
diff --git a/examples/peripheral/uart/comm_uart_binary.py b/examples/peripheral/uart/comm_uart_binary.py
diff --git a/examples/peripheral/uart/comm_uart_callback.py b/examples/peripheral/uart/comm_uart_callback.py
