Merge pull request #708 from makermelissa/i2c-freq-message

Display a message if user tries to set freq on linux

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -3,7 +3,7 @@
 # SPDX-License-Identifier: MIT
 
 name: 🐞 Bug Report
-description: Create a bug report to help us improve
+description: Create a bug report to help us improve. Use New Board Request if your board isn't being detected.
 labels:
   - bug
 body:

.github/ISSUE_TEMPLATE/new_board_request.md

@@ -1,5 +1,5 @@
 ---
-name: 🚀 New Board Request
+name: 📟 New Board Request
 about: Request Support for a New Board
 title: ''
 labels: 'New Board Request'

src/adafruit_blinka/microcontroller/generic_linux/i2c.py

@@ -2,11 +2,17 @@
 #
 # SPDX-License-Identifier: MIT
 """Generic Linux I2C class using PureIO's smbus class"""
+
+import warnings
 from Adafruit_PureIO import smbus
 
 
 class I2C:
-    """I2C class"""
+    """
+    I2C class
+
+    Baudrate has no effect on Linux systems. The argument is only there for compatibility.
+    """
 
     MASTER = 0
     SLAVE = 1
@@ -20,8 +26,10 @@ def __init__(self, bus_num, mode=MASTER, baudrate=None):
             raise NotImplementedError("Only I2C Master supported!")
         _mode = self.MASTER
 
-        # if baudrate != None:
-        #    print("I2C frequency is not settable in python, ignoring!")
+        if baudrate is not None:
+            warnings.warn(
+                "I2C frequency is not settable in python, ignoring!", RuntimeWarning
+            )
 
         try:
             self._i2c_bus = smbus.SMBus(bus_num)

src/busio.py

@@ -29,6 +29,8 @@ class I2C(Lockable):
     """
     Busio I2C Class for CircuitPython Compatibility. Used
     for both MicroPython and Linux.
+
+    NOTE: Frequency has no effect on Linux systems. The argument is only there for compatibility.
     """
 
     def __init__(self, scl, sda, frequency=100000):