I want to make a platform support myself, but I don't quite understand some things

maxgerhardt · May 9, 2023, 11:10am

I’ve created 4 or so new platforms, or signifcant extensions to them, in the past years and all I can say is: Learn by doing. You start to recognize patterns when you look at different official platforms like https://github.com/platformio/platform-ststm32, https://github.com/platformio/platform-atmelavr/, https://github.com/platformio/platform-raspberrypi/, et cetara.

The class Espressif32Platform is instantiated by the PlatformIO core code with a certain expected name based on the platform’s name declared in the platform.json, lowercased except the first letter.

github.com

platformio/platformio-core/blob/148ce1a897d72edfe78bc43f6573bd5b4948488f/platformio/platform/factory.py#L26-L39


      
          class PlatformFactory:
              @staticmethod
              def get_clsname(name):
                  name = re.sub(r"[^\da-z\_]+", "", name, flags=re.I)
                  return "%sPlatform" % name.lower().capitalize()
          
          
    @staticmethod
              def load_platform_module(name, path):
                  # backward compatibiility with the legacy dev-platforms
                  sys.modules["platformio.managers.platform"] = base
                  try:
                      return load_python_module("platformio.platform.%s" % name, path)
                  except ImportError as exc:
                      raise UnknownPlatform(name) from exc

github.com

platformio/platformio-core/blob/148ce1a897d72edfe78bc43f6573bd5b4948488f/platformio/platform/factory.py#L76-L82


      
          if os.path.isfile(os.path.join(platform_dir, "platform.py")):
              platform_cls = getattr(
                  cls.load_platform_module(
                      platform_name, os.path.join(platform_dir, "platform.py")
                  ),
                  cls.get_clsname(platform_name),
              )

The PlatformIO core will call the magic methods defined in that class for getting the configuration options for boards, packages, debug tools, et cetara. It’s really best to learn by the examples here and recognize the common code patterns for inclusion of packages, definition of debug servers etc.

I really, really want good documentation on the very intricate details of that too, but they’re not provided in that depth yet. There are lots of scattered islands of knowledge one has to have to create this.

Best I can give you is some thing I wrote some ago for helping you understand the build system (aka, SCons) and some PlatformIO specifics: Arduino Due (or other SAM3/4) upload fails with ATMEL ICE JTAG on VSCode with PlatformIO - #8 by maxgerhardt

Along with the platforms I’ve created or expanded…