run-tests: set python stdio encoding to utf-8

.. unsetting this causes python3 to fail to start at all,
stating "Fatal Python error: Failed to initialize Windows random API
(CryptoGen)".  See https://bugs.python.org/issue20614

.gitattributes

@@ -1,7 +1,3 @@
-# SPDX-FileCopyrightText: 2014 MicroPython & CircuitPython contributors (https://github.com/adafruit/circuitpython/graphs/contributors)
-#
-# SPDX-License-Identifier: MIT
-
 # Per default everything gets normalized and gets LF line endings on checkout.
 * text eol=lf
 
@@ -11,20 +7,18 @@
 *.bat text eol=crlf
 
 # These are binary so should never be modified by git.
-*.a binary
 *.png binary
 *.jpg binary
 *.dxf binary
 *.mpy binary
 *.deb binary
-*.zip binary
-*.pdf binary
-*.wav binary
 
 # These should also not be modified by git.
 tests/basics/string_cr_conversion.py -text
 tests/basics/string_crlf_conversion.py -text
 ports/stm32/pybcdc.inf_template -text
+ports/stm32/usbd_* -text
+ports/stm32/usbdev/** -text
 ports/stm32/usbhost/** -text
 ports/cc3200/hal/aes.c -text
 ports/cc3200/hal/aes.h -text

.github/ISSUE_TEMPLATE/bug_report.md

@@ -1,54 +0,0 @@
----
-name: Bug report
-about: Create a report to help us improve
-title: ''
-labels: 'bug'
-assignees: ''
-
----
-
-<!-- Thanks! for testing out CircuitPython. Now that you have got a problem...
-you can file a bug report for it. Feel free to modify the below format to better
-suit your issue. :) -->
-
-**Firmware**
-
-<!-- Include the version of CircuitPython you're running. You can see it in the
-`boot_out.txt` file, as well as in the REPL. -->
-
-```python
-Adafruit CircuitPython 6.2.0-beta.2 on 2021-03-01; Raspberry Pi Pico with rp2040
-```
-
-**Code/REPL**
-
-<!-- Include your code that reproduces the bug here. Try to distill down to the
-minimum possible to reproduce. -->
-
-```python
-import busio, bitbangio
-i2c = bitbangio.I2C(board.GP1, board.GP0)
-```
-
-**Behavior**
-
-<!-- What happens when you run the code above? Include any error messages. -->
-
-```python
-Traceback (most recent call last):
-  File "<stdin>", line 1, in <module>
-TimeoutError: Clock stretch too long
-```
-
-**Description**
-
-<!-- Optionally, describe the issue in more detail. Here are some examples: -->
-
-- Error while using i2c...
-- Only happens when...
-- might be related to #4291...
-
-**Additional Info**
-
-<!-- Optionally, add any other information like hardware connection, scope output etc.
-If you have already done some debugging, mention it here. -->

.github/ISSUE_TEMPLATE/config.yml

@@ -1,7 +0,0 @@
-contact_links:
-  - name: Adafruit Forum
-    url: https://forums.adafruit.com/
-    about: Official Adafruit technical support forum. Good for getting help on getting a project working.
-  - name: Adafruit Discord
-    url: https://adafru.it/discord
-    about: Unofficial chat with many helpful folks and normally prompt replies.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -1,11 +0,0 @@
----
-name: Feature request
-about: Suggest an idea for this project
-title: ''
-labels: 'enhancement'
-assignees: ''
-
----
-
-<!-- We are always adding new features and enhancements to CircuitPython 🚀
-and would love ❤ to see what new challenge you have got for us... 🙂 -->

.github/workflows/build.yml

@@ -1,560 +0,0 @@
-# SPDX-FileCopyrightText: 2014 MicroPython & CircuitPython contributors (https://github.com/adafruit/circuitpython/graphs/contributors)
-#
-# SPDX-License-Identifier: MIT
-
-name: Build CI
-
-on:
-  push:
-  pull_request:
-  release:
-    types: [published]
-  check_suite:
-    types: [rerequested]
-
-jobs:
-  test:
-    runs-on: ubuntu-20.04
-    steps:
-    - name: Dump GitHub context
-      env:
-        GITHUB_CONTEXT: ${{ toJson(github) }}
-      run: echo "$GITHUB_CONTEXT"
-    - uses: actions/checkout@v2.2.0
-      with:
-        submodules: true
-        fetch-depth: 0
-    - run: git fetch --recurse-submodules=no https://github.com/adafruit/circuitpython refs/tags/*:refs/tags/*
-    - name: CircuitPython version
-      run: |
-        git describe --dirty --tags
-        echo >>$GITHUB_ENV CP_VERSION=$(git describe --dirty --tags)
-    - name: Set up Python 3.8
-      uses: actions/setup-python@v1
-      with:
-        python-version: 3.8
-    - name: Install deps
-      run: |
-        sudo apt-get update
-        sudo apt-get install -y eatmydata
-        sudo eatmydata apt-get install -y gettext librsvg2-bin mingw-w64 latexmk texlive-fonts-recommended texlive-latex-recommended texlive-latex-extra
-        pip install -r requirements-dev.txt
-    - name: Versions
-      run: |
-        gcc --version
-        python3 --version
-    - name: New boards check
-      run: python3 -u ci_new_boards_check.py
-      working-directory: tools
-    - name: Duplicate USB VID/PID Check
-      run: python3 -u -m tools.ci_check_duplicate_usb_vid_pid
-    - name: Build and Validate Stubs
-      run: make check-stubs -j2
-    - uses: actions/upload-artifact@v2
-      with:
-        name: stubs
-        path: circuitpython-stubs*
-    - name: Test Documentation Build (HTML)
-      run: sphinx-build -E -W -b html -D version=${{ env.CP_VERSION }} -D release=${{ env.CP_VERSION }} . _build/html
-    - uses: actions/upload-artifact@v2
-      with:
-        name: docs
-        path: _build/html
-    - name: Test Documentation Build (LaTeX/PDF)
-      run: |
-        make latexpdf
-    - uses: actions/upload-artifact@v2
-      with:
-        name: docs
-        path: _build/latex
-    - name: Build mpy-cross
-      run: make -C mpy-cross -j2
-    - name: Build unix port
-      run: |
-        make -C ports/unix deplibs -j2
-        make -C ports/unix -j2
-        make -C ports/unix coverage -j2
-    - name: Test all
-      run: MICROPY_CPYTHON3=python3.8 MICROPY_MICROPYTHON=../ports/unix/micropython_coverage ./run-tests -j1
-      working-directory: tests
-    - name: Print failure info
-      run: |
-        shopt -s nullglob;
-        for exp in *.exp;
-        do testbase=$(basename $exp .exp);
-        echo -e "\nFAILURE $testbase";
-        diff -u $testbase.exp $testbase.out;
-        done
-      working-directory: tests
-      if: failure()
-    - name: Native Tests
-      run: MICROPY_CPYTHON3=python3.8 MICROPY_MICROPYTHON=../ports/unix/micropython_coverage ./run-tests -j1 --emit native
-      working-directory: tests
-    - name: mpy Tests
-      run: MICROPY_CPYTHON3=python3.8 MICROPY_MICROPYTHON=../ports/unix/micropython_coverage ./run-tests -j1 --via-mpy -d basics float
-      working-directory: tests
-    - name: Build mpy-cross.static-raspbian
-      run: make -C mpy-cross -j2 -f Makefile.static-raspbian
-    - uses: actions/upload-artifact@v2
-      with:
-        name: mpy-cross.static-raspbian
-        path: mpy-cross/mpy-cross.static-raspbian
-    - name: Build mpy-cross.static
-      run: make -C mpy-cross -j2 -f Makefile.static
-    - uses: actions/upload-artifact@v2
-      with:
-        name: mpy-cross.static-amd64-linux
-        path: mpy-cross/mpy-cross.static
-    - name: Build mpy-cross.static-mingw
-      run: make -C mpy-cross -j2 -f Makefile.static-mingw
-    - uses: actions/upload-artifact@v2
-      with:
-        name: mpy-cross.static-x64-windows
-        path: mpy-cross/mpy-cross.static.exe
-    - name: Upload stubs and mpy-cross builds to S3
-      run: |
-        [ -z "$AWS_ACCESS_KEY_ID" ] || aws s3 cp mpy-cross/mpy-cross.static-raspbian s3://adafruit-circuit-python/bin/mpy-cross/mpy-cross.static-raspbian-${{ env.CP_VERSION }} --no-progress --region us-east-1
-        [ -z "$AWS_ACCESS_KEY_ID" ] || aws s3 cp mpy-cross/mpy-cross.static s3://adafruit-circuit-python/bin/mpy-cross/mpy-cross.static-amd64-linux-${{ env.CP_VERSION }} --no-progress --region us-east-1
-        [ -z "$AWS_ACCESS_KEY_ID" ] || aws s3 cp mpy-cross/mpy-cross.static.exe s3://adafruit-circuit-python/bin/mpy-cross/mpy-cross.static-x64-windows-${{ env.CP_VERSION }}.exe --no-progress --region us-east-1
-        zip -9r circuitpython-stubs.zip circuitpython-stubs
-        [ -z "$AWS_ACCESS_KEY_ID" ] || aws s3 cp circuitpython-stubs.zip s3://adafruit-circuit-python/bin/stubs/circuitpython-stubs-${{ env.CP_VERSION }}.zip --no-progress --region us-east-1
-      env:
-        AWS_PAGER: ''
-        AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
-        AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
-      if: github.event_name == 'push' || (github.event_name == 'release' && (github.event.action == 'published' || github.event.action == 'rerequested'))
-
-
-  mpy-cross-mac:
-    runs-on: macos-10.15
-    steps:
-    - name: Dump GitHub context
-      env:
-        GITHUB_CONTEXT: ${{ toJson(github) }}
-      run: echo "$GITHUB_CONTEXT"
-    - uses: actions/checkout@v2.2.0
-      with:
-        submodules: true
-        fetch-depth: 0
-    - run: git fetch --recurse-submodules=no https://github.com/adafruit/circuitpython refs/tags/*:refs/tags/*
-    - name: CircuitPython version
-      run: |
-        git describe --dirty --tags
-        echo >>$GITHUB_ENV CP_VERSION=$(git describe --dirty --tags)
-    - name: Install dependencies
-      run: |
-        brew install gettext
-        echo >>$GITHUB_PATH /usr/local/opt/gettext/bin
-    - name: Versions
-      run: |
-        gcc --version
-        python3 --version
-        msgfmt --version
-    - name: Build mpy-cross
-      run: make -C mpy-cross -j2
-    - uses: actions/upload-artifact@v2
-      with:
-        name: mpy-cross-macos-catalina
-        path: mpy-cross/mpy-cross
-    - name: Upload mpy-cross build to S3
-      run: |
-        [ -z "$AWS_ACCESS_KEY_ID" ] || aws s3 cp mpy-cross/mpy-cross s3://adafruit-circuit-python/bin/mpy-cross/mpy-cross-macos-catalina-${{ env.CP_VERSION }} --no-progress --region us-east-1
-      env:
-        AWS_PAGER: ''
-        AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
-        AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
-      if: github.event_name == 'push' || (github.event_name == 'release' && (github.event.action == 'published' || github.event.action == 'rerequested'))
-
-
-  build-arm:
-    runs-on: ubuntu-20.04
-    needs: test
-    strategy:
-      fail-fast: false
-      matrix:
-        board:
-        - "8086_commander"
-        - "ADM_B_NRF52840_1"
-        - "TG-Watch"
-        - "adafruit_feather_rp2040"
-        - "adafruit_itsybitsy_rp2040"
-        - "adafruit_neokey_trinkey_m0"
-        - "adafruit_proxlight_trinkey_m0"
-        - "adafruit_qtpy_rp2040"
-        - "adafruit_rotary_trinkey_m0"
-        - "adafruit_slide_trinkey_m0"
-        - "aloriumtech_evo_m51"
-        - "aramcon2_badge"
-        - "aramcon_badge_2019"
-        - "arduino_mkr1300"
-        - "arduino_mkrzero"
-        - "arduino_nano_33_ble"
-        - "arduino_nano_33_iot"
-        - "arduino_zero"
-        - "bast_pro_mini_m0"
-        - "bastble"
-        - "bdmicro_vina_d21"
-        - "bdmicro_vina_d51"
-        - "bdmicro_vina_d51_pcb7"
-        - "bless_dev_board_multi_sensor"
-        - "blm_badge"
-        - "capablerobot_usbhub"
-        - "catwan_usbstick"
-        - "circuitbrains_basic_m0"
-        - "circuitbrains_deluxe_m4"
-        - "circuitplayground_bluefruit"
-        - "circuitplayground_express"
-        - "circuitplayground_express_crickit"
-        - "circuitplayground_express_displayio"
-        - "clue_nrf52840_express"
-        - "cp32-m4"
-        - "cp_sapling_m0"
-        - "cp_sapling_m0_spiflash"
-        - "datalore_ip_m4"
-        - "datum_distance"
-        - "datum_imu"
-        - "datum_light"
-        - "datum_weather"
-        - "dynalora_usb"
-        - "dynossat_edu_eps"
-        - "dynossat_edu_obc"
-        - "electronut_labs_blip"
-        - "electronut_labs_papyr"
-        - "escornabot_makech"
-        - "espruino_pico"
-        - "espruino_wifi"
-        - "feather_bluefruit_sense"
-        - "feather_m0_adalogger"
-        - "feather_m0_basic"
-        - "feather_m0_express"
-        - "feather_m0_express_crickit"
-        - "feather_m0_rfm69"
-        - "feather_m0_rfm9x"
-        - "feather_m0_supersized"
-        - "feather_m4_can"
-        - "feather_m4_express"
-        - "feather_m7_1011"
-        - "feather_mimxrt1011"
-        - "feather_mimxrt1062"
-        - "feather_nrf52840_express"
-        - "feather_radiofruit_zigbee"
-        - "feather_stm32f405_express"
-        - "fluff_m0"
-        - "gemma_m0"
-        - "grandcentral_m4_express"
-        - "hallowing_m0_express"
-        - "hallowing_m4_express"
-        - "hiibot_bluefi"
-        - "huntercat_nfc"
-        - "ikigaisense_vita"
-        - "imxrt1010_evk"
-        - "imxrt1020_evk"
-        - "imxrt1060_evk"
-        - "itsybitsy_m0_express"
-        - "itsybitsy_m4_express"
-        - "itsybitsy_nrf52840_express"
-        - "kicksat-sprite"
-        - "loc_ber_m4_base_board"
-        - "makerdiary_m60_keyboard"
-        - "makerdiary_nrf52840_m2_devkit"
-        - "makerdiary_nrf52840_mdk"
-        - "makerdiary_nrf52840_mdk_usb_dongle"
-        - "matrixportal_m4"
-        - "meowbit_v121"
-        - "meowmeow"
-        - "metro_m0_express"
-        - "metro_m4_airlift_lite"
-        - "metro_m4_express"
-        - "metro_m7_1011"
-        - "metro_nrf52840_express"
-        - "mini_sam_m4"
-        - "monster_m4sk"
-        - "ndgarage_ndbit6"
-        - "ndgarage_ndbit6_v2"
-        - "neopixel_trinkey_m0"
-        - "nfc_copy_cat"
-        - "nice_nano"
-        - "nucleo_f746zg"
-        - "nucleo_f767zi"
-        - "nucleo_h743zi_2"
-        - "ohs2020_badge"
-        - "openbook_m4"
-        - "openmv_h7"
-        - "particle_argon"
-        - "particle_boron"
-        - "particle_xenon"
-        - "pca10056"
-        - "pca10059"
-        - "pca10100"
-        - "pewpew10"
-        - "pewpew_m4"
-        - "picoplanet"
-        - "pimoroni_keybow2040"
-        - "pimoroni_picolipo_16mb"
-        - "pimoroni_picolipo_4mb"
-        - "pimoroni_picosystem"
-        - "pimoroni_tiny2040"
-        - "pirkey_m0"
-        - "pitaya_go"
-        - "pyb_nano_v2"
-        - "pybadge"
-        - "pybadge_airlift"
-        - "pyboard_v11"
-        - "pycubed"
-        - "pycubed_mram"
-        - "pygamer"
-        - "pygamer_advance"
-        - "pyportal"
-        - "pyportal_titano"
-        - "pyruler"
-        - "qtpy_m0"
-        - "qtpy_m0_haxpress"
-        - "raspberry_pi_pico"
-        - "raytac_mdbt50q-db-40"
-        - "robohatmm1_m4"
-        - "sam32"
-        - "same54_xplained"
-        - "seeeduino_wio_terminal"
-        - "seeeduino_xiao"
-        - "sensebox_mcu"
-        - "serpente"
-        - "shirtty"
-        - "silicognition-m4-shim"
-        - "simmel"
-        - "snekboard"
-        - "sparkfun_lumidrive"
-        - "sparkfun_micromod_rp2040"
-        - "sparkfun_nrf52840_micromod"
-        - "sparkfun_nrf52840_mini"
-        - "sparkfun_pro_micro_rp2040"
-        - "sparkfun_qwiic_micro_no_flash"
-        - "sparkfun_qwiic_micro_with_flash"
-        - "sparkfun_redboard_turbo"
-        - "sparkfun_samd21_dev"
-        - "sparkfun_samd21_mini"
-        - "sparkfun_samd51_thing_plus"
-        - "sparkfun_thing_plus_rp2040"
-        - "spresense"
-        - "stackrduino_m0_pro"
-        - "stm32f411ce_blackpill"
-        - "stm32f411ce_blackpill_with_flash"
-        - "stm32f411ve_discovery"
-        - "stm32f412zg_discovery"
-        - "stm32f4_discovery"
-        - "stm32f746g_discovery"
-        - "stringcar_m0_express"
-        - "teensy40"
-        - "teensy41"
-        - "teknikio_bluebird"
-        - "thunderpack_v11"
-        - "thunderpack_v12"
-        - "tinkeringtech_scoutmakes_azul"
-        - "trellis_m4_express"
-        - "trinket_m0"
-        - "trinket_m0_haxpress"
-        - "uartlogger2"
-        - "uchip"
-        - "ugame10"
-        - "winterbloom_big_honking_button"
-        - "winterbloom_sol"
-        - "xinabox_cc03"
-        - "xinabox_cs11"
-
-    steps:
-    - name: Set up Python 3.8
-      uses: actions/setup-python@v1
-      with:
-        python-version: 3.8
-    - uses: actions/checkout@v2.2.0
-      with:
-        submodules: true
-        fetch-depth: 0
-    - run: git fetch --recurse-submodules=no https://github.com/adafruit/circuitpython refs/tags/*:refs/tags/*
-    - name: Install deps
-      run: |
-        sudo apt-get install -y gettext
-        pip install -r requirements-dev.txt
-        wget --no-verbose https://adafruit-circuit-python.s3.amazonaws.com/gcc-arm-none-eabi-10-2020-q4-major-x86_64-linux.tar.bz2
-        sudo tar -C /usr --strip-components=1 -xaf gcc-arm-none-eabi-10-2020-q4-major-x86_64-linux.tar.bz2
-    - name: Versions
-      run: |
-        gcc --version
-        arm-none-eabi-gcc --version
-        python3 --version
-    - name: mpy-cross
-      run: make -C mpy-cross -j2
-    - name: Setup build failure matcher
-      run: echo "::add-matcher::$GITHUB_WORKSPACE/.github/workflows/match-build-fail.json"
-    - name: build
-      run: python3 -u build_release_files.py
-      working-directory: tools
-      env:
-        BOARDS: ${{ matrix.board }}
-    - uses: actions/upload-artifact@v2
-      with:
-        name: ${{ matrix.board }}
-        path: bin/${{ matrix.board }}
-    - name: Upload to S3
-      run: "[ -z \"$AWS_ACCESS_KEY_ID\" ] || aws s3 cp bin/ s3://adafruit-circuit-python/bin/ --recursive --no-progress --region us-east-1"
-      env:
-        AWS_PAGER: ''
-        AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
-        AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
-      if: github.event_name == 'push' || (github.event_name == 'release' && (github.event.action == 'published' || github.event.action == 'rerequested'))
-
-  build-riscv:
-    runs-on: ubuntu-20.04
-    needs: test
-    strategy:
-      fail-fast: false
-      matrix:
-        board:
-        - "fomu"
-
-    steps:
-    - name: Set up Python 3.8
-      uses: actions/setup-python@v1
-      with:
-        python-version: 3.8
-    - uses: actions/checkout@v2.2.0
-      with:
-        submodules: true
-        fetch-depth: 0
-    - run: git fetch --recurse-submodules=no https://github.com/adafruit/circuitpython refs/tags/*:refs/tags/*
-    - name: Install deps
-      run: |
-        sudo apt-get install -y gettext
-        pip install requests sh click setuptools awscli
-        wget https://static.dev.sifive.com/dev-tools/riscv64-unknown-elf-gcc-8.3.0-2019.08.0-x86_64-linux-centos6.tar.gz
-        sudo tar -C /usr --strip-components=1 -xaf riscv64-unknown-elf-gcc-8.3.0-2019.08.0-x86_64-linux-centos6.tar.gz
-    - name: Versions
-      run: |
-        gcc --version
-        riscv64-unknown-elf-gcc --version
-        python3 --version
-    - name: mpy-cross
-      run: make -C mpy-cross -j2
-    - name: Setup build failure matcher
-      run: echo "::add-matcher::$GITHUB_WORKSPACE/.github/workflows/match-build-fail.json"
-    - name: build
-      run: python3 -u build_release_files.py
-      working-directory: tools
-      env:
-        BOARDS: ${{ matrix.board }}
-    - uses: actions/upload-artifact@v2
-      with:
-        name: ${{ matrix.board }}
-        path: bin/${{ matrix.board }}
-    - name: Upload to S3
-      run: "[ -z \"$AWS_ACCESS_KEY_ID\" ] || aws s3 cp bin/ s3://adafruit-circuit-python/bin/ --recursive --no-progress --region us-east-1"
-      env:
-        AWS_PAGER: ''
-        AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
-        AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
-      if: github.event_name == 'push' || (github.event_name == 'release' && (github.event.action == 'published' || github.event.action == 'rerequested'))
-  build-xtensa:
-    runs-on: ubuntu-20.04
-    needs: test
-    strategy:
-      fail-fast: false
-      matrix:
-        board:
-        - "adafruit_feather_esp32s2_nopsram"
-        - "adafruit_feather_esp32s2_tftback_nopsram"
-        - "adafruit_funhouse"
-        - "adafruit_magtag_2.9_grayscale"
-        - "adafruit_metro_esp32s2"
-        - "artisense_rd00"
-        - "atmegazero_esp32s2"
-        - "electroniccats_bastwifi"
-        - "espressif_kaluga_1"
-        - "espressif_saola_1_wroom"
-        - "espressif_saola_1_wrover"
-        - "franzininho_wifi_wroom"
-        - "franzininho_wifi_wrover"
-        - "lilygo_ttgo_t8_s2_st7789"
-        - "microdev_micro_s2"
-        - "muselab_nanoesp32_s2"
-        - "targett_module_clip_wroom"
-        - "targett_module_clip_wrover"
-        - "unexpectedmaker_feathers2"
-        - "unexpectedmaker_feathers2_prerelease"
-        - "unexpectedmaker_tinys2"
-
-    steps:
-    - name: Set up Python 3.8
-      uses: actions/setup-python@v1
-      with:
-        python-version: 3.8
-    - uses: actions/checkout@v2.2.0
-      with:
-        submodules: true
-        fetch-depth: 0
-    - run: git fetch --recurse-submodules=no https://github.com/adafruit/circuitpython refs/tags/*:refs/tags/*
-    - name: CircuitPython version
-      run: git describe --dirty --tags
-    - uses: actions/cache@v2
-      name: Fetch IDF tool cache
-      id: idf-cache
-      with:
-        path: ${{ github.workspace }}/.idf_tools
-        key: ${{ runner.os }}-idf-tools-${{ hashFiles('.git/modules/ports/esp32s2/esp-idf/HEAD') }}-20210422
-    - name: Clone IDF submodules
-      run: |
-        (cd $IDF_PATH && git submodule update --init)
-      env:
-        IDF_PATH: ${{ github.workspace }}/ports/esp32s2/esp-idf
-    - name: Install IDF tools
-      run: |
-        $IDF_PATH/tools/idf_tools.py --non-interactive install required
-        $IDF_PATH/tools/idf_tools.py --non-interactive install cmake
-        $IDF_PATH/tools/idf_tools.py --non-interactive install-python-env
-        rm -rf $IDF_TOOLS_PATH/dist
-      env:
-        IDF_PATH: ${{ github.workspace }}/ports/esp32s2/esp-idf
-        IDF_TOOLS_PATH: ${{ github.workspace }}/.idf_tools
-    - name: Install CircuitPython deps
-      run: |
-        source $IDF_PATH/export.sh
-        pip install -r requirements-dev.txt
-        sudo apt-get install -y gettext ninja-build
-      env:
-        IDF_PATH: ${{ github.workspace }}/ports/esp32s2/esp-idf
-        IDF_TOOLS_PATH: ${{ github.workspace }}/.idf_tools
-    - name: Versions
-      run: |
-        source $IDF_PATH/export.sh
-        gcc --version
-        xtensa-esp32s2-elf-gcc --version
-        python3 --version
-        ninja --version
-        cmake --version
-      shell: bash
-      env:
-        IDF_PATH: ${{ github.workspace }}/ports/esp32s2/esp-idf
-        IDF_TOOLS_PATH: ${{ github.workspace }}/.idf_tools
-    - name: mpy-cross
-      run: make -C mpy-cross -j2
-    - name: Setup build failure matcher
-      run: echo "::add-matcher::$GITHUB_WORKSPACE/.github/workflows/match-build-fail.json"
-    - name: build
-      run: |
-        source $IDF_PATH/export.sh
-        python3 -u build_release_files.py
-      working-directory: tools
-      shell: bash
-      env:
-        IDF_PATH: ${{ github.workspace }}/ports/esp32s2/esp-idf
-        IDF_TOOLS_PATH: ${{ github.workspace }}/.idf_tools
-        BOARDS: ${{ matrix.board }}
-    - uses: actions/upload-artifact@v2
-      with:
-        name: ${{ matrix.board }}
-        path: bin/${{ matrix.board }}
-    - name: Upload to S3
-      run: "[ -z \"$AWS_ACCESS_KEY_ID\" ] || aws s3 cp bin/ s3://adafruit-circuit-python/bin/ --recursive --no-progress --region us-east-1"
-      env:
-        AWS_PAGER: ''
-        AWS_ACCESS_KEY_ID: ${{ secrets.AWS_ACCESS_KEY_ID }}
-        AWS_SECRET_ACCESS_KEY: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
-      if: github.event_name == 'push' || (github.event_name == 'release' && (github.event.action == 'published' || github.event.action == 'rerequested'))

.github/workflows/create_website_pr.yml

@@ -1,43 +0,0 @@
-# SPDX-FileCopyrightText: 2014 MicroPython & CircuitPython contributors (https://github.com/adafruit/circuitpython/graphs/contributors)
-#
-# SPDX-License-Identifier: MIT
-
-name: Update CircuitPython.org
-
-on:
-  release:
-    types: [published]
-
-jobs:
-  website:
-    runs-on: ubuntu-20.04
-    steps:
-    - name: Dump GitHub context
-      env:
-        GITHUB_CONTEXT: ${{ toJson(github) }}
-      run: echo "$GITHUB_CONTEXT"
-    - uses: actions/checkout@v2.2.0
-      with:
-        submodules: true
-        fetch-depth: 0
-    - name: Set up Python 3.8
-      uses: actions/setup-python@v1
-      with:
-        python-version: 3.8
-    - name: Install deps
-      run: |
-        pip install -r requirements-dev.txt
-    - name: Versions
-      run: |
-        gcc --version
-        python3 --version
-    - run: git fetch --recurse-submodules=no https://github.com/adafruit/circuitpython refs/tags/*:refs/tags/*
-    - name: CircuitPython version
-      run: git describe --dirty --tags
-    - name: Website
-      run: python3 build_board_info.py
-      working-directory: tools
-      env:
-        RELEASE_TAG: ${{ github.event.release.tag_name }}
-        ADABOT_GITHUB_ACCESS_TOKEN: ${{ secrets.BLINKA_GITHUB_ACCESS_TOKEN }}
-      if: github.event_name == 'release' && (github.event.action == 'published'  || github.event.action == 'rerequested')

.github/workflows/match-build-fail.json

@@ -1,14 +0,0 @@
-{
-  "problemMatcher": [
-    {
-      "severity": "error",
-      "pattern": [
-        {
-          "regexp": "^(Build .+ and \\x1b\\[31mfailed\\x1b\\[0m)$",
-          "message": 1
-        }
-      ],
-      "owner": "build-failed"
-    }
-  ]
-}

.github/workflows/pre-commit.yml

@@ -1,30 +0,0 @@
-# SPDX-FileCopyrightText: Copyright (c) 2019 Anthony Sottile
-#
-# SPDX-License-Identifier: MIT
-
-name: pre-commit
-
-on:
-  pull_request:
-  push:
-
-jobs:
-  pre-commit:
-    runs-on: ubuntu-20.04
-    steps:
-    - uses: actions/checkout@v1
-    - uses: actions/setup-python@v1
-    - name: Install deps
-      run: |
-        sudo apt-add-repository -y -u ppa:pybricks/ppa
-        sudo apt-get install -y black gettext uncrustify
-        pip3 install -r requirements-dev.txt
-    - name: Populate selected submodules
-      run: git submodule update --init extmod/ulab
-    - name: Set PY
-      run: echo >>$GITHUB_ENV PY="$(python -c 'import hashlib, sys;print(hashlib.sha256(sys.version.encode()+sys.executable.encode()).hexdigest())')"
-    - uses: actions/cache@v2
-      with:
-        path: ~/.cache/pre-commit
-        key: pre-commit|${{ env.PY }}|${{ hashFiles('.pre-commit-config.yaml') }}
-    - uses: pre-commit/action@v1.1.0

.gitignore

@@ -1,7 +1,3 @@
-# SPDX-FileCopyrightText: 2014 MicroPython & CircuitPython contributors (https://github.com/adafruit/circuitpython/graphs/contributors)
-#
-# SPDX-License-Identifier: MIT
-
 # Compiled Sources
 ###################
 *.o
@@ -11,14 +7,12 @@
 *.bin
 *.map
 *.hex
+!ports/nrf/**/bootloader/*.hex
 *.dis
 *.exe
 
 # Packages
 ############
-dist/
-*.egg-info
-.eggs
 
 # Logs and Databases
 ######################
@@ -28,12 +22,10 @@ dist/
 ######################
 *.swp
 
-# Build directories
+# Build directory
 ######################
 build/
 bin/
-circuitpython-stubs/
-build-*/
 
 # Test failure outputs
 ######################
@@ -57,8 +49,6 @@ _build
 # Generated rst files
 ######################
 genrst/
-/autoapi/
-/shared-bindings/*/**/*.rst
 
 # ctags and similar
 ###################
@@ -68,25 +58,3 @@ TAGS
 #################
 *.orig
 
-# Emacs backup files
-####################
-*~
-
-*.DS_Store
-**/*.DS_Store
-*.icloud
-
-# POEdit mo files
-####################
-*.mo
-
-.vscode
-.idea
-
-# Python Virtual Environments
-####################
-.venv
-.env
-
-# Uncrustify formatting
-*.uncrustify

.gitmodules

@@ -1,7 +1,3 @@
-# SPDX-FileCopyrightText: 2014 MicroPython & CircuitPython contributors (https://github.com/adafruit/circuitpython/graphs/contributors)
-#
-# SPDX-License-Identifier: MIT
-
 [submodule "lib/axtls"]
 	path = lib/axtls
 	url = https://github.com/pfalcon/axtls
@@ -9,12 +5,12 @@
 [submodule "lib/libffi"]
 	path = lib/libffi
 	url = https://github.com/atgreen/libffi
+[submodule "lib/lwip"]
+	path = lib/lwip
+	url = http://git.savannah.gnu.org/r/lwip.git
 [submodule "lib/berkeley-db-1.xx"]
 	path = lib/berkeley-db-1.xx
 	url = https://github.com/pfalcon/berkeley-db-1.xx
-[submodule "lib/uzlib"]
-	path = lib/uzlib
-	url = https://github.com/pfalcon/uzlib
 [submodule "tools/uf2"]
 	path = tools/uf2
 	url = https://github.com/Microsoft/uf2.git
@@ -33,149 +29,20 @@
 [submodule "tools/python-semver"]
 	path = tools/python-semver
 	url = https://github.com/k-bx/python-semver.git
+[submodule "lib/stm32lib"]
+	path = lib/stm32lib
+	url = https://github.com/micropython/stm32lib
+	branch = work-F4-1.13.1+F7-1.5.0+L4-1.3.0
+[submodule "freetouch2"]
+       path = ports/atmel-samd/freetouch
+       url = https://github.com/adafruit/Adafruit_FreeTouch.git
 [submodule "atmel-samd/asf4"]
-	path = ports/atmel-samd/asf4
-	url = https://github.com/adafruit/asf4.git
-	branch = circuitpython
+       path = ports/atmel-samd/asf4
+       url = https://github.com/adafruit/asf4.git
+       branch = circuitpython
 [submodule "tools/usb_descriptor"]
 	path = tools/usb_descriptor
 	url = https://github.com/adafruit/usb_descriptor.git
 [submodule "lib/nrfutil"]
 	path = lib/nrfutil
 	url = https://github.com/adafruit/nRF52_nrfutil
-[submodule "ports/atmel-samd/freetouch"]
-	path = ports/atmel-samd/freetouch
-	url = https://github.com/adafruit/Adafruit_FreeTouch.git
-[submodule "frozen/Adafruit_CircuitPython_CircuitPlayground"]
-	path = frozen/Adafruit_CircuitPython_CircuitPlayground
-	url = https://github.com/adafruit/Adafruit_CircuitPython_CircuitPlayground.git
-[submodule "frozen/Adafruit_CircuitPython_HID"]
-	path = frozen/Adafruit_CircuitPython_HID
-	url = https://github.com/adafruit/Adafruit_CircuitPython_HID.git
-[submodule "ports/atmel-samd/Adafruit_CircuitPython_Motor"]
-	path = frozen/Adafruit_CircuitPython_Motor
-	url = https://github.com/adafruit/Adafruit_CircuitPython_Motor.git
-[submodule "ports/atmel-samd/Adafruit_CircuitPython_seesaw"]
-	path = frozen/Adafruit_CircuitPython_seesaw
-	url = https://github.com/adafruit/Adafruit_CircuitPython_seesaw.git
-[submodule "frozen/Adafruit_CircuitPython_IRRemote"]
-	path = frozen/Adafruit_CircuitPython_IRRemote
-	url = https://github.com/adafruit/Adafruit_CircuitPython_IRRemote.git
-[submodule "frozen/Adafruit_CircuitPython_DotStar"]
-	path = frozen/Adafruit_CircuitPython_DotStar
-	url = https://github.com/adafruit/Adafruit_CircuitPython_DotStar.git
-[submodule "ports/atmel-samd/peripherals"]
-	path = ports/atmel-samd/peripherals
-	url = https://github.com/adafruit/samd-peripherals.git
-[submodule "frozen/Adafruit_CircuitPython_Crickit"]
-	path = frozen/Adafruit_CircuitPython_Crickit
-	url = https://github.com/adafruit/Adafruit_CircuitPython_Crickit
-[submodule "ports/nrf/nrfx"]
-	path = ports/nrf/nrfx
-	url = https://github.com/adafruit/nrfx.git
-[submodule "tools/huffman"]
-	path = tools/huffman
-	url = https://github.com/tannewt/huffman.git
-[submodule "tools/adabot"]
-	path = tools/adabot
-	url = https://github.com/adafruit/adabot.git
-[submodule "tools/bitmap_font"]
-	path = tools/bitmap_font
-	url = https://github.com/adafruit/Adafruit_CircuitPython_BitmapFont.git
-[submodule "tools/Tecate-bitmap-fonts"]
-	path = tools/Tecate-bitmap-fonts
-	url = https://github.com/Tecate/bitmap-fonts.git
-[submodule "frozen/pew-pewpew-standalone-10.x"]
-	path = frozen/pew-pewpew-standalone-10.x
-	url = https://github.com/pewpew-game/pew-pewpew-standalone-10.x.git
-[submodule "frozen/circuitpython-stage"]
-	path = frozen/circuitpython-stage
-	url = https://github.com/python-ugame/circuitpython-stage.git
-[submodule "ports/cxd56/spresense-exported-sdk"]
-	path = ports/cxd56/spresense-exported-sdk
-	url = https://github.com/sonydevworld/spresense-exported-sdk.git
-[submodule "frozen/Adafruit_CircuitPython_SD"]
-	path = frozen/Adafruit_CircuitPython_SD
-	url = https://github.com/adafruit/Adafruit_CircuitPython_SD.git
-[submodule "lib/mp3"]
-	path = lib/mp3
-	url = https://github.com/adafruit/Adafruit_MP3
-[submodule "ports/mimxrt10xx/sdk"]
-	path = ports/mimxrt10xx/sdk
-	url = https://github.com/adafruit/MIMXRT10xx_SDK
-[submodule "frozen/Adafruit_CircuitPython_Register"]
-	path = frozen/Adafruit_CircuitPython_Register
-	url = https://github.com/adafruit/Adafruit_CircuitPython_Register.git
-[submodule "extmod/ulab"]
-	path = extmod/ulab
-	url = https://github.com/adafruit/circuitpython-ulab
-[submodule "frozen/Adafruit_CircuitPython_ESP32SPI"]
-	path = frozen/Adafruit_CircuitPython_ESP32SPI
-	url = https://github.com/adafruit/Adafruit_CircuitPython_ESP32SPI
-[submodule "frozen/Adafruit_CircuitPython_Requests"]
-	path = frozen/Adafruit_CircuitPython_Requests
-	url = https://github.com/adafruit/Adafruit_CircuitPython_Requests
-[submodule "ports/stm/st_driver"]
-	path = ports/stm/st_driver
-	url = https://github.com/hathach/st_driver.git
-[submodule "lib/protomatter"]
-	path = lib/protomatter
-	url = https://github.com/adafruit/Adafruit_Protomatter
-[submodule "frozen/Adafruit_CircuitPython_LSM6DS"]
-	path = frozen/Adafruit_CircuitPython_LSM6DS
-	url = https://github.com/adafruit/Adafruit_CircuitPython_LSM6DS
-[submodule "frozen/Adafruit_CircuitPython_FocalTouch"]
-	path = frozen/Adafruit_CircuitPython_FocalTouch
-	url = https://github.com/adafruit/Adafruit_CircuitPython_FocalTouch
-[submodule "frozen/Adafruit_CircuitPython_DS3231"]
-	path = frozen/Adafruit_CircuitPython_DS3231
-	url = https://github.com/adafruit/Adafruit_CircuitPython_DS3231
-[submodule "frozen/Adafruit_CircuitPython_DRV2605"]
-	path = frozen/Adafruit_CircuitPython_DRV2605
-	url = https://github.com/adafruit/Adafruit_CircuitPython_DRV2605
-[submodule "frozen/Adafruit_CircuitPython_BLE"]
-	path = frozen/Adafruit_CircuitPython_BLE
-	url = https://github.com/adafruit/Adafruit_CircuitPython_BLE
-[submodule "frozen/Adafruit_CircuitPython_BLE_Apple_Notification_Center"]
-	path = frozen/Adafruit_CircuitPython_BLE_Apple_Notification_Center
-	url = https://github.com/adafruit/Adafruit_CircuitPython_BLE_Apple_Notification_Center
-[submodule "frozen/Adafruit_CircuitPython_RFM9x"]
-	path = frozen/Adafruit_CircuitPython_RFM9x
-	url = https://github.com/adafruit/Adafruit_CircuitPython_RFM9x.git
-[submodule "frozen/Adafruit_CircuitPython_RFM69"]
-	path = frozen/Adafruit_CircuitPython_RFM69
-	url = https://github.com/adafruit/Adafruit_CircuitPython_RFM69.git
-[submodule "ports/esp32s2/esp-idf"]
-	path = ports/esp32s2/esp-idf
-	url = https://github.com/adafruit/esp-idf.git
-[submodule "ports/esp32s2/certificates/nina-fw"]
-	path = ports/esp32s2/certificates/nina-fw
-	url = https://github.com/adafruit/nina-fw.git
-[submodule "frozen/Adafruit_CircuitPython_ST7789"]
-	path = frozen/Adafruit_CircuitPython_ST7789
-	url = https://github.com/adafruit/Adafruit_CircuitPython_ST7789
-[submodule "frozen/Adafruit_CircuitPython_Display_Shapes"]
-	path = frozen/Adafruit_CircuitPython_Display_Shapes
-	url = https://github.com/adafruit/Adafruit_CircuitPython_Display_Shapes
-[submodule "frozen/Adafruit_CircuitPython_Display_Text"]
-	path = frozen/Adafruit_CircuitPython_Display_Text
-	url = https://github.com/adafruit/Adafruit_CircuitPython_Display_Text
-[submodule "frozen/Adafruit_CircuitPython_ProgressBar"]
-	path = frozen/Adafruit_CircuitPython_ProgressBar
-	url = https://github.com/adafruit/Adafruit_CircuitPython_ProgressBar
-[submodule "frozen/Adafruit_CircuitPython_LC709203F"]
-	path = frozen/Adafruit_CircuitPython_LC709203F
-	url = https://github.com/adafruit/Adafruit_CircuitPython_LC709203F
-[submodule "frozen/Adafruit_CircuitPython_SimpleMath"]
-	path = frozen/Adafruit_CircuitPython_SimpleMath
-	url = https://github.com/adafruit/Adafruit_CircuitPython_SimpleMath
-[submodule "ports/raspberrypi/sdk"]
-	path = ports/raspberrypi/sdk
-	url = https://github.com/adafruit/pico-sdk.git
-[submodule "data/nvm.toml"]
-	path = data/nvm.toml
-	url = https://github.com/adafruit/nvm.toml.git
-	branch = main
-[submodule "frozen/Adafruit_CircuitPython_MIDI"]
-	path = frozen/Adafruit_CircuitPython_MIDI
-	url = https://github.com/adafruit/Adafruit_CircuitPython_MIDI

.mailmap

@@ -1,112 +0,0 @@
-# SPDX-FileCopyrightText: 2020 Diego Elio Pettenò
-#
-# SPDX-License-Identifier: Unlicense
-
-Alexander Steffen <devel.20.webmeister@spamgourmet.com>
-Alexander Steffen <devel.20.webmeister@spamgourmet.com> <Alexander.Steffen@infineon.com>
-Alexander Steffen <devel.20.webmeister@spamgourmet.com> <webmeister@users.noreply.github.com>
-Benjamin Vernoux <bvernoux@gmail.com>
-Brent Rubell <robots199@me.com>
-Brent Rubell <robots199@me.com> <brent@xn.home>
-Brent Rubell <robots199@me.com> <brentru@users.noreply.github.com>
-Carlos <carlos.santiago.diaz@gmail.com>
-Chris Packham <judge.packham@gmail.com>
-Chris Packham <judge.packham@gmail.com> <chris.packham@alliedtelesis.co.nz>
-Damiano Mazzella <damianomazzella@gmail.com>
-Damien George <damien.p.george@gmail.com>
-Dan Halbert <halbert@adafruit.com>
-Dan Halbert <halbert@adafruit.com> <halbert@halwitz.org>
-Daniel Pollard <daniel@learnweaver.com>
-Daniel Pollard <daniel@learnweaver.com> <daniel.pollard@learnweaver.com>
-Daniel Tralamazza <daniel@tralamazza.com>
-Daniel Tralamazza <daniel@tralamazza.com> <tralamazza@users.noreply.github.com>
-David Glaude <david.glaude@gmail.com>
-David Glaude <david.glaude@gmail.com> <dglaude@users.noreply.github.com>
-George Waters <gwatersdev@gmail.com>
-George Waters <gwatersdev@gmail.com> <george@georgeh2os.com>
-Ha Thach <thach@tinyusb.org>
-Henrik Sölver <henrik.solver@gmail.com>
-Ilya Dmitrichenko <errordeveloper@gmail.com>
-Ilya Dmitrichenko <errordeveloper@gmail.com> <ilya@xively.com>
-Jason Pecor <14111408+jpecor@users.noreply.github.com>
-Jeff Epler <jepler@gmail.com>
-Jeff Epler <jepler@gmail.com> <jeff@adafruit.com>
-Jeff Epler <jepler@gmail.com> <jepler@de11.u>
-Jeff Epler <jepler@gmail.com> <jepler@unpythonic.net>
-Jerry Needell <jerryneedell@gmail.com>
-Joe Bakalor <jmbakalor@gmail.com>
-Josh Klar <josh@klar.sh>
-Josh Klar <josh@klar.sh> <j@iv597.com>
-Juan Biondi <juanernestobiondi@gmail.com>
-Juan Biondi <juanernestobiondi@gmail.com> <juanernestobiondi@hotmail.com>
-KalbeAbbas <kalbeabbas142@gmail.com>
-KalbeAbbas <kalbeabbas142@gmail.com> <kalbeabbas@142@gmail.com>
-Kamil Tomaszewski <kamil.tomaszewski@sony.com>
-Kamil Tomaszewski <kamil.tomaszewski@sony.com> <46525824+kamtom480@users.noreply.github.com>
-Kattni <kattni@adafruit.com> <kattni@kittyfish.org>
-Kattni Rembor <kattni@adafruit.com>
-Kenny <WarriorOfWire@users.noreply.github.com>
-Kenny <WarriorOfWire@users.noreply.github.com> <3454741+WarriorOfWire@users.noreply.github.com>
-Kevin Townsend <contact@microbuilder.eu>
-Kevin Townsend <contact@microbuilder.eu> <microbuilder@users.noreply.github.com>
-Krzysztof Blazewicz <blazewicz.krzysztof@gmail.com>
-Krzysztof Blazewicz <blazewicz.krzysztof@gmail.com> <krzysztof.blazewicz@uxeon.com>
-Li Weiwei <liweiwei@yeweitech.org>
-Li Weiwei <liweiwei@yeweitech.org> <liweiwei@yeweitech.com>
-Limor "Ladyada" Fried <limor@ladyada.net>
-Limor "Ladyada" Fried <limor@ladyada.net> <ladyada>
-Lucian Copeland <hierophect@gmail.com>
-Lucian Copeland <hierophect@gmail.com> <hierophect@Lucians-MacBook-Air-2.local>
-Mark Olsson <post@markolsson.se>
-Mark Olsson <post@markolsson.se> <mark@markolsson.se>
-Matt Land <matt-land@users.noreply.github.com>
-Matt Land <matt-land@users.noreply.github.com> <mland@sparefoot.com>
-Matt Wozniski <godlygeek+git@gmail.com>
-Matt Wozniski <godlygeek+git@gmail.com> <mwozniski@bloomberg.net>
-Melissa LeBlanc-Williams <melissa@adafruit.com>
-Melissa LeBlanc-Williams <melissa@adafruit.com> <melissa@melissagirl.com>
-Metallicow <metaliobovinus@gmail.com>
-Metallicow <metaliobovinus@gmail.com> <edg62702@yahoo.com>
-Peter Hinch <peter@hinch.me.uk>
-Peter Hinch <peter@hinch.me.uk> <peterhinch@users.noreply.github.com>
-Radomir Dopieralski <openstack@sheep.art.pl>
-Radomir Dopieralski <openstack@sheep.art.pl> <deshipu@users.noreply.github.com>
-Rafa Gould <rafagoulds@gmail.com>
-Rafa Gould <rafagoulds@gmail.com> <50337143+rafa-gould@users.noreply.github.com>
-Ryan Shaw <ryan.shaw@wisetechglobal.com>
-Ryan Shaw <ryan.shaw@wisetechglobal.com> <ryannathans@hotmail.com>
-Sabas <s@electroniccats.com>
-Sabas <s@electroniccats.com> <s@theinventorhouse.org>
-Sabas <s@electroniccats.com> <sabasjimenez@gmail.com>
-Scott Shawcroft <scott@adafruit.com>
-Scott Shawcroft <scott@adafruit.com> <devnull@unpythonic.net>
-Scott Shawcroft <scott@adafruit.com> <scott.shawcroft@gmail.com>
-Scott Shawcroft <scott@adafruit.com> <scott@chickadee.tech>
-Scott Shawcroft <scott@adafruit.com> <scott@tannewt.org>
-Sebastian Plamauer <oeplse@gmail.com>
-Sebastian Plamauer <oeplse@gmail.com> <oepse@gmail.com>
-Senuros <Senuros@users.noreply.github.com>
-Senuros <Senuros@users.noreply.github.com> <senuros@noreply.github.com>
-Stewart Colborne <tscolborne@outlook.com>
-Stewart Colborne <tscolborne@outlook.com> <tscolborne@hotmail.com>
-TG-Techie <TGTechie01@gmail.com>
-TG-Techie <TGTechie01@gmail.com> <39284876+TG-Techie@users.noreply.github.com>
-Thea Flowers <me@thea.codes>
-Thea Flowers <me@thea.codes> <theaflowers@google.com>
-Tobias Badertscher <badi@baerospace.ch>
-Tobias Badertscher <badi@baerospace.ch> <python@baerospace.ch>
-danicampora <danicampora@gmail.com>
-danicampora <danicampora@gmail.com> <daniel@wipy.io>
-dherrada <dylan.herrada@gmail.com>
-dherrada <dylan.herrada@gmail.com> <33632497+dherrada@users.noreply.github.com>
-dherrada <dylan.herrada@gmail.com> <=>
-glennrub <glennbakke@gmail.com>
-retoc <retoc@users.noreply.github.com>
-retoc <retoc@users.noreply.github.com> <Retoc@noreply.github.com>
-siddacious <nospam187+github@gmail.com>
-siddacious <nospam187+github@gmail.com> <bsiepert@gmail.com>
-siddacious <nospam187+github@gmail.com> <bsiepert@lbl.gov>
-sommersoft <sommersoft@gmail.com>
-sommersoft <sommersoft@gmail.com> <sommersoft@users.noreply.github.com>
-stijn <stijn@ignitron.net>
-stijn <stijn@ignitron.net> <stinos@zoho.com>

.pre-commit-config.yaml

@@ -1,26 +0,0 @@
-# SPDX-FileCopyrightText: 2020 Diego Elio Pettenò
-#
-# SPDX-License-Identifier: Unlicense
-
-repos:
--   repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: v2.3.0
-    hooks:
-    -   id: check-yaml
-    -   id: end-of-file-fixer
-        exclude: '^(tests/.*\.exp|tests/cmdline/.*|tests/.*/data/.*|ports/esp32s2/esp-idf-config/.*|ports/esp32s2/boards/.*/sdkconfig)'
-    -   id: trailing-whitespace
-        exclude: '^(tests/.*\.exp|tests/cmdline/.*|tests/.*/data/.*)'
--   repo: local
-    hooks:
-    -   id: translations
-        name: Translations
-        entry: sh -c "if ! make check-translate; then make translate; fi"
-        types: [c]
-        pass_filenames: false
-        language: system
-    -   id: formatting
-        name: Formatting
-        entry: python3 tools/codeformat.py
-        types_or: [c, python]
-        language: system

.readthedocs.yml

@@ -1,21 +1,2 @@
-# SPDX-FileCopyrightText: 2014 MicroPython & CircuitPython contributors (https://github.com/adafruit/circuitpython/graphs/contributors)
-#
-# SPDX-License-Identifier: MIT
-
-# .readthedocs.yml
-# Read the Docs configuration file
-# See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
-
-version: 2
-
-submodules:
-    include:
-        - extmod/ulab
-
-formats:
-  - pdf
-
 python:
     version: 3
-    install:
-        - requirements: docs/requirements.txt

.rosie.yml

@@ -1,7 +1,3 @@
-# SPDX-FileCopyrightText: 2014 MicroPython & CircuitPython contributors (https://github.com/adafruit/circuitpython/graphs/contributors)
-#
-# SPDX-License-Identifier: MIT
-
 # This configuration file tells Rosie where to find prebuilt .bin files (Travis
 # builds them) and where to find the tests.
 
@@ -10,7 +6,7 @@ binaries:
         bucket: adafruit-circuit-python
         file_pattern: bin/{board}/adafruit-circuitpython-{board}-*-{short_sha}.{extension}
     rosie_upload:
-        file_pattern: adafruit-circuitpython-{board}-*{short_sha}.{extension}
+        file_pattern: adafruit-circuitpython-{board}*{short_sha}.{extension}
 
 circuitpython_tests:
     test_directories:

.travis.yml

@@ -0,0 +1,111 @@
+sudo: required
+dist: trusty
+language: c
+compiler:
+  - gcc
+env:
+  - TRAVIS_BOARD=arduino_zero
+  - TRAVIS_BOARD=circuitplayground_express
+  - TRAVIS_BOARD=feather_m0_basic
+  - TRAVIS_BOARD=feather_m0_adalogger
+  - TRAVIS_BOARD=feather_m0_rfm69
+  - TRAVIS_BOARD=feather_m0_rfm9x
+  - TRAVIS_BOARD=feather_m0_express
+  - TRAVIS_BOARD=feather_m4_express
+  - TRAVIS_BOARD=itsybitsy_m0_express
+  - TRAVIS_BOARD=metro_m0_express
+  - TRAVIS_BOARD=metro_m4_express
+  - TRAVIS_BOARD=metro_m4_express_revb
+  - TRAVIS_BOARD=trinket_m0
+  - TRAVIS_BOARD=gemma_m0
+  - TRAVIS_BOARD=feather52
+  - TRAVIS_TEST=qemu
+  - TRAVIS_TEST=unix
+  - TRAVIS_TEST=docs
+
+addons:
+  artifacts:
+    paths:
+    - $(ls -d1 bin/*/* | tr "\n" ":")
+    target_paths: /
+
+notifications:
+  webhooks:
+    urls:
+      - https://rosie-ci.ngrok.io/travis
+    on_success: always
+    on_failure: always
+    on_start: always
+    on_cancel: always
+    on_error: always
+
+before_script:
+  - sudo dpkg --add-architecture i386
+  - sudo apt-get install -y python3 gcc-multilib pkg-config libffi-dev libffi-dev:i386 qemu-system
+  - ([[ -z "$TRAVIS_TEST" ]] || sudo apt-get install -y qemu-system)
+  - ([[ -z "$TRAVIS_BOARD" ]] || (wget https://s3.amazonaws.com/adafruit-circuit-python/gcc-arm-embedded_7-2017q4-1~trusty3_amd64.deb && sudo dpkg -i gcc-arm-embedded*_amd64.deb))
+  - ([[ $TRAVIS_TEST != "qemu" ]] || (wget https://s3.amazonaws.com/adafruit-circuit-python/gcc-arm-embedded_7-2017q4-1~trusty3_amd64.deb && sudo dpkg -i gcc-arm-embedded*_amd64.deb))
+
+  # For teensy build
+  - sudo apt-get install realpath
+  # For nrf builds
+  - ([[ $TRAVIS_BOARD != "feather52" ]] || sudo ports/nrf/drivers/bluetooth/download_ble_stack.sh)
+  # For coverage testing (upgrade is used to get latest urllib3 version)
+  - ([[ -z "$TRAVIS_TEST" ]] || sudo pip install --upgrade cpp-coveralls)
+  - ([[ $TRAVIS_TEST != "docs" ]] || sudo pip install Sphinx sphinx-rtd-theme recommonmark)
+  - gcc --version
+  - ([[ -z "$TRAVIS_BOARD" ]] || arm-none-eabi-gcc --version)
+  - python3 --version
+
+script:
+  # Build mpy-cross first because other builds depend on it.
+  - echo 'Building mpy-cross' && echo -en 'travis_fold:start:mpy-cross\\r'
+  - make -C mpy-cross
+  - echo -en 'travis_fold:end:mpy-cross\\r'
+
+  - echo 'Building Adafruit binaries' && echo -en 'travis_fold:start:adafruit-bins\\r'
+  - ([[ -z "$TRAVIS_BOARD" ]] || tools/build_adafruit_bins.sh)
+  - echo -en 'travis_fold:end:adafruit-bins\\r'
+
+  - echo 'Building unix' && echo -en 'travis_fold:start:unix\\r'
+  - ([[ $TRAVIS_TEST != "unix" ]] || make -C ports/unix deplibs)
+  - ([[ $TRAVIS_TEST != "unix" ]] || make -C ports/unix)
+  - ([[ $TRAVIS_TEST != "unix" ]] || make -C ports/unix coverage)
+  - echo -en 'travis_fold:end:unix\\r'
+
+  - echo 'Building qemu' && echo -en 'travis_fold:start:qemu\\r'
+  - ([[ $TRAVIS_TEST != "qemu" ]] || make -C ports/qemu-arm test)
+  - echo -en 'travis_fold:end:qemu\\r'
+
+  # run tests without coverage info
+  #- (cd tests && MICROPY_CPYTHON3=python3.4 ./run-tests)
+  #- (cd tests && MICROPY_CPYTHON3=python3.4 ./run-tests --emit native)
+
+  # run tests with coverage info
+  - echo 'Test all' && echo -en 'travis_fold:start:test_all\\r'
+  - ([[ $TRAVIS_TEST != "unix" ]] || (cd tests && MICROPY_CPYTHON3=python3.4 MICROPY_MICROPYTHON=../ports/unix/micropython_coverage ./run-tests))
+  - echo -en 'travis_fold:end:test_all\\r'
+
+  - echo 'Test threads' && echo -en 'travis_fold:start:test_threads\\r'
+  - ([[ $TRAVIS_TEST != "unix" ]] || (cd tests && MICROPY_CPYTHON3=python3.4 MICROPY_MICROPYTHON=../ports/unix/micropython_coverage ./run-tests -d thread))
+  - echo -en 'travis_fold:end:test_threads\\r'
+
+  - echo 'Testing with native' && echo -en 'travis_fold:start:test_native\\r'
+  - ([[ $TRAVIS_TEST != "unix" ]] || (cd tests && MICROPY_CPYTHON3=python3.4 MICROPY_MICROPYTHON=../ports/unix/micropython_coverage ./run-tests --emit native))
+  - echo -en 'travis_fold:end:test_native\\r'
+
+  - (echo 'Testing with mpy' && echo -en 'travis_fold:start:test_mpy\\r')
+  - ([[ $TRAVIS_TEST != "unix" ]] || (cd tests && MICROPY_CPYTHON3=python3.4 MICROPY_MICROPYTHON=../ports/unix/micropython_coverage ./run-tests --via-mpy -d basics float))
+  - echo -en 'travis_fold:end:test_mpy\\r'
+
+  - (echo 'Building docs' && echo -en 'travis_fold:start:build_docs\\r')
+  - ([[ $TRAVIS_TEST != "docs" ]] || sphinx-build -E -W -b html . _build/html)
+  - echo -en 'travis_fold:end:build_docs\\r'
+
+
+  # run coveralls coverage analysis (try to, even if some builds/tests failed)
+  #- (cd ports/unix && coveralls --root ../.. --build-root . --gcov $(which gcov) --gcov-options '\-o build-coverage/' --include py --include extmod)
+
+after_failure:
+  - (cd tests && for exp in *.exp; do testbase=$(basename $exp .exp); echo -e "\nFAILURE $testbase"; diff -u $testbase.exp $testbase.out; done)
+  - (grep "FAIL" ports/qemu-arm/build/console.out)

ACKNOWLEDGEMENTS

@@ -762,6 +762,7 @@ today.  The names appear in order of pledging.
  1642 Udine
  1643 Simon Critchley
  1644 Sven Haiges, Germany
+ 1645 Yi Qing Sim
  1646 "silicium" ("silicium_one", if "silicium" is busy)
  1648 Andy O'Malia, @andyomalia
  1650 RedCamelApps.com

ACKNOWLEDGEMENTS.license

@@ -1,3 +0,0 @@
-SPDX-FileCopyrightText: 2014 MicroPython & CircuitPython contributors (https://github.com/adafruit/circuitpython/graphs/contributors)
-
-SPDX-License-Identifier: MIT

BUILDING.md

@@ -1,107 +0,0 @@
-<!--
-SPDX-FileCopyrightText: 2014 MicroPython & CircuitPython contributors (https://github.com/adafruit/circuitpython/graphs/contributors)
-
-SPDX-License-Identifier: MIT
--->
-
-# Building CircuitPython
-
-Welcome to CircuitPython!
-
-This document is a quick-start guide only.
-
-Detailed guides on how to build CircuitPython can be found in the Adafruit Learn system at
-https://learn.adafruit.com/building-circuitpython/
-
-## Setup
-
-Please ensure you setup your build environment appropriately, as per the guide.  You will need:
-
-* Linux: https://learn.adafruit.com/building-circuitpython/linux
-* MacOS: https://learn.adafruit.com/building-circuitpython/macos
-* Windows Subsystem for Linux (WSL): https://learn.adafruit.com/building-circuitpython/windows-subsystem-for-linux
-
-### Submodules
-
-This project has a bunch of git submodules.  You will need to update them regularly.
-
-    git submodule sync
-    git submodule update --init
-
-### mpy-cross
-
-As part of the build process, mpy-cross is needed to compile .py files into .mpy files.
-To compile (or recompile) mpy-cross:
-
-    make -C mpy-cross
-
-# Building
-
-There a number of ports of CircuitPython!  To build for your board, change to the appropriate ports directory and build.
-
-Examples:
-
-    cd ports/atmel-samd
-    make BOARD=circuitplayground_express
-
-    cd ports/nrf
-    make BOARD=circuitplayground_bluefruit
-
-If you aren't sure what boards exist, have a peek in the boards subdirectory of your port.
-If you have a fast computer with many cores, consider adding `-j` to your build flags, such as `-j17` on
-a 6-core 12-thread machine.
-
-# Testing
-
-If you are working on changes to the core language, you might find it useful to run the test suite.
-The test suite in the top level `tests` directory.  It needs the unix port to run.
-
-    cd ports/unix
-    make axtls
-    make micropython
-
-Then you can run the test suite:
-
-    cd ../../tests
-    ./run-tests
-
-A successful run will say something like
-
-    676 tests performed (19129 individual testcases)
-    676 tests passed
-    30 tests skipped: buffered_writer builtin_help builtin_range_binop class_delattr_setattr cmd_parsetree extra_coverage framebuf1 framebuf16 framebuf2 framebuf4 framebuf8 framebuf_subclass mpy_invalid namedtuple_asdict non_compliant resource_stream schedule sys_getsizeof urandom_extra ure_groups ure_span ure_sub ure_sub_unmatched vfs_basic vfs_fat_fileio1 vfs_fat_fileio2 vfs_fat_more vfs_fat_oldproto vfs_fat_ramdisk vfs_userfs
-
-# Debugging
-
-The easiest way to debug CircuitPython on hardware is with a JLink device, JLinkGDBServer, and an appropriate GDB.
-Instructions can be found at https://learn.adafruit.com/debugging-the-samd21-with-gdb
-
-If using JLink, you'll need both the `JLinkGDBServer` and `arm-none-eabi-gdb` running.
-
-Example:
-
-    JLinkGDBServer -if SWD -device ATSAMD51J19
-    arm-none-eabi-gdb build-metro_m4_express/firmware.elf -iex "target extended-remote :2331"
-
-If your port/build includes `arm-none-eabi-gdb-py`, consider using it instead, as it can be used for better register
-debugging with https://github.com/bnahill/PyCortexMDebug
-
-# Code Quality Checks
-
-We apply code quality checks using pre-commit.  Install pre-commit once per system with
-
-    python3 -mpip install pre-commit
-
-Activate it once per git clone with
-
-    pre-commit --install
-
-Pre-commit also requires some additional programs to be installed through your package manager:
-
- * Standard Unix tools such as make, find, etc
- * The gettext package, any modern version
- * uncrustify version 0.71 (0.72 is also tested)
-
-Each time you create a git commit, the pre-commit quality checks will be run.  You can also run them e.g., with `pre-commit run foo.c` or `pre-commit run --all` to run on all files whether modified or not.
-
-Some pre-commit quality checks require your active attention to resolve, others (such as the formatting checks of uncrustify) are made automatically and must simply be incorporated into your code changes by committing them.

CODE_OF_CONDUCT.md

@@ -1,135 +1,74 @@
-<!--
-SPDX-FileCopyrightText: 2014 Coraline Ada Ehmke
-SPDX-FileCopyrightText: 2019 Kattni Rembor for Adafruit Industries
-
-SPDX-License-Identifier: CC-BY-4.0
--->
-# Adafruit Community Code of Conduct
+# Contributor Covenant Code of Conduct
 
 ## Our Pledge
 
 In the interest of fostering an open and welcoming environment, we as
-contributors and leaders pledge to making participation in our project and
+contributors and maintainers pledge to making participation in our project and
 our community a harassment-free experience for everyone, regardless of age, body
-size, disability, ethnicity, gender identity and expression, level or type of
-experience, education, socio-economic status, nationality, personal appearance,
-race, religion, or sexual identity and orientation.
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
 
 ## Our Standards
 
-We are committed to providing a friendly, safe and welcoming environment for
-all.
-
 Examples of behavior that contributes to creating a positive environment
 include:
 
-* Be kind and courteous to others
 * Using welcoming and inclusive language
 * Being respectful of differing viewpoints and experiences
-* Collaborating with other community members
 * Gracefully accepting constructive criticism
 * Focusing on what is best for the community
 * Showing empathy towards other community members
 
 Examples of unacceptable behavior by participants include:
 
-* The use of sexualized language or imagery and sexual attention or advances
-* The use of inappropriate images, including in a community member's avatar
-* The use of inappropriate language, including in a community member's nickname
-* Any spamming, flaming, baiting or other attention-stealing behavior
-* Excessive or unwelcome helping; answering outside the scope of the question
-  asked
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
 * Trolling, insulting/derogatory comments, and personal or political attacks
-* Promoting or spreading disinformation, lies, or conspiracy theories against
-  a person, group, organisation, project, or community
 * Public or private harassment
 * Publishing others' private information, such as a physical or electronic
   address, without explicit permission
-* Other conduct which could reasonably be considered inappropriate
-
-The goal of the standards and moderation guidelines outlined here is to build
-and maintain a respectful community. We ask that you don’t just aim to be
-"technically unimpeachable", but rather try to be your best self.
-
-We value many things beyond technical expertise, including collaboration and
-supporting others within our community. Providing a positive experience for
-other community members can have a much more significant impact than simply
-providing the correct answer.
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
 
 ## Our Responsibilities
 
-Project leaders are responsible for clarifying the standards of acceptable
+Project maintainers are responsible for clarifying the standards of acceptable
 behavior and are expected to take appropriate and fair corrective action in
 response to any instances of unacceptable behavior.
 
-Project leaders have the right and responsibility to remove, edit, or
-reject messages, comments, commits, code, issues, and other contributions
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
 that are not aligned to this Code of Conduct, or to ban temporarily or
-permanently any community member for other behaviors that they deem
-inappropriate, threatening, offensive, or harmful.
-
-## Moderation
-
-Instances of behaviors that violate the Adafruit Community Code of Conduct
-may be reported by any member of the community. Community members are
-encouraged to report these situations, including situations they witness
-involving other community members.
-
-You may report in the following ways:
-
-In any situation, you may send an email to <support@adafruit.com>.
-
-On the Adafruit Discord, you may send an open message from any channel
-to all Community Moderators by tagging @community moderators. You may
-also send an open message from any channel, or a direct message to
-@kattni#1507, @tannewt#4653, @danh#1614, @cater#2442,
-@sommersoft#0222, @Mr. Certainly#0472 or @Andon#8175.
-
-Email and direct message reports will be kept confidential.
-
-In situations on Discord where the issue is particularly egregious, possibly
-illegal, requires immediate action, or violates the Discord terms of service,
-you should also report the message directly to Discord.
-
-These are the steps for upholding our community’s standards of conduct.
-
-1. Any member of the community may report any situation that violates the
-Adafruit Community Code of Conduct. All reports will be reviewed and
-investigated.
-2. If the behavior is an egregious violation, the community member who
-committed the violation may be banned immediately, without warning.
-3. Otherwise, moderators will first respond to such behavior with a warning.
-4. Moderators follow a soft "three strikes" policy - the community member may
-be given another chance, if they are receptive to the warning and change their
-behavior.
-5. If the community member is unreceptive or unreasonable when warned by a
-moderator, or the warning goes unheeded, they may be banned for a first or
-second offense. Repeated offenses will result in the community member being
-banned.
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
 
 ## Scope
 
-This Code of Conduct and the enforcement policies listed above apply to all
-Adafruit Community venues. This includes but is not limited to any community
-spaces (both public and private), the entire Adafruit Discord server, and
-Adafruit GitHub repositories. Examples of Adafruit Community spaces include
-but are not limited to meet-ups, audio chats on the Adafruit Discord, or
-interaction at a conference.
-
 This Code of Conduct applies both within project spaces and in public spaces
-when an individual is representing the project or its community. As a community
-member, you are representing our community, and are expected to behave
-accordingly.
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at support@adafruit.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
 
 ## Attribution
 
-This Code of Conduct is adapted from the [Contributor Covenant][homepage],
-version 1.4, available at
-<https://www.contributor-covenant.org/version/1/4/code-of-conduct.html>,
-and the [Rust Code of Conduct](https://www.rust-lang.org/en-US/conduct.html).
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
 
-For other projects adopting the Adafruit Community Code of
-Conduct, please contact the maintainers of those projects for enforcement.
-If you wish to use this code of conduct for your own project, consider
-explicitly mentioning your moderation policy or making a copy with your
-own moderation policy so as to avoid confusion.
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

CONTRIBUTING.md

@@ -1,16 +1,16 @@
-<!--
-SPDX-FileCopyrightText: 2014 MicroPython & CircuitPython contributors (https://github.com/adafruit/circuitpython/graphs/contributors)
-
-SPDX-License-Identifier: MIT
--->
-
 # Contributing
 Please note that this project is released with a
-[Contributor Code of Conduct](CODE_OF_CONDUCT.md).
+[Contributor Code of Conduct](https://github.com/adafruit/circuitpython/blob/master/CODE_OF_CONDUCT.md).
 By participating in this project you agree to abide by its terms. Participation
 covers any forum used to converse about CircuitPython including unofficial and official spaces. Failure to do
 so will result in corrective actions such as time out or ban from the project.
 
+## Developer contact
+[@tannewt](https://github.com/tannewt) is the main developer of CircuitPython
+and is sponsored by [Adafruit Industries LLC](https://adafruit.com). He is
+reachable on [Discord](https://adafru.it/discord) as tannewt during US West Coast
+working hours. He also checks GitHub issues and the [Adafruit support forum](https://forums.adafruit.com/viewforum.php?f=60).
+
 ## Licensing
 By contributing to this repository you are certifying that you have all necessary
 permissions to license the code under an MIT License. You still retain the
@@ -20,31 +20,6 @@ If you have an employment contract with your employer please make sure that they
 don't automatically own your work product. Make sure to get any necessary approvals
 before contributing. Another term for this contribution off-hours is moonlighting.
 
-## Ways to contribute
-As CircuitPython grows, there are more and more ways to contribute. Here are some ideas:
-
-* Build a project with CircuitPython and share how to do it online.
-* Test the latest libraries and CircuitPython versions with your projects and file issues for any bugs you find.
-* Contribute Python code to CircuitPython libraries that support new devices or features of an existing device.
-* Contribute C code to CircuitPython which fixes an open issue or adds a new feature.
-
-## Getting started with C
-CircuitPython developer Dan Halbert (@dhalbert) has written up build instructions using native build
-tools [here](https://learn.adafruit.com/building-circuitpython).
-
-For SAMD21 debugging workflow tips check out [this learn guide](https://learn.adafruit.com/debugging-the-samd21-with-gdb) from Scott (@tannewt).
-
-## Developer contacts
-Scott Shawcroft ([@tannewt](https://github.com/tannewt)) is the lead developer of CircuitPython
-and is sponsored by [Adafruit Industries LLC](https://adafruit.com). Scott is usually available
-during US West Coast working hours. Dan Halbert ([@dhalbert](https://github.com/dhalbert)) and
-Kattni Rembor ([@kattni](https://github.com/kattni)) are also sponsored by [Adafruit Industries
- LLC](https://adafruit.com) and are usually available during US East Coast daytime hours including
-some weekends.
-
-They are all reachable on [Discord](https://adafru.it/discord), GitHub issues and the [Adafruit
-support forum](https://forums.adafruit.com/viewforum.php?f=60).
-
 ## Code guidelines
 We aim to keep our code and commit style compatible with MicroPython upstream.
 Please review their

LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2013-2019 Damien P. George
+Copyright (c) 2013, 2014 Damien P. George
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

LICENSES/BSD-3-Clause.txt

@@ -1,26 +0,0 @@
-Copyright (c) <year> <owner>. All rights reserved.
-
-Redistribution and use in source and binary forms, with or without modification,
-are permitted provided that the following conditions are met:
-
-1. Redistributions of source code must retain the above copyright notice,
-this list of conditions and the following disclaimer.
-
-2. Redistributions in binary form must reproduce the above copyright notice,
-this list of conditions and the following disclaimer in the documentation
-and/or other materials provided with the distribution.
-
-3. Neither the name of the copyright holder nor the names of its contributors
-may be used to endorse or promote products derived from this software without
-specific prior written permission.
-
-THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
-IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
-ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
-LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
-DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
-SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
-CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
-OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE
-USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

LICENSES/CC-BY-4.0.txt

@@ -1,324 +0,0 @@
-Creative Commons Attribution 4.0 International Creative Commons Corporation
-("Creative Commons") is not a law firm and does not provide legal services
-or legal advice. Distribution of Creative Commons public licenses does not
-create a lawyer-client or other relationship. Creative Commons makes its licenses
-and related information available on an "as-is" basis. Creative Commons gives
-no warranties regarding its licenses, any material licensed under their terms
-and conditions, or any related information. Creative Commons disclaims all
-liability for damages resulting from their use to the fullest extent possible.
-
-Using Creative Commons Public Licenses
-
-Creative Commons public licenses provide a standard set of terms and conditions
-that creators and other rights holders may use to share original works of
-authorship and other material subject to copyright and certain other rights
-specified in the public license below. The following considerations are for
-informational purposes only, are not exhaustive, and do not form part of our
-licenses.
-
-Considerations for licensors: Our public licenses are intended for use by
-those authorized to give the public permission to use material in ways otherwise
-restricted by copyright and certain other rights. Our licenses are irrevocable.
-Licensors should read and understand the terms and conditions of the license
-they choose before applying it. Licensors should also secure all rights necessary
-before applying our licenses so that the public can reuse the material as
-expected. Licensors should clearly mark any material not subject to the license.
-This includes other CC-licensed material, or material used under an exception
-or limitation to copyright. More considerations for licensors : wiki.creativecommons.org/Considerations_for_licensors
-
-Considerations for the public: By using one of our public licenses, a licensor
-grants the public permission to use the licensed material under specified
-terms and conditions. If the licensor's permission is not necessary for any
-reason–for example, because of any applicable exception or limitation to copyright–then
-that use is not regulated by the license. Our licenses grant only permissions
-under copyright and certain other rights that a licensor has authority to
-grant. Use of the licensed material may still be restricted for other reasons,
-including because others have copyright or other rights in the material. A
-licensor may make special requests, such as asking that all changes be marked
-or described. Although not required by our licenses, you are encouraged to
-respect those requests where reasonable. More considerations for the public
-: wiki.creativecommons.org/Considerations_for_licensees Creative Commons Attribution
-4.0 International Public License
-
-By exercising the Licensed Rights (defined below), You accept and agree to
-be bound by the terms and conditions of this Creative Commons Attribution
-4.0 International Public License ("Public License"). To the extent this Public
-License may be interpreted as a contract, You are granted the Licensed Rights
-in consideration of Your acceptance of these terms and conditions, and the
-Licensor grants You such rights in consideration of benefits the Licensor
-receives from making the Licensed Material available under these terms and
-conditions.
-
-Section 1 – Definitions.
-
-a. Adapted Material means material subject to Copyright and Similar Rights
-that is derived from or based upon the Licensed Material and in which the
-Licensed Material is translated, altered, arranged, transformed, or otherwise
-modified in a manner requiring permission under the Copyright and Similar
-Rights held by the Licensor. For purposes of this Public License, where the
-Licensed Material is a musical work, performance, or sound recording, Adapted
-Material is always produced where the Licensed Material is synched in timed
-relation with a moving image.
-
-b. Adapter's License means the license You apply to Your Copyright and Similar
-Rights in Your contributions to Adapted Material in accordance with the terms
-and conditions of this Public License.
-
-c. Copyright and Similar Rights means copyright and/or similar rights closely
-related to copyright including, without limitation, performance, broadcast,
-sound recording, and Sui Generis Database Rights, without regard to how the
-rights are labeled or categorized. For purposes of this Public License, the
-rights specified in Section 2(b)(1)-(2) are not Copyright and Similar Rights.
-
-d. Effective Technological Measures means those measures that, in the absence
-of proper authority, may not be circumvented under laws fulfilling obligations
-under Article 11 of the WIPO Copyright Treaty adopted on December 20, 1996,
-and/or similar international agreements.
-
-e. Exceptions and Limitations means fair use, fair dealing, and/or any other
-exception or limitation to Copyright and Similar Rights that applies to Your
-use of the Licensed Material.
-
-f. Licensed Material means the artistic or literary work, database, or other
-material to which the Licensor applied this Public License.
-
-g. Licensed Rights means the rights granted to You subject to the terms and
-conditions of this Public License, which are limited to all Copyright and
-Similar Rights that apply to Your use of the Licensed Material and that the
-Licensor has authority to license.
-
-h. Licensor means the individual(s) or entity(ies) granting rights under this
-Public License.
-
-i. Share means to provide material to the public by any means or process that
-requires permission under the Licensed Rights, such as reproduction, public
-display, public performance, distribution, dissemination, communication, or
-importation, and to make material available to the public including in ways
-that members of the public may access the material from a place and at a time
-individually chosen by them.
-
-j. Sui Generis Database Rights means rights other than copyright resulting
-from Directive 96/9/EC of the European Parliament and of the Council of 11
-March 1996 on the legal protection of databases, as amended and/or succeeded,
-as well as other essentially equivalent rights anywhere in the world.
-
-k. You means the individual or entity exercising the Licensed Rights under
-this Public License. Your has a corresponding meaning.
-
-Section 2 – Scope.
-
-   a. License grant.
-
-1. Subject to the terms and conditions of this Public License, the Licensor
-hereby grants You a worldwide, royalty-free, non-sublicensable, non-exclusive,
-irrevocable license to exercise the Licensed Rights in the Licensed Material
-to:
-
-         A. reproduce and Share the Licensed Material, in whole or in part; and
-
-         B. produce, reproduce, and Share Adapted Material.
-
-2. Exceptions and Limitations. For the avoidance of doubt, where Exceptions
-and Limitations apply to Your use, this Public License does not apply, and
-You do not need to comply with its terms and conditions.
-
-      3. Term. The term of this Public License is specified in Section 6(a).
-
-4. Media and formats; technical modifications allowed. The Licensor authorizes
-You to exercise the Licensed Rights in all media and formats whether now known
-or hereafter created, and to make technical modifications necessary to do
-so. The Licensor waives and/or agrees not to assert any right or authority
-to forbid You from making technical modifications necessary to exercise the
-Licensed Rights, including technical modifications necessary to circumvent
-Effective Technological Measures. For purposes of this Public License, simply
-making modifications authorized by this Section 2(a)(4) never produces Adapted
-Material.
-
-      5. Downstream recipients.
-
-A. Offer from the Licensor – Licensed Material. Every recipient of the Licensed
-Material automatically receives an offer from the Licensor to exercise the
-Licensed Rights under the terms and conditions of this Public License.
-
-B. No downstream restrictions. You may not offer or impose any additional
-or different terms or conditions on, or apply any Effective Technological
-Measures to, the Licensed Material if doing so restricts exercise of the Licensed
-Rights by any recipient of the Licensed Material.
-
-6. No endorsement. Nothing in this Public License constitutes or may be construed
-as permission to assert or imply that You are, or that Your use of the Licensed
-Material is, connected with, or sponsored, endorsed, or granted official status
-by, the Licensor or others designated to receive attribution as provided in
-Section 3(a)(1)(A)(i).
-
-   b. Other rights.
-
-1. Moral rights, such as the right of integrity, are not licensed under this
-Public License, nor are publicity, privacy, and/or other similar personality
-rights; however, to the extent possible, the Licensor waives and/or agrees
-not to assert any such rights held by the Licensor to the limited extent necessary
-to allow You to exercise the Licensed Rights, but not otherwise.
-
-2. Patent and trademark rights are not licensed under this Public License.
-
-3. To the extent possible, the Licensor waives any right to collect royalties
-from You for the exercise of the Licensed Rights, whether directly or through
-a collecting society under any voluntary or waivable statutory or compulsory
-licensing scheme. In all other cases the Licensor expressly reserves any right
-to collect such royalties.
-
-Section 3 – License Conditions.
-
-Your exercise of the Licensed Rights is expressly made subject to the following
-conditions.
-
-   a. Attribution.
-
-1. If You Share the Licensed Material (including in modified form), You must:
-
-A. retain the following if it is supplied by the Licensor with the Licensed
-Material:
-
-i. identification of the creator(s) of the Licensed Material and any others
-designated to receive attribution, in any reasonable manner requested by the
-Licensor (including by pseudonym if designated);
-
-            ii. a copyright notice;
-
-            iii. a notice that refers to this Public License;
-
-            iv. a notice that refers to the disclaimer of warranties;
-
-v. a URI or hyperlink to the Licensed Material to the extent reasonably practicable;
-
-B. indicate if You modified the Licensed Material and retain an indication
-of any previous modifications; and
-
-C. indicate the Licensed Material is licensed under this Public License, and
-include the text of, or the URI or hyperlink to, this Public License.
-
-2. You may satisfy the conditions in Section 3(a)(1) in any reasonable manner
-based on the medium, means, and context in which You Share the Licensed Material.
-For example, it may be reasonable to satisfy the conditions by providing a
-URI or hyperlink to a resource that includes the required information.
-
-3. If requested by the Licensor, You must remove any of the information required
-by Section 3(a)(1)(A) to the extent reasonably practicable.
-
-4. If You Share Adapted Material You produce, the Adapter's License You apply
-must not prevent recipients of the Adapted Material from complying with this
-Public License.
-
-Section 4 – Sui Generis Database Rights.
-
-Where the Licensed Rights include Sui Generis Database Rights that apply to
-Your use of the Licensed Material:
-
-a. for the avoidance of doubt, Section 2(a)(1) grants You the right to extract,
-reuse, reproduce, and Share all or a substantial portion of the contents of
-the database;
-
-b. if You include all or a substantial portion of the database contents in
-a database in which You have Sui Generis Database Rights, then the database
-in which You have Sui Generis Database Rights (but not its individual contents)
-is Adapted Material; and
-
-c. You must comply with the conditions in Section 3(a) if You Share all or
-a substantial portion of the contents of the database.
-
-For the avoidance of doubt, this Section 4 supplements and does not replace
-Your obligations under this Public License where the Licensed Rights include
-other Copyright and Similar Rights.
-
-Section 5 – Disclaimer of Warranties and Limitation of Liability.
-
-a. Unless otherwise separately undertaken by the Licensor, to the extent possible,
-the Licensor offers the Licensed Material as-is and as-available, and makes
-no representations or warranties of any kind concerning the Licensed Material,
-whether express, implied, statutory, or other. This includes, without limitation,
-warranties of title, merchantability, fitness for a particular purpose, non-infringement,
-absence of latent or other defects, accuracy, or the presence or absence of
-errors, whether or not known or discoverable. Where disclaimers of warranties
-are not allowed in full or in part, this disclaimer may not apply to You.
-
-b. To the extent possible, in no event will the Licensor be liable to You
-on any legal theory (including, without limitation, negligence) or otherwise
-for any direct, special, indirect, incidental, consequential, punitive, exemplary,
-or other losses, costs, expenses, or damages arising out of this Public License
-or use of the Licensed Material, even if the Licensor has been advised of
-the possibility of such losses, costs, expenses, or damages. Where a limitation
-of liability is not allowed in full or in part, this limitation may not apply
-to You.
-
-c. The disclaimer of warranties and limitation of liability provided above
-shall be interpreted in a manner that, to the extent possible, most closely
-approximates an absolute disclaimer and waiver of all liability.
-
-Section 6 – Term and Termination.
-
-a. This Public License applies for the term of the Copyright and Similar Rights
-licensed here. However, if You fail to comply with this Public License, then
-Your rights under this Public License terminate automatically.
-
-b. Where Your right to use the Licensed Material has terminated under Section
-6(a), it reinstates:
-
-1. automatically as of the date the violation is cured, provided it is cured
-within 30 days of Your discovery of the violation; or
-
-      2. upon express reinstatement by the Licensor.
-
-c. For the avoidance of doubt, this Section 6(b) does not affect any right
-the Licensor may have to seek remedies for Your violations of this Public
-License.
-
-d. For the avoidance of doubt, the Licensor may also offer the Licensed Material
-under separate terms or conditions or stop distributing the Licensed Material
-at any time; however, doing so will not terminate this Public License.
-
-   e. Sections 1, 5, 6, 7, and 8 survive termination of this Public License.
-
-Section 7 – Other Terms and Conditions.
-
-a. The Licensor shall not be bound by any additional or different terms or
-conditions communicated by You unless expressly agreed.
-
-b. Any arrangements, understandings, or agreements regarding the Licensed
-Material not stated herein are separate from and independent of the terms
-and conditions of this Public License.
-
-Section 8 – Interpretation.
-
-a. For the avoidance of doubt, this Public License does not, and shall not
-be interpreted to, reduce, limit, restrict, or impose conditions on any use
-of the Licensed Material that could lawfully be made without permission under
-this Public License.
-
-b. To the extent possible, if any provision of this Public License is deemed
-unenforceable, it shall be automatically reformed to the minimum extent necessary
-to make it enforceable. If the provision cannot be reformed, it shall be severed
-from this Public License without affecting the enforceability of the remaining
-terms and conditions.
-
-c. No term or condition of this Public License will be waived and no failure
-to comply consented to unless expressly agreed to by the Licensor.
-
-d. Nothing in this Public License constitutes or may be interpreted as a limitation
-upon, or waiver of, any privileges and immunities that apply to the Licensor
-or You, including from the legal processes of any jurisdiction or authority.
-
-Creative Commons is not a party to its public licenses. Notwithstanding, Creative
-Commons may elect to apply one of its public licenses to material it publishes
-and in those instances will be considered the "Licensor." The text of the
-Creative Commons public licenses is dedicated to the public domain under the
-CC0 Public Domain Dedication. Except for the limited purpose of indicating
-that material is shared under a Creative Commons public license or as otherwise
-permitted by the Creative Commons policies published at creativecommons.org/policies,
-Creative Commons does not authorize the use of the trademark "Creative Commons"
-or any other trademark or logo of Creative Commons without its prior written
-consent including, without limitation, in connection with any unauthorized
-modifications to any of its public licenses or any other arrangements, understandings,
-or agreements concerning use of licensed material. For the avoidance of doubt,
-this paragraph does not form part of the public licenses.
-
-Creative Commons may be contacted at creativecommons.org.

LICENSES/MIT.txt

@@ -1,19 +0,0 @@
-MIT License Copyright (c) <year> <copyright holders>
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is furnished
-to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice (including the next
-paragraph) shall be included in all copies or substantial portions of the
-Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
-FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS
-OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
-WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF
-OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

LICENSES/OFL-1.1.txt

@@ -1,90 +0,0 @@
-Copyright (c) <dates>, <Copyright Holder> (<URL|email>),
-
-with Reserved Font Name <Reserved Font Name>. This Font Software is licensed
-under the SIL Open Font License, Version 1.1.
-
-This license is copied below, and is also available with a FAQ at: http://scripts.sil.org/OFL
-SIL OPEN FONT LICENSE
-
-Version 1.1 - 26 February 2007
-
-PREAMBLE
-
-The goals of the Open Font License (OFL) are to stimulate worldwide development
-of collaborative font projects, to support the font creation efforts of academic
-and linguistic communities, and to provide a free and open framework in which
-fonts may be shared and improved in partnership with others.
-
-The OFL allows the licensed fonts to be used, studied, modified and redistributed
-freely as long as they are not sold by themselves. The fonts, including any
-derivative works, can be bundled, embedded, redistributed and/or sold with
-any software provided that any reserved names are not used by derivative works.
-The fonts and derivatives, however, cannot be released under any other type
-of license. The requirement for fonts to remain under this license does not
-apply to any document created using the fonts or their derivatives.
-
-DEFINITIONS
-
-"Font Software" refers to the set of files released by the Copyright Holder(s)
-under this license and clearly marked as such. This may include source files,
-build scripts and documentation.
-
-"Reserved Font Name" refers to any names specified as such after the copyright
-statement(s).
-
-"Original Version" refers to the collection of Font Software components as
-distributed by the Copyright Holder(s).
-
-"Modified Version" refers to any derivative made by adding to, deleting, or
-substituting — in part or in whole — any of the components of the Original
-Version, by changing formats or by porting the Font Software to a new environment.
-
-"Author" refers to any designer, engineer, programmer, technical writer or
-other person who contributed to the Font Software.
-
-PERMISSION & CONDITIONS
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of the Font Software, to use, study, copy, merge, embed, modify, redistribute,
-and sell modified and unmodified copies of the Font Software, subject to the
-following conditions:
-
-1) Neither the Font Software nor any of its individual components, in Original
-or Modified Versions, may be sold by itself.
-
-2) Original or Modified Versions of the Font Software may be bundled, redistributed
-and/or sold with any software, provided that each copy contains the above
-copyright notice and this license. These can be included either as stand-alone
-text files, human-readable headers or in the appropriate machine-readable
-metadata fields within text or binary files as long as those fields can be
-easily viewed by the user.
-
-3) No Modified Version of the Font Software may use the Reserved Font Name(s)
-unless explicit written permission is granted by the corresponding Copyright
-Holder. This restriction only applies to the primary font name as presented
-to the users.
-
-4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font Software
-shall not be used to promote, endorse or advertise any Modified Version, except
-to acknowledge the contribution(s) of the Copyright Holder(s) and the Author(s)
-or with their explicit written permission.
-
-5) The Font Software, modified or unmodified, in part or in whole, must be
-distributed entirely under this license, and must not be distributed under
-any other license. The requirement for fonts to remain under this license
-does not apply to any document created using the Font Software.
-
-TERMINATION
-
-This license becomes null and void if any of the above conditions are not met.
-
-DISCLAIMER
-
-THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
-OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF COPYRIGHT, PATENT,
-TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE
-FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, INCLUDING ANY GENERAL, SPECIAL,
-INDIRECT, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, WHETHER IN AN ACTION OF CONTRACT,
-TORT OR OTHERWISE, ARISING FROM, OUT OF THE USE OR INABILITY TO USE THE FONT
-SOFTWARE OR FROM OTHER DEALINGS IN THE FONT SOFTWARE.

LICENSES/Unlicense.txt

@@ -1,20 +0,0 @@
-This is free and unencumbered software released into the public domain.
-
-Anyone is free to copy, modify, publish, use, compile, sell, or distribute
-this software, either in source code form or as a compiled binary, for any
-purpose, commercial or non-commercial, and by any means.
-
-In jurisdictions that recognize copyright laws, the author or authors of this
-software dedicate any and all copyright interest in the software to the public
-domain. We make this dedication for the benefit of the public at large and
-to the detriment of our heirs and successors. We intend this dedication to
-be an overt act of relinquishment in perpetuity of all present and future
-rights to this software under copyright law.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
-FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS
-BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH
-THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. For more information,
-please refer to <https://unlicense.org/>

Makefile

@@ -1,314 +0,0 @@
-# SPDX-FileCopyrightText: 2014 MicroPython & CircuitPython contributors (https://github.com/adafruit/circuitpython/graphs/contributors)
-#
-# SPDX-License-Identifier: MIT
-
-# Top-level Makefile for documentation builds and miscellaneous tasks.
-#
-
-# You can set these variables from the command line.
-PYTHON        = python3
-SPHINXOPTS    =
-SPHINXBUILD   = sphinx-build
-PAPER         =
-# path to build the generated docs
-BUILDDIR      = _build
-# path to source files to process
-SOURCEDIR     = .
-# path to conf.py
-CONFDIR      = .
-# Run "make FORCE= ..." to avoid rebuilding from scratch (and risk
-# producing incorrect docs).
-FORCE         = -E
-VERBOSE       = -v
-
-# path to generated type stubs
-STUBDIR       = circuitpython-stubs
-# Run "make VALIDATE= stubs" to avoid validating generated stub files
-VALIDATE      = -v
-# path to pypi source distributions
-DISTDIR       = dist
-
-# Make sure you have Sphinx installed, then set the SPHINXBUILD environment variable to point to the
-# full path of the '$(SPHINXBUILD)' executable. Alternatively you can add the directory with the
-# executable to your PATH. If you don't have Sphinx installed, grab it from http://sphinx-doc.org/)
-
-# Internal variables.
-PAPEROPT_a4     = -D latex_paper_size=a4
-PAPEROPT_letter = -D latex_paper_size=letter
-BASEOPTS        = -c $(CONFDIR) $(PAPEROPT_$(PAPER)) $(FORCE) $(VERBOSE) $(SPHINXOPTS) $(SOURCEDIR)
-ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(BASEOPTS)
-# the i18n builder cannot share the environment and doctrees with the others
-I18NSPHINXOPTS  = $(BASEOPTS)
-
-TRANSLATE_SOURCES = extmod lib main.c ports/atmel-samd ports/cxd56 ports/esp32s2 ports/mimxrt10xx ports/nrf ports/raspberrypi ports/stm py shared-bindings shared-module supervisor
-# Paths to exclude from TRANSLATE_SOURCES
-# Each must be preceded by "-path"; if any wildcards, enclose in quotes.
-# Separate by "-o" (Find's "or" operand)
-TRANSLATE_SOURCES_EXC = -path "ports/*/build-*" \
-	-o -path "ports/*/build" \
-	-o -path ports/atmel-samd/asf4 \
-	-o -path ports/cxd56/spresense-exported-sdk \
-	-o -path ports/esp32s2/esp-idf \
-	-o -path ports/mimxrt10xx/sdk \
-	-o -path ports/raspberrypi/sdk \
-	-o -path ports/stm/st_driver \
-	-o -path lib/tinyusb \
-	-o -path lib/lwip \
-
-.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext stubs
-
-help:
-	@echo "Please use \`make <target>' where <target> is one of"
-	@echo "  html       to make standalone HTML files"
-	@echo "  dirhtml    to make HTML files named index.html in directories"
-	@echo "  singlehtml to make a single large HTML file"
-	@echo "  pickle     to make pickle files"
-	@echo "  json       to make JSON files"
-	@echo "  htmlhelp   to make HTML files and a HTML help project"
-	@echo "  qthelp     to make HTML files and a qthelp project"
-	@echo "  devhelp    to make HTML files and a Devhelp project"
-	@echo "  epub       to make an epub"
-	@echo "  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
-	@echo "  latexpdf   to make LaTeX files and run them through pdflatex"
-	@echo "  latexpdfja to make LaTeX files and run them through platex/dvipdfmx"
-	@echo "  text       to make text files"
-	@echo "  man        to make manual pages"
-	@echo "  texinfo    to make Texinfo files"
-	@echo "  info       to make Texinfo files and run them through makeinfo"
-	@echo "  gettext    to make PO message catalogs"
-	@echo "  changes    to make an overview of all changed/added/deprecated items"
-	@echo "  xml        to make Docutils-native XML files"
-	@echo "  pseudoxml  to make pseudoxml-XML files for display purposes"
-	@echo "  linkcheck  to check all external links for integrity"
-	@echo "  doctest    to run all doctests embedded in the documentation (if enabled)"
-
-clean:
-	rm -rf $(BUILDDIR)/*
-	rm -rf autoapi
-	rm -rf $(STUBDIR) $(DISTDIR) *.egg-info
-
-html: stubs
-	$(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
-	@echo
-	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
-
-dirhtml:
-	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
-	@echo
-	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
-
-singlehtml:
-	$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
-	@echo
-	@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
-
-pickle:
-	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
-	@echo
-	@echo "Build finished; now you can process the pickle files."
-
-json:
-	$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
-	@echo
-	@echo "Build finished; now you can process the JSON files."
-
-htmlhelp:
-	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
-	@echo
-	@echo "Build finished; now you can run HTML Help Workshop with the" \
-	      ".hhp project file in $(BUILDDIR)/htmlhelp."
-
-qthelp:
-	$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
-	@echo
-	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
-	      ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
-	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/MicroPython.qhcp"
-	@echo "To view the help file:"
-	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/MicroPython.qhc"
-
-devhelp:
-	$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
-	@echo
-	@echo "Build finished."
-	@echo "To view the help file:"
-	@echo "# mkdir -p $$HOME/.local/share/devhelp/MicroPython"
-	@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/MicroPython"
-	@echo "# devhelp"
-
-epub:
-	$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
-	@echo
-	@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
-
-latex:
-	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
-	@echo
-	@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
-	@echo "Run \`make' in that directory to run these through (pdf)latex" \
-	      "(use \`make latexpdf' here to do that automatically)."
-
-# seems to be malfunctioning
-latexpdf:
-	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
-	@echo "Running LaTeX files through pdflatex..."
-	$(MAKE) -C $(BUILDDIR)/latex all-pdf
-	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
-
-# seems to be malfunctioning
-latexpdfja:
-	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
-	@echo "Running LaTeX files through platex and dvipdfmx..."
-	$(MAKE) -C $(BUILDDIR)/latex all-pdf-ja
-	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
-
-# seems to be malfunctioning
-text:
-	$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
-	@echo
-	@echo "Build finished. The text files are in $(BUILDDIR)/text."
-
-# seems to be malfunctioning
-man:
-	$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
-	@echo
-	@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
-
-texinfo:
-	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
-	@echo
-	@echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo."
-	@echo "Run \`make' in that directory to run these through makeinfo" \
-	      "(use \`make info' here to do that automatically)."
-
-info:
-	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
-	@echo "Running Texinfo files through makeinfo..."
-	make -C $(BUILDDIR)/texinfo info
-	@echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo."
-
-gettext:
-	$(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
-	@echo
-	@echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."
-
-changes:
-	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
-	@echo
-	@echo "The overview file is in $(BUILDDIR)/changes."
-
-linkcheck:
-	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
-	@echo
-	@echo "Link check complete; look for any errors in the above output " \
-	      "or in $(BUILDDIR)/linkcheck/output.txt."
-
-doctest:
-	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
-	@echo "Testing of doctests in the sources finished, look at the " \
-	      "results in $(BUILDDIR)/doctest/output.txt."
-
-xml:
-	$(SPHINXBUILD) -b xml $(ALLSPHINXOPTS) $(BUILDDIR)/xml
-	@echo
-	@echo "Build finished. The XML files are in $(BUILDDIR)/xml."
-
-pseudoxml:
-	$(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/pseudoxml
-	@echo
-	@echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml."
-
-# phony target so we always run
-.PHONY: all-source
-all-source:
-
-locale/circuitpython.pot: all-source
-	find $(TRANSLATE_SOURCES) -type d \( $(TRANSLATE_SOURCES_EXC) \) -prune -o -type f \( -iname "*.c" -o -iname "*.h" \) -print | (LC_ALL=C sort) | xgettext -f- -L C -s --add-location=file --keyword=translate -o - | sed -e '/"POT-Creation-Date: /d' > $@
-
-# Historically, `make translate` updated the .pot file and ran msgmerge.
-# However, this was a frequent source of merge conflicts.  Weblate can perform
-# msgmerge, so make translate merely update the translation template file.
-.PHONY: translate
-translate: locale/circuitpython.pot
-
-# Note that normally we rely on weblate to perform msgmerge.  This reduces the
-# chance of a merge conflict between developer changes (that only add and
-# remove source strings) and weblate changes (that only add and remove
-# translated strings from po files).  However, in case this is legitimately
-# needed we preserve a rule to do it.
-.PHONY: msgmerge
-msgmerge:
-	for po in $(shell ls locale/*.po); do msgmerge -U $$po -s --no-fuzzy-matching --add-location=file locale/circuitpython.pot; done
-
-merge-translate:
-	git merge HEAD 1>&2 2> /dev/null; test $$? -eq 128
-	rm locale/*~ || true
-	git checkout --theirs -- locale/*
-	make translate
-
-.PHONY: check-translate
-check-translate:
-	find $(TRANSLATE_SOURCES) -type d \( $(TRANSLATE_SOURCES_EXC) \) -prune -o -type f \( -iname "*.c" -o -iname "*.h" \) -print | (LC_ALL=C sort) | xgettext -f- -L C -s --add-location=file --keyword=translate -o circuitpython.pot.tmp -p locale
-	$(PYTHON) tools/check_translations.py locale/circuitpython.pot.tmp locale/circuitpython.pot; status=$$?; rm -f locale/circuitpython.pot.tmp; exit $$status
-
-stubs:
-	@mkdir -p circuitpython-stubs
-	@$(PYTHON) tools/extract_pyi.py shared-bindings/ $(STUBDIR)
-	@$(PYTHON) tools/extract_pyi.py extmod/ulab/code/ $(STUBDIR)/ulab
-	@$(PYTHON) tools/extract_pyi.py ports/atmel-samd/bindings $(STUBDIR)
-	@$(PYTHON) tools/extract_pyi.py ports/raspberrypi/bindings $(STUBDIR)
-	@$(PYTHON) setup.py -q sdist
-
-.PHONY: check-stubs
-check-stubs: stubs
-	MYPYPATH=$(STUBDIR) mypy --strict $(STUBDIR)
-
-update-frozen-libraries:
-	@echo "Updating all frozen libraries to latest tagged version."
-	cd frozen; for library in *; do cd $$library; ../../tools/git-checkout-latest-tag.sh; cd ..; done
-
-one-of-each: samd21 litex mimxrt10xx nrf stm
-
-samd21:
-	$(MAKE) -C ports/atmel-samd BOARD=trinket_m0
-
-samd51:
-	$(MAKE) -C ports/atmel-samd BOARD=feather_m4_express
-
-esp32s2:
-	$(MAKE) -C ports/esp32s2 BOARD=espressif_saola_1_wroom
-
-litex:
-	$(MAKE) -C ports/litex BOARD=fomu
-
-mimxrt10xx:
-	$(MAKE) -C ports/mimxrt10xx BOARD=feather_mimxrt1011
-
-nrf:
-	$(MAKE) -C ports/nrf BOARD=feather_nrf52840_express
-
-stm:
-	$(MAKE) -C ports/stm BOARD=feather_stm32f405_express
-
-clean-one-of-each: clean-samd21 clean-samd51 clean-esp32s2 clean-litex clean-mimxrt10xx clean-nrf clean-stm
-
-clean-samd21:
-	$(MAKE) -C ports/atmel-samd BOARD=trinket_m0 clean
-
-clean-samd51:
-	$(MAKE) -C ports/atmel-samd BOARD=feather_m4_express clean
-
-clean-esp32s2:
-	$(MAKE) -C ports/esp32s2 BOARD=espressif_saola_1_wroom clean
-
-clean-litex:
-	$(MAKE) -C ports/litex BOARD=fomu clean
-
-clean-mimxrt10xx:
-	$(MAKE) -C ports/mimxrt10xx BOARD=feather_mimxrt1011 clean
-
-clean-nrf:
-	$(MAKE) -C ports/nrf BOARD=feather_nrf52840_express clean
-
-clean-stm:
-	$(MAKE) -C ports/stm BOARD=feather_stm32f405_express clean

README.rst

@@ -1,95 +1,90 @@
-CircuitPython
-=============
+Adafruit CircuitPython
+======================
 
-.. image:: https://s3.amazonaws.com/adafruit-circuit-python/CircuitPython_Repo_header_logo.png
+|Build Status| |Doc Status| |Discord|
 
-|Build Status| |Doc Status| |License| |Discord| |Weblate|
+`Status <#status>`__ \| `Supported Boards <#supported-boards>`__
+\| `Download <#download>`__ \|
+`Documentation <#documentation>`__ \|
+`Contributing <#contributing>`__ \| `Differences from
+Micropython <#differences-from-micropython>`__ \| `Project
+Structure <#project-structure>`__
 
-`circuitpython.org <https://circuitpython.org>`__ \| `Get CircuitPython <#get-circuitpython>`__ \|
-`Documentation <#documentation>`__ \| `Contributing <#contributing>`__ \|
-`Branding <#branding>`__ \| `Differences from Micropython <#differences-from-micropython>`__ \|
-`Project Structure <#project-structure>`__
+**CircuitPython** is an *education friendly* open source derivative of
+`MicroPython <https://micropython.org>`_. CircuitPython supports use
+on educational development boards designed and sold by
+`Adafruit <https://adafruit.com>`_. Adafruit CircuitPython features
+unified Python core APIs and a growing list of Adafruit libraries and
+drivers of that work with it.
 
-**CircuitPython** is a *beginner friendly*, open source version of Python for tiny, inexpensive
-computers called microcontrollers. Microcontrollers are the brains of many electronics including a
-wide variety of development boards used to build hobby projects and prototypes. CircuitPython in
-electronics is one of the best ways to learn to code because it connects code to reality. Simply
-install CircuitPython on a supported board via drag and drop and then edit a ``code.py`` file on
-the CIRCUITPY drive. The code will automatically reload. No software installs are needed besides a
-text editor (we recommend `Mu <https://codewith.mu/>`_ for beginners.)
+Status
+------
 
-CircuitPython features unified Python core APIs and a growing list of 150+ device libraries and
-drivers that work with it. These libraries also work on single board computers with regular
-Python via the `Adafruit Blinka Library <https://github.com/adafruit/Adafruit_Blinka>`_.
+This project is stable. Most APIs should be stable going forward. Those
+that change will change on major version numbers such as 2.0.0 and
+3.0.0.
 
-CircuitPython is based on `MicroPython <https://micropython.org>`_. See
-`below <#differences-from-micropython>`_ for differences. CircuitPython development is sponsored by
-`Adafruit <https://adafruit.com>`_ and is available on their educational development boards. Please
-support both MicroPython and Adafruit.
+Supported Boards
+----------------
 
-Get CircuitPython
-------------------
+Designed for CircuitPython
+~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Official binaries for all supported boards are available through
-`circuitpython.org/downloads <https://circuitpython.org/downloads>`_. The site includes stable, unstable and
-continuous builds. Full release notes and assets are available through
-`GitHub releases <https://github.com/adafruit/circuitpython/releases>`_ as well.
+-  `Adafruit CircuitPlayground
+   Express <https://www.adafruit.com/product/3333>`__
+-  `Adafruit Feather M0
+   Express <https://www.adafruit.com/product/3403>`__
+-  `Adafruit Metro M0 Express <https://www.adafruit.com/product/3505>`__
+-  `Adafruit Gemma M0 <https://www.adafruit.com/product/3501>`__
+
+Other
+~~~~~
+
+-  `Adafruit Feather HUZZAH <https://www.adafruit.com/products/2821>`__
+-  `Adafruit Feather M0
+   Basic <https://www.adafruit.com/products/2772>`__
+-  `Adafruit Feather M0 Bluefruit
+   LE <https://www.adafruit.com/products/2995>`__ (uses M0 Basic
+   binaries)
+-  `Adafruit Feather M0
+   Adalogger <https://www.adafruit.com/product/2796>`__ (MicroSD card
+   supported using the `Adafruit CircuitPython SD
+   library <https://github.com/adafruit/Adafruit_CircuitPython_SD>`__)
+-  `Arduino Zero <https://www.arduino.cc/en/Main/ArduinoBoardZero>`__
+
+Download
+--------
+
+Official binaries are available through the `latest GitHub
+releases <https://github.com/adafruit/circuitpython/releases>`__.
+Continuous (one per commit) builds are available
+`here <https://adafruit-circuit-python.s3.amazonaws.com/index.html?prefix=bin>`__
+and includes experimental hardware support.
 
 Documentation
 -------------
 
 Guides and videos are available through the `Adafruit Learning
 System <https://learn.adafruit.com/>`__ under the `CircuitPython
-category <https://learn.adafruit.com/category/circuitpython>`__. An API
-reference is also available on `Read the Docs
-<http://circuitpython.readthedocs.io/en/latest/?>`__. A collection of awesome
-resources can be found at `Awesome CircuitPython <https://github.com/adafruit/awesome-circuitpython>`__.
-
-Specifically useful documentation when starting out:
-
-- `Welcome to CircuitPython <https://learn.adafruit.com/welcome-to-circuitpython>`__
-- `CircuitPython Essentials <https://learn.adafruit.com/circuitpython-essentials>`__
-- `Example Code <https://github.com/adafruit/Adafruit_Learning_System_Guides/tree/master/CircuitPython_Essentials>`__
-
-Code Search
-------------
-GitHub doesn't currently support code search on forks. Therefore, CircuitPython doesn't have code search through GitHub because it is a fork of MicroPython. Luckily, `SourceGraph <https://sourcegraph.com/github.com/adafruit/circuitpython>`_ has free code search for public repos like CircuitPython. So, visit `sourcegraph.com/github.com/adafruit/circuitpython <https://sourcegraph.com/github.com/adafruit/circuitpython>`_ to search the CircuitPython codebase online.
+category <https://learn.adafruit.com/category/circuitpython>`__ and
+`MicroPython
+category <https://learn.adafruit.com/category/micropython>`__. An API
+reference is also available on `Read the
+Docs <http://circuitpython.readthedocs.io/en/latest/?>`__.
 
 Contributing
 ------------
 
 See
-`CONTRIBUTING.md <https://github.com/adafruit/circuitpython/blob/main/CONTRIBUTING.md>`__
+`CONTRIBUTING.md <https://github.com/adafruit/circuitpython/blob/master/CONTRIBUTING.md>`__
 for full guidelines but please be aware that by contributing to this
 project you are agreeing to the `Code of
-Conduct <https://github.com/adafruit/circuitpython/blob/main/CODE_OF_CONDUCT.md>`__.
+Conduct <https://github.com/adafruit/circuitpython/blob/master/CODE_OF_CONDUCT.md>`__.
 Contributors who follow the `Code of
-Conduct <https://github.com/adafruit/circuitpython/blob/main/CODE_OF_CONDUCT.md>`__
+Conduct <https://github.com/adafruit/circuitpython/blob/master/CODE_OF_CONDUCT.md>`__
 are welcome to submit pull requests and they will be promptly reviewed
 by project admins. Please join the
-`Discord <https://adafru.it/discord>`__ too.
-
-Branding
-------------
-
-While we are happy to see CircuitPython forked and modified, we'd appreciate it if forked releases
-not use the name "CircuitPython" or the Blinka logo. "CircuitPython" means something special to
-us and those who learn about it. As a result, we'd like to make sure products referring to it meet a
-common set of requirements.
-
-If you'd like to use the term "CircuitPython" and Blinka for your product here is what we ask:
-
-* Your product is supported by the primary
-  `"adafruit/circuitpython" <https://github.com/adafruit/circuitpython>`_ repo. This way we can
-  update any custom code as we update the CircuitPython internals.
-* Your product is listed on `circuitpython.org <https://circuitpython.org>`__ (source
-  `here <https://github.com/adafruit/circuitpython-org/>`_). This is to ensure that a user of your
-  product can always download the latest version of CircuitPython from the standard place.
-* Your product has a user accessible USB plug which appears as a CIRCUITPY drive when plugged in.
-
-If you choose not to meet these requirements, then we ask you call your version of CircuitPython
-something else (for example, SuperDuperPython) and not use the Blinka logo. You can say it is
-"CircuitPython-compatible" if most CircuitPython drivers will work with it.
+`Discord <https://discord.gg/nBQh6qu>`__ too.
 
 --------------
 
@@ -98,11 +93,10 @@ Differences from `MicroPython <https://github.com/micropython/micropython>`__
 
 CircuitPython:
 
--  Supports native USB on all boards, allowing file editing without special tools.
--  Floats (aka decimals) are enabled for all builds.
--  Error messages are translated into 10+ languages.
--  Does not support concurrency within Python (including interrupts and threading). Some concurrency
-   is achieved with native modules for tasks that require it such as audio file playback.
+-  includes a port for Atmel SAMD21 (Commonly known as M0 in Adafruit
+   product names.)
+-  supports only Atmel SAMD21 and ESP8266 ports.
+-  tracks MicroPython's releases (not master).
 
 Behavior
 ~~~~~~~~
@@ -116,32 +110,23 @@ Behavior
    output is written to ``boot_out.txt``.
 -  ``code.py`` (or ``main.py``) is run after every reload until it
    finishes or is interrupted. After it is done running, the vm and
-   hardware is reinitialized. **This means you cannot read state from**
-   ``code.py`` **in the REPL anymore, as the REPL is a fresh vm.** CircuitPython's goal for this
-   change includes reducing confusion about pins and memory being used.
--  After the main code is finished the REPL can be entered by pressing any key.
+   hardware is reinitialized. **This means you cannot read state from
+   ``code.py`` in the REPL anymore.** CircuitPython's goal for this
+   change includes reduce confusion about pins and memory being used.
+-  After ``code.py`` the REPL can be entered by pressing any key. It no
+   longer shares state with ``code.py`` so it is a fresh vm.
 -  Autoreload state will be maintained across reload.
 -  Adds a safe mode that does not run user code after a hard crash or
    brown out. The hope is that this will make it easier to fix code that
    causes nasty crashes by making it available through mass storage
-   after the crash. A reset (the button) is needed after it's fixed to
+   after the crash. A reset (the button) is needed after its fixed to
    get back into normal mode.
--  RGB status LED indicating CircuitPython state, and errors through a sequence of colored flashes.
--  Re-runs ``code.py`` or other main file after file system writes over USB mass storage. (Disable with
-   ``supervisor.disable_autoreload()``)
--  Autoreload is disabled while the REPL is active.
--  Main is one of these: ``code.txt``, ``code.py``, ``main.py``,
-   ``main.txt``
--  Boot is one of these: ``settings.txt``, ``settings.py``, ``boot.py``,
-   ``boot.txt``
 
 API
 ~~~
 
--  Unified hardware APIs. Documented on
-   `ReadTheDocs <https://circuitpython.readthedocs.io/en/latest/shared-bindings/index.html>`_.
--  API docs are rST within the C files in ``shared-bindings``.
--  No ``machine`` API.
+-  Unified hardware APIs: `audioio <https://circuitpython.readthedocs.io/en/latest/shared-bindings/audioio/__init__.html>`_, `analogio <https://circuitpython.readthedocs.io/en/latest/shared-bindings/analogio/__init__.html>`_, `busio <https://circuitpython.readthedocs.io/en/latest/shared-bindings/busio/__init__.html>`_, `digitalio <https://circuitpython.readthedocs.io/en/latest/shared-bindings/digitalio/__init__.html>`_, `pulseio <https://circuitpython.readthedocs.io/en/latest/shared-bindings/pulseio/__init__.html>`_, `touchio <https://circuitpython.readthedocs.io/en/latest/shared-bindings/touchio/__init__.html>`_, `microcontroller <https://circuitpython.readthedocs.io/en/latest/shared-bindings/microcontroller/__init__.html>`_, `board <https://circuitpython.readthedocs.io/en/latest/shared-bindings/board/__init__.html>`_, `bitbangio <https://circuitpython.readthedocs.io/en/latest/shared-bindings/bitbangio/__init__.html>`_
+-  No ``machine`` API on Atmel SAMD21 port.
 
 Modules
 ~~~~~~~
@@ -161,6 +146,18 @@ Modules
 -  tick count is available as
    `time.monotonic() <https://circuitpython.readthedocs.io/en/latest/shared-bindings/time/__init__.html#time.monotonic>`__
 
+atmel-samd21 features
+~~~~~~~~~~~~~~~~~~~~~
+
+-  RGB status LED
+-  Auto-reload after file write over mass storage. (Disable with
+   ``samd.disable_autoreload()``)
+-  Wait state after boot and main run, before REPL.
+-  Main is one of these: ``code.txt``, ``code.py``, ``main.py``,
+   ``main.txt``
+-  Boot is one of these: ``settings.txt``, ``settings.py``, ``boot.py``,
+   ``boot.txt``
+
 --------------
 
 Project Structure
@@ -182,7 +179,7 @@ amongst ports including CircuitPython:
 -  ``extmod`` Shared C code used in multiple ports' modules.
 -  ``lib`` Shared core C code including externally developed libraries
    such as FATFS.
--  ``logo`` The CircuitPython logo.
+-  ``logo`` The MicroPython logo.
 -  ``mpy-cross`` A cross compiler that converts Python files to byte
    code prior to being run in MicroPython. Useful for reducing library
    size.
@@ -202,36 +199,44 @@ Ports
 Ports include the code unique to a microcontroller line and also
 variations based on the board.
 
-================  ============================================================
-Supported         Support status
-================  ============================================================
-atmel-samd        ``SAMD21`` stable | ``SAMD51`` stable
-cxd56             stable
-esp32s2           beta
-litex             alpha
-mimxrt10xx        alpha
-nrf               stable
-raspberrypi       beta
-stm               ``F4`` stable | ``others`` beta
-unix              alpha
-================  ============================================================
+-  ``atmel-samd`` Support for SAMD21 based boards such as `Arduino
+   Zero <https://www.arduino.cc/en/Main/ArduinoBoardZero>`__, `Adafruit
+   Feather M0 Basic <https://www.adafruit.com/products/2772>`__, and
+   `Adafruit Feather M0 Bluefruit
+   LE <https://www.adafruit.com/products/2995>`__.
+-  ``bare-arm`` A bare minimum version of MicroPython for ARM MCUs.
+-  ``cc3200`` Support for boards based
+   `CC3200 <http://www.ti.com/product/CC3200>`__ from TI such as the
+   `WiPy 1.0 <https://www.pycom.io/solutions/py-boards/wipy1/>`__.
+-  ``esp8266`` Support for boards based on ESP8266 WiFi modules such as
+   the `Adafruit Feather
+   HUZZAH <https://www.adafruit.com/products/2821>`__.
+-  ``minimal`` A minimal MicroPython port. Start with this if you want
+   to port MicroPython to another microcontroller.
+-  ``pic16bit`` Support for 16-bit PIC microcontrollers.
+-  ``qemu-arm`` Support for ARM emulation through
+   `QEMU <https://qemu.org>`__.
+-  ``stmhal`` Support for boards based on STM32 microcontrollers
+   including the MicroPython flagship
+   `PyBoard <https://store.micropython.org/store/#/products/PYBv1_1>`__.
+-  ``teensy`` Support for the Teensy line of boards such as the `Teensy
+   3.1 <https://www.pjrc.com/teensy/teensy31.html>`__.
+-  ``unix`` Support for UNIX.
+-  ``windows`` Support for
+   `Windows <https://www.microsoft.com/en-us/windows/>`__.
+-  ``zephyr`` Support for `Zephyr <https://www.zephyrproject.org/>`__, a
+   real-time operating system by the Linux Foundation.
 
--  ``stable`` Highly unlikely to have bugs or missing functionality.
--  ``beta``   Being actively improved but may be missing functionality and have bugs.
--  ``alpha``  Will have bugs and missing functionality.
+CircuitPython only maintains the ``atmel-samd`` and ``esp8266`` ports.
+The rest are here to maintain compatibility with the
+`MicroPython <https://github.com/micropython/micropython>`__ parent
+project.
 
-The remaining port directories not listed above are in the repo to maintain compatibility with the
-`MicroPython <https://github.com/micropython/micropython>`__ parent project.
+`⬆ back to top <#adafruit-circuitpython>`__
 
-`Back to Top <#circuitpython>`__
-
-.. |Build Status| image:: https://github.com/adafruit/circuitpython/workflows/Build%20CI/badge.svg
-   :target: https://github.com/adafruit/circuitpython/actions?query=branch%3Amain
+.. |Build Status| image:: https://travis-ci.org/adafruit/circuitpython.svg?branch=master
+   :target: https://travis-ci.org/adafruit/circuitpython
 .. |Doc Status| image:: https://readthedocs.org/projects/circuitpython/badge/?version=latest
    :target: http://circuitpython.readthedocs.io/
 .. |Discord| image:: https://img.shields.io/discord/327254708534116352.svg
-   :target: https://adafru.it/discord
-.. |License| image:: https://img.shields.io/badge/License-MIT-brightgreen.svg
-   :target: https://choosealicense.com/licenses/mit/
-.. |Weblate| image:: https://hosted.weblate.org/widgets/circuitpython/-/svg-badge.svg
-   :target: https://hosted.weblate.org/engage/circuitpython/?utm_source=widget
+   :target: https://discord.gg/nBQh6qu

WEBUSB_README.md

@@ -1,94 +0,0 @@
-<!--
-SPDX-FileCopyrightText: 2014 MicroPython & CircuitPython contributors (https://github.com/adafruit/circuitpython/graphs/contributors)
-
-SPDX-License-Identifier: MIT
--->
-
-# WebUSB Serial Support
-
-To date, this has only been tested on one port (esp32s2), on one board (espressif_kaluga_1).
-
-## What it does
-
-If you have ever used CircuitPython on a platform with a graphical LCD display, you have probably
-already seen multiple "consoles" in use (although the LCD console is "output only").
-
-New compile-time option CIRCUITPY_USB_VENDOR enables an additional "console" that can be used in
-parallel with the original (CDC) serial console.
-
-Web pages that support the WebUSB standard can connect to the "vendor" interface and activate
-this WebUSB serial console at any time.
-
-You can type into either console, and CircuitPython output is sent to all active consoles.
-
-One example of a web page you can use to test drive this feature can be found at:
-
-https://adafruit.github.io/Adafruit_TinyUSB_Arduino/examples/webusb-serial/index.html
-
-## How to enable
-
-Update your platform's mpconfigboard.mk file to enable and disable specific types of USB interfaces.
-
-CIRCUITPY_USB_HID = xxx
-CIRCUITPY_USB_MIDI = xxx
-CIRCUITPY_USB_VENDOR = xxx
-
-On at least some of the hardware platforms, the maximum number of USB endpoints is fixed.
-For example, on the ESP32S2, you must pick only one of the above 3 interfaces to be enabled.
-
-Original espressif_kaluga_1 mpconfigboard.mk settings:
-
-CIRCUITPY_USB_HID = 1
-CIRCUITPY_USB_MIDI = 0
-CIRCUITPY_USB_VENDOR = 0
-
-Settings to enable WebUSB instead:
-
-CIRCUITPY_USB_HID = 0
-CIRCUITPY_USB_MIDI = 0
-CIRCUITPY_USB_VENDOR = 1
-
-Notice that to enable VENDOR on ESP32-S2, we had to give up HID. There may be platforms that can have both, or even all three.
-
-## Implementation Notes
-
-CircuitPython uses the tinyusb library.
-
-The tinyusb library already has support for WebUSB serial.
-The tinyusb examples already include a "WebUSB serial" example.
-
-    Sidenote - The use of the term "vendor" instead of "WebUSB" was done to match tinyusb.
-
-Basically, this feature was ported into CircuitPython by pulling code snippets out of the
-tinyusb example, and putting them where they best belonged in the CircuitPython codebase.
-
-There was one complication:
-
-tinyusb uses C preprocessor macros to define things like USB descriptors.
-
-CircuitPython uses a Python program (tools/gen_usb_descriptor.py) to create USB descriptors (etc.)
-using "helper objects" from another repo (adafruit_usb_descriptor). This means some of the example
-code had to be adapted to the new programing model, and gen_usb_descriptor gained new command-line
-options to control the generated code.
-
-The generated files go into the "build" directory, look for autogen_usb_descriptor.c and
-genhdr/autogen_usb_descriptor.h.
-
-
-Also worth pointing out - the re-use of the CDC connect/disconnect mechanism is not actually part
-of the WebUSB standard, it's more of "common idiom". We make use of it here because we need to know
-when we should be paying attention to the WebUSB serial interface, and when we should ignore it..
-
-## Possible future work areas
-
-The current code uses the existing Python infrastructure to create the Interface descriptor, but
-simply outputs the code snippets from the original tinyusb demo code to create the WEBUSB_URL,
-BOS, and MS_OS_20 descriptors. I suppose additional work could be done to add these to the
-adafruit_usb_descriptor project, and then gen_usb_descriptor.py could be modified to make use
-of them.
-
-Program gen_usb_descriptor.py creates objects for most interface types, regardless of whether or
-not they are actually enabled. This increases the size of a generated string table. I made the
-new vendor-interface-related code not do this (because some of the ARM platforms would no longer
-build), but I did not go back and do this for the other interface types (CDC, MIDI, HID, etc.)
-Some FLASH savings are probably possible if this is done.

conf.py

@@ -13,22 +13,10 @@
 # All configuration values have a default; values that are commented out
 # serve to show the default.
 
-# SPDX-FileCopyrightText: 2014 MicroPython & CircuitPython contributors (https://github.com/adafruit/circuitpython/graphs/contributors)
-#
-# SPDX-License-Identifier: MIT
-
-import logging
-import os
-import re
-import subprocess
 import sys
-import urllib.parse
-import time
+import os
 
-import recommonmark
-from sphinx.transforms import SphinxTransform
-from docutils import nodes
-from sphinx import addnodes
+from recommonmark.parser import CommonMarkParser
 
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the
@@ -36,23 +24,8 @@ from sphinx import addnodes
 sys.path.insert(0, os.path.abspath('docs'))
 sys.path.insert(0, os.path.abspath('.'))
 
-import shared_bindings_matrix
-
 master_doc = 'docs/index'
 
-# Grab the JSON values to use while building the module support matrix
-# in 'shared-bindings/index.rst'
-
-# The stubs must be built before we calculate the shared bindings matrix
-subprocess.check_output(["make", "stubs"])
-
-#modules_support_matrix = shared_bindings_matrix.support_matrix_excluded_boards()
-modules_support_matrix = shared_bindings_matrix.support_matrix_by_board()
-
-html_context = {
-    'support_matrix': modules_support_matrix
-}
-
 # -- General configuration ------------------------------------------------
 
 # If your documentation needs a minimal Sphinx version, state it here.
@@ -64,37 +37,19 @@ needs_sphinx = '1.3'
 extensions = [
     'sphinx.ext.autodoc',
     'sphinx.ext.doctest',
-    'sphinxcontrib.rsvgconverter',
     'sphinx.ext.intersphinx',
     'sphinx.ext.todo',
-    'sphinx.ext.coverage',
-    'rstjinja',
-    'recommonmark',
+    'sphinx.ext.coverage'
 ]
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['templates']
 
 # The suffix of source filenames.
-source_suffix = {
-    '.rst': 'restructuredtext',
-    '.md': 'markdown',
-}
+source_suffix = ['.rst', '.md', '.c', '.h']
 
-extensions.append('autoapi.extension')
-
-autoapi_type = 'python'
-# Uncomment this if debugging autoapi
-autoapi_keep_files = True
-autoapi_dirs = [os.path.join('circuitpython-stubs', x) for x in os.listdir('circuitpython-stubs')]
-autoapi_add_toctree_entry = False
-autoapi_options = ['members', 'undoc-members', 'private-members', 'show-inheritance', 'special-members', 'show-module-summary']
-autoapi_template_dir = 'docs/autoapi/templates'
-autoapi_python_class_content = "both"
-autoapi_python_use_implicit_namespaces = True
-autoapi_root = "shared-bindings"
-
-redirects_file = 'docs/redirects.txt'
+source_parsers = {'.md': CommonMarkParser,
+                  '.c': "c2rst.CStrip", '.h': "c2rst.CStrip"}
 
 # The encoding of source files.
 #source_encoding = 'utf-8-sig'
@@ -102,12 +57,9 @@ redirects_file = 'docs/redirects.txt'
 # The master toctree document.
 #master_doc = 'index'
 
-# Get current date (execution) for copyright year
-current_date = time.localtime()
-
 # General information about the project.
 project = 'Adafruit CircuitPython'
-copyright = f'2014-{current_date.tm_year}, MicroPython & CircuitPython contributors (https://github.com/adafruit/circuitpython/graphs/contributors)'
+copyright = '2014-2018, MicroPython & CircuitPython contributors (https://github.com/adafruit/circuitpython/graphs/contributors)'
 
 # These are overwritten on ReadTheDocs.
 # The version info for the project you're documenting, acts as replacement for
@@ -116,25 +68,7 @@ copyright = f'2014-{current_date.tm_year}, MicroPython & CircuitPython contribut
 #
 # We don't follow "The short X.Y version" vs "The full version, including alpha/beta/rc tags"
 # breakdown, so use the same version identifier for both to avoid confusion.
-
-final_version = ""
-git_describe = subprocess.run(
-    ["git", "describe", "--dirty", "--tags"],
-    stdout=subprocess.PIPE,
-    stderr=subprocess.STDOUT,
-    encoding="utf-8"
-)
-if git_describe.returncode == 0:
-    git_version = re.search(
-        r"^\d(?:\.\d){0,2}(?:\-(?:alpha|beta|rc)\.\d+){0,1}",
-        str(git_describe.stdout)
-    )
-    if git_version:
-        final_version = git_version[0]
-else:
-    print("Failed to retrieve git version:", git_describe.stdout)
-
-version = release = final_version
+version = release = '0.0.0'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
@@ -149,13 +83,7 @@ version = release = final_version
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
 exclude_patterns = ["**/build*",
-                    ".git",
-                    ".github",
-                    ".env",
                     ".venv",
-                    ".direnv",
-                    "data",
-                    "docs/autoapi",
                     "docs/README.md",
                     "drivers",
                     "examples",
@@ -173,31 +101,31 @@ exclude_patterns = ["**/build*",
                     "ports/atmel-samd/asf4_conf",
                     "ports/atmel-samd/external_flash",
                     "ports/atmel-samd/freetouch",
-                    "ports/atmel-samd/peripherals",
                     "ports/atmel-samd/QTouch",
                     "ports/atmel-samd/tools",
-                    "ports/cxd56/mkspk",
-                    "ports/cxd56/spresense-exported-sdk",
-                    "ports/esp32s2/certificates",
-                    "ports/esp32s2/esp-idf",
-                    "ports/esp32s2/.idf_tools",
-                    "ports/esp32s2/peripherals",
-                    "ports/litex/hw",
+                    "ports/bare-arm",
+                    "ports/cc3200",
+                    "ports/cc3200/FreeRTOS",
+                    "ports/cc3200/hal",
+                    "ports/esp8266/boards",
+                    "ports/esp8266/common-hal",
+                    "ports/esp8266/modules",
                     "ports/minimal",
-                    "ports/mimxrt10xx/peripherals",
-                    "ports/mimxrt10xx/sdk",
                     "ports/nrf/device",
-                    "ports/nrf/bluetooth",
+                    "ports/nrf/drivers",
+                    "ports/nrf/hal",
                     "ports/nrf/modules",
-                    "ports/nrf/nrfx",
-                    "ports/nrf/peripherals",
-                    "ports/nrf/usb",
-                    "ports/raspberrypi/sdk",
-                    "ports/stm/st_driver",
-                    "ports/stm/packages",
-                    "ports/stm/peripherals",
-                    "ports/stm/ref",
+                    "ports/pic16bit",
+                    "ports/qemu-arm",
+                    "ports/stm32",
+                    "ports/stm32/hal",
+                    "ports/stm32/cmsis",
+                    "ports/stm32/usbdev",
+                    "ports/stm32/usbhost",
+                    "ports/teensy",
                     "ports/unix",
+                    "ports/windows",
+                    "ports/zephyr",
                     "py",
                     "shared-bindings/util.*",
                     "shared-module",
@@ -351,7 +279,7 @@ latex_elements = {
 #  author, documentclass [howto, manual, or own class]).
 latex_documents = [
   (master_doc, 'CircuitPython.tex', 'CircuitPython Documentation',
-   'CircuitPython Contributors', 'manual'),
+   'Damien P. George, Paul Sokolovsky, and contributors', 'manual'),
 ]
 
 # The name of an image file (relative to this directory) to place at the top of
@@ -381,7 +309,7 @@ latex_documents = [
 # (source start file, name, description, authors, manual section).
 man_pages = [
     ('index', 'CircuitPython', 'CircuitPython Documentation',
-     ['CircuitPython contributors'], 1),
+     ['Damien P. George, Paul Sokolovsky, and contributors'], 1),
 ]
 
 # If true, show URL addresses after external links.
@@ -395,7 +323,7 @@ man_pages = [
 #  dir menu entry, description, category)
 texinfo_documents = [
   (master_doc, 'CircuitPython', 'CircuitPython Documentation',
-   'CircuitPython contributors', 'CircuitPython', 'Python for Microcontrollers.',
+   'Damien P. George, Paul Sokolovsky, and contributors', 'CircuitPython', 'One line description of project.',
    'Miscellaneous'),
 ]
 
@@ -416,81 +344,3 @@ texinfo_documents = [
 intersphinx_mapping = {"cpython": ('https://docs.python.org/3/', None),
                        "bus_device": ('https://circuitpython.readthedocs.io/projects/busdevice/en/latest/', None),
                        "register": ('https://circuitpython.readthedocs.io/projects/register/en/latest/', None)}
-
-# Adapted from sphinxcontrib-redirects
-from sphinx.builders import html as builders
-
-TEMPLATE = """<html>
-  <head><meta http-equiv="refresh" content="0; url=%s"/></head>
-</html>
-"""
-
-
-def generate_redirects(app):
-    path = os.path.join(app.srcdir, app.config.redirects_file)
-    if not os.path.exists(path):
-        logging.error("Could not find redirects file at '%s'" % path)
-        return
-
-    if not isinstance(app.builder, builders.StandaloneHTMLBuilder):
-        logging.warn("The 'sphinxcontib-redirects' plugin is only supported "
-                 "by the 'html' builder and subclasses. Skipping...")
-        logging.warn(f"Builder is {app.builder.name} ({type(app.builder)})")
-        return
-
-    with open(path) as redirects:
-        for line in redirects.readlines():
-            from_path, to_path = line.rstrip().split(' ')
-
-            logging.debug("Redirecting '%s' to '%s'" % (from_path, to_path))
-
-            from_path = os.path.splitext(from_path)[0] + ".html"
-            to_path_prefix = '..%s' % os.path.sep * (
-                len(from_path.split(os.path.sep)) - 1)
-            to_path = to_path_prefix + to_path
-
-            redirected_filename = os.path.join(app.builder.outdir, from_path)
-            redirected_directory = os.path.dirname(redirected_filename)
-            if not os.path.exists(redirected_directory):
-                os.makedirs(redirected_directory)
-
-            with open(redirected_filename, 'w') as f:
-                f.write(TEMPLATE % urllib.parse.quote(to_path, '#/'))
-
-
-class CoreModuleTransform(SphinxTransform):
-    default_priority = 870
-
-    def _convert_first_paragraph_into_title(self):
-        title = self.document.next_node(nodes.title)
-        paragraph = self.document.next_node(nodes.paragraph)
-        if not title or not paragraph:
-            return
-        if isinstance(paragraph[0], nodes.paragraph):
-            paragraph = paragraph[0]
-        if all(isinstance(child, nodes.Text) for child in paragraph.children):
-            for child in paragraph.children:
-                title.append(nodes.Text(" \u2013 "))
-                title.append(child)
-            paragraph.parent.remove(paragraph)
-
-    def _enable_linking_to_nonclass_targets(self):
-        for desc in self.document.traverse(addnodes.desc):
-            for xref in desc.traverse(addnodes.pending_xref):
-                if xref.attributes.get("reftype") == "class":
-                    xref.attributes.pop("refspecific", None)
-
-    def apply(self, **kwargs):
-        docname = self.env.docname
-        if docname.startswith(autoapi_root) and docname.endswith("/index"):
-            self._convert_first_paragraph_into_title()
-            self._enable_linking_to_nonclass_targets()
-
-
-def setup(app):
-    app.add_css_file("customstyle.css")
-    app.add_css_file("filter.css")
-    app.add_js_file("filter.js")
-    app.add_config_value('redirects_file', 'redirects', 'env')
-    app.connect('builder-inited', generate_redirects)
-    app.add_transform(CoreModuleTransform)

data/nvm.toml

@@ -1 +0,0 @@
-Subproject commit 9b4a5241d8c3310b31a7925a4f2160743890a2e4

devices/ble_hci/common-hal/_bleio/Adapter.c

@@ -1,957 +0,0 @@
-/*
- * This file is part of the MicroPython project, http://micropython.org/
- *
- * The MIT License (MIT)
- *
- * Copyright (c) 2020 Dan Halbert for Adafruit Industries
- * Copyright (c) 2016 Glenn Ruben Bakke
- * Copyright (c) 2018 Artur Pacholec
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-#include <math.h>
-#include <stdint.h>
-#include <stdio.h>
-#include <string.h>
-
-#include "hci.h"
-
-#include "py/gc.h"
-#include "py/mphal.h"
-#include "py/objstr.h"
-#include "py/runtime.h"
-#include "supervisor/shared/safe_mode.h"
-#include "supervisor/shared/tick.h"
-#include "supervisor/usb.h"
-#include "shared-bindings/_bleio/__init__.h"
-#include "shared-bindings/_bleio/Adapter.h"
-#include "shared-bindings/_bleio/Address.h"
-#include "shared-bindings/_bleio/Characteristic.h"
-#include "shared-bindings/_bleio/Service.h"
-#include "shared-bindings/_bleio/Connection.h"
-#include "shared-bindings/_bleio/ScanEntry.h"
-#include "shared-bindings/time/__init__.h"
-
-#define MSEC_TO_UNITS(TIME, RESOLUTION) (((TIME) * 1000) / (RESOLUTION))
-#define SEC_TO_UNITS(TIME, RESOLUTION) (((TIME) * 1000000) / (RESOLUTION))
-#define UNITS_TO_SEC(TIME, RESOLUTION) (((TIME)*(RESOLUTION)) / 1000000)
-// 0.625 msecs (625 usecs)
-#define ADV_INTERVAL_UNIT_FLOAT_SECS (0.000625)
-// Microseconds is the base unit. The macros above know that.
-#define UNIT_0_625_MS (625)
-#define UNIT_1_25_MS  (1250)
-#define UNIT_10_MS    (10000)
-
-#define MAX_ADVERTISEMENT_SIZE (31)
-
-// TODO make this settable from Python.
-#define DEFAULT_TX_POWER 0  // 0 dBm
-#define MAX_ANONYMOUS_ADV_TIMEOUT_SECS (60 * 15)
-#define MAX_LIMITED_DISCOVERABLE_ADV_TIMEOUT_SECS (180)
-
-#define BLE_MIN_CONN_INTERVAL        MSEC_TO_UNITS(15, UNIT_0_625_MS)
-#define BLE_MAX_CONN_INTERVAL        MSEC_TO_UNITS(15, UNIT_0_625_MS)
-#define BLE_SLAVE_LATENCY            0
-#define BLE_CONN_SUP_TIMEOUT         MSEC_TO_UNITS(4000, UNIT_10_MS)
-
-bleio_connection_internal_t bleio_connections[BLEIO_TOTAL_CONNECTION_COUNT];
-
-STATIC void add_generic_services(bleio_adapter_obj_t *adapter) {
-    // Create Generic Access UUID, Service, and Characteristics.
-
-    // Generic Access Service setup.
-
-    bleio_uuid_obj_t *generic_access_service_uuid = m_new_obj(bleio_uuid_obj_t);
-    generic_access_service_uuid->base.type = &bleio_uuid_type;
-    common_hal_bleio_uuid_construct(generic_access_service_uuid, 0x1800, NULL);
-
-    bleio_uuid_obj_t *device_name_characteristic_uuid = m_new_obj(bleio_uuid_obj_t);
-    device_name_characteristic_uuid->base.type = &bleio_uuid_type;
-    common_hal_bleio_uuid_construct(device_name_characteristic_uuid, 0x2A00, NULL);
-
-    bleio_uuid_obj_t *appearance_characteristic_uuid = m_new_obj(bleio_uuid_obj_t);
-    appearance_characteristic_uuid->base.type = &bleio_uuid_type;
-    common_hal_bleio_uuid_construct(appearance_characteristic_uuid, 0x2A01, NULL);
-
-    // Not implemented:
-    // Peripheral Preferred Connection Parameters
-    // Central Address Resolution
-
-    bleio_service_obj_t *generic_access_service = m_new_obj(bleio_service_obj_t);
-    generic_access_service->base.type = &bleio_service_type;
-    common_hal_bleio_service_construct(generic_access_service, generic_access_service_uuid, false);
-
-    adapter->device_name_characteristic = m_new_obj(bleio_characteristic_obj_t);
-    adapter->device_name_characteristic->base.type = &bleio_characteristic_type;
-
-    char generic_name[] = { 'C', 'I', 'R', 'C', 'U', 'I', 'T', 'P', 'Y', 'n', 'n', 'n', 'n' };
-    mp_buffer_info_t generic_name_bufinfo = {
-        .buf = generic_name,
-        .len = sizeof(generic_name),
-    };
-
-    // Will be added to service by constructor.
-    common_hal_bleio_characteristic_construct(
-        adapter->device_name_characteristic,
-        generic_access_service,
-        BLE_GATT_HANDLE_INVALID,
-        device_name_characteristic_uuid,
-        CHAR_PROP_READ,
-        SECURITY_MODE_OPEN,
-        SECURITY_MODE_NO_ACCESS,
-        248,                    // max length, from Bluetooth spec
-        false,                  // not fixed length
-        &generic_name_bufinfo
-        );
-
-    uint16_t zero_16 = 0;
-    mp_buffer_info_t zero_16_value = {
-        .buf = &zero_16,
-        .len = sizeof(zero_16),
-    };
-
-    adapter->appearance_characteristic = m_new_obj(bleio_characteristic_obj_t);
-    adapter->appearance_characteristic->base.type = &bleio_characteristic_type;
-
-    common_hal_bleio_characteristic_construct(
-        adapter->appearance_characteristic,
-        generic_access_service,
-        BLE_GATT_HANDLE_INVALID,
-        appearance_characteristic_uuid,
-        CHAR_PROP_READ,
-        SECURITY_MODE_OPEN,
-        SECURITY_MODE_NO_ACCESS,
-        2,                      // max length, from Bluetooth spec
-        true,                  // fixed length
-        &zero_16_value
-        );
-
-    // Generic Attribute Service setup.
-
-    bleio_uuid_obj_t *generic_attribute_service_uuid = m_new_obj(bleio_uuid_obj_t);
-    generic_attribute_service_uuid->base.type = &bleio_uuid_type;
-    common_hal_bleio_uuid_construct(generic_attribute_service_uuid, 0x1801, NULL);
-
-    bleio_uuid_obj_t *service_changed_characteristic_uuid = m_new_obj(bleio_uuid_obj_t);
-    service_changed_characteristic_uuid->base.type = &bleio_uuid_type;
-    common_hal_bleio_uuid_construct(service_changed_characteristic_uuid, 0x2A05, NULL);
-
-    bleio_service_obj_t *generic_attribute_service = m_new_obj(bleio_service_obj_t);
-    generic_attribute_service->base.type = &bleio_service_type;
-    common_hal_bleio_service_construct(generic_attribute_service, generic_attribute_service_uuid, false);
-
-    adapter->service_changed_characteristic = m_new_obj(bleio_characteristic_obj_t);
-    adapter->service_changed_characteristic->base.type = &bleio_characteristic_type;
-
-    uint32_t zero_32 = 0;
-    mp_buffer_info_t zero_32_value = {
-        .buf = &zero_32,
-        .len = sizeof(zero_32),
-    };
-
-    common_hal_bleio_characteristic_construct(
-        adapter->service_changed_characteristic,
-        generic_attribute_service,
-        BLE_GATT_HANDLE_INVALID,
-        service_changed_characteristic_uuid,
-        CHAR_PROP_INDICATE,
-        SECURITY_MODE_OPEN,
-        SECURITY_MODE_NO_ACCESS,
-        4,                     // max length, from Bluetooth spec
-        true,                  // fixed length
-        &zero_32_value
-        );
-}
-
-
-STATIC void check_enabled(bleio_adapter_obj_t *adapter) {
-    if (!common_hal_bleio_adapter_get_enabled(adapter)) {
-        mp_raise_bleio_BluetoothError(translate("Adapter not enabled"));
-    }
-}
-
-// STATIC bool adapter_on_ble_evt(ble_evt_t *ble_evt, void *self_in) {
-//     bleio_adapter_obj_t *self = (bleio_adapter_obj_t*)self_in;
-
-//     // For debugging.
-//     // mp_printf(&mp_plat_print, "Adapter event: 0x%04x\n", ble_evt->header.evt_id);
-
-//     switch (ble_evt->header.evt_id) {
-//         case BLE_GAP_EVT_CONNECTED: {
-//             // Find an empty connection. One must always be available because the SD has the same
-//             // total connection limit.
-//             bleio_connection_internal_t *connection;
-//             for (size_t i = 0; i < BLEIO_TOTAL_CONNECTION_COUNT; i++) {
-//                 connection = &bleio_connections[i];
-//                 if (connection->conn_handle == BLE_CONN_HANDLE_INVALID) {
-//                     break;
-//                 }
-//             }
-
-//             // Central has connected.
-//             ble_gap_evt_connected_t* connected = &ble_evt->evt.gap_evt.params.connected;
-
-//             connection->conn_handle = ble_evt->evt.gap_evt.conn_handle;
-//             connection->connection_obj = mp_const_none;
-//             connection->pair_status = PAIR_NOT_PAIRED;
-//             connection->mtu = 0;
-
-//             ble_drv_add_event_handler_entry(&connection->handler_entry, connection_on_ble_evt, connection);
-//             self->connection_objs = NULL;
-
-//             // Save the current connection parameters.
-//             memcpy(&connection->conn_params, &connected->conn_params, sizeof(ble_gap_conn_params_t));
-
-//             #if CIRCUITPY_VERBOSE_BLE
-//             ble_gap_conn_params_t *cp = &connected->conn_params;
-//             mp_printf(&mp_plat_print, "conn params: min_ci %d max_ci %d s_l %d sup_timeout %d\n", cp->min_conn_interval, cp->max_conn_interval, cp->slave_latency, cp->conn_sup_timeout);
-//             #endif
-
-//             // See if connection interval set by Central is out of range.
-//             // If so, negotiate our preferred range.
-//             ble_gap_conn_params_t conn_params;
-//             sd_ble_gap_ppcp_get(&conn_params);
-//             if (conn_params.min_conn_interval < connected->conn_params.min_conn_interval ||
-//                 conn_params.min_conn_interval > connected->conn_params.max_conn_interval) {
-//                 sd_ble_gap_conn_param_update(ble_evt->evt.gap_evt.conn_handle, &conn_params);
-//             }
-//             self->current_advertising_data = NULL;
-//             break;
-//         }
-//         case BLE_GAP_EVT_DISCONNECTED: {
-//             // Find the connection that was disconnected.
-//             bleio_connection_internal_t *connection;
-//             for (size_t i = 0; i < BLEIO_TOTAL_CONNECTION_COUNT; i++) {
-//                 connection = &bleio_connections[i];
-//                 if (connection->conn_handle == ble_evt->evt.gap_evt.conn_handle) {
-//                     break;
-//                 }
-//             }
-//             ble_drv_remove_event_handler(connection_on_ble_evt, connection);
-//             connection->conn_handle = BLE_CONN_HANDLE_INVALID;
-//             connection->pair_status = PAIR_NOT_PAIRED;
-//             if (connection->connection_obj != mp_const_none) {
-//                 bleio_connection_obj_t* obj = connection->connection_obj;
-//                 obj->connection = NULL;
-//                 obj->disconnect_reason = ble_evt->evt.gap_evt.params.disconnected.reason;
-//             }
-//             self->connection_objs = NULL;
-
-//             break;
-//         }
-
-//         case BLE_GAP_EVT_ADV_SET_TERMINATED:
-//             self->current_advertising_data = NULL;
-//             break;
-
-//         default:
-//             // For debugging.
-//             // mp_printf(&mp_plat_print, "Unhandled adapter event: 0x%04x\n", ble_evt->header.evt_id);
-//             return false;
-//             break;
-//     }
-//     return true;
-// }
-
-char default_ble_name[] = { 'C', 'I', 'R', 'C', 'U', 'I', 'T', 'P', 'Y', 0, 0, 0, 0};
-
-// Get various values and limits set by the adapter.
-// Set event mask.
-STATIC void bleio_adapter_hci_init(bleio_adapter_obj_t *self) {
-
-    const size_t len = sizeof(default_ble_name);
-
-    bt_addr_t addr;
-    hci_check_error(hci_read_bd_addr(&addr));
-
-    default_ble_name[len - 4] = nibble_to_hex_lower[addr.val[1] >> 4 & 0xf];
-    default_ble_name[len - 3] = nibble_to_hex_lower[addr.val[1] & 0xf];
-    default_ble_name[len - 2] = nibble_to_hex_lower[addr.val[0] >> 4 & 0xf];
-    default_ble_name[len - 1] = nibble_to_hex_lower[addr.val[0] & 0xf];
-    self->name = mp_obj_new_str(default_ble_name, len);
-
-    // Get version information.
-    if (hci_read_local_version(&self->hci_version, &self->hci_revision, &self->lmp_version,
-        &self->manufacturer, &self->lmp_subversion) != HCI_OK) {
-        mp_raise_bleio_BluetoothError(translate("Could not read HCI version"));
-    }
-    // Get supported features.
-    if (hci_le_read_local_supported_features(self->features) != HCI_OK) {
-        mp_raise_bleio_BluetoothError(translate("Could not read BLE features"));
-    }
-
-    // Enabled desired events.
-    // Most importantly, includes:
-    // BT_EVT_MASK_LE_META_EVENT                BT_EVT_BIT(61)
-    if (hci_set_event_mask(0x3FFFFFFFFFFFFFFF) != HCI_OK) {
-        mp_raise_bleio_BluetoothError(translate("Could not set event mask"));
-    }
-    // The default events for LE are:
-    // BT_EVT_MASK_LE_CONN_COMPLETE,  BT_EVT_MASK_LE_ADVERTISING_REPORT,
-    // BT_EVT_MASK_LE_CONN_UPDATE_COMPLETE, BT_EVT_MASK_LE_REMOTE_FEAT_COMPLETE
-    // BT_EVT_MASK_LE_LTK_REQUEST.
-    // That's all we need right now, so we don't bother to set the LE event mask.
-
-    // Get ACL buffer info.
-    uint16_t le_max_len;
-    uint8_t le_max_num;
-    if (hci_le_read_buffer_size(&le_max_len, &le_max_num) == HCI_OK) {
-        self->max_acl_buffer_len = le_max_len;
-        self->max_acl_num_buffers = le_max_num;
-    } else {
-        // LE Read Buffer Size not available; use the general Read Buffer Size.
-        uint16_t acl_max_len;
-        uint8_t sco_max_len;
-        uint16_t acl_max_num;
-        uint16_t sco_max_num;
-        if (hci_read_buffer_size(&acl_max_len, &sco_max_len, &acl_max_num, &sco_max_num) != HCI_OK) {
-            mp_raise_bleio_BluetoothError(translate("Could not read BLE buffer info"));
-        }
-        self->max_acl_buffer_len = acl_max_len;
-        self->max_acl_num_buffers = acl_max_num;
-    }
-
-    // Get max advertising length if extended advertising is supported.
-    if (BT_FEAT_LE_EXT_ADV(self->features)) {
-        uint16_t max_adv_data_len;
-        if (hci_le_read_maximum_advertising_data_length(&max_adv_data_len) != HCI_OK) {
-            mp_raise_bleio_BluetoothError(translate("Could not get max advertising length"));
-        }
-        self->max_adv_data_len = max_adv_data_len;
-    } else {
-        self->max_adv_data_len = MAX_ADVERTISEMENT_SIZE;
-    }
-}
-
-void common_hal_bleio_adapter_construct_hci_uart(bleio_adapter_obj_t *self, busio_uart_obj_t *uart, digitalio_digitalinout_obj_t *rts, digitalio_digitalinout_obj_t *cts) {
-    self->allocated = true;
-    self->hci_uart = uart;
-    self->rts_digitalinout = rts;
-    self->cts_digitalinout = cts;
-
-    // Advertising-related fields are initialized by common_hal_bleio_adapter_set_enabled().
-    self->enabled = false;
-
-    common_hal_bleio_adapter_set_enabled(self, true);
-    bleio_adapter_hci_init(self);
-    common_hal_bleio_adapter_set_name(self, default_ble_name);
-}
-
-void common_hal_bleio_adapter_set_enabled(bleio_adapter_obj_t *self, bool enabled) {
-    const bool is_enabled = common_hal_bleio_adapter_get_enabled(self);
-
-    // Don't enable or disable twice
-    if (is_enabled == enabled) {
-        return;
-    }
-
-    self->enabled = enabled;
-
-    // We must poll for input from the HCI adapter.
-    // TODO Can we instead trigger an interrupt on UART input traffic?
-    if (enabled) {
-        supervisor_enable_tick();
-    } else {
-        supervisor_disable_tick();
-    }
-
-    // Enabling or disabling: stop any current activity; reset to known state.
-    hci_reset();
-    self->now_advertising = false;
-    self->extended_advertising = false;
-    self->circuitpython_advertising = false;
-    self->advertising_timeout_msecs = 0;
-
-    if (enabled) {
-        // Reset list of known attributes.
-        // Indices into the list are handles. Handle 0x0000 designates an invalid handle,
-        // so store None there to skip it.
-        self->attributes = mp_obj_new_list(0, NULL);
-        bleio_adapter_add_attribute(self, mp_const_none);
-        add_generic_services(self);
-    }
-}
-
-bool common_hal_bleio_adapter_get_enabled(bleio_adapter_obj_t *self) {
-    return self->enabled;
-}
-
-bleio_address_obj_t *common_hal_bleio_adapter_get_address(bleio_adapter_obj_t *self) {
-    check_enabled(self);
-
-    bt_addr_t addr;
-    hci_check_error(hci_read_bd_addr(&addr));
-
-    bleio_address_obj_t *address = m_new_obj(bleio_address_obj_t);
-    address->base.type = &bleio_address_type;
-
-    common_hal_bleio_address_construct(address, addr.val, BT_ADDR_LE_PUBLIC);
-    return address;
-}
-
-bool common_hal_bleio_adapter_set_address(bleio_adapter_obj_t *self, bleio_address_obj_t *address) {
-    mp_buffer_info_t bufinfo;
-    if (!mp_get_buffer(address->bytes, &bufinfo, MP_BUFFER_READ)) {
-        return false;
-    }
-    return hci_le_set_random_address(bufinfo.buf) == HCI_OK;
-}
-
-mp_obj_str_t *common_hal_bleio_adapter_get_name(bleio_adapter_obj_t *self) {
-    return self->name;
-}
-
-void common_hal_bleio_adapter_set_name(bleio_adapter_obj_t *self, const char *name) {
-    self->name = mp_obj_new_str(name, strlen(name));
-    mp_buffer_info_t bufinfo;
-    mp_get_buffer_raise(self->name, &bufinfo, MP_BUFFER_READ);
-    bleio_characteristic_set_local_value(self->device_name_characteristic, &bufinfo);
-}
-
-
-// STATIC bool scan_on_ble_evt(ble_evt_t *ble_evt, void *scan_results_in) {
-//     bleio_scanresults_obj_t *scan_results = (bleio_scanresults_obj_t*)scan_results_in;
-
-//     if (ble_evt->header.evt_id == BLE_GAP_EVT_TIMEOUT &&
-//         ble_evt->evt.gap_evt.params.timeout.src == BLE_GAP_TIMEOUT_SRC_SCAN) {
-//         shared_module_bleio_scanresults_set_done(scan_results, true);
-//         ble_drv_remove_event_handler(scan_on_ble_evt, scan_results);
-//         return true;
-//     }
-
-//     if (ble_evt->header.evt_id != BLE_GAP_EVT_ADV_REPORT) {
-//         return false;
-//     }
-//     ble_gap_evt_adv_report_t *report = &ble_evt->evt.gap_evt.params.adv_report;
-
-//     shared_module_bleio_scanresults_append(scan_results,
-//                                            supervisor_ticks_ms64(),
-//                                            report->type.connectable,
-//                                            report->type.scan_response,
-//                                            report->rssi,
-//                                            report->peer_addr.addr,
-//                                            report->peer_addr.addr_type,
-//                                            report->data.p_data,
-//                                            report->data.len);
-
-//     const uint32_t err_code = sd_ble_gap_scan_start(NULL, scan_results->common_hal_data);
-//     if (err_code != NRF_SUCCESS) {
-//         // TODO: Pass the error into the scan results so it can throw an exception.
-//         scan_results->done = true;
-//     }
-//     return true;
-// }
-
-mp_obj_t common_hal_bleio_adapter_start_scan(bleio_adapter_obj_t *self, uint8_t *prefixes, size_t prefix_length, bool extended, mp_int_t buffer_size, mp_float_t timeout, mp_float_t interval, mp_float_t window, mp_int_t minimum_rssi, bool active) {
-    // TODO
-    mp_raise_NotImplementedError(NULL);
-    check_enabled(self);
-
-    if (self->scan_results != NULL) {
-        if (!shared_module_bleio_scanresults_get_done(self->scan_results)) {
-            mp_raise_bleio_BluetoothError(translate("Scan already in progess. Stop with stop_scan."));
-        }
-        self->scan_results = NULL;
-    }
-    self->scan_results = shared_module_bleio_new_scanresults(buffer_size, prefixes, prefix_length, minimum_rssi);
-
-    // size_t max_packet_size = extended ? BLE_GAP_SCAN_BUFFER_EXTENDED_MAX_SUPPORTED : BLE_GAP_SCAN_BUFFER_MAX;
-    // uint8_t *raw_data = m_malloc(sizeof(ble_data_t) + max_packet_size, false);
-    // ble_data_t * sd_data = (ble_data_t *) raw_data;
-    // self->scan_results->common_hal_data = sd_data;
-    // sd_data->len = max_packet_size;
-    // sd_data->p_data = raw_data + sizeof(ble_data_t);
-
-    // ble_drv_add_event_handler(scan_on_ble_evt, self->scan_results);
-
-    // uint32_t nrf_timeout = SEC_TO_UNITS(timeout, UNIT_10_MS);
-    // if (timeout <= 0.0001) {
-    //     nrf_timeout = BLE_GAP_SCAN_TIMEOUT_UNLIMITED;
-    // }
-
-    // ble_gap_scan_params_t scan_params = {
-    //     .extended = extended,
-    //     .interval = SEC_TO_UNITS(interval, UNIT_0_625_MS),
-    //     .timeout = nrf_timeout,
-    //     .window = SEC_TO_UNITS(window, UNIT_0_625_MS),
-    //     .scan_phys = BLE_GAP_PHY_1MBPS,
-    //     .active = active
-    // };
-    // uint32_t err_code;
-    // vm_used_ble = true;
-    // err_code = sd_ble_gap_scan_start(&scan_params, sd_data);
-
-    // if (err_code != NRF_SUCCESS) {
-    //     self->scan_results = NULL;
-    //     ble_drv_remove_event_handler(scan_on_ble_evt, self->scan_results);
-    //     check_nrf_error(err_code);
-    // }
-
-    return MP_OBJ_FROM_PTR(self->scan_results);
-}
-
-void common_hal_bleio_adapter_stop_scan(bleio_adapter_obj_t *self) {
-    // TODO
-    mp_raise_NotImplementedError(NULL);
-    check_enabled(self);
-
-    // If not already scanning, no problem.
-    if (hci_le_set_scan_enable(BT_HCI_LE_SCAN_DISABLE, BT_HCI_LE_SCAN_FILTER_DUP_DISABLE) == HCI_OK) {
-        shared_module_bleio_scanresults_set_done(self->scan_results, true);
-        self->scan_results = NULL;
-    }
-}
-
-// typedef struct {
-//     uint16_t conn_handle;
-//     volatile bool done;
-// } connect_info_t;
-
-// STATIC bool connect_on_ble_evt(ble_evt_t *ble_evt, void *info_in) {
-//     connect_info_t *info = (connect_info_t*)info_in;
-
-//     switch (ble_evt->header.evt_id) {
-//         case BLE_GAP_EVT_CONNECTED:
-//             info->conn_handle = ble_evt->evt.gap_evt.conn_handle;
-//             info->done = true;
-
-//             break;
-
-//         case BLE_GAP_EVT_TIMEOUT:
-//             // Handle will be invalid.
-//             info->done = true;
-//             break;
-//         default:
-//             // For debugging.
-//             // mp_printf(&mp_plat_print, "Unhandled central event: 0x%04x\n", ble_evt->header.evt_id);
-//             return false;
-//             break;
-//     }
-//     return true;
-// }
-
-mp_obj_t common_hal_bleio_adapter_connect(bleio_adapter_obj_t *self, bleio_address_obj_t *address, mp_float_t timeout) {
-    // TODO
-    mp_raise_NotImplementedError(NULL);
-
-    check_enabled(self);
-
-    // ble_gap_addr_t addr;
-
-    // addr.addr_type = address->type;
-    // mp_buffer_info_t address_buf_info;
-    // mp_get_buffer_raise(address->bytes, &address_buf_info, MP_BUFFER_READ);
-    // memcpy(addr.addr, (uint8_t *) address_buf_info.buf, NUM_BLEIO_ADDRESS_BYTES);
-
-    // ble_gap_scan_params_t scan_params = {
-    //     .interval = MSEC_TO_UNITS(100, UNIT_0_625_MS),
-    //     .window = MSEC_TO_UNITS(100, UNIT_0_625_MS),
-    //     .scan_phys = BLE_GAP_PHY_1MBPS,
-    //     // timeout of 0 means no timeout
-    //     .timeout = SEC_TO_UNITS(timeout, UNIT_10_MS),
-    // };
-
-    // ble_gap_conn_params_t conn_params = {
-    //     .conn_sup_timeout = MSEC_TO_UNITS(4000, UNIT_10_MS),
-    //     .min_conn_interval = MSEC_TO_UNITS(15, UNIT_1_25_MS),
-    //     .max_conn_interval = MSEC_TO_UNITS(300, UNIT_1_25_MS),
-    //     .slave_latency = 0,          // number of conn events
-    // };
-
-    // connect_info_t event_info;
-    // ble_drv_add_event_handler(connect_on_ble_evt, &event_info);
-    // event_info.done = false;
-
-    vm_used_ble = true;
-    // uint32_t err_code = sd_ble_gap_connect(&addr, &scan_params, &conn_params, BLE_CONN_CFG_TAG_CUSTOM);
-
-    // if (err_code != NRF_SUCCESS) {
-    //     ble_drv_remove_event_handler(connect_on_ble_evt, &event_info);
-    //     check_nrf_error(err_code);
-    // }
-
-    // while (!event_info.done) {
-    //     RUN_BACKGROUND_TASKS;
-    // }
-
-    // ble_drv_remove_event_handler(connect_on_ble_evt, &event_info);
-
-    // uint16_t conn_handle = event_info.conn_handle;
-    // if (conn_handle == BLE_CONN_HANDLE_INVALID) {
-    //     mp_raise_bleio_BluetoothError(translate("Failed to connect: timeout"));
-    // }
-
-    // // Negotiate for better PHY, larger MTU and data lengths since we are the central. These are
-    // // nice-to-haves so ignore any errors.
-    // ble_gap_phys_t const phys = {
-    //     .rx_phys = BLE_GAP_PHY_AUTO,
-    //     .tx_phys = BLE_GAP_PHY_AUTO,
-    // };
-    // sd_ble_gap_phy_update(conn_handle, &phys);
-    // sd_ble_gattc_exchange_mtu_request(conn_handle, BLE_GATTS_VAR_ATTR_LEN_MAX);
-    // sd_ble_gap_data_length_update(conn_handle, NULL, NULL);
-
-    // Make the connection object and return it.
-    // for (size_t i = 0; i < BLEIO_TOTAL_CONNECTION_COUNT; i++) {
-    //     bleio_connection_internal_t *connection = &bleio_connections[i];
-    //     if (connection->conn_handle == conn_handle) {
-    //         return bleio_connection_new_from_internal(connection);
-    //     }
-    // }
-
-    mp_raise_bleio_BluetoothError(translate("Failed to connect: internal error"));
-
-    return mp_const_none;
-}
-
-STATIC void check_data_fit(size_t data_len, bool connectable) {
-    if (data_len > MAX_ADVERTISEMENT_SIZE) {
-        mp_raise_ValueError(translate("Data too large for advertisement packet"));
-    }
-}
-
-// STATIC bool advertising_on_ble_evt(ble_evt_t *ble_evt, void *self_in) {
-//     bleio_adapter_obj_t *self = (bleio_adapter_obj_t*)self_in;
-
-//     switch (ble_evt->header.evt_id) {
-//         case BLE_GAP_EVT_ADV_SET_TERMINATED:
-//             common_hal_bleio_adapter_stop_advertising(self);
-//             ble_drv_remove_event_handler(advertising_on_ble_evt, self_in);
-//             break;
-
-//         default:
-//             // For debugging.
-//             // mp_printf(&mp_plat_print, "Unhandled advertising event: 0x%04x\n", ble_evt->header.evt_id);
-//             return false;
-//             break;
-//     }
-//     return true;
-// }
-
-uint32_t _common_hal_bleio_adapter_start_advertising(bleio_adapter_obj_t *self, bool connectable, bool anonymous, uint32_t timeout, float interval, uint8_t *advertising_data, uint16_t advertising_data_len, uint8_t *scan_response_data, uint16_t scan_response_data_len) {
-    check_enabled(self);
-
-    if (self->now_advertising) {
-        if (self->circuitpython_advertising) {
-            common_hal_bleio_adapter_stop_advertising(self);
-        } else {
-            // User-requested advertising.
-            // TODO allow multiple advertisements.
-            // Already advertising. Can't advertise twice.
-            return 1;
-        }
-    }
-
-    // Peer address, which we don't use (no directed advertising).
-    bt_addr_le_t empty_addr = { 0 };
-
-    bool extended =
-        advertising_data_len > self->max_adv_data_len || scan_response_data_len > self->max_adv_data_len;
-
-    if (extended) {
-        if (!BT_FEAT_LE_EXT_ADV(self->features)) {
-            mp_raise_bleio_BluetoothError(translate("Data length needs extended advertising, but this adapter does not support it"));
-        }
-
-        uint16_t props = 0;
-        if (connectable) {
-            props |= BT_HCI_LE_ADV_PROP_CONN;
-        }
-        if (scan_response_data_len > 0) {
-            props |= BT_HCI_LE_ADV_PROP_SCAN;
-        }
-
-        // Advertising interval.
-        uint32_t interval_units = SEC_TO_UNITS(interval, UNIT_0_625_MS);
-
-        hci_check_error(
-            hci_le_set_extended_advertising_parameters(
-                0,              // handle
-                props,          // adv properties
-                interval_units, // min interval
-                interval_units, // max interval
-                0b111,          // channel map: channels 37, 38, 39
-                anonymous ? BT_ADDR_LE_RANDOM : BT_ADDR_LE_PUBLIC,
-                &empty_addr,    // peer_addr,
-                0x00,           // filter policy: no filter
-                DEFAULT_TX_POWER,
-                BT_HCI_LE_EXT_SCAN_PHY_1M, // Secondary PHY to use
-                0x00,                      // AUX_ADV_IND shall be sent prior to next adv event
-                BT_HCI_LE_EXT_SCAN_PHY_1M, // Secondary PHY to use
-                0x00,                      // Advertising SID
-                0x00                       // Scan req notify disable
-                ));
-
-        // We can use the duration mechanism provided, instead of our own.
-        self->advertising_timeout_msecs = 0;
-
-        uint8_t handle[1] = { 0 };
-        uint16_t duration_10msec[1] = { timeout * 100 };
-        uint8_t max_ext_adv_evts[1] = { 0 };
-        hci_check_error(
-            hci_le_set_extended_advertising_enable(
-                BT_HCI_LE_ADV_ENABLE,
-                1,                // one advertising set.
-                handle,
-                duration_10msec,
-                max_ext_adv_evts
-                ));
-
-        self->extended_advertising = true;
-    } else {
-        // Legacy advertising (not extended).
-
-        uint8_t adv_type;
-        if (connectable) {
-            // Connectable, scannable, undirected.
-            adv_type = BT_HCI_ADV_IND;
-        } else if (scan_response_data_len > 0) {
-            // Unconnectable, scannable, undirected.
-            adv_type = BT_HCI_ADV_SCAN_IND;
-        } else {
-            // Unconnectable, unscannable, undirected.
-            adv_type = BT_HCI_ADV_NONCONN_IND;
-        }
-
-        // Advertising interval.
-        uint16_t interval_units = SEC_TO_UNITS(interval, UNIT_0_625_MS);
-
-        hci_check_error(
-            hci_le_set_advertising_parameters(
-                interval_units, // min interval
-                interval_units, // max interval
-                adv_type,
-                anonymous ? BT_ADDR_LE_RANDOM : BT_ADDR_LE_PUBLIC,
-                &empty_addr,
-                0b111,          // channel map: channels 37, 38, 39
-                0x00            // filter policy: no filter
-                ));
-
-        // The HCI commands expect MAX_ADVERTISEMENT_SIZE (31)octets,
-        // even though the actual data length may be shorter.
-        uint8_t full_data[MAX_ADVERTISEMENT_SIZE] = { 0 };
-        memcpy(full_data, advertising_data, MIN(sizeof(full_data), advertising_data_len));
-        hci_check_error(hci_le_set_advertising_data(advertising_data_len, full_data));
-        memset(full_data, 0, sizeof(full_data));
-        if (scan_response_data_len > 0) {
-            memcpy(full_data, scan_response_data, MIN(sizeof(full_data), scan_response_data_len));
-            hci_check_error(hci_le_set_scan_response_data(scan_response_data_len, full_data));
-        }
-
-        // No duration mechanism is provided for legacy advertising, so we need to do our own.
-        self->advertising_timeout_msecs = timeout * 1000;
-        self->advertising_start_ticks = supervisor_ticks_ms64();
-
-        // Start advertising.
-        hci_check_error(hci_le_set_advertising_enable(BT_HCI_LE_ADV_ENABLE));
-        self->extended_advertising = false;
-    } // end legacy advertising setup
-
-    vm_used_ble = true;
-    self->now_advertising = true;
-    return 0;
-}
-
-void common_hal_bleio_adapter_start_advertising(bleio_adapter_obj_t *self, bool connectable, bool anonymous, uint32_t timeout, mp_float_t interval, mp_buffer_info_t *advertising_data_bufinfo, mp_buffer_info_t *scan_response_data_bufinfo) {
-    check_enabled(self);
-
-    // interval value has already been validated.
-
-    check_data_fit(advertising_data_bufinfo->len, connectable);
-    check_data_fit(scan_response_data_bufinfo->len, connectable);
-
-    if (advertising_data_bufinfo->len > MAX_ADVERTISEMENT_SIZE && scan_response_data_bufinfo->len > 0) {
-        mp_raise_bleio_BluetoothError(translate("Extended advertisements with scan response not supported."));
-    }
-
-    // Anonymous mode requires a timeout so that we don't continue to broadcast
-    // the same data while cycling the MAC address -- otherwise, what's the
-    // point of randomizing the MAC address?
-    if (timeout == 0 && anonymous) {
-        timeout = MAX_ANONYMOUS_ADV_TIMEOUT_SECS;
-    } else {
-        if (timeout > MAX_LIMITED_DISCOVERABLE_ADV_TIMEOUT_SECS) {
-            mp_raise_bleio_BluetoothError(translate("Timeout is too long: Maximum timeout length is %d seconds"),
-                MAX_LIMITED_DISCOVERABLE_ADV_TIMEOUT_SECS);
-        }
-    }
-
-    const uint32_t result = _common_hal_bleio_adapter_start_advertising(
-        self, connectable, anonymous, timeout, interval,
-        advertising_data_bufinfo->buf,
-        advertising_data_bufinfo->len,
-        scan_response_data_bufinfo->buf,
-        scan_response_data_bufinfo->len);
-
-    if (result) {
-        mp_raise_bleio_BluetoothError(translate("Already advertising"));
-    }
-    self->circuitpython_advertising = false;
-}
-
-void common_hal_bleio_adapter_stop_advertising(bleio_adapter_obj_t *self) {
-    check_enabled(self);
-
-    self->now_advertising = false;
-    self->extended_advertising = false;
-    self->circuitpython_advertising = false;
-
-    int result = hci_le_set_advertising_enable(BT_HCI_LE_ADV_DISABLE);
-    // OK if we're already stopped. There seems to be an ESP32 HCI bug:
-    // If advertising is already off, then LE_SET_ADV_ENABLE does not return a response.
-    if (result != HCI_RESPONSE_TIMEOUT) {
-        hci_check_error(result);
-    }
-
-    // TODO startup CircuitPython advertising again.
-}
-
-// Note that something stopped advertising, such as a connection happening.
-// Don't ask the adapter to stop.
-void bleio_adapter_advertising_was_stopped(bleio_adapter_obj_t *self) {
-    self->now_advertising = false;
-    self->extended_advertising = false;
-    self->circuitpython_advertising = false;
-}
-
-bool common_hal_bleio_adapter_get_advertising(bleio_adapter_obj_t *self) {
-    check_enabled(self);
-
-    return self->now_advertising;
-}
-
-bool common_hal_bleio_adapter_get_connected(bleio_adapter_obj_t *self) {
-    check_enabled(self);
-
-    for (size_t i = 0; i < BLEIO_TOTAL_CONNECTION_COUNT; i++) {
-        bleio_connection_internal_t *connection = &bleio_connections[i];
-        if (connection->conn_handle != BLE_CONN_HANDLE_INVALID) {
-            return true;
-        }
-    }
-    return false;
-}
-
-mp_obj_t common_hal_bleio_adapter_get_connections(bleio_adapter_obj_t *self) {
-    check_enabled(self);
-
-    if (self->connection_objs != NULL) {
-        return self->connection_objs;
-    }
-    size_t total_connected = 0;
-    mp_obj_t items[BLEIO_TOTAL_CONNECTION_COUNT];
-    for (size_t i = 0; i < BLEIO_TOTAL_CONNECTION_COUNT; i++) {
-        bleio_connection_internal_t *connection = &bleio_connections[i];
-        if (connection->conn_handle != BLE_CONN_HANDLE_INVALID) {
-            if (connection->connection_obj == mp_const_none) {
-                connection->connection_obj = bleio_connection_new_from_internal(connection);
-            }
-            items[total_connected] = connection->connection_obj;
-            total_connected++;
-        }
-    }
-    self->connection_objs = mp_obj_new_tuple(total_connected, items);
-    return self->connection_objs;
-}
-
-void common_hal_bleio_adapter_erase_bonding(bleio_adapter_obj_t *self) {
-    // TODO
-    mp_raise_NotImplementedError(NULL);
-    check_enabled(self);
-
-    // FIX bonding_erase_storage();
-}
-
-uint16_t bleio_adapter_add_attribute(bleio_adapter_obj_t *adapter, mp_obj_t *attribute) {
-    check_enabled(adapter);
-
-    // The handle is the index of this attribute in the attributes list.
-    uint16_t handle = (uint16_t)adapter->attributes->len;
-    mp_obj_list_append(adapter->attributes, attribute);
-
-    if (mp_obj_is_type(attribute, &bleio_service_type)) {
-        adapter->last_added_service_handle = handle;
-    }
-    if (mp_obj_is_type(attribute, &bleio_characteristic_type)) {
-        adapter->last_added_characteristic_handle = handle;
-    }
-
-    return handle;
-}
-
-mp_obj_t *bleio_adapter_get_attribute(bleio_adapter_obj_t *adapter, uint16_t handle) {
-    check_enabled(adapter);
-
-    if (handle == 0 || handle >= adapter->attributes->len) {
-        return mp_const_none;
-    }
-    return adapter->attributes->items[handle];
-}
-
-uint16_t bleio_adapter_max_attribute_handle(bleio_adapter_obj_t *adapter) {
-    check_enabled(adapter);
-
-    return adapter->attributes->len - 1;
-}
-
-
-void bleio_adapter_gc_collect(bleio_adapter_obj_t *adapter) {
-    gc_collect_root((void **)adapter, sizeof(bleio_adapter_obj_t) / sizeof(size_t));
-    gc_collect_root((void **)bleio_connections, sizeof(bleio_connections) / sizeof(size_t));
-}
-
-void bleio_adapter_reset(bleio_adapter_obj_t *adapter) {
-
-    if (!common_hal_bleio_adapter_get_enabled(adapter)) {
-        return;
-    }
-
-    // Adapter will be reset.
-    common_hal_bleio_adapter_set_enabled(adapter, false);
-
-    adapter->connection_objs = NULL;
-    for (size_t i = 0; i < BLEIO_TOTAL_CONNECTION_COUNT; i++) {
-        bleio_connection_internal_t *connection = &bleio_connections[i];
-        // Disconnect all connections with Python state cleanly. Keep any supervisor-only connections.
-        if (connection->connection_obj != mp_const_none &&
-            connection->conn_handle != BLE_CONN_HANDLE_INVALID) {
-            common_hal_bleio_connection_disconnect(connection);
-        }
-        connection->connection_obj = mp_const_none;
-    }
-
-}
-
-void bleio_adapter_background(bleio_adapter_obj_t *adapter) {
-    if (!common_hal_bleio_adapter_get_enabled(adapter)) {
-        return;
-    }
-
-    if (adapter->advertising_timeout_msecs > 0 &&
-        supervisor_ticks_ms64() - adapter->advertising_start_ticks > adapter->advertising_timeout_msecs) {
-        adapter->advertising_timeout_msecs = 0;
-        common_hal_bleio_adapter_stop_advertising(adapter);
-    }
-
-    hci_result_t result = hci_poll_for_incoming_pkt();
-    if (result != HCI_OK) {
-        mp_printf(&mp_plat_print, "bad hci_poll_for_incoming_pkt() result in background: %d\n", result);
-    }
-}

devices/ble_hci/common-hal/_bleio/Adapter.h

@@ -1,99 +0,0 @@
-/*
- * This file is part of the MicroPython project, http://micropython.org/
- *
- * The MIT License (MIT)
- *
- * Copyright (c) 2018 Dan Halbert for Adafruit Industries
- * Copyright (c) 2018 Artur Pacholec
- * Copyright (c) 2016 Glenn Ruben Bakke
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-#ifndef MICROPY_INCLUDED_BLE_HCI_COMMON_HAL_ADAPTER_H
-#define MICROPY_INCLUDED_BLE_HCI_COMMON_HAL_ADAPTER_H
-
-#include "py/obj.h"
-#include "py/objtuple.h"
-
-#include "shared-bindings/_bleio/Characteristic.h"
-#include "shared-bindings/_bleio/Connection.h"
-#include "shared-bindings/_bleio/ScanResults.h"
-#include "shared-bindings/busio/UART.h"
-#include "shared-bindings/digitalio/DigitalInOut.h"
-
-#ifndef BLEIO_TOTAL_CONNECTION_COUNT
-#define BLEIO_TOTAL_CONNECTION_COUNT 5
-#endif
-
-extern bleio_connection_internal_t bleio_connections[BLEIO_TOTAL_CONNECTION_COUNT];
-
-typedef struct _bleio_adapter_obj_t {
-    mp_obj_base_t base;
-    bleio_scanresults_obj_t *scan_results;
-    mp_obj_t name;
-    mp_obj_tuple_t *connection_objs;
-    busio_uart_obj_t *hci_uart;
-    digitalio_digitalinout_obj_t *rts_digitalinout;
-    digitalio_digitalinout_obj_t *cts_digitalinout;
-    bool allocated;  // True when in use.
-    bool now_advertising;
-    bool extended_advertising;
-    bool circuitpython_advertising;
-    bool enabled;
-
-    // HCI adapter version info.
-    uint8_t hci_version;
-    uint8_t lmp_version;
-    uint16_t hci_revision;
-    uint16_t manufacturer;
-    uint16_t lmp_subversion;
-
-    // Used to monitor advertising timeout for legacy avertising.
-    uint64_t advertising_start_ticks;
-    uint64_t advertising_timeout_msecs;  // If zero, do not check.
-
-    // Generic services characteristics.
-    bleio_characteristic_obj_t *device_name_characteristic;
-    bleio_characteristic_obj_t *appearance_characteristic;
-    bleio_characteristic_obj_t *service_changed_characteristic;
-
-    uint16_t max_acl_buffer_len;
-    uint16_t max_acl_num_buffers;
-    uint16_t max_adv_data_len;
-    uint8_t features[8];        // Supported BLE features.
-
-    // All the local attributes for this device. The index into the list
-    // corresponds to the handle.
-    mp_obj_list_t *attributes;
-    // Handle for last added service. Characteristics can only be added immediately after
-    // the service they belong to. This vets that.
-    uint16_t last_added_service_handle;
-    uint16_t last_added_characteristic_handle;
-} bleio_adapter_obj_t;
-
-uint16_t bleio_adapter_add_attribute(bleio_adapter_obj_t *adapter, mp_obj_t *attribute);
-void bleio_adapter_advertising_was_stopped(bleio_adapter_obj_t *self);
-mp_obj_t *bleio_adapter_get_attribute(bleio_adapter_obj_t *adapter, uint16_t handle);
-uint16_t bleio_adapter_max_attribute_handle(bleio_adapter_obj_t *adapter);
-void bleio_adapter_background(bleio_adapter_obj_t *adapter);
-void bleio_adapter_gc_collect(bleio_adapter_obj_t *adapter);
-void bleio_adapter_reset(bleio_adapter_obj_t *adapter);
-
-#endif // MICROPY_INCLUDED_BLE_HCI_COMMON_HAL_ADAPTER_H

devices/ble_hci/common-hal/_bleio/Attribute.c

@@ -1,49 +0,0 @@
-/*
- * This file is part of the MicroPython project, http://micropython.org/
- *
- * The MIT License (MIT)
- *
- * Copyright (c) 2019 Dan Halbert for Adafruit Industries
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-#include "py/runtime.h"
-
-#include "shared-bindings/_bleio/Attribute.h"
-#include "shared-bindings/_bleio/Characteristic.h"
-#include "shared-bindings/_bleio/Descriptor.h"
-#include "shared-bindings/_bleio/Service.h"
-
-
-bleio_uuid_obj_t *bleio_attribute_get_uuid(mp_obj_t *attribute) {
-    if (mp_obj_is_type(attribute, &bleio_characteristic_type)) {
-        bleio_characteristic_obj_t *characteristic = MP_OBJ_TO_PTR(attribute);
-        return characteristic->uuid;
-    }
-    if (mp_obj_is_type(attribute, &bleio_descriptor_type)) {
-        bleio_descriptor_obj_t *descriptor = MP_OBJ_TO_PTR(attribute);
-        return descriptor->uuid;
-    }
-    if (mp_obj_is_type(attribute, &bleio_service_type)) {
-        bleio_service_obj_t *service = MP_OBJ_TO_PTR(attribute);
-        return service->uuid;
-    }
-    mp_raise_RuntimeError(translate("Invalid BLE attribute"));
-}

devices/ble_hci/common-hal/_bleio/Attribute.h

@@ -1,35 +0,0 @@
-/*
- * This file is part of the MicroPython project, http://micropython.org/
- *
- * The MIT License (MIT)
- *
- * Copyright (c) 2020 Dan Halbert for Adafruit Industries
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-#ifndef MICROPY_INCLUDED_BLE_HCI_COMMON_HAL_ATTRIBUTE_H
-#define MICROPY_INCLUDED_BLE_HCI_COMMON_HAL_ATTRIBUTE_H
-
-#include "shared-module/_bleio/Attribute.h"
-#include "shared-bindings/_bleio/UUID.h"
-
-bleio_uuid_obj_t *bleio_attribute_get_uuid(mp_obj_t *attribute);
-
-#endif // MICROPY_INCLUDED_BLE_HCI_COMMON_HAL_ATTRIBUTE_H

devices/ble_hci/common-hal/_bleio/Characteristic.c

@@ -1,232 +0,0 @@
-/*
- * This file is part of the MicroPython project, http://micropython.org/
- *
- * The MIT License (MIT)
- *
- * Copyright (c) Dan Halbert for Adafruit Industries
- * Copyright (c) 2018 Artur Pacholec
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-#include "py/runtime.h"
-
-#include "shared-bindings/_bleio/__init__.h"
-#include "shared-bindings/_bleio/Characteristic.h"
-#include "shared-bindings/_bleio/CharacteristicBuffer.h"
-#include "shared-bindings/_bleio/Descriptor.h"
-#include "shared-bindings/_bleio/PacketBuffer.h"
-#include "shared-bindings/_bleio/Service.h"
-
-#include "common-hal/_bleio/Adapter.h"
-#include "common-hal/_bleio/att.h"
-
-#define CCCD_NOTIFY   0x1
-#define CCCD_INDICATE 0x2
-
-
-void common_hal_bleio_characteristic_construct(bleio_characteristic_obj_t *self, bleio_service_obj_t *service, uint16_t handle, bleio_uuid_obj_t *uuid, bleio_characteristic_properties_t props, bleio_attribute_security_mode_t read_perm, bleio_attribute_security_mode_t write_perm, mp_int_t max_length, bool fixed_length, mp_buffer_info_t *initial_value_bufinfo) {
-    self->service = service;
-    self->uuid = uuid;
-    self->decl_handle = BLE_GATT_HANDLE_INVALID;
-    self->handle = BLE_GATT_HANDLE_INVALID;
-    self->props = props;
-    self->read_perm = read_perm;
-    self->write_perm = write_perm;
-    self->descriptor_list = mp_obj_new_list(0, NULL);
-    self->observer = mp_const_none;
-    self->user_desc = NULL;
-    self->cccd = NULL;
-    self->sccd = NULL;
-    self->value = mp_obj_new_bytes(initial_value_bufinfo->buf, initial_value_bufinfo->len);
-
-    const mp_int_t max_length_max = 512;
-    if (max_length < 0 || max_length > max_length_max) {
-        mp_raise_ValueError(translate("max_length must be <= 512"));
-    }
-    self->max_length = max_length;
-    self->fixed_length = fixed_length;
-
-    if (service->is_remote) {
-        self->handle = handle;
-    } else {
-        common_hal_bleio_service_add_characteristic(self->service, self, initial_value_bufinfo);
-    }
-}
-
-mp_obj_tuple_t *common_hal_bleio_characteristic_get_descriptors(bleio_characteristic_obj_t *self) {
-    return mp_obj_new_tuple(self->descriptor_list->len, self->descriptor_list->items);
-}
-
-bleio_service_obj_t *common_hal_bleio_characteristic_get_service(bleio_characteristic_obj_t *self) {
-    return self->service;
-}
-
-size_t common_hal_bleio_characteristic_get_max_length(bleio_characteristic_obj_t *self) {
-    return self->max_length;
-}
-
-size_t common_hal_bleio_characteristic_get_value(bleio_characteristic_obj_t *self, uint8_t *buf, size_t len) {
-    // Do GATT operations only if this characteristic has been added to a registered service.
-    if (self->handle != BLE_GATT_HANDLE_INVALID) {
-        // FIX uint16_t conn_handle = bleio_connection_get_conn_handle(self->service->connection);
-        if (common_hal_bleio_service_get_is_remote(self->service)) {
-            // FIX read remote chars
-            // uint8_t rsp[MAX(len, 512)];
-            // FIX improve att_read_req to write into our requested buffer.
-            // return att_read_req(conn_handle, self->handle, rsp);
-            return 0; // FIX
-        } else {
-            mp_buffer_info_t bufinfo;
-            if (!mp_get_buffer(self->value, &bufinfo, MP_BUFFER_READ)) {
-                return 0;
-            }
-            const size_t actual_length = MIN(len, bufinfo.len);
-            memcpy(buf, bufinfo.buf, actual_length);
-            return actual_length;
-        }
-    }
-
-    return 0;
-}
-
-void common_hal_bleio_characteristic_set_value(bleio_characteristic_obj_t *self, mp_buffer_info_t *bufinfo) {
-    if (self->fixed_length && bufinfo->len != self->max_length) {
-        mp_raise_ValueError(translate("Value length != required fixed length"));
-    }
-    if (bufinfo->len > self->max_length) {
-        mp_raise_ValueError(translate("Value length > max_length"));
-    }
-
-    // Do GATT operations only if this characteristic has been added to a registered service.
-    if (self->handle != BLE_GATT_HANDLE_INVALID) {
-        if (common_hal_bleio_service_get_is_remote(self->service)) {
-            // FIX uint16_t conn_handle = bleio_connection_get_conn_handle(self->service->connection);
-            if (self->props & CHAR_PROP_WRITE) {
-                // FIX writing remote chars
-                // uint8_t rsp[sizeof(bt_att_error_rsp)];
-                // att_write_req(conn_handle, self->handle, bufinfo->buf, bufinfo->len, rsp);
-            } else if (self->props & CHAR_PROP_WRITE_NO_RESPONSE) {
-                // att_write_cmd(conn_handle, self->handle, bufinfo->buff, bufinfo->len);
-            } else {
-                mp_raise_bleio_BluetoothError(translate("Characteristic not writable"));
-            }
-        } else {
-            // Always write the value locally even if no connections are active.
-            bleio_characteristic_set_local_value(self, bufinfo);
-            // Notify or indicate all active connections.
-
-            uint16_t cccd_value = 0;
-            mp_buffer_info_t cccd_bufinfo = {
-                .buf = &cccd_value,
-                .len = sizeof(cccd_value),
-            };
-
-            const bool notify = self->props & CHAR_PROP_NOTIFY;
-            const bool indicate = self->props & CHAR_PROP_INDICATE;
-            // Read the CCCD value, if there is one.
-            if ((notify | indicate) && self->cccd != NULL) {
-                common_hal_bleio_descriptor_get_value(self->cccd, cccd_bufinfo.buf, cccd_bufinfo.len);
-            }
-
-            // It's possible that both notify and indicate are set.
-            if (notify && (cccd_value & CCCD_NOTIFY)) {
-                att_notify(self->handle, bufinfo->buf, MIN(bufinfo->len, self->max_length));
-            }
-            if (indicate && (cccd_value & CCCD_INDICATE)) {
-                att_indicate(self->handle, bufinfo->buf, MIN(bufinfo->len, self->max_length));
-
-            }
-        }
-    }
-}
-
-bleio_uuid_obj_t *common_hal_bleio_characteristic_get_uuid(bleio_characteristic_obj_t *self) {
-    return self->uuid;
-}
-
-bleio_characteristic_properties_t common_hal_bleio_characteristic_get_properties(bleio_characteristic_obj_t *self) {
-    return self->props;
-}
-
-void common_hal_bleio_characteristic_add_descriptor(bleio_characteristic_obj_t *self, bleio_descriptor_obj_t *descriptor) {
-    if (self->handle != common_hal_bleio_adapter_obj.last_added_characteristic_handle) {
-        mp_raise_bleio_BluetoothError(
-            translate("Descriptor can only be added to most recently added characteristic"));
-    }
-
-    descriptor->handle = bleio_adapter_add_attribute(&common_hal_bleio_adapter_obj, MP_OBJ_TO_PTR(descriptor));
-    // Include this descriptor in the service handle's range.
-    self->service->end_handle = descriptor->handle;
-
-    mp_obj_list_append(MP_OBJ_FROM_PTR(self->descriptor_list),
-        MP_OBJ_FROM_PTR(descriptor));
-}
-
-void common_hal_bleio_characteristic_set_cccd(bleio_characteristic_obj_t *self, bool notify, bool indicate) {
-    if (self->cccd == NULL) {
-        mp_raise_bleio_BluetoothError(translate("No CCCD for this Characteristic"));
-    }
-
-    if (!common_hal_bleio_service_get_is_remote(self->service)) {
-        mp_raise_bleio_RoleError(translate("Can't set CCCD on local Characteristic"));
-    }
-
-    const uint16_t conn_handle = bleio_connection_get_conn_handle(self->service->connection);
-    common_hal_bleio_check_connected(conn_handle);
-
-    uint16_t cccd_value =
-        (notify ? CCCD_NOTIFY : 0) |
-        (indicate ? CCCD_INDICATE : 0);
-
-    // FIX do remote
-    (void)cccd_value;
-    // uint8_t rsp[sizeof(bt_att_error_rsp)];
-    // if (att_write_req(conn_handle, self->cccd->handle, &cccd_value, sizeof(cccd_value)) == 0) {
-    //     mp_raise_bleio_BluetoothError(translate("Could not write CCCD"));
-    // }
-}
-
-bool bleio_characteristic_set_local_value(bleio_characteristic_obj_t *self, mp_buffer_info_t *bufinfo) {
-    if (self->fixed_length && bufinfo->len != self->max_length) {
-        return false;
-    }
-    if (bufinfo->len > self->max_length) {
-        return false;
-    }
-
-    self->value = mp_obj_new_bytes(bufinfo->buf, bufinfo->len);
-
-    if (mp_obj_is_type(self->observer, &bleio_characteristic_buffer_type)) {
-        bleio_characteristic_buffer_update(MP_OBJ_FROM_PTR(self->observer), bufinfo);
-    } else if (mp_obj_is_type(self->observer, &bleio_packet_buffer_type)) {
-        bleio_packet_buffer_update(MP_OBJ_FROM_PTR(self->observer), bufinfo);
-    } else {
-        return false;
-    }
-    return true;
-}
-
-void bleio_characteristic_set_observer(bleio_characteristic_obj_t *self, mp_obj_t observer) {
-    self->observer = observer;
-}
-
-void bleio_characteristic_clear_observer(bleio_characteristic_obj_t *self) {
-    self->observer = mp_const_none;
-}

devices/ble_hci/common-hal/_bleio/Characteristic.h

@@ -1,63 +0,0 @@
-/*
- * This file is part of the MicroPython project, http://micropython.org/
- *
- * The MIT License (MIT)
- *
- * Copyright (c) 2019 Dan Halbert for Adafruit Industries
- * Copyright (c) 2018 Artur Pacholec
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-#ifndef MICROPY_INCLUDED_BLE_HCI_COMMON_HAL_CHARACTERISTIC_H
-#define MICROPY_INCLUDED_BLE_HCI_COMMON_HAL_CHARACTERISTIC_H
-
-#include "shared-bindings/_bleio/Attribute.h"
-#include "common-hal/_bleio/Descriptor.h"
-#include "shared-module/_bleio/Characteristic.h"
-#include "common-hal/_bleio/Service.h"
-#include "common-hal/_bleio/UUID.h"
-
-typedef struct _bleio_characteristic_obj {
-    mp_obj_base_t base;
-    // Will be MP_OBJ_NULL before being assigned to a Service.
-    bleio_service_obj_t *service;
-    bleio_uuid_obj_t *uuid;
-    mp_obj_t value;
-    mp_obj_t observer;
-    mp_obj_list_t *descriptor_list;
-    uint16_t max_length;
-    bool fixed_length;
-    uint16_t decl_handle;
-    uint16_t handle; // Should be decl_handle+1.
-    bleio_characteristic_properties_t props;
-    bleio_attribute_security_mode_t read_perm;
-    bleio_attribute_security_mode_t write_perm;
-    bleio_descriptor_obj_t *descriptor_linked_list;
-    bleio_descriptor_obj_t *user_desc;
-    bleio_descriptor_obj_t *cccd;
-    bleio_descriptor_obj_t *sccd;
-} bleio_characteristic_obj_t;
-
-bool bleio_characteristic_set_local_value(bleio_characteristic_obj_t *self, mp_buffer_info_t *bufinfo);
-
-void bleio_characteristic_set_observer(bleio_characteristic_obj_t *self, mp_obj_t observer);
-void bleio_characteristic_clear_observer(bleio_characteristic_obj_t *self);
-
-#endif // MICROPY_INCLUDED_BLE_HCI_COMMON_HAL_CHARACTERISTIC_H

devices/ble_hci/common-hal/_bleio/CharacteristicBuffer.c

@@ -1,104 +0,0 @@
-/*
- * This file is part of the MicroPython project, http://micropython.org/
- *
- * The MIT License (MIT)
- *
- * Copyright (c) 2019 Dan Halbert for Adafruit Industries
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-#include <string.h>
-#include <stdio.h>
-
-#include "lib/utils/interrupt_char.h"
-#include "py/runtime.h"
-#include "py/stream.h"
-
-#include "shared-bindings/_bleio/__init__.h"
-#include "shared-bindings/_bleio/Connection.h"
-#include "supervisor/shared/tick.h"
-#include "common-hal/_bleio/CharacteristicBuffer.h"
-
-// Push all the data onto the ring buffer. When the buffer is full, new bytes will be dropped.
-STATIC void write_to_ringbuf(bleio_characteristic_buffer_obj_t *self, uint8_t *data, uint16_t len) {
-    ringbuf_put_n(&self->ringbuf, data, len);
-}
-
-void bleio_characteristic_buffer_update(bleio_characteristic_buffer_obj_t *self, mp_buffer_info_t *bufinfo) {
-    write_to_ringbuf(self, bufinfo->buf, bufinfo->len);
-}
-
-// Assumes that timeout and buffer_size have been validated before call.
-void common_hal_bleio_characteristic_buffer_construct(bleio_characteristic_buffer_obj_t *self,
-    bleio_characteristic_obj_t *characteristic,
-    mp_float_t timeout,
-    size_t buffer_size) {
-
-    self->characteristic = characteristic;
-    self->timeout_ms = timeout * 1000;
-    // This is a macro.
-    // true means long-lived, so it won't be moved.
-    ringbuf_alloc(&self->ringbuf, buffer_size, true);
-
-    bleio_characteristic_set_observer(characteristic, self);
-}
-
-uint32_t common_hal_bleio_characteristic_buffer_read(bleio_characteristic_buffer_obj_t *self, uint8_t *data, size_t len, int *errcode) {
-    uint64_t start_ticks = supervisor_ticks_ms64();
-
-    // Wait for all bytes received or timeout
-    while ((ringbuf_num_filled(&self->ringbuf) < len) && (supervisor_ticks_ms64() - start_ticks < self->timeout_ms)) {
-        RUN_BACKGROUND_TASKS;
-        // Allow user to break out of a timeout with a KeyboardInterrupt.
-        if (mp_hal_is_interrupted()) {
-            return 0;
-        }
-    }
-
-    uint32_t num_bytes_read = ringbuf_get_n(&self->ringbuf, data, len);
-    return num_bytes_read;
-}
-
-uint32_t common_hal_bleio_characteristic_buffer_rx_characters_available(bleio_characteristic_buffer_obj_t *self) {
-    uint16_t count = ringbuf_num_filled(&self->ringbuf);
-    return count;
-}
-
-void common_hal_bleio_characteristic_buffer_clear_rx_buffer(bleio_characteristic_buffer_obj_t *self) {
-    ringbuf_clear(&self->ringbuf);
-}
-
-bool common_hal_bleio_characteristic_buffer_deinited(bleio_characteristic_buffer_obj_t *self) {
-    return self->characteristic == NULL;
-}
-
-void common_hal_bleio_characteristic_buffer_deinit(bleio_characteristic_buffer_obj_t *self) {
-    if (!common_hal_bleio_characteristic_buffer_deinited(self)) {
-        bleio_characteristic_clear_observer(self->characteristic);
-    }
-}
-
-bool common_hal_bleio_characteristic_buffer_connected(bleio_characteristic_buffer_obj_t *self) {
-    return self->characteristic != NULL &&
-           self->characteristic->service != NULL &&
-           (!self->characteristic->service->is_remote ||
-               (self->characteristic->service->connection != MP_OBJ_NULL &&
-                   common_hal_bleio_connection_get_connected(self->characteristic->service->connection)));
-}

devices/ble_hci/common-hal/_bleio/CharacteristicBuffer.h

@@ -1,43 +0,0 @@
-/*
- * This file is part of the MicroPython project, http://micropython.org/
- *
- * The MIT License (MIT)
- *
- * Copyright (c) 2019 Dan Halbert for Adafruit Industries
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-#ifndef MICROPY_INCLUDED_BLE_HCI_COMMON_HAL_CHARACTERISTICBUFFER_H
-#define MICROPY_INCLUDED_BLE_HCI_COMMON_HAL_CHARACTERISTICBUFFER_H
-
-#include "py/ringbuf.h"
-#include "shared-bindings/_bleio/Characteristic.h"
-
-typedef struct {
-    mp_obj_base_t base;
-    bleio_characteristic_obj_t *characteristic;
-    uint32_t timeout_ms;
-    // Ring buffer storing consecutive incoming values.
-    ringbuf_t ringbuf;
-} bleio_characteristic_buffer_obj_t;
-
-void bleio_characteristic_buffer_update(bleio_characteristic_buffer_obj_t *self, mp_buffer_info_t *bufinfo);
-
-#endif // MICROPY_INCLUDED_BLE_HCI_COMMON_HAL_CHARACTERISTICBUFFER_H

devices/ble_hci/common-hal/_bleio/Connection.c

@@ -1,772 +0,0 @@
-/*
- * This file is part of the MicroPython project, http://micropython.org/
- *
- * The MIT License (MIT)
- *
- * Copyright (c) 2018 Dan Halbert for Adafruit Industries
- * Copyright (c) 2018 Artur Pacholec
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-#include "shared-bindings/_bleio/Connection.h"
-
-#include "att.h"
-
-#include <string.h>
-#include <stdio.h>
-
-#include "lib/utils/interrupt_char.h"
-#include "py/gc.h"
-#include "py/objlist.h"
-#include "py/objstr.h"
-#include "py/qstr.h"
-#include "py/runtime.h"
-#include "shared-bindings/_bleio/__init__.h"
-#include "shared-bindings/_bleio/Adapter.h"
-#include "shared-bindings/_bleio/Attribute.h"
-#include "shared-bindings/_bleio/Characteristic.h"
-#include "shared-bindings/_bleio/Service.h"
-#include "shared-bindings/_bleio/UUID.h"
-#include "supervisor/shared/tick.h"
-
-#define BLE_ADV_LENGTH_FIELD_SIZE   1
-#define BLE_ADV_AD_TYPE_FIELD_SIZE  1
-#define BLE_AD_TYPE_FLAGS_DATA_SIZE 1
-
-// static const ble_gap_sec_params_t pairing_sec_params = {
-//     .bond = 1,
-//     .mitm = 0,
-//     .lesc = 0,
-//     .keypress = 0,
-//     .oob = 0,
-//     .io_caps = BLE_GAP_IO_CAPS_NONE,
-//     .min_key_size = 7,
-//     .max_key_size = 16,
-//     .kdist_own    = { .enc = 1, .id = 1},
-//     .kdist_peer   = { .enc = 1, .id = 1},
-// };
-
-#define CONNECTION_DEBUG (1)
-#if CONNECTION_DEBUG
-  #define CONNECTION_DEBUG_PRINTF(...) printf(__VA_ARGS__)
-#else
-  #define CONNECTION_DEBUG_PRINTF(...)
-#endif
-
-static volatile bool m_discovery_in_process;
-static volatile bool m_discovery_successful;
-
-// FIX static bleio_service_obj_t *m_char_discovery_service;
-// FIX static bleio_characteristic_obj_t *m_desc_discovery_characteristic;
-
-// bool connection_on_ble_evt(ble_evt_t *ble_evt, void *self_in) {
-//     bleio_connection_internal_t *self = (bleio_connection_internal_t*)self_in;
-
-//     if (BLE_GAP_EVT_BASE <= ble_evt->header.evt_id && ble_evt->header.evt_id <= BLE_GAP_EVT_LAST &&
-//         ble_evt->evt.gap_evt.conn_handle != self->conn_handle) {
-//         return false;
-//     }
-//     if (BLE_GATTS_EVT_BASE <= ble_evt->header.evt_id && ble_evt->header.evt_id <= BLE_GATTS_EVT_LAST &&
-//         ble_evt->evt.gatts_evt.conn_handle != self->conn_handle) {
-//         return false;
-//     }
-
-//     switch (ble_evt->header.evt_id) {
-//         case BLE_GAP_EVT_DISCONNECTED:
-//             // Adapter.c does the work for this event.
-//             break;
-
-//         case BLE_GAP_EVT_PHY_UPDATE_REQUEST: {
-//             ble_gap_phys_t const phys = {
-//                 .rx_phys = BLE_GAP_PHY_AUTO,
-//                 .tx_phys = BLE_GAP_PHY_AUTO,
-//             };
-//             sd_ble_gap_phy_update(ble_evt->evt.gap_evt.conn_handle, &phys);
-//             break;
-//         }
-
-//         case BLE_GAP_EVT_PHY_UPDATE: { // 0x22
-//             break;
-//         }
-
-//         case BLE_GAP_EVT_DATA_LENGTH_UPDATE_REQUEST:
-//             // SoftDevice will respond to a length update request.
-//             sd_ble_gap_data_length_update(self->conn_handle, NULL, NULL);
-//             break;
-
-//         case BLE_GAP_EVT_DATA_LENGTH_UPDATE: { // 0x24
-//             break;
-//         }
-
-//         case BLE_GATTS_EVT_EXCHANGE_MTU_REQUEST: {
-//             ble_gatts_evt_exchange_mtu_request_t *request =
-//                     &ble_evt->evt.gatts_evt.params.exchange_mtu_request;
-
-//             uint16_t new_mtu = BLE_GATTS_VAR_ATTR_LEN_MAX;
-//             if (request->client_rx_mtu < new_mtu) {
-//                 new_mtu = request->client_rx_mtu;
-//             }
-//             if (new_mtu < BLE_GATT_ATT_MTU_DEFAULT) {
-//                 new_mtu = BLE_GATT_ATT_MTU_DEFAULT;
-//             }
-//             if (self->mtu > 0) {
-//                 new_mtu = self->mtu;
-//             }
-
-//             self->mtu = new_mtu;
-//             sd_ble_gatts_exchange_mtu_reply(self->conn_handle, new_mtu);
-//             break;
-//         }
-
-
-//         case BLE_GATTC_EVT_EXCHANGE_MTU_RSP: {
-//             ble_gattc_evt_exchange_mtu_rsp_t *response =
-//                     &ble_evt->evt.gattc_evt.params.exchange_mtu_rsp;
-
-//             self->mtu = response->server_rx_mtu;
-//             break;
-//         }
-
-//         case BLE_GATTS_EVT_WRITE:
-//             // A client wrote a value.
-//             // If we are bonded and it's a CCCD (UUID 0x2902), store the CCCD value.
-//             if (self->conn_handle != BLE_CONN_HANDLE_INVALID &&
-//                 self->pair_status == PAIR_PAIRED &&
-//                 ble_evt->evt.gatts_evt.params.write.uuid.type == BLE_UUID_TYPE_BLE &&
-//                 ble_evt->evt.gatts_evt.params.write.uuid.uuid == 0x2902) {
-//                 //
-//                 // Save sys_attr data (CCCD state) in bonding area at
-//                 // next opportunity, but also remember time of this
-//                 // request, so we can consolidate closely-spaced requests.
-//                 self->do_bond_cccds = true;
-//                 self->do_bond_cccds_request_time = supervisor_ticks_ms64();
-//             }
-//             // Return false so other handlers get this event as well.
-//             return false;
-
-//         case BLE_GATTS_EVT_SYS_ATTR_MISSING:
-//             sd_ble_gatts_sys_attr_set(self->conn_handle, NULL, 0, 0);
-//             break;
-
-//         #if CIRCUITPY_VERBOSE_BLE
-//         // Use read authorization to snoop on all reads when doing verbose debugging.
-//         case BLE_GATTS_EVT_RW_AUTHORIZE_REQUEST: {
-
-//             ble_gatts_evt_rw_authorize_request_t *request =
-//                     &ble_evt->evt.gatts_evt.params.authorize_request;
-
-//             mp_printf(&mp_plat_print, "Read %x offset %d ", request->request.read.handle, request->request.read.offset);
-//             uint8_t value_bytes[22];
-//             ble_gatts_value_t value;
-//             value.offset = request->request.read.offset;
-//             value.len = 22;
-//             value.p_value = value_bytes;
-
-//             sd_ble_gatts_value_get(self->conn_handle, request->request.read.handle, &value);
-//             size_t len = value.len;
-//             if (len > 22) {
-//                 len = 22;
-//             }
-//             for (uint8_t i = 0; i < len; i++) {
-//                 mp_printf(&mp_plat_print, " %02x", value_bytes[i]);
-//             }
-//             mp_printf(&mp_plat_print, "\n");
-//             ble_gatts_rw_authorize_reply_params_t reply;
-//             reply.type = request->type;
-//             reply.params.read.gatt_status = BLE_GATT_STATUS_SUCCESS;
-//             reply.params.read.update = false;
-//             reply.params.read.offset = request->request.read.offset;
-//             sd_ble_gatts_rw_authorize_reply(self->conn_handle, &reply);
-//             break;
-//         }
-//         #endif
-
-//         case BLE_GATTS_EVT_HVN_TX_COMPLETE: // Capture this for now. 0x55
-//             break;
-//         case BLE_GAP_EVT_CONN_PARAM_UPDATE_REQUEST: {
-//             self->conn_params_updating = true;
-//             ble_gap_evt_conn_param_update_request_t *request =
-//                     &ble_evt->evt.gap_evt.params.conn_param_update_request;
-//             sd_ble_gap_conn_param_update(self->conn_handle, &request->conn_params);
-//             break;
-//         }
-//         case BLE_GAP_EVT_CONN_PARAM_UPDATE: { // 0x12
-//             ble_gap_evt_conn_param_update_t *result =
-//                     &ble_evt->evt.gap_evt.params.conn_param_update;
-
-//             #if CIRCUITPY_VERBOSE_BLE
-//             ble_gap_conn_params_t *cp = &ble_evt->evt.gap_evt.params.conn_param_update.conn_params;
-//             mp_printf(&mp_plat_print, "conn params updated: min_ci %d max_ci %d s_l %d sup_timeout %d\n", cp->min_conn_interval, cp->max_conn_interval, cp->slave_latency, cp->conn_sup_timeout);
-//             #endif
-
-//             memcpy(&self->conn_params, &result->conn_params, sizeof(ble_gap_conn_params_t));
-//             self->conn_params_updating = false;
-//             break;
-//         }
-//         case BLE_GAP_EVT_SEC_PARAMS_REQUEST: {
-//             // First time pairing.
-//             // 1. Either we or peer initiate the process
-//             // 2. Peer asks for security parameters using BLE_GAP_EVT_SEC_PARAMS_REQUEST.
-//             // 3. Pair Key exchange ("just works" implemented now; TODO: out-of-band key pairing)
-//             // 4. Connection is secured: BLE_GAP_EVT_CONN_SEC_UPDATE
-//             // 5. Long-term Keys exchanged: BLE_GAP_EVT_AUTH_STATUS
-
-//             bonding_clear_keys(&self->bonding_keys);
-//             self->ediv = EDIV_INVALID;
-//             ble_gap_sec_keyset_t keyset = {
-//                 .keys_own = {
-//                     .p_enc_key  = &self->bonding_keys.own_enc,
-//                     .p_id_key   = NULL,
-//                     .p_sign_key = NULL,
-//                     .p_pk       = NULL
-//                 },
-
-//                 .keys_peer = {
-//                     .p_enc_key  = &self->bonding_keys.peer_enc,
-//                     .p_id_key   = &self->bonding_keys.peer_id,
-//                     .p_sign_key = NULL,
-//                     .p_pk       = NULL
-//                 }
-//             };
-
-//             sd_ble_gap_sec_params_reply(self->conn_handle, BLE_GAP_SEC_STATUS_SUCCESS,
-//                                         self->is_central ? NULL : &pairing_sec_params,
-//                                         &keyset);
-//             break;
-//         }
-
-//         case BLE_GAP_EVT_LESC_DHKEY_REQUEST:
-//             // TODO for LESC pairing:
-//             // sd_ble_gap_lesc_dhkey_reply(...);
-//             break;
-
-//         case BLE_GAP_EVT_AUTH_STATUS: { // 0x19
-//             // Key exchange completed.
-//             ble_gap_evt_auth_status_t* status = &ble_evt->evt.gap_evt.params.auth_status;
-//             self->sec_status = status->auth_status;
-//             if (status->auth_status == BLE_GAP_SEC_STATUS_SUCCESS) {
-//                 self->ediv = self->bonding_keys.own_enc.master_id.ediv;
-//                 self->pair_status = PAIR_PAIRED;
-//                 // Save keys in bonding area at next opportunity.
-//                 self->do_bond_keys = true;
-//             } else {
-//                 // Inform busy-waiter pairing has failed.
-//                 self->pair_status = PAIR_NOT_PAIRED;
-//             }
-//             break;
-//         }
-
-//         case BLE_GAP_EVT_SEC_INFO_REQUEST: { // 0x14
-//             // Peer asks for the stored keys.
-//             // - load key and return if bonded previously.
-//             // - Else return NULL --> Initiate key exchange
-//             ble_gap_evt_sec_info_request_t* sec_info_request = &ble_evt->evt.gap_evt.params.sec_info_request;
-//             (void) sec_info_request;
-//             if ( bonding_load_keys(self->is_central, sec_info_request->master_id.ediv, &self->bonding_keys) ) {
-//                 sd_ble_gap_sec_info_reply(
-//                     self->conn_handle,
-//                     &self->bonding_keys.own_enc.enc_info,
-//                     &self->bonding_keys.peer_id.id_info,
-//                     NULL);
-//                 self->ediv = self->bonding_keys.own_enc.master_id.ediv;
-//             } else {
-//                 // We don't have stored keys. Ask for keys.
-//                 sd_ble_gap_sec_info_reply(self->conn_handle, NULL, NULL, NULL);
-//             }
-//             break;
-//         }
-
-//         case BLE_GAP_EVT_CONN_SEC_UPDATE: { // 0x1a
-//             // We get this both on first-time pairing and on subsequent pairings using stored keys.
-//             ble_gap_conn_sec_t* conn_sec = &ble_evt->evt.gap_evt.params.conn_sec_update.conn_sec;
-//             if (conn_sec->sec_mode.sm <= 1 && conn_sec->sec_mode.lv <= 1) {
-//                 // Security setup did not succeed:
-//                 // mode 0, level 0 means no access
-//                 // mode 1, level 1 means open link
-//                 // mode >=1 and/or level >=1 means encryption is set up
-//                 self->pair_status = PAIR_NOT_PAIRED;
-//             } else {
-//                 if (bonding_load_cccd_info(self->is_central, self->conn_handle, self->ediv)) {
-//                     // Did an sd_ble_gatts_sys_attr_set() with the stored sys_attr values.
-//                 } else {
-//                     // No matching bonding found, so use fresh system attributes.
-//                     sd_ble_gatts_sys_attr_set(self->conn_handle, NULL, 0, 0);
-//                 }
-//                 self->pair_status = PAIR_PAIRED;
-//             }
-//             break;
-//         }
-
-//         default:
-//             return false;
-//     }
-//     return true;
-// }
-
-void bleio_connection_clear(bleio_connection_internal_t *self) {
-    mp_obj_list_clear(MP_OBJ_FROM_PTR(self->remote_service_list));
-
-    self->conn_handle = BLE_CONN_HANDLE_INVALID;
-    self->pair_status = PAIR_NOT_PAIRED;
-    self->is_central = false;
-    // FIX bonding_clear_keys(&self->bonding_keys);
-}
-
-bool common_hal_bleio_connection_get_paired(bleio_connection_obj_t *self) {
-    if (self->connection == NULL) {
-        return false;
-    }
-    return self->connection->pair_status == PAIR_PAIRED;
-}
-
-bool common_hal_bleio_connection_get_connected(bleio_connection_obj_t *self) {
-    if (self->connection == NULL) {
-        return false;
-    }
-    return self->connection->conn_handle != BLE_CONN_HANDLE_INVALID;
-}
-
-void common_hal_bleio_connection_disconnect(bleio_connection_internal_t *self) {
-    hci_disconnect(self->conn_handle);
-}
-
-void common_hal_bleio_connection_pair(bleio_connection_internal_t *self, bool bond) {
-    self->pair_status = PAIR_WAITING;
-
-    // FIX check_nrf_error(sd_ble_gap_authenticate(self->conn_handle, &pairing_sec_params));
-
-    while (self->pair_status == PAIR_WAITING && !mp_hal_is_interrupted()) {
-        RUN_BACKGROUND_TASKS;
-    }
-    if (mp_hal_is_interrupted()) {
-        return;
-    }
-    // FIX    check_sec_status(self->sec_status);
-}
-
-mp_float_t common_hal_bleio_connection_get_connection_interval(bleio_connection_internal_t *self) {
-    while (self->conn_params_updating && !mp_hal_is_interrupted()) {
-        RUN_BACKGROUND_TASKS;
-    }
-    // FIX return 1.25f * self->conn_params.min_conn_interval;
-    return 0.0f;
-}
-
-// Return the current negotiated MTU length, minus overhead.
-mp_int_t common_hal_bleio_connection_get_max_packet_length(bleio_connection_internal_t *self) {
-    return (self->mtu == 0 ? BT_ATT_DEFAULT_LE_MTU : self->mtu) - 3;
-}
-
-void common_hal_bleio_connection_set_connection_interval(bleio_connection_internal_t *self, mp_float_t new_interval) {
-    // self->conn_params_updating = true;
-    // uint16_t interval = new_interval / 1.25f;
-    // self->conn_params.min_conn_interval = interval;
-    // self->conn_params.max_conn_interval = interval;
-    // uint32_t status = NRF_ERROR_BUSY;
-    // while (status == NRF_ERROR_BUSY) {
-    //     status = sd_ble_gap_conn_param_update(self->conn_handle, &self->conn_params);
-    //     RUN_BACKGROUND_TASKS;
-    // }
-    // check_nrf_error(status);
-}
-
-// service_uuid may be NULL, to discover all services.
-// STATIC bool discover_next_services(bleio_connection_internal_t* connection, uint16_t start_handle, ble_uuid_t *service_uuid) {
-//     m_discovery_successful = false;
-//     m_discovery_in_process = true;
-
-//     uint32_t nrf_err = NRF_ERROR_BUSY;
-//     while (nrf_err == NRF_ERROR_BUSY) {
-//         nrf_err = sd_ble_gattc_primary_services_discover(connection->conn_handle, start_handle, service_uuid);
-//     }
-//     check_nrf_error(nrf_err);
-
-//     // Wait for a discovery event.
-//     while (m_discovery_in_process) {
-//         MICROPY_VM_HOOK_LOOP;
-//     }
-//     return m_discovery_successful;
-// }
-
-// STATIC bool discover_next_characteristics(bleio_connection_internal_t* connection, bleio_service_obj_t *service, uint16_t start_handle) {
-//     m_char_discovery_service = service;
-
-//     ble_gattc_handle_range_t handle_range;
-//     handle_range.start_handle = start_handle;
-//     handle_range.end_handle = service->end_handle;
-
-//     m_discovery_successful = false;
-//     m_discovery_in_process = true;
-
-//     uint32_t err_code = sd_ble_gattc_characteristics_discover(connection->conn_handle, &handle_range);
-//     if (err_code != NRF_SUCCESS) {
-//         return false;
-//     }
-
-//     // Wait for a discovery event.
-//     while (m_discovery_in_process) {
-//         MICROPY_VM_HOOK_LOOP;
-//     }
-//     return m_discovery_successful;
-// }
-
-// STATIC bool discover_next_descriptors(bleio_connection_internal_t* connection, bleio_characteristic_obj_t *characteristic, uint16_t start_handle, uint16_t end_handle) {
-//     m_desc_discovery_characteristic = characteristic;
-
-//     ble_gattc_handle_range_t handle_range;
-//     handle_range.start_handle = start_handle;
-//     handle_range.end_handle = end_handle;
-
-//     m_discovery_successful = false;
-//     m_discovery_in_process = true;
-
-//     uint32_t err_code = sd_ble_gattc_descriptors_discover(connection->conn_handle, &handle_range);
-//     if (err_code != NRF_SUCCESS) {
-//         return false;
-//     }
-
-//     // Wait for a discovery event.
-//     while (m_discovery_in_process) {
-//         MICROPY_VM_HOOK_LOOP;
-//     }
-//     return m_discovery_successful;
-// }
-
-// STATIC void on_primary_srv_discovery_rsp(ble_gattc_evt_prim_srvc_disc_rsp_t *response, bleio_connection_internal_t* connection) {
-//     for (size_t i = 0; i < response->count; ++i) {
-//         ble_gattc_service_t *gattc_service = &response->services[i];
-
-//         bleio_service_obj_t *service = m_new_obj(bleio_service_obj_t);
-//         service->base.type = &bleio_service_type;
-
-//         // Initialize several fields at once.
-//         bleio_service_from_connection(service, bleio_connection_new_from_internal(connection));
-
-//         service->is_remote = true;
-//         service->start_handle = gattc_service->handle_range.start_handle;
-//         service->end_handle = gattc_service->handle_range.end_handle;
-//         service->handle = gattc_service->handle_range.start_handle;
-
-//         if (gattc_service->uuid.type != BLE_UUID_TYPE_UNKNOWN) {
-//             // Known service UUID.
-//             bleio_uuid_obj_t *uuid = m_new_obj(bleio_uuid_obj_t);
-//             uuid->base.type = &bleio_uuid_type;
-//             bleio_uuid_construct_from_nrf_ble_uuid(uuid, &gattc_service->uuid);
-//             service->uuid = uuid;
-//         } else {
-//             // The discovery response contained a 128-bit UUID that has not yet been registered with the
-//             // softdevice via sd_ble_uuid_vs_add(). We need to fetch the 128-bit value and register it.
-//             // For now, just set the UUID to NULL.
-//             service->uuid = NULL;
-//         }
-//
-//         mp_obj_list_append(MP_OBJ_FROM_PTR(connection->remote_service_list),
-//                            MP_OBJ_FROM_PTR(service));
-//     }
-//
-//     if (response->count > 0) {
-//         m_discovery_successful = true;
-//     }
-//     m_discovery_in_process = false;
-// }
-
-// STATIC void on_char_discovery_rsp(ble_gattc_evt_char_disc_rsp_t *response, bleio_connection_internal_t* connection) {
-//     for (size_t i = 0; i < response->count; ++i) {
-//         ble_gattc_char_t *gattc_char = &response->chars[i];
-
-//         bleio_characteristic_obj_t *characteristic = m_new_obj(bleio_characteristic_obj_t);
-//         characteristic->base.type = &bleio_characteristic_type;
-
-//         bleio_uuid_obj_t *uuid = NULL;
-
-//         if (gattc_char->uuid.type != BLE_UUID_TYPE_UNKNOWN) {
-//             // Known characteristic UUID.
-//             uuid = m_new_obj(bleio_uuid_obj_t);
-//             uuid->base.type = &bleio_uuid_type;
-//             bleio_uuid_construct_from_nrf_ble_uuid(uuid, &gattc_char->uuid);
-//         } else {
-//             // The discovery response contained a 128-bit UUID that has not yet been registered with the
-//             // softdevice via sd_ble_uuid_vs_add(). We need to fetch the 128-bit value and register it.
-//             // For now, just leave the UUID as NULL.
-//         }
-
-//         bleio_characteristic_properties_t props =
-//             (gattc_char->char_props.broadcast ? CHAR_PROP_BROADCAST : 0) |
-//             (gattc_char->char_props.indicate ? CHAR_PROP_INDICATE : 0) |
-//             (gattc_char->char_props.notify ? CHAR_PROP_NOTIFY : 0) |
-//             (gattc_char->char_props.read ? CHAR_PROP_READ : 0) |
-//             (gattc_char->char_props.write ? CHAR_PROP_WRITE : 0) |
-//             (gattc_char->char_props.write_wo_resp ? CHAR_PROP_WRITE_NO_RESPONSE : 0);
-
-//         // Call common_hal_bleio_characteristic_construct() to initalize some fields and set up evt handler.
-//         common_hal_bleio_characteristic_construct(
-//             characteristic, m_char_discovery_service, gattc_char->handle_value, uuid,
-//             props, SECURITY_MODE_OPEN, SECURITY_MODE_OPEN,
-//             GATT_MAX_DATA_LENGTH, false,   // max_length, fixed_length: values may not matter for gattc
-//             NULL);
-
-//         mp_obj_list_append(MP_OBJ_FROM_PTR(m_char_discovery_service->characteristic_list),
-//                            MP_OBJ_FROM_PTR(characteristic));
-//     }
-
-//     if (response->count > 0) {
-//         m_discovery_successful = true;
-//     }
-//     m_discovery_in_process = false;
-// }
-
-// STATIC void on_desc_discovery_rsp(ble_gattc_evt_desc_disc_rsp_t *response, bleio_connection_internal_t* connection) {
-//     for (size_t i = 0; i < response->count; ++i) {
-//         ble_gattc_desc_t *gattc_desc = &response->descs[i];
-
-//         // Remember handles for certain well-known descriptors.
-//         switch (gattc_desc->uuid.uuid) {
-//             case BLE_UUID_DESCRIPTOR_CLIENT_CHAR_CONFIG:
-//                 m_desc_discovery_characteristic->cccd_handle = gattc_desc->handle;
-//                 break;
-
-//             case BLE_UUID_DESCRIPTOR_SERVER_CHAR_CONFIG:
-//                 m_desc_discovery_characteristic->sccd_handle = gattc_desc->handle;
-//                 break;
-
-//             case BLE_UUID_DESCRIPTOR_CHAR_USER_DESC:
-//                 m_desc_discovery_characteristic->user_desc_handle = gattc_desc->handle;
-//                 break;
-
-//             default:
-//                 // TODO: sd_ble_gattc_descriptors_discover() can return things that are not descriptors,
-//                 // so ignore those.
-//                 // https://devzone.nordicsemi.com/f/nordic-q-a/49500/sd_ble_gattc_descriptors_discover-is-returning-attributes-that-are-not-descriptors
-//                 break;
-//         }
-
-//         bleio_descriptor_obj_t *descriptor = m_new_obj(bleio_descriptor_obj_t);
-//         descriptor->base.type = &bleio_descriptor_type;
-
-//         bleio_uuid_obj_t *uuid = NULL;
-
-//         if (gattc_desc->uuid.type != BLE_UUID_TYPE_UNKNOWN) {
-//             // Known descriptor UUID.
-//             uuid = m_new_obj(bleio_uuid_obj_t);
-//             uuid->base.type = &bleio_uuid_type;
-//             bleio_uuid_construct_from_nrf_ble_uuid(uuid, &gattc_desc->uuid);
-//         } else {
-//             // The discovery response contained a 128-bit UUID that has not yet been registered with the
-//             // softdevice via sd_ble_uuid_vs_add(). We need to fetch the 128-bit value and register it.
-//             // For now, just leave the UUID as NULL.
-//         }
-
-//         common_hal_bleio_descriptor_construct(
-//             descriptor, m_desc_discovery_characteristic, uuid,
-//             SECURITY_MODE_OPEN, SECURITY_MODE_OPEN,
-//             GATT_MAX_DATA_LENGTH, false, mp_const_empty_bytes);
-//         descriptor->handle = gattc_desc->handle;
-
-//         mp_obj_list_append(MP_OBJ_FROM_PTR(m_desc_discovery_characteristic->descriptor_list),
-//                            MP_OBJ_FROM_PTR(descriptor));
-//     }
-
-//     if (response->count > 0) {
-//         m_discovery_successful = true;
-//     }
-//     m_discovery_in_process = false;
-// }
-
-// STATIC bool discovery_on_ble_evt(ble_evt_t *ble_evt, mp_obj_t payload) {
-//     bleio_connection_internal_t* connection = MP_OBJ_TO_PTR(payload);
-//     switch (ble_evt->header.evt_id) {
-//         case BLE_GAP_EVT_DISCONNECTED:
-//             m_discovery_successful = false;
-//             m_discovery_in_process = false;
-//             break;
-
-//         case BLE_GATTC_EVT_PRIM_SRVC_DISC_RSP:
-//             on_primary_srv_discovery_rsp(&ble_evt->evt.gattc_evt.params.prim_srvc_disc_rsp, connection);
-//             break;
-
-//         case BLE_GATTC_EVT_CHAR_DISC_RSP:
-//             on_char_discovery_rsp(&ble_evt->evt.gattc_evt.params.char_disc_rsp, connection);
-//             break;
-
-//         case BLE_GATTC_EVT_DESC_DISC_RSP:
-//             on_desc_discovery_rsp(&ble_evt->evt.gattc_evt.params.desc_disc_rsp, connection);
-//             break;
-
-//         default:
-//             // CONNECTION_DEBUG_PRINTF(&mp_plat_print, "Unhandled discovery event: 0x%04x\n", ble_evt->header.evt_id);
-//             return false;
-//             break;
-//     }
-//     return true;
-// }
-
-// STATIC void discover_remote_services(bleio_connection_internal_t *self, mp_obj_t service_uuids_whitelist) {
-//     ble_drv_add_event_handler(discovery_on_ble_evt, self);
-
-//     // Start over with an empty list.
-//     self->remote_service_list = mp_obj_new_list(0, NULL);
-
-
-//     if (service_uuids_whitelist == mp_const_none) {
-//         // List of service UUID's not given, so discover all available services.
-
-//         uint16_t next_service_start_handle = BLE_GATT_HANDLE_START;
-
-//         while (discover_next_services(self, next_service_start_handle, MP_OBJ_NULL)) {
-//             // discover_next_services() appends to remote_services_list.
-
-//             // Get the most recently discovered service, and then ask for services
-//             // whose handles start after the last attribute handle inside that service.
-//             // There must be at least one if discover_next_services() returned true.
-//             const bleio_service_obj_t *service =
-//                 self->remote_service_list->items[self->remote_service_list->len - 1];
-//             next_service_start_handle = service->end_handle + 1;
-//         }
-//     } else {
-//         mp_obj_iter_buf_t iter_buf;
-//         mp_obj_t iterable = mp_getiter(service_uuids_whitelist, &iter_buf);
-//         mp_obj_t uuid_obj;
-//         while ((uuid_obj = mp_iternext(iterable)) != MP_OBJ_STOP_ITERATION) {
-//             if (!mp_obj_is_type(uuid_obj, &bleio_uuid_type)) {
-//                 mp_raise_TypeError(translate("non-UUID found in service_uuids_whitelist"));
-//             }
-//             bleio_uuid_obj_t *uuid = MP_OBJ_TO_PTR(uuid_obj);
-
-//             ble_uuid_t nrf_uuid;
-//             bleio_uuid_convert_to_nrf_ble_uuid(uuid, &nrf_uuid);
-
-//             // Service might or might not be discovered; that's ok. Caller has to check
-//             // Central.remote_services to find out.
-//             // We only need to call this once for each service to discover.
-//             discover_next_services(self, BLE_GATT_HANDLE_START, &nrf_uuid);
-//         }
-//     }
-
-
-//     for (size_t i = 0; i < self->remote_service_list->len; i++) {
-//         bleio_service_obj_t *service = MP_OBJ_TO_PTR(self->remote_service_list->items[i]);
-//         // Skip the service if it had an unknown (unregistered) UUID.
-//         if (service->uuid == NULL) {
-//             continue;
-//         }
-
-//         uint16_t next_char_start_handle = service->start_handle;
-
-//         // Stop when we go past the end of the range of handles for this service or
-//         // discovery call returns nothing.
-//         // discover_next_characteristics() appends to the characteristic_list.
-//         while (next_char_start_handle <= service->end_handle &&
-//                discover_next_characteristics(self, service, next_char_start_handle)) {
-
-
-//             // Get the most recently discovered characteristic, and then ask for characteristics
-//             // whose handles start after the last attribute handle inside that characteristic.
-//             const bleio_characteristic_obj_t *characteristic =
-//                 MP_OBJ_TO_PTR(service->characteristic_list->items[service->characteristic_list->len - 1]);
-
-//             next_char_start_handle = characteristic->handle + 1;
-//         }
-
-//         // Got characteristics for this service. Now discover descriptors for each characteristic.
-//         size_t char_list_len = service->characteristic_list->len;
-//         for (size_t char_idx = 0; char_idx < char_list_len; ++char_idx) {
-//             bleio_characteristic_obj_t *characteristic =
-//                 MP_OBJ_TO_PTR(service->characteristic_list->items[char_idx]);
-//             const bool last_characteristic = char_idx == char_list_len - 1;
-//             bleio_characteristic_obj_t *next_characteristic = last_characteristic
-//                 ? NULL
-//                 : MP_OBJ_TO_PTR(service->characteristic_list->items[char_idx + 1]);
-
-//             // Skip the characteristic if it had an unknown (unregistered) UUID.
-//             if (characteristic->uuid == NULL) {
-//                 continue;
-//             }
-
-//             uint16_t next_desc_start_handle = characteristic->handle + 1;
-
-//             // Don't run past the end of this service or the beginning of the next characteristic.
-//             uint16_t next_desc_end_handle = next_characteristic == NULL
-//                 ? service->end_handle
-//                 : next_characteristic->handle - 1;
-
-//             // Stop when we go past the end of the range of handles for this service or
-//             // discovery call returns nothing.
-//             // discover_next_descriptors() appends to the descriptor_linked_list.
-//             while (next_desc_start_handle <= service->end_handle &&
-//                    next_desc_start_handle <= next_desc_end_handle &&
-//                    discover_next_descriptors(self, characteristic,
-//                                              next_desc_start_handle, next_desc_end_handle)) {
-//                 // Get the most recently discovered descriptor, and then ask for descriptors
-//                 // whose handles start after that descriptor's handle.
-//                 // There must be at least one if discover_next_descriptors() returned true.
-//                 const bleio_descriptor_obj_t *descriptor =
-//                     characteristic->descriptor_list->items[characteristic->descriptor_list->len - 1];
-//                 next_desc_start_handle = descriptor->handle + 1;
-//             }
-//         }
-//     }
-
-//     // This event handler is no longer needed.
-//     ble_drv_remove_event_handler(discovery_on_ble_evt, self);
-
-// }
-
-mp_obj_tuple_t *common_hal_bleio_connection_discover_remote_services(bleio_connection_obj_t *self, mp_obj_t service_uuids_whitelist) {
-    // FIX discover_remote_services(self->connection, service_uuids_whitelist);
-    bleio_connection_ensure_connected(self);
-    // Convert to a tuple and then clear the list so the callee will take ownership.
-    mp_obj_tuple_t *services_tuple =
-        mp_obj_new_tuple(self->connection->remote_service_list->len,
-            self->connection->remote_service_list->items);
-    mp_obj_list_clear(MP_OBJ_FROM_PTR(self->connection->remote_service_list));
-    return services_tuple;
-}
-
-uint16_t bleio_connection_get_conn_handle(bleio_connection_obj_t *self) {
-    if (self == NULL || self->connection == NULL) {
-        return BLE_CONN_HANDLE_INVALID;
-    }
-    return self->connection->conn_handle;
-}
-
-mp_obj_t bleio_connection_new_from_internal(bleio_connection_internal_t *internal) {
-    if (internal->connection_obj != mp_const_none) {
-        return internal->connection_obj;
-    }
-    bleio_connection_obj_t *connection = m_new_obj(bleio_connection_obj_t);
-    connection->base.type = &bleio_connection_type;
-    connection->connection = internal;
-    internal->connection_obj = connection;
-
-    return MP_OBJ_FROM_PTR(connection);
-}
-
-// Find the connection that uses the given conn_handle. Return NULL if not found.
-bleio_connection_internal_t *bleio_conn_handle_to_connection(uint16_t conn_handle) {
-    bleio_connection_internal_t *connection;
-    for (size_t i = 0; i < BLEIO_TOTAL_CONNECTION_COUNT; i++) {
-        connection = &bleio_connections[i];
-        if (connection->conn_handle == conn_handle) {
-            return connection;
-        }
-    }
-
-    return NULL;
-}

devices/ble_hci/common-hal/_bleio/Connection.h

@@ -1,89 +0,0 @@
-/*
- * This file is part of the MicroPython project, http://micropython.org/
- *
- * The MIT License (MIT)
- *
- * Copyright (c) 2019 Dan Halbert for Adafruit Industries
- * Copyright (c) 2018 Artur Pacholec
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-#ifndef MICROPY_INCLUDED_BLE_HCI_COMMON_HAL_CONNECTION_H
-#define MICROPY_INCLUDED_BLE_HCI_COMMON_HAL_CONNECTION_H
-
-#include <stdbool.h>
-
-#include "py/obj.h"
-#include "py/objlist.h"
-
-#include "common-hal/_bleio/__init__.h"
-#include "shared-module/_bleio/Address.h"
-#include "common-hal/_bleio/Service.h"
-
-typedef enum {
-    PAIR_NOT_PAIRED,
-    PAIR_WAITING,
-    PAIR_PAIRED,
-} pair_status_t;
-
-// We split the Connection object into two so that the internal mechanics can live outside of the
-// VM. If it were one object, then we'd risk user code seeing a connection object of theirs be
-// reused.
-typedef struct {
-    uint16_t conn_handle;
-    bool is_central;
-    // Remote services discovered when this peripheral is acting as a client.
-    mp_obj_list_t *remote_service_list;
-    // The advertising data and scan response buffers are held by us, not by the SD, so we must
-    // maintain them and not change it. If we need to change the contents during advertising,
-    // there are tricks to get the SD to notice (see DevZone - TBS).
-    bonding_keys_t bonding_keys;
-    // EDIV: Encrypted Diversifier: Identifies LTK during legacy pairing.
-    uint16_t ediv;
-    volatile pair_status_t pair_status;
-    uint8_t sec_status; // Internal security status.
-    mp_obj_t connection_obj;
-    // REMOVE ble_gap_conn_params_t conn_params;
-    volatile bool conn_params_updating;
-    uint16_t mtu;
-    // Request that CCCD values for this connection be saved, using sys_attr values.
-    volatile bool do_bond_cccds;
-    // Request that security key info for this connection be saved.
-    volatile bool do_bond_keys;
-    // Time of setting do_bond_ccds: we delay a bit to consolidate multiple CCCD changes
-    // into one write. Time is currently in ticks_ms.
-    uint64_t do_bond_cccds_request_time;
-    // FIX from att.c
-    uint8_t role;
-    bt_addr_le_t addr;
-} bleio_connection_internal_t;
-
-typedef struct {
-    mp_obj_base_t base;
-    bleio_connection_internal_t *connection;
-    // The HCI disconnect reason.
-    uint8_t disconnect_reason;
-} bleio_connection_obj_t;
-
-uint16_t bleio_connection_get_conn_handle(bleio_connection_obj_t *self);
-mp_obj_t bleio_connection_new_from_internal(bleio_connection_internal_t *connection);
-bleio_connection_internal_t *bleio_conn_handle_to_connection(uint16_t conn_handle);
-
-#endif // MICROPY_INCLUDED_BLE_HCI_COMMON_HAL_CONNECTION_H

devices/ble_hci/common-hal/_bleio/Descriptor.c

@@ -1,114 +0,0 @@
-/*
- * This file is part of the MicroPython project, http://micropython.org/
- *
- * The MIT License (MIT)
- *
- * Copyright (c) 2019 Dan Halbert for Adafruit Industries
- * Copyright (c) 2018 Artur Pacholec
- * Copyright (c) 2016 Glenn Ruben Bakke
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-#include "py/runtime.h"
-
-#include "shared-bindings/_bleio/__init__.h"
-#include "shared-bindings/_bleio/Descriptor.h"
-#include "shared-bindings/_bleio/Service.h"
-#include "shared-bindings/_bleio/UUID.h"
-
-void common_hal_bleio_descriptor_construct(bleio_descriptor_obj_t *self, bleio_characteristic_obj_t *characteristic, bleio_uuid_obj_t *uuid, bleio_attribute_security_mode_t read_perm, bleio_attribute_security_mode_t write_perm, mp_int_t max_length, bool fixed_length, mp_buffer_info_t *initial_value_bufinfo) {
-    self->characteristic = characteristic;
-    self->uuid = uuid;
-    self->handle = BLE_GATT_HANDLE_INVALID;
-    self->read_perm = read_perm;
-    self->write_perm = write_perm;
-    self->value = mp_obj_new_bytes(initial_value_bufinfo->buf, initial_value_bufinfo->len);
-
-    const mp_int_t max_length_max = fixed_length ? BLE_GATTS_FIX_ATTR_LEN_MAX : BLE_GATTS_VAR_ATTR_LEN_MAX;
-    if (max_length < 0 || max_length > max_length_max) {
-        mp_raise_ValueError_varg(translate("max_length must be 0-%d when fixed_length is %s"),
-            max_length_max, fixed_length ? "True" : "False");
-    }
-    self->max_length = max_length;
-    self->fixed_length = fixed_length;
-
-    common_hal_bleio_descriptor_set_value(self, initial_value_bufinfo);
-}
-
-bleio_uuid_obj_t *common_hal_bleio_descriptor_get_uuid(bleio_descriptor_obj_t *self) {
-    return self->uuid;
-}
-
-bleio_characteristic_obj_t *common_hal_bleio_descriptor_get_characteristic(bleio_descriptor_obj_t *self) {
-    return self->characteristic;
-}
-
-size_t common_hal_bleio_descriptor_get_value(bleio_descriptor_obj_t *self, uint8_t *buf, size_t len) {
-    // Do GATT operations only if this descriptor has been registered
-    if (self->handle != BLE_GATT_HANDLE_INVALID) {
-        if (common_hal_bleio_service_get_is_remote(self->characteristic->service)) {
-            // uint16_t conn_handle = bleio_connection_get_conn_handle(self->characteristic->service->connection);
-            // FIX have att_read_req fill in a buffer
-            // uint8_t rsp[MAX(len, 512)];
-            // return att_read_req(conn_handle, self->handle, rsp, len);
-            return 0;
-        } else {
-            mp_buffer_info_t bufinfo;
-            if (!mp_get_buffer(self->value, &bufinfo, MP_BUFFER_READ)) {
-                return 0;
-            }
-            const size_t actual_length = MIN(len, bufinfo.len);
-            memcpy(buf, bufinfo.buf, actual_length);
-            return actual_length;
-        }
-    }
-
-    return 0;
-}
-
-void common_hal_bleio_descriptor_set_value(bleio_descriptor_obj_t *self, mp_buffer_info_t *bufinfo) {
-    if (self->fixed_length && bufinfo->len != self->max_length) {
-        mp_raise_ValueError(translate("Value length != required fixed length"));
-    }
-    if (bufinfo->len > self->max_length) {
-        mp_raise_ValueError(translate("Value length > max_length"));
-    }
-
-    self->value = mp_obj_new_bytes(bufinfo->buf, bufinfo->len);
-
-    // Do GATT operations only if this descriptor has been registered.
-    if (self->handle != BLE_GATT_HANDLE_INVALID) {
-        if (common_hal_bleio_service_get_is_remote(self->characteristic->service)) {
-            // FIX
-            // uint16_t conn_handle = bleio_connection_get_conn_handle(self->service->connection);
-            // att_write_req(conn_handle, self->handle, bufinfo->buf, bufinfo->len, rsp);
-        } else {
-            // Always write the value locally even if no connections are active.
-            if (self->fixed_length && bufinfo->len != self->max_length) {
-                return;
-            }
-            if (bufinfo->len > self->max_length) {
-                return;
-            }
-
-            self->value = mp_obj_new_bytes(bufinfo->buf, bufinfo->len);
-        }
-    }
-}

devices/ble_hci/common-hal/_bleio/Descriptor.h

@@ -1,53 +0,0 @@
-/*
- * This file is part of the MicroPython project, http://micropython.org/
- *
- * The MIT License (MIT)
- *
- * Copyright (c) 2018 Dan Halbert for Adafruit Industries
- * Copyright (c) 2018 Artur Pacholec
- * Copyright (c) 2016 Glenn Ruben Bakke
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-#ifndef MICROPY_INCLUDED_BLE_HCI_COMMON_HAL_DESCRIPTOR_H
-#define MICROPY_INCLUDED_BLE_HCI_COMMON_HAL_DESCRIPTOR_H
-
-#include "py/obj.h"
-
-#include "common-hal/_bleio/UUID.h"
-
-// Forward declare characteristic because it includes a Descriptor.
-struct _bleio_characteristic_obj;
-
-typedef struct _bleio_descriptor_obj {
-    mp_obj_base_t base;
-    // Will be MP_OBJ_NULL before being assigned to a Characteristic.
-    struct _bleio_characteristic_obj *characteristic;
-    bleio_uuid_obj_t *uuid;
-    mp_obj_t value;
-    uint16_t max_length;
-    bool fixed_length;
-    uint16_t handle;
-    bleio_attribute_security_mode_t read_perm;
-    bleio_attribute_security_mode_t write_perm;
-    struct _bleio_descriptor_obj *next;
-} bleio_descriptor_obj_t;
-
-#endif // MICROPY_INCLUDED_BLE_HCI_COMMON_HAL_DESCRIPTOR_H

devices/ble_hci/common-hal/_bleio/PacketBuffer.c

@@ -1,267 +0,0 @@
-/*
- * This file is part of the MicroPython project, http://micropython.org/
- *
- * The MIT License (MIT)
- *
- * Copyright (c) 2019-2020 Scott Shawcroft for Adafruit Industries
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-#include <string.h>
-#include <stdio.h>
-
-#include "lib/utils/interrupt_char.h"
-#include "py/runtime.h"
-#include "py/stream.h"
-
-#include "shared-bindings/_bleio/__init__.h"
-#include "shared-bindings/_bleio/Connection.h"
-#include "shared-bindings/_bleio/PacketBuffer.h"
-#include "supervisor/shared/tick.h"
-
-STATIC void write_to_ringbuf(bleio_packet_buffer_obj_t *self, uint8_t *data, uint16_t len) {
-    if (len + sizeof(uint16_t) > ringbuf_capacity(&self->ringbuf)) {
-        // This shouldn't happen.
-        return;
-    }
-    // Push all the data onto the ring buffer.
-    // Make room for the new value by dropping the oldest packets first.
-    while (ringbuf_capacity(&self->ringbuf) - ringbuf_num_filled(&self->ringbuf) < len + sizeof(uint16_t)) {
-        uint16_t packet_length;
-        ringbuf_get_n(&self->ringbuf, (uint8_t *)&packet_length, sizeof(uint16_t));
-        for (uint16_t i = 0; i < packet_length; i++) {
-            ringbuf_get(&self->ringbuf);
-        }
-        // set an overflow flag?
-    }
-    ringbuf_put_n(&self->ringbuf, (uint8_t *)&len, sizeof(uint16_t));
-    ringbuf_put_n(&self->ringbuf, data, len);
-}
-
-STATIC uint32_t queue_next_write(bleio_packet_buffer_obj_t *self) {
-    // Queue up the next outgoing buffer. We use two, one that has been passed to the SD for
-    // transmission (when packet_queued is true) and the other is `pending` and can still be
-    // modified. By primarily appending to the `pending` buffer we can reduce the protocol overhead
-    // of the lower level link and ATT layers.
-    self->packet_queued = false;
-    if (self->pending_size > 0) {
-        mp_buffer_info_t bufinfo = {
-            .buf = self->outgoing[self->pending_index],
-            .len = self->pending_size,
-        };
-        common_hal_bleio_characteristic_set_value(self->characteristic, &bufinfo);
-
-        self->pending_size = 0;
-        self->pending_index = (self->pending_index + 1) % 2;
-        self->packet_queued = true;
-    }
-    return 0;
-}
-
-void bleio_packet_buffer_update(bleio_packet_buffer_obj_t *self, mp_buffer_info_t *bufinfo) {
-    write_to_ringbuf(self, bufinfo->buf, bufinfo->len);
-}
-
-void common_hal_bleio_packet_buffer_construct(
-    bleio_packet_buffer_obj_t *self, bleio_characteristic_obj_t *characteristic,
-    size_t buffer_size, size_t max_packet_size) {
-
-    self->characteristic = characteristic;
-    self->client = self->characteristic->service->is_remote;
-    bleio_characteristic_properties_t incoming =
-        self->characteristic->props & (CHAR_PROP_WRITE_NO_RESPONSE | CHAR_PROP_WRITE);
-    bleio_characteristic_properties_t outgoing =
-        self->characteristic->props & (CHAR_PROP_NOTIFY | CHAR_PROP_INDICATE);
-
-    if (self->client) {
-        // Swap if we're the client.
-        bleio_characteristic_properties_t temp = incoming;
-        incoming = outgoing;
-        outgoing = temp;
-        self->conn_handle = bleio_connection_get_conn_handle(MP_OBJ_TO_PTR(self->characteristic->service->connection));
-    } else {
-        self->conn_handle = BLE_CONN_HANDLE_INVALID;
-    }
-
-    if (incoming) {
-        if (!ringbuf_alloc(&self->ringbuf, buffer_size * (sizeof(uint16_t) + max_packet_size), false)) {
-            mp_raise_ValueError(translate("Buffer too large and unable to allocate"));
-        }
-    }
-
-    if (outgoing) {
-        self->packet_queued = false;
-        self->pending_index = 0;
-        self->pending_size = 0;
-        self->outgoing[0] = m_malloc(max_packet_size, false);
-        self->outgoing[1] = m_malloc(max_packet_size, false);
-    } else {
-        self->outgoing[0] = NULL;
-        self->outgoing[1] = NULL;
-    }
-    self->max_packet_size = max_packet_size;
-
-    bleio_characteristic_set_observer(self->characteristic, self);
-}
-
-mp_int_t common_hal_bleio_packet_buffer_readinto(bleio_packet_buffer_obj_t *self, uint8_t *data, size_t len) {
-    if (ringbuf_num_filled(&self->ringbuf) < 2) {
-        return 0;
-    }
-
-    // Copy received data.
-    // Get packet length, which is in first two bytes of packet.
-    uint16_t packet_length;
-    ringbuf_get_n(&self->ringbuf, (uint8_t *)&packet_length, sizeof(uint16_t));
-
-    mp_int_t ret;
-    if (packet_length > len) {
-        // Packet is longer than requested. Return negative of overrun value.
-        ret = len - packet_length;
-        // Discard the packet if it's too large. Don't fill data.
-        while (packet_length--) {
-            (void)ringbuf_get(&self->ringbuf);
-        }
-    } else {
-        // Read as much as possible, but might be shorter than len.
-        ringbuf_get_n(&self->ringbuf, data, packet_length);
-        ret = packet_length;
-    }
-
-    return ret;
-}
-
-mp_int_t common_hal_bleio_packet_buffer_write(bleio_packet_buffer_obj_t *self, uint8_t *data, size_t len, uint8_t *header, size_t header_len) {
-    if (self->outgoing[0] == NULL) {
-        mp_raise_bleio_BluetoothError(translate("Writes not supported on Characteristic"));
-    }
-    if (self->conn_handle == BLE_CONN_HANDLE_INVALID) {
-        return -1;
-    }
-    uint16_t outgoing_packet_length = common_hal_bleio_packet_buffer_get_outgoing_packet_length(self);
-
-    if (len + header_len > outgoing_packet_length) {
-        // Supplied data will not fit in a single BLE packet.
-        mp_raise_ValueError(translate("Total data to write is larger than outgoing_packet_length"));
-    }
-
-    if (len + self->pending_size > outgoing_packet_length) {
-        // No room to append len bytes to packet. Wait until we get a free buffer,
-        // and keep checking that we haven't been disconnected.
-        while (self->pending_size != 0 && self->conn_handle != BLE_CONN_HANDLE_INVALID) {
-            RUN_BACKGROUND_TASKS;
-        }
-    }
-    if (self->conn_handle == BLE_CONN_HANDLE_INVALID) {
-        return -1;
-    }
-
-    size_t num_bytes_written = 0;
-
-    uint8_t *pending = self->outgoing[self->pending_index];
-
-    if (self->pending_size == 0) {
-        memcpy(pending, header, header_len);
-        self->pending_size += header_len;
-        num_bytes_written += header_len;
-    }
-    memcpy(pending + self->pending_size, data, len);
-    self->pending_size += len;
-    num_bytes_written += len;
-
-    // If no writes are queued then sneak in this data.
-    if (!self->packet_queued) {
-        queue_next_write(self);
-    }
-    return num_bytes_written;
-}
-
-mp_int_t common_hal_bleio_packet_buffer_get_incoming_packet_length(bleio_packet_buffer_obj_t *self) {
-    // If this PacketBuffer is coming from a remote service via NOTIFY or INDICATE
-    // the maximum size is what can be sent in one
-    // BLE packet. But we must be connected to know that value.
-    //
-    // Otherwise it can be as long as the characteristic
-    // will permit, whether or not we're connected.
-
-    if (self->characteristic == NULL) {
-        return -1;
-    }
-
-    if (self->characteristic->service != NULL &&
-        self->characteristic->service->is_remote &&
-        (common_hal_bleio_characteristic_get_properties(self->characteristic) &
-         (CHAR_PROP_INDICATE | CHAR_PROP_NOTIFY))) {
-        // We are talking to a remote service, and data is arriving via NOTIFY or INDICATE.
-        if (self->conn_handle != BLE_CONN_HANDLE_INVALID) {
-            bleio_connection_internal_t *connection = bleio_conn_handle_to_connection(self->conn_handle);
-            if (connection) {
-                return MIN(common_hal_bleio_connection_get_max_packet_length(connection),
-                    self->characteristic->max_length);
-            }
-        }
-        // There's no current connection, so we don't know the MTU, and
-        // we can't tell what the largest incoming packet length would be.
-        return -1;
-    }
-    return self->characteristic->max_length;
-}
-
-mp_int_t common_hal_bleio_packet_buffer_get_outgoing_packet_length(bleio_packet_buffer_obj_t *self) {
-    // If we are sending data via NOTIFY or INDICATE, the maximum size
-    // is what can be sent in one BLE packet. But we must be connected
-    // to know that value.
-    //
-    // Otherwise it can be as long as the characteristic
-    // will permit, whether or not we're connected.
-
-    if (self->characteristic == NULL) {
-        return -1;
-    }
-
-    if (self->characteristic->service != NULL &&
-        !self->characteristic->service->is_remote &&
-        (common_hal_bleio_characteristic_get_properties(self->characteristic) &
-         (CHAR_PROP_INDICATE | CHAR_PROP_NOTIFY))) {
-        // We are sending to a client, via NOTIFY or INDICATE.
-        if (self->conn_handle != BLE_CONN_HANDLE_INVALID) {
-            bleio_connection_internal_t *connection = bleio_conn_handle_to_connection(self->conn_handle);
-            if (connection) {
-                return MIN(MIN(common_hal_bleio_connection_get_max_packet_length(connection),
-                               self->max_packet_size),
-                           self->characteristic->max_length);
-            }
-        }
-        // There's no current connection, so we don't know the MTU, and
-        // we can't tell what the largest outgoing packet length would be.
-        return -1;
-    }
-    return MIN(self->characteristic->max_length, self->max_packet_size);
-}
-
-bool common_hal_bleio_packet_buffer_deinited(bleio_packet_buffer_obj_t *self) {
-    return self->characteristic == NULL;
-}
-
-void common_hal_bleio_packet_buffer_deinit(bleio_packet_buffer_obj_t *self) {
-    if (!common_hal_bleio_packet_buffer_deinited(self)) {
-        bleio_characteristic_clear_observer(self->characteristic);
-    }
-}

devices/ble_hci/common-hal/_bleio/PacketBuffer.h

@@ -1,54 +0,0 @@
-/*
- * This file is part of the MicroPython project, http://micropython.org/
- *
- * The MIT License (MIT)
- *
- * Copyright (c) 2019-2020 Scott Shawcroft for Adafruit Industries
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-#ifndef MICROPY_INCLUDED_BLE_HCI_COMMON_HAL_PACKETBUFFER_H
-#define MICROPY_INCLUDED_BLE_HCI_COMMON_HAL_PACKETBUFFER_H
-
-#include "py/ringbuf.h"
-#include "shared-bindings/_bleio/Characteristic.h"
-
-typedef struct {
-    mp_obj_base_t base;
-    bleio_characteristic_obj_t *characteristic;
-    // Ring buffer storing consecutive incoming values.
-    ringbuf_t ringbuf;
-    // Two outgoing buffers to alternate between. One will be queued for transmission by the SD and
-    // the other is waiting to be queued and can be extended.
-    uint8_t *outgoing[2];
-    volatile uint16_t pending_size;
-    // We remember the conn_handle so we can do a NOTIFY/INDICATE to a client.
-    // We can find out the conn_handle on a Characteristic write or a CCCD write (but not a read).
-    volatile uint16_t conn_handle;
-    uint16_t max_packet_size;
-    uint8_t pending_index;
-    uint8_t write_type;
-    bool client;
-    bool packet_queued;
-} bleio_packet_buffer_obj_t;
-
-void bleio_packet_buffer_update(bleio_packet_buffer_obj_t *self, mp_buffer_info_t *bufinfo);
-
-#endif // MICROPY_INCLUDED_BLE_HCI_COMMON_HAL_PACKETBUFFER_H

devices/ble_hci/common-hal/_bleio/Service.c

@@ -1,129 +0,0 @@
-/*
- * This file is part of the MicroPython project, http://micropython.org/
- *
- * The MIT License (MIT)
- *
- * Copyright (c) 2020 Dan Halbert for Adafruit Industries
- * Copyright (c) 2018 Artur Pacholec
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-#include "py/runtime.h"
-#include "shared-bindings/_bleio/__init__.h"
-#include "shared-bindings/_bleio/Characteristic.h"
-#include "shared-bindings/_bleio/Descriptor.h"
-#include "shared-bindings/_bleio/Service.h"
-#include "shared-bindings/_bleio/Adapter.h"
-
-uint32_t _common_hal_bleio_service_construct(bleio_service_obj_t *self, bleio_uuid_obj_t *uuid, bool is_secondary, mp_obj_list_t *characteristic_list) {
-    self->uuid = uuid;
-    self->characteristic_list = characteristic_list;
-    self->is_remote = false;
-    self->connection = NULL;
-    self->is_secondary = is_secondary;
-
-    vm_used_ble = true;
-
-    self->handle = bleio_adapter_add_attribute(&common_hal_bleio_adapter_obj, MP_OBJ_TO_PTR(self));
-    self->start_handle = self->handle;
-    self->end_handle = self->handle;
-    if (self->handle == BLE_GATT_HANDLE_INVALID) {
-        return 1;
-    }
-    return 0;
-}
-
-void common_hal_bleio_service_construct(bleio_service_obj_t *self, bleio_uuid_obj_t *uuid, bool is_secondary) {
-    if (_common_hal_bleio_service_construct(self, uuid, is_secondary,
-        mp_obj_new_list(0, NULL)) != 0) {
-        mp_raise_RuntimeError(translate("Failed to add service"));
-    }
-}
-
-void bleio_service_from_connection(bleio_service_obj_t *self, mp_obj_t connection) {
-    self->handle = 0xFFFF;
-    self->uuid = NULL;
-    self->characteristic_list = mp_obj_new_list(0, NULL);
-    self->is_remote = true;
-    self->is_secondary = false;
-    self->connection = connection;
-}
-
-bleio_uuid_obj_t *common_hal_bleio_service_get_uuid(bleio_service_obj_t *self) {
-    return self->uuid;
-}
-
-mp_obj_tuple_t *common_hal_bleio_service_get_characteristics(bleio_service_obj_t *self) {
-    return mp_obj_new_tuple(self->characteristic_list->len, self->characteristic_list->items);
-}
-
-bool common_hal_bleio_service_get_is_remote(bleio_service_obj_t *self) {
-    return self->is_remote;
-}
-
-bool common_hal_bleio_service_get_is_secondary(bleio_service_obj_t *self) {
-    return self->is_secondary;
-}
-
-void common_hal_bleio_service_add_characteristic(bleio_service_obj_t *self,
-    bleio_characteristic_obj_t *characteristic,
-    mp_buffer_info_t *initial_value_bufinfo) {
-
-    if (self->handle != common_hal_bleio_adapter_obj.last_added_service_handle) {
-        mp_raise_bleio_BluetoothError(
-            translate("Characteristic can only be added to most recently added service"));
-    }
-    characteristic->decl_handle = bleio_adapter_add_attribute(
-        &common_hal_bleio_adapter_obj, MP_OBJ_TO_PTR(characteristic));
-    // This is the value handle.
-    characteristic->handle = bleio_adapter_add_attribute(
-        &common_hal_bleio_adapter_obj, MP_OBJ_TO_PTR(characteristic));
-
-    self->end_handle = characteristic->handle;
-
-    if (characteristic->props & (CHAR_PROP_NOTIFY | CHAR_PROP_INDICATE)) {
-        // We need a CCCD if this characteristic is doing notify or indicate.
-        bleio_descriptor_obj_t *cccd = m_new_obj(bleio_descriptor_obj_t);
-        cccd->base.type = &bleio_descriptor_type;
-
-        uint16_t zero = 0;
-        mp_buffer_info_t zero_cccd_value = {
-            .buf = &zero,
-            .len = sizeof(zero),
-        };
-
-        common_hal_bleio_descriptor_construct(
-            cccd,
-            characteristic,
-            &cccd_uuid,                // 0x2902
-            SECURITY_MODE_OPEN,        // CCCD read perm
-            characteristic->read_perm, // Make CCCD write perm match characteristic read perm.
-            2,                         // 2 bytes
-            true,                      // fixed length
-            &zero_cccd_value           // Initial value is 0.
-            );
-
-        // Adds CCCD to attribute table, and also extends self->end_handle to include the CCCD.
-        common_hal_bleio_characteristic_add_descriptor(characteristic, cccd);
-        characteristic->cccd = cccd;
-    }
-
-    mp_obj_list_append(self->characteristic_list, MP_OBJ_FROM_PTR(characteristic));
-}

devices/ble_hci/common-hal/_bleio/Service.h

@@ -1,54 +0,0 @@
-/*
- * This file is part of the MicroPython project, http://micropython.org/
- *
- * The MIT License (MIT)
- *
- * Copyright (c) 2018 Dan Halbert for Adafruit Industries
- * Copyright (c) 2018 Artur Pacholec
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-#ifndef MICROPY_INCLUDED_BLE_HCI_COMMON_HAL_SERVICE_H
-#define MICROPY_INCLUDED_BLE_HCI_COMMON_HAL_SERVICE_H
-
-#include "py/objlist.h"
-#include "common-hal/_bleio/UUID.h"
-
-typedef struct bleio_service_obj {
-    mp_obj_base_t base;
-    // Handle for the local service.
-    uint16_t handle;
-    // True if created during discovery.
-    bool is_remote;
-    bool is_secondary;
-    bleio_uuid_obj_t *uuid;
-    // The connection object is set only when this is a remote service.
-    // A local service doesn't know the connection.
-    mp_obj_t connection;
-    mp_obj_list_t *characteristic_list;
-    // Range of attribute handles of this service.
-    uint16_t start_handle;
-    uint16_t end_handle;
-    struct bleio_service_obj *next;
-} bleio_service_obj_t;
-
-void bleio_service_from_connection(bleio_service_obj_t *self, mp_obj_t connection);
-
-#endif // MICROPY_INCLUDED_BLE_HCI_COMMON_HAL_SERVICE_H

devices/ble_hci/common-hal/_bleio/UUID.c

@@ -1,75 +0,0 @@
-/*
- * This file is part of the MicroPython project, http://micropython.org/
- *
- * The MIT License (MIT)
- *
- * Copyright (c) 2018 Dan Halbert for Adafruit Industries
- * Copyright (c) 2018 Artur Pacholec
- * Copyright (c) 2016 Glenn Ruben Bakke
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-#include <string.h>
-
-#include "py/runtime.h"
-#include "common-hal/_bleio/UUID.h"
-#include "shared-bindings/_bleio/__init__.h"
-#include "shared-bindings/_bleio/Adapter.h"
-
-// If uuid128 is NULL, this is a Bluetooth SIG 16-bit UUID.
-// If uuid128 is not NULL, it's a 128-bit (16-byte) UUID, with bytes 12 and 13 zero'd out, where
-// the 16-bit part goes. Those 16 bits are passed in uuid16.
-void common_hal_bleio_uuid_construct(bleio_uuid_obj_t *self, mp_int_t uuid16, const uint8_t uuid128[16]) {
-    self->size = uuid128 == NULL ? 16 : 128;
-    self->uuid16 = uuid16;
-    if (uuid128) {
-        memcpy(self->uuid128, uuid128, 16);
-        self->uuid128[12] = uuid16 & 0xff;
-        self->uuid128[13] = uuid16 >> 8;
-    } else {
-        memset(self->uuid128, 0, 16);
-    }
-}
-
-uint32_t common_hal_bleio_uuid_get_size(bleio_uuid_obj_t *self) {
-    return self->size;
-}
-
-uint32_t common_hal_bleio_uuid_get_uuid16(bleio_uuid_obj_t *self) {
-    return self->uuid16;
-}
-
-void common_hal_bleio_uuid_get_uuid128(bleio_uuid_obj_t *self, uint8_t uuid128[16]) {
-    memcpy(uuid128, self->uuid128, 16);
-}
-
-void common_hal_bleio_uuid_pack_into(bleio_uuid_obj_t *self, uint8_t *buf) {
-    if (self->size == 16) {
-        buf[0] = self->uuid16 & 0xff;
-        buf[1] = self->uuid16 >> 8;
-    } else {
-        common_hal_bleio_uuid_get_uuid128(self, buf);
-    }
-}
-
-// Return a uui16 only if this is a standard uuid. Otherwise return BLE_UUID_UNKNOWN.
-uint16_t bleio_uuid_get_uuid16_or_unknown(bleio_uuid_obj_t *uuid) {
-    return uuid->size == 16 ? uuid->uuid16 : BLE_UUID_UNKNOWN;
-}

devices/ble_hci/common-hal/_bleio/UUID.h

@@ -1,58 +0,0 @@
-/*
- * This file is part of the MicroPython project, http://micropython.org/
- *
- * The MIT License (MIT)
- *
- * Copyright (c) 2019 Dan Halbert for Adafruit Industries
- * Copyright (c) 2018 Artur Pacholec
- * Copyright (c) 2016 Glenn Ruben Bakke
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-#ifndef MICROPY_INCLUDED_BLE_HCI_COMMON_HAL_UUID_H
-#define MICROPY_INCLUDED_BLE_HCI_COMMON_HAL_UUID_H
-
-#include "py/obj.h"
-
-// Types returned by attribute table lookups. These are UUIDs.
-typedef enum {
-    BLE_UUID_UNKNOWN               = 0x0000,
-    BLE_UUID_SERVICE_PRIMARY       = 0x2800,
-    BLE_UUID_SERVICE_SECONDARY     = 0x2801,
-    BLE_UUID_SERVICE_INCLUDE       = 0x2802,// not yet implemented by us
-    BLE_UUID_CHARACTERISTIC        = 0x2803,
-    BLE_UUID_CHAR_EXTENDED_PROPS   = 0x2900,// not yet implemented by us
-    BLE_UUID_CHAR_USER_DESC        = 0x2901,// not yet implemented by us
-    BLE_UUID_CCCD                  = 0x2902,
-    BLE_UUID_SCCD                  = 0x2903,// not yet implemented by us
-    BLE_UUID_CHAR_PRESENTATION_FMT = 0x2904, // not yet implemented by us
-    BLE_UUID_CHAR_AGGREGATE_FMT    = 0x2905,// not yet implemented by us
-} ble_standard_uuid;
-
-typedef struct {
-    mp_obj_base_t base;
-    uint8_t size;
-    uint16_t uuid16;
-    uint8_t uuid128[16];
-} bleio_uuid_obj_t;
-
-uint16_t bleio_uuid_get_uuid16_or_unknown(bleio_uuid_obj_t *uuid);
-
-#endif // MICROPY_INCLUDED_BLE_HCI_COMMON_HAL_UUID_H

devices/ble_hci/common-hal/_bleio/__init__.c

@@ -1,112 +0,0 @@
-/*
- * This file is part of the MicroPython project, http://micropython.org/
- *
- * The MIT License (MIT)
- *
- * Copyright (c) 2018 Dan Halbert for Adafruit Industries
- * Copyright (c) 2018 Artur Pacholec
- * Copyright (c) 2016 Glenn Ruben Bakke
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-#include <string.h>
-
-#include "py/runtime.h"
-#include "shared-bindings/_bleio/__init__.h"
-#include "shared-bindings/_bleio/Adapter.h"
-#include "shared-bindings/_bleio/Characteristic.h"
-#include "shared-bindings/_bleio/Connection.h"
-#include "shared-bindings/_bleio/Descriptor.h"
-#include "shared-bindings/_bleio/Service.h"
-#include "shared-bindings/_bleio/UUID.h"
-#include "supervisor/shared/bluetooth.h"
-
-// UUID shared by all cccd's.
-bleio_uuid_obj_t cccd_uuid;
-
-bool vm_used_ble;
-
-// void check_sec_status(uint8_t sec_status) {
-//     if (sec_status == BLE_GAP_SEC_STATUS_SUCCESS) {
-//         return;
-//     }
-
-//     switch (sec_status) {
-//         case BLE_GAP_SEC_STATUS_UNSPECIFIED:
-//             mp_raise_bleio_SecurityError(translate("Unspecified issue. Can be that the pairing prompt on the other device was declined or ignored."));
-//             return;
-//         default:
-//             mp_raise_bleio_SecurityError(translate("Unknown security error: 0x%04x"), sec_status);
-//     }
-// }
-
-// Turn off BLE on a reset or reload.
-void bleio_reset() {
-    // Create a UUID object for all CCCD's.
-    cccd_uuid.base.type = &bleio_uuid_type;
-    common_hal_bleio_uuid_construct(&cccd_uuid, BLE_UUID_CCCD, NULL);
-
-    bleio_hci_reset();
-
-    if (!common_hal_bleio_adapter_get_enabled(&common_hal_bleio_adapter_obj)) {
-        return;
-    }
-    bleio_adapter_reset(&common_hal_bleio_adapter_obj);
-    if (!vm_used_ble) {
-        // No user-code BLE operations were done, so we can maintain the supervisor state.
-        return;
-    }
-    common_hal_bleio_adapter_set_enabled(&common_hal_bleio_adapter_obj, false);
-    common_hal_bleio_adapter_obj.allocated = false;
-
-    bleio_set_adapter(mp_const_none);
-
-    // FIX bonding_reset();
-    supervisor_start_bluetooth();
-}
-
-// The singleton _bleio.Adapter object, bound to _bleio.adapter
-bleio_adapter_obj_t common_hal_bleio_adapter_obj = {
-    .base = {
-        .type = &bleio_adapter_type,
-    },
-};
-
-bleio_adapter_obj_t *common_hal_bleio_allocate_adapter_or_raise(void) {
-    if (common_hal_bleio_adapter_obj.allocated) {
-        mp_raise_RuntimeError(translate("Too many Adapters"));
-    }
-    return &common_hal_bleio_adapter_obj;
-}
-
-void common_hal_bleio_check_connected(uint16_t conn_handle) {
-    if (conn_handle == BLE_CONN_HANDLE_INVALID) {
-        mp_raise_ConnectionError(translate("Not connected"));
-    }
-}
-
-void common_hal_bleio_gc_collect(void) {
-    bleio_adapter_gc_collect(&common_hal_bleio_adapter_obj);
-}
-
-
-void bleio_background(void) {
-    bleio_adapter_background(&common_hal_bleio_adapter_obj);
-}

devices/ble_hci/common-hal/_bleio/__init__.h

@@ -1,62 +0,0 @@
-/*
- * This file is part of the MicroPython project, http://micropython.org/
- *
- * The MIT License (MIT)
- *
- * Copyright (c) 2018 Dan Halbert for Adafruit Industries
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-#ifndef MICROPY_INCLUDED_BLE_HCI_COMMON_HAL_INIT_H
-#define MICROPY_INCLUDED_BLE_HCI_COMMON_HAL_INIT_H
-
-#include <stdbool.h>
-
-#include "shared-bindings/_bleio/UUID.h"
-
-#include "att.h"
-#include "hci.h"
-
-void bleio_background(void);
-void bleio_reset(void);
-
-typedef struct {
-    // ble_gap_enc_key_t own_enc;
-    // ble_gap_enc_key_t peer_enc;
-    // ble_gap_id_key_t peer_id;
-} bonding_keys_t;
-
-// We assume variable length data.
-// 20 bytes max (23 - 3).
-#define GATT_MAX_DATA_LENGTH (BT_ATT_DEFAULT_LE_MTU - 3)
-
-// FIX
-#define BLE_GATT_HANDLE_INVALID 0x0000
-#define BLE_CONN_HANDLE_INVALID 0xFFFF
-#define BLE_GATTS_FIX_ATTR_LEN_MAX (510)  /**< Maximum length for fixed length Attribute Values. */
-#define BLE_GATTS_VAR_ATTR_LEN_MAX (512)  /**< Maximum length for variable length Attribute Values. */
-
-// Track if the user code modified the BLE state to know if we need to undo it on reload.
-extern bool vm_used_ble;
-
-// UUID shared by all CCCD's.
-extern bleio_uuid_obj_t cccd_uuid;
-
-#endif // MICROPY_INCLUDED_BLE_HCI_COMMON_HAL_INIT_H

devices/ble_hci/common-hal/_bleio/att.h

@@ -1,57 +0,0 @@
-// Derived from ArduinoBLE.
-// Copyright 2020 Dan Halbert for Adafruit Industries
-
-/*
-  This file is part of the ArduinoBLE library.
-  Copyright (c) 2018 Arduino SA. All rights reserved.
-
-  This library is free software; you can redistribute it and/or
-  modify it under the terms of the GNU Lesser General Public
-  License as published by the Free Software Foundation; either
-  version 2.1 of the License, or (at your option) any later version.
-
-  This library is distributed in the hope that it will be useful,
-  but WITHOUT ANY WARRANTY; without even the implied warranty of
-  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
-  Lesser General Public License for more details.
-
-  You should have received a copy of the GNU Lesser General Public
-  License along with this library; if not, write to the Free Software
-  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
-*/
-
-#ifndef MICROPY_INCLUDED_DEVICES_BLE_HCI_COMMON_HAL_BLEIO_ATT_H
-#define MICROPY_INCLUDED_DEVICES_BLE_HCI_COMMON_HAL_BLEIO_ATT_H
-
-#include <stdbool.h>
-#include <stdint.h>
-
-#include "hci_include/addr.h"
-#include "hci_include/att.h"
-#include "hci_include/att_internal.h"
-
-void bleio_att_reset(void);
-
-// FIX void att_set_event_handler(BLEDeviceEvent event, BLEDeviceEventHandler eventHandler);
-bool att_address_is_connected(bt_addr_le_t *addr);
-bool att_connect_to_address(bt_addr_le_t *addr);
-bool att_disconnect(uint16_t conn_handle);
-bool att_disconnect_all(void);
-bool att_discover_attributes(bt_addr_le_t *addr, const char *service_uuid_filter);
-bool att_exchange_mtu(uint16_t conn_handle);
-bool att_handle_is_connected(uint16_t handle);
-bool att_indicate(uint16_t handle, const uint8_t *value, int length);
-bool att_is_connected(void);
-bool att_notify(uint16_t handle, const uint8_t *value, int length);
-int att_read_req(uint16_t conn_handle, uint16_t handle, uint8_t response_buffer[]);
-int att_write_req(uint16_t conn_handle, uint16_t handle, const uint8_t *data, uint8_t data_len, uint8_t response_buffer[]);
-uint16_t att_conn_handle(bt_addr_le_t *addr);
-uint16_t att_mtu(uint16_t handle);
-void att_add_connection(uint16_t handle, uint8_t role, bt_addr_le_t *peer_addr, uint16_t interval, uint16_t latency, uint16_t supervision_timeout, uint8_t master_clock_accuracy);
-void att_process_data(uint16_t conn_handle, uint8_t dlen, uint8_t data[]);
-void att_remove_connection(uint16_t conn_handle, uint8_t reason);
-void att_set_max_mtu(uint16_t max_mtu);
-void att_set_timeout(unsigned long timeout);
-void att_write_cmd(uint16_t conn_handle, uint16_t handle, const uint8_t *data, uint8_t data_len);
-
-#endif // MICROPY_INCLUDED_DEVICES_BLE_HCI_COMMON_HAL_BLEIO_ATT_H

devices/ble_hci/common-hal/_bleio/hci.c

@@ -1,805 +0,0 @@
-//  This file is derived from the ArduinoBLE library. Its header is below.
-/*
-  This file is part of the ArduinoBLE library.
-  Copyright (c) 2018 Arduino SA. All rights reserved.
-
-  This library is distributed in the hope that it will be useful,
-  but WITHOUT ANY WARRANTY; without even the implied warranty of
-  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
-  Lesser General Public License for more details.
-
-  You should have received a copy of the GNU Lesser General Public
-  License along with this library; if not, write to the Free Software
-  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
-*/
-
-#include "att.h"
-#include "hci.h"
-
-#include "py/obj.h"
-#include "py/mperrno.h"
-#include "py/runtime.h"
-
-// Zephyr include files to define HCI communication values and structs.
-#include "hci_include/hci.h"
-#include "hci_include/hci_err.h"
-#include "hci_include/l2cap_internal.h"
-
-#include <string.h>
-
-#include "py/mphal.h"  // *****************************
-#include "supervisor/shared/tick.h"
-#include "shared-bindings/_bleio/__init__.h"
-#include "common-hal/_bleio/Adapter.h"
-#include "shared-bindings/microcontroller/__init__.h"
-
-// Set to 1 for extensive HCI packet logging.
-#define HCI_DEBUG 0
-
-// HCI H4 protocol packet types: first byte in the packet.
-#define H4_CMD 0x01
-#define H4_ACL 0x02
-#define H4_SCO 0x03
-#define H4_EVT 0x04
-
-#define CTS_TIMEOUT_MSECS (1000)
-#define RESPONSE_TIMEOUT_MSECS (1000)
-
-// These are the headers of the full packets that are sent over the serial interface.
-// They all have a one-byte type-field at the front, one of the H4_xxx packet types.
-
-typedef struct __attribute__ ((packed)) {
-    uint8_t pkt_type;
-    uint16_t opcode;
-    uint8_t param_len;
-    uint8_t params[];
-} h4_hci_cmd_pkt_t;
-
-#define ACL_DATA_PB_FIRST_NON_FLUSH  0
-#define ACL_DATA_PB_MIDDLE           1
-#define ACL_DATA_PB_FIRST_FLUSH      2
-#define ACL_DATA_PB_FULL             3
-
-typedef struct __attribute__ ((packed)) {
-    uint8_t pkt_type;
-    uint16_t handle : 12;
-    uint8_t pb : 2;            // Packet boundary flag: ACL_DATA_PB values.
-    uint8_t bc : 2;            // Broadcast flag: always 0b00 for BLE.
-    uint16_t data_len;        // length of data[] in this packet.
-    uint8_t data[];
-}  h4_hci_acl_pkt_t;
-
-// The ACL data in an h4_hci_acl_pkt_t may be fragmented across
-// multiple ACL_DATA packets, and need to be recombined.  This is the
-// structure of the combined packet or the first fragment.
-typedef struct __attribute__ ((packed)) {
-    uint16_t acl_data_len;  // Length of acl_data. Does not include this header.
-    uint16_t cid;           // Channel ID.
-    uint8_t acl_data[];     // Length is acl_data_len of full packet.
-} acl_data_t;
-
-typedef struct __attribute__ ((packed)) {
-    uint8_t pkt_type;
-    uint8_t evt;
-    uint8_t param_len;
-    uint8_t params[];
-} h4_hci_evt_pkt_t;
-
-
-//////////////////////////////////////////////////////////////////////
-// Static storage:
-
-// FIX size
-#define RX_BUFFER_SIZE (3 + 255)
-#define ACL_DATA_BUFFER_SIZE (255)
-
-STATIC uint8_t rx_buffer[RX_BUFFER_SIZE];
-STATIC size_t rx_idx;
-
-STATIC uint8_t acl_data_buffer[ACL_DATA_BUFFER_SIZE];
-STATIC size_t acl_data_len;
-
-STATIC size_t num_command_packets_allowed;
-STATIC volatile size_t pending_pkt;
-
-// Results from parsing a command response packet.
-STATIC bool cmd_response_received;
-STATIC uint16_t cmd_response_opcode;
-STATIC uint8_t cmd_response_status;
-STATIC size_t cmd_response_len;
-STATIC uint8_t *cmd_response_data;
-
-STATIC volatile bool hci_poll_in_progress = false;
-
-
-//////////////////////////////////////////////////////////////////////
-
-#if HCI_DEBUG
-#include "hci_debug.c"
-#endif // HCI_DEBUG
-
-STATIC void process_acl_data_pkt(uint8_t pkt_len, uint8_t pkt_data[]) {
-    h4_hci_acl_pkt_t *pkt = (h4_hci_acl_pkt_t *)pkt_data;
-
-    if (pkt->pb != ACL_DATA_PB_MIDDLE) {
-        // This is the start of a fragmented acl_data packet or is a full packet.
-        memcpy(acl_data_buffer, pkt->data, pkt->data_len);
-        acl_data_len = pkt->data_len;
-    } else {
-        // This is a middle or end fragment of acl data.
-        // Append to the accumulated data so far.
-        memcpy(&acl_data_buffer[acl_data_len], pkt->data, pkt->data_len);
-        acl_data_len += pkt->data_len;
-    }
-
-    acl_data_t *acl = (acl_data_t *)&acl_data_buffer;
-    if (acl_data_len != sizeof(acl) + acl->acl_data_len) {
-        // We don't have the full packet yet.
-        return;
-    }
-
-    if (acl->cid == BT_L2CAP_CID_ATT) {
-        att_process_data(pkt->handle, acl->acl_data_len, acl->acl_data);
-    }
-    // } else if (aclHdr->cid == BT_L2CAP_CID_LE_SIG) {
-    //     L2CAPSignaling.handleData(aclHdr->handle & 0x0fff, aclHdr->len, &rx_buffer[1 + sizeof(HCIACLHdr)]);
-    // } else {
-    //     struct __attribute__ ((packed)) {
-    //         uint8_t op;
-    //         uint8_t id;
-    //         uint16_t length;
-    //         uint16_t reason;
-    //         uint16_t localCid;
-    //         uint16_t remoteCid;
-    //     } l2capRejectCid= { 0x01, 0x00, 0x006, 0x0002, aclHdr->cid, 0x0000 };
-
-    //     sendAclPkt(aclHdr->handle & 0x0fff, 0x0005, sizeof(l2capRejectCid), &l2capRejectCid);
-    // }
-}
-
-// Process number of completed packets. Reduce number of pending packets by reported
-// number of completed.
-STATIC void process_num_comp_pkts(uint16_t handle, uint16_t num_pkts) {
-    if (num_pkts && pending_pkt > num_pkts) {
-        pending_pkt -= num_pkts;
-    } else {
-        pending_pkt = 0;
-    }
-}
-
-STATIC void process_evt_pkt(size_t pkt_len, uint8_t pkt_data[]) {
-    h4_hci_evt_pkt_t *pkt = (h4_hci_evt_pkt_t *)pkt_data;
-
-    switch (pkt->evt) {
-        case BT_HCI_EVT_DISCONN_COMPLETE: {
-            struct bt_hci_evt_disconn_complete *disconn_complete =
-                (struct bt_hci_evt_disconn_complete *)pkt->params;
-            (void)disconn_complete;
-
-            att_remove_connection(disconn_complete->handle, disconn_complete->reason);
-            // FIX L2CAPSignaling.removeConnection(disconn_complete->handle, disconn_complete->reason);
-            break;
-        }
-
-        case BT_HCI_EVT_CMD_COMPLETE: {
-            struct cmd_complete_with_status {
-                struct bt_hci_evt_cmd_complete cmd_complete;
-                struct bt_hci_evt_cc_status cc_status;
-            } __packed;
-
-            struct cmd_complete_with_status *evt = (struct cmd_complete_with_status *)pkt->params;
-
-            num_command_packets_allowed = evt->cmd_complete.ncmd;
-
-            cmd_response_received = true;
-            cmd_response_opcode = evt->cmd_complete.opcode;
-            cmd_response_status = evt->cc_status.status;
-            // All the bytes following cmd_complete, -including- the status byte, which is
-            // included in all the _bt_hci_rp_* structs.
-            cmd_response_data = (uint8_t *)&evt->cc_status;
-            // Includes status byte.
-            cmd_response_len = pkt->param_len - sizeof_field(struct cmd_complete_with_status, cmd_complete);
-
-            break;
-        }
-
-        case BT_HCI_EVT_CMD_STATUS: {
-            struct bt_hci_evt_cmd_status *evt = (struct bt_hci_evt_cmd_status *)pkt->params;
-
-            num_command_packets_allowed = evt->ncmd;
-
-            cmd_response_received = true;
-            cmd_response_opcode = evt->opcode;
-            cmd_response_status = evt->status;
-            cmd_response_data = NULL;
-            cmd_response_len = 0;
-
-            break;
-        }
-
-        case BT_HCI_EVT_NUM_COMPLETED_PACKETS: {
-            struct bt_hci_evt_num_completed_packets *evt =
-                (struct bt_hci_evt_num_completed_packets *)pkt->params;
-
-            // Start at zero-th pair: (conn handle, num completed packets).
-            struct bt_hci_handle_count *handle_and_count = &(evt->h[0]);
-            for (uint8_t i = 0; i < evt->num_handles; i++) {
-                process_num_comp_pkts(handle_and_count->handle, handle_and_count->count);
-                handle_and_count++;
-            }
-            break;
-        }
-
-        case BT_HCI_EVT_LE_META_EVENT: {
-            struct bt_hci_evt_le_meta_event *meta_evt = (struct bt_hci_evt_le_meta_event *)pkt->params;
-            uint8_t *le_evt = pkt->params + sizeof (struct bt_hci_evt_le_meta_event);
-
-            if (meta_evt->subevent == BT_HCI_EVT_LE_CONN_COMPLETE) {
-                // Advertising stops when connection occurs.
-                // We don't tell the adapter to stop, because stopping advertising
-                // when it's already stopped seems to exercise a bug in the ESP32 HCI code:
-                // It doesn't return a response.
-                bleio_adapter_advertising_was_stopped(&common_hal_bleio_adapter_obj);
-
-                struct bt_hci_evt_le_conn_complete *le_conn_complete =
-                    (struct bt_hci_evt_le_conn_complete *)le_evt;
-
-                if (le_conn_complete->status == BT_HCI_ERR_SUCCESS) {
-                    att_add_connection(
-                        le_conn_complete->handle,
-                        le_conn_complete->role,
-                        &le_conn_complete->peer_addr,
-                        le_conn_complete->interval,
-                        le_conn_complete->latency,
-                        le_conn_complete->supv_timeout,
-                        le_conn_complete->clock_accuracy);
-
-                }
-            } else if (meta_evt->subevent == BT_HCI_EVT_LE_ADVERTISING_REPORT) {
-                struct bt_hci_evt_le_advertising_info *le_advertising_info =
-                    (struct bt_hci_evt_le_advertising_info *)le_evt;
-                if (le_advertising_info->evt_type == BT_HCI_ADV_DIRECT_IND) {
-                    // FIX
-                    // last byte is RSSI
-                    // GAP.handleLeAdvertisingReport(leAdvertisingReport->type,
-                    //                               leAdvertisingReport->peerBdaddrType,
-                    //                               leAdvertisingReport->peerBdaddr,
-                    //                               leAdvertisingReport->eirLength,
-                    //                               leAdvertisingReport->eirData,
-                    //                               rssi); //FIX, don't separate
-
-                }
-            }
-            break;
-        }
-
-        default:
-            #if HCI_DEBUG
-            mp_printf(&mp_plat_print, "process_evt_pkt: Unknown event: %02x\n");
-            #endif
-            break;
-    }
-}
-
-void bleio_hci_reset(void) {
-    rx_idx = 0;
-    pending_pkt = 0;
-    hci_poll_in_progress = false;
-    bleio_att_reset();
-}
-
-hci_result_t hci_poll_for_incoming_pkt(void) {
-    common_hal_mcu_disable_interrupts();
-    if (hci_poll_in_progress) {
-        common_hal_mcu_enable_interrupts();
-        return HCI_OK;
-    }
-    hci_poll_in_progress = true;
-    common_hal_mcu_enable_interrupts();
-
-    // Assert RTS low to say we're ready to read data.
-    common_hal_digitalio_digitalinout_set_value(common_hal_bleio_adapter_obj.rts_digitalinout, false);
-
-    int errcode = 0;
-    bool packet_is_complete = false;
-
-    // Read bytes until we run out. There may be more than one packet in the input buffer.
-    while (!packet_is_complete &&
-           common_hal_busio_uart_rx_characters_available(common_hal_bleio_adapter_obj.hci_uart) > 0) {
-
-        // Read just one character a a time, so we don't accidentally get part of a second
-        // packet.
-        size_t num_read =
-            common_hal_busio_uart_read(common_hal_bleio_adapter_obj.hci_uart, rx_buffer + rx_idx, 1, &errcode);
-        if (num_read == 0) {
-            return HCI_OK;
-        }
-        if (errcode) {
-            if (errcode == EAGAIN) {
-                continue;
-            }
-            hci_poll_in_progress = false;
-            mp_printf(&mp_plat_print, "HCI_READ_ERROR, errcode: %x\n", errcode);
-            return HCI_READ_ERROR;
-        }
-        rx_idx++;
-        if (rx_idx >= sizeof(rx_buffer)) {
-            // Incoming packet is too large. Should not happen.
-            return HCI_READ_ERROR;
-        }
-
-        switch (rx_buffer[0]) {
-            case H4_ACL:
-                if (rx_idx >= sizeof(h4_hci_acl_pkt_t)) {
-                    const size_t total_len =
-                        sizeof(h4_hci_acl_pkt_t) + ((h4_hci_acl_pkt_t *)rx_buffer)->data_len;
-                    if (rx_idx == total_len) {
-                        packet_is_complete = true;
-                    }
-                    if (rx_idx > total_len) {
-                        return HCI_PACKET_SIZE_ERROR;
-                    }
-                }
-                break;
-
-            case H4_EVT:
-                if (rx_idx >= sizeof(h4_hci_evt_pkt_t)) {
-                    const size_t total_len =
-                        sizeof(h4_hci_evt_pkt_t) + ((h4_hci_evt_pkt_t *)rx_buffer)->param_len;
-                    if (rx_idx == total_len) {
-                        packet_is_complete = true;
-                    }
-                    if (rx_idx > total_len) {
-                        return HCI_PACKET_SIZE_ERROR;
-                    }
-                }
-                break;
-
-            default:
-                // Unknown or bad packet type. Start over.
-                rx_idx = 0;
-                break;
-        }
-    } // end while
-
-    if (packet_is_complete) {
-        // Stop incoming data while processing packet.
-        common_hal_digitalio_digitalinout_set_value(common_hal_bleio_adapter_obj.rts_digitalinout, true);
-        size_t pkt_len = rx_idx;
-
-        // Reset for next packet.
-        rx_idx = 0;
-        packet_is_complete = false;
-
-        switch (rx_buffer[0]) {
-            case H4_ACL:
-                #if HCI_DEBUG
-                dump_acl_pkt(false, pkt_len, rx_buffer);
-                #endif
-                process_acl_data_pkt(pkt_len, rx_buffer);
-                break;
-
-            case H4_EVT:
-                #if HCI_DEBUG
-                dump_evt_pkt(false, pkt_len, rx_buffer);
-                #endif
-                process_evt_pkt(pkt_len, rx_buffer);
-                break;
-
-            default:
-                #if HCI_DEBUG
-                mp_printf(&mp_plat_print, "Unknown HCI packet type: %d\n", rx_buffer[0]);
-                #endif
-                break;
-        }
-
-        // Let incoming bytes flow again.
-        common_hal_digitalio_digitalinout_set_value(common_hal_bleio_adapter_obj.rts_digitalinout, false);
-    }
-
-    // All done with this batch. Hold off receiving bytes until we're ready again.
-    ///common_hal_digitalio_digitalinout_set_value(common_hal_bleio_adapter_obj.rts_digitalinout, true);
-    hci_poll_in_progress = false;
-    return HCI_OK;
-}
-
-
-STATIC hci_result_t write_pkt(uint8_t *buffer, size_t len) {
-    // Wait for CTS to go low before writing to HCI adapter.
-    uint64_t start = supervisor_ticks_ms64();
-
-    while (common_hal_digitalio_digitalinout_get_value(common_hal_bleio_adapter_obj.cts_digitalinout)) {
-        RUN_BACKGROUND_TASKS;
-        if (supervisor_ticks_ms64() - start > CTS_TIMEOUT_MSECS) {
-            return HCI_WRITE_TIMEOUT;
-        }
-    }
-
-    int errcode = 0;
-    common_hal_busio_uart_write(common_hal_bleio_adapter_obj.hci_uart, buffer, len, &errcode);
-    if (errcode) {
-        return HCI_WRITE_ERROR;
-    }
-
-    return HCI_OK;
-}
-
-STATIC hci_result_t send_command(uint16_t opcode, uint8_t params_len, void *params) {
-    uint8_t cmd_pkt_len = sizeof(h4_hci_cmd_pkt_t) + params_len;
-    uint8_t tx_buffer[cmd_pkt_len];
-
-    // cmd header is at the beginning of tx_buffer
-    h4_hci_cmd_pkt_t *cmd_pkt = (h4_hci_cmd_pkt_t *)tx_buffer;
-    cmd_pkt->pkt_type = H4_CMD;
-    cmd_pkt->opcode = opcode;
-    cmd_pkt->param_len = params_len;
-
-    memcpy(cmd_pkt->params, params, params_len);
-
-    #if HCI_DEBUG
-    dump_cmd_pkt(true, sizeof(tx_buffer), tx_buffer);
-    #endif
-
-    int result = write_pkt(tx_buffer, cmd_pkt_len);
-    if (result != HCI_OK) {
-        return result;
-    }
-
-    cmd_response_received = false;
-
-    // Wait for a response. Note that other packets may be received that are not
-    // command responses.
-    uint64_t start = supervisor_ticks_ms64();
-    while (supervisor_ticks_ms64() - start < RESPONSE_TIMEOUT_MSECS) {
-        // RUN_BACKGROUND_TASKS includes hci_poll_for_incoming_pkt();
-        RUN_BACKGROUND_TASKS;
-        if (cmd_response_received && cmd_response_opcode == opcode) {
-            // If this is definitely a response to the command that was sent,
-            // return the status value, which will will be
-            // BT_HCI_ERR_SUCCESS (0x00) if the command succeeded,
-            // or a BT_HCI_ERR_x value (> 0x00) if there was a problem.
-            return cmd_response_status;
-        }
-    }
-
-    // No I/O error, but no response sent back in time.
-    return HCI_RESPONSE_TIMEOUT;
-}
-
-hci_result_t hci_send_acl_pkt(uint16_t handle, uint8_t cid, uint16_t data_len, uint8_t *data) {
-    // Wait for all backlogged packets to finish.
-    while (pending_pkt >= common_hal_bleio_adapter_obj.max_acl_num_buffers) {
-        // RUN_BACKGROUND_TASKS includes hci_poll_for_incoming_pkt();
-        RUN_BACKGROUND_TASKS;
-    }
-
-    // buf_len is size of entire packet including header.
-    const size_t buf_len = sizeof(h4_hci_acl_pkt_t) + sizeof(acl_data_t) + data_len;
-    uint8_t tx_buffer[buf_len];
-
-    h4_hci_acl_pkt_t *acl_pkt = (h4_hci_acl_pkt_t *)tx_buffer;
-    acl_data_t *acl_data = (acl_data_t *)acl_pkt->data;
-    acl_pkt->pkt_type = H4_ACL;
-    acl_pkt->handle = handle;
-    acl_pkt->pb = ACL_DATA_PB_FIRST_FLUSH;
-    acl_pkt->bc = 0;
-    acl_pkt->data_len = (uint16_t)(sizeof(acl_data_t) + data_len);
-    acl_data->acl_data_len = data_len;
-    acl_data->cid = cid;
-
-    memcpy(&acl_data->acl_data, data, data_len);
-
-    #if HCI_DEBUG
-    dump_acl_pkt(true, buf_len, tx_buffer);
-    #endif
-
-    pending_pkt++;
-
-    int errcode = 0;
-    common_hal_busio_uart_write(common_hal_bleio_adapter_obj.hci_uart, tx_buffer, buf_len, &errcode);
-    if (errcode) {
-        return HCI_WRITE_ERROR;
-    }
-    return HCI_OK;
-}
-
-hci_result_t hci_reset(void) {
-    return send_command(BT_HCI_OP_RESET, 0, NULL);
-}
-
-hci_result_t hci_read_local_version(uint8_t *hci_version, uint16_t *hci_revision, uint8_t *lmp_version, uint16_t *manufacturer, uint16_t *lmp_subversion) {
-    hci_result_t result = send_command(BT_HCI_OP_READ_LOCAL_VERSION_INFO, 0, NULL);
-    if (result == HCI_OK) {
-        struct bt_hci_rp_read_local_version_info *response =
-            (struct bt_hci_rp_read_local_version_info *)cmd_response_data;
-        *hci_version = response->hci_version;
-        *hci_revision = response->hci_revision;
-        *lmp_version = response->lmp_version;
-        *manufacturer = response->manufacturer;
-        *lmp_subversion = response->lmp_subversion;
-    }
-
-    return result;
-}
-
-hci_result_t hci_read_bd_addr(bt_addr_t *addr) {
-    int result = send_command(BT_HCI_OP_READ_BD_ADDR, 0, NULL);
-    if (result == HCI_OK) {
-        struct bt_hci_rp_read_bd_addr *response = (struct bt_hci_rp_read_bd_addr *)cmd_response_data;
-        memcpy(addr->val, response->bdaddr.val, sizeof_field(bt_addr_t, val));
-    }
-
-    return result;
-}
-
-hci_result_t hci_read_rssi(uint16_t handle, int *rssi) {
-    int result = send_command(BT_HCI_OP_READ_RSSI, sizeof(handle), &handle);
-    if (result == HCI_OK) {
-        struct bt_hci_rp_read_rssi *response = (struct bt_hci_rp_read_rssi *)cmd_response_data;
-        *rssi = response->rssi;
-    }
-
-    return result;
-}
-
-hci_result_t hci_set_event_mask(uint64_t event_mask) {
-    return send_command(BT_HCI_OP_SET_EVENT_MASK, sizeof(event_mask), &event_mask);
-}
-
-hci_result_t hci_le_read_buffer_size(uint16_t *le_max_len, uint8_t *le_max_num) {
-    int result = send_command(BT_HCI_OP_LE_READ_BUFFER_SIZE, 0, NULL);
-    if (result == HCI_OK) {
-        struct bt_hci_rp_le_read_buffer_size *response =
-            (struct bt_hci_rp_le_read_buffer_size *)cmd_response_data;
-        *le_max_len = response->le_max_len;
-        *le_max_num = response->le_max_num;
-    }
-
-    return result;
-}
-
-hci_result_t hci_read_buffer_size(uint16_t *acl_max_len, uint8_t *sco_max_len, uint16_t *acl_max_num, uint16_t *sco_max_num) {
-    int result = send_command(BT_HCI_OP_READ_BUFFER_SIZE, 0, NULL);
-    if (result == HCI_OK) {
-        struct bt_hci_rp_read_buffer_size *response =
-            (struct bt_hci_rp_read_buffer_size *)cmd_response_data;
-        *acl_max_len = response->acl_max_len;
-        *sco_max_len = response->sco_max_len;
-        *acl_max_num = response->acl_max_num;
-        *sco_max_num = response->sco_max_num;
-    }
-
-    return result;
-}
-
-hci_result_t hci_le_set_random_address(uint8_t addr[6]) {
-    return send_command(BT_HCI_OP_LE_SET_RANDOM_ADDRESS, 6, addr);
-}
-
-hci_result_t hci_le_set_advertising_parameters(uint16_t min_interval, uint16_t max_interval, uint8_t type, uint8_t own_addr_type, bt_addr_le_t *direct_addr, uint8_t channel_map, uint8_t filter_policy) {
-    struct bt_hci_cp_le_set_adv_param params = {
-        .min_interval = min_interval,
-        .max_interval = max_interval,
-        .type = type,
-        .own_addr_type = own_addr_type,
-        // .direct_addr set below.
-        .channel_map = channel_map,
-        .filter_policy = filter_policy,
-    };
-    params.direct_addr.type = direct_addr->type;
-    memcpy(params.direct_addr.a.val, direct_addr->a.val, sizeof(params.direct_addr.a.val));
-
-    return send_command(BT_HCI_OP_LE_SET_ADV_PARAM, sizeof(params), &params);
-}
-
-hci_result_t hci_le_set_extended_advertising_parameters(uint8_t handle, uint16_t props, uint32_t prim_min_interval, uint32_t prim_max_interval, uint8_t prim_channel_map, uint8_t own_addr_type, bt_addr_le_t *peer_addr, uint8_t filter_policy, int8_t tx_power, uint8_t prim_adv_phy, uint8_t sec_adv_max_skip, uint8_t sec_adv_phy, uint8_t sid, uint8_t scan_req_notify_enable) {
-    struct bt_hci_cp_le_set_ext_adv_param params = {
-        .handle = handle,
-        .props = props,
-        // .prim_min_interval and .prim_max_interval set below
-        .prim_channel_map = prim_channel_map,
-        .own_addr_type = own_addr_type,
-        // .peer_addr set below.
-        .tx_power = tx_power,
-        .sec_adv_max_skip = sec_adv_max_skip,
-        .sec_adv_phy = sec_adv_phy,
-        .sid = sid,
-        .scan_req_notify_enable = scan_req_notify_enable,
-    };
-    // Assumes little-endian.
-    memcpy(params.prim_min_interval, (void *)&prim_min_interval,
-        sizeof_field(struct bt_hci_cp_le_set_ext_adv_param, prim_min_interval));
-    memcpy(params.prim_max_interval, (void *)&prim_max_interval,
-        sizeof_field(struct bt_hci_cp_le_set_ext_adv_param, prim_max_interval));
-    memcpy(params.peer_addr.a.val, peer_addr->a.val, sizeof_field(bt_addr_le_t, a.val));
-    return send_command(BT_HCI_OP_LE_SET_EXT_ADV_PARAM, sizeof(params), &params);
-}
-
-hci_result_t hci_le_read_maximum_advertising_data_length(uint16_t *max_adv_data_len) {
-    int result = send_command(BT_HCI_OP_LE_READ_MAX_ADV_DATA_LEN, 0, NULL);
-    if (result == HCI_OK) {
-        struct bt_hci_rp_le_read_max_adv_data_len *response =
-            (struct bt_hci_rp_le_read_max_adv_data_len *)cmd_response_data;
-        *max_adv_data_len = response->max_adv_data_len;
-    }
-
-    return result;
-}
-
-hci_result_t hci_le_read_local_supported_features(uint8_t features[8]) {
-    int result = send_command(BT_HCI_OP_LE_READ_LOCAL_FEATURES, 0, NULL);
-    if (result == HCI_OK) {
-        struct bt_hci_rp_le_read_local_features *response =
-            (struct bt_hci_rp_le_read_local_features *)cmd_response_data;
-        memcpy(features, response->features,
-            sizeof_field(struct bt_hci_rp_le_read_local_features, features));
-    }
-
-    return result;
-}
-
-hci_result_t hci_le_set_advertising_data(uint8_t len, uint8_t data[]) {
-    struct bt_hci_cp_le_set_adv_data params = {
-        // Zero out unused data bytes.
-        .data = { 0 },
-    };
-
-    params.len = len;
-    memcpy(params.data, data, len);
-
-    // All data bytes are sent even if some are unused.
-    return send_command(BT_HCI_OP_LE_SET_ADV_DATA, sizeof(params), &params);
-}
-
-hci_result_t hci_le_set_extended_advertising_data(uint8_t handle, uint8_t op, uint8_t frag_pref, uint8_t len, uint8_t data[]) {
-    const uint8_t max_len = sizeof_field(struct bt_hci_cp_le_set_ext_adv_data, data);
-    uint8_t valid_len = MIN(len, max_len);
-    struct bt_hci_cp_le_set_ext_adv_data params = {
-        .handle = handle,
-        .op = op,
-        .frag_pref = frag_pref,
-        .len = valid_len,
-    };
-    memcpy(params.data, data, valid_len);
-    return send_command(BT_HCI_OP_LE_SET_EXT_ADV_DATA, sizeof(params) - (max_len - valid_len), &params);
-}
-
-
-hci_result_t hci_le_set_scan_response_data(uint8_t len, uint8_t data[]) {
-    struct bt_hci_cp_le_set_scan_rsp_data params = {
-        // Zero out unused data bytes.
-        .data = { 0 },
-    };
-    params.len = len;
-    memcpy(params.data, data, len);
-
-    // All data bytes are sent even if some are unused.
-    return send_command(BT_HCI_OP_LE_SET_SCAN_RSP_DATA, sizeof(params), &params);
-}
-
-hci_result_t hci_le_set_advertising_enable(uint8_t enable) {
-    return send_command(BT_HCI_OP_LE_SET_ADV_ENABLE, sizeof(enable), &enable);
-}
-
-hci_result_t hci_le_set_extended_advertising_enable(uint8_t enable, uint8_t set_num, uint8_t handle[], uint16_t duration[], uint8_t max_ext_adv_evts[]) {
-    uint8_t params[sizeof(struct bt_hci_cp_le_set_ext_adv_enable) +
-                   set_num * (sizeof(struct bt_hci_ext_adv_set))];
-    struct bt_hci_cp_le_set_ext_adv_enable *params_p = (struct bt_hci_cp_le_set_ext_adv_enable *)&params;
-    params_p->enable = enable;
-    params_p->set_num = set_num;
-    for (size_t i = 0; i < set_num; i++) {
-        params_p->s[i].handle = handle[i];
-        params_p->s[i].duration = duration[i];
-        params_p->s[i].max_ext_adv_evts = max_ext_adv_evts[i];
-    }
-
-    return send_command(BT_HCI_OP_LE_SET_EXT_ADV_ENABLE, sizeof(params), &params);
-}
-
-hci_result_t hci_le_set_scan_parameters(uint8_t scan_type, uint16_t interval, uint16_t window, uint8_t addr_type, uint8_t filter_policy) {
-    struct bt_hci_cp_le_set_scan_param params = {
-        .scan_type = scan_type,
-        .interval = interval,
-        .window = window,
-        .addr_type = addr_type,
-        .filter_policy = filter_policy,
-    };
-
-    return send_command(BT_HCI_OP_LE_SET_SCAN_PARAM, sizeof(params), &params);
-}
-
-hci_result_t hci_le_set_scan_enable(uint8_t enable, uint8_t filter_dup) {
-    struct bt_hci_cp_le_set_scan_enable params = {
-        .enable = enable,
-        .filter_dup = filter_dup,
-    };
-
-    return send_command(BT_HCI_OP_LE_SET_SCAN_ENABLE, sizeof(params), &params);
-}
-
-hci_result_t hci_le_create_conn(uint16_t scan_interval, uint16_t scan_window, uint8_t filter_policy, bt_addr_le_t *peer_addr, uint8_t own_addr_type, uint16_t conn_interval_min, uint16_t conn_interval_max, uint16_t conn_latency, uint16_t supervision_timeout, uint16_t min_ce_len, uint16_t max_ce_len) {
-    struct bt_hci_cp_le_create_conn params = {
-        .scan_interval = scan_interval,
-        .scan_window = scan_window,
-        .filter_policy = filter_policy,
-        // .peer_addr is set below
-        .own_addr_type = own_addr_type,
-        .conn_interval_min = conn_interval_min,
-        .conn_interval_max = conn_interval_max,
-        .conn_latency = conn_latency,
-        .supervision_timeout = supervision_timeout,
-        .min_ce_len = min_ce_len,
-        .max_ce_len = max_ce_len,
-    };
-    params.peer_addr.type = peer_addr->type;
-    memcpy(params.peer_addr.a.val, peer_addr->a.val, sizeof(params.peer_addr.a.val));
-
-    return send_command(BT_HCI_OP_LE_CREATE_CONN, sizeof(params), &params);
-}
-
-hci_result_t hci_le_cancel_conn(void) {
-    return send_command(BT_HCI_OP_CONNECT_CANCEL, 0, NULL);
-}
-
-hci_result_t hci_le_conn_update(uint16_t handle, uint16_t conn_interval_min, uint16_t conn_interval_max, uint16_t conn_latency, uint16_t supervision_timeout) {
-    struct hci_cp_le_conn_update params = {
-        .handle = handle,
-        .conn_interval_min = conn_interval_min,
-        .conn_interval_max = conn_interval_max,
-        .conn_latency = conn_latency,
-        .supervision_timeout = supervision_timeout,
-        .min_ce_len = 4,
-        .max_ce_len = 6,
-    };
-
-    return send_command(BT_HCI_OP_LE_CONN_UPDATE, sizeof(params), &params);
-}
-
-hci_result_t hci_disconnect(uint16_t handle) {
-    struct bt_hci_cp_disconnect params = {
-        .handle = handle,
-        .reason = BT_HCI_ERR_REMOTE_USER_TERM_CONN,
-    };
-
-    return send_command(BT_HCI_OP_DISCONNECT, sizeof(params), &params);
-}
-
-void hci_check_error(hci_result_t result) {
-    switch (result) {
-        case HCI_OK:
-            return;
-
-        case HCI_RESPONSE_TIMEOUT:
-            mp_raise_bleio_BluetoothError(translate("Timeout waiting for HCI response"));
-            return;
-
-        case HCI_WRITE_TIMEOUT:
-            mp_raise_bleio_BluetoothError(translate("Timeout waiting to write HCI request"));
-            return;
-
-        case HCI_READ_ERROR:
-            mp_raise_bleio_BluetoothError(translate("Error reading from HCI adapter"));
-            return;
-
-        case HCI_WRITE_ERROR:
-            mp_raise_bleio_BluetoothError(translate("Error writing to HCI adapter"));
-            return;
-
-        case HCI_PACKET_SIZE_ERROR:
-            mp_raise_RuntimeError(translate("HCI packet size mismatch"));
-            return;
-
-        case HCI_ATT_ERROR:
-            mp_raise_RuntimeError(translate("Error in ATT protocol code"));
-            return;
-
-        default:
-            // Should be an HCI status error, > 0.
-            if (result > 0) {
-                mp_raise_bleio_BluetoothError(translate("HCI status error: %02x"), result);
-            } else {
-                mp_raise_bleio_BluetoothError(translate("Unknown hci_result_t: %d"), result);
-            }
-            return;
-    }
-}

devices/ble_hci/common-hal/_bleio/hci.h

@@ -1,81 +0,0 @@
-/*
-  This file is part of the ArduinoBLE library.
-  Copyright (c) 2018 Arduino SA. All rights reserved.
-
-  This library is free software; you can redistribute it and/or
-  modify it under the terms of the GNU Lesser General Public
-  License as published by the Free Software Foundation; either
-  version 2.1 of the License, or (at your option) any later version.
-
-  This library is distributed in the hope that it will be useful,
-  but WITHOUT ANY WARRANTY; without even the implied warranty of
-  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
-  Lesser General Public License for more details.
-
-  You should have received a copy of the GNU Lesser General Public
-  License along with this library; if not, write to the Free Software
-  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
-*/
-
-#ifndef MICROPY_INCLUDED_DEVICES_BLE_HCI_COMMON_HAL_BLEIO_HCI_H
-#define MICROPY_INCLUDED_DEVICES_BLE_HCI_COMMON_HAL_BLEIO_HCI_H
-
-#include <stdint.h>
-
-#include "common-hal/_bleio/hci_include/hci.h"
-#include "common-hal/_bleio/hci_include/hci_err.h"
-
-// Incomplete forward declaration to get around mutually-dependent include files.
-typedef struct _bleio_adapter_obj_t bleio_adapter_obj_t;
-
-// An hci_result_t is one of the HCI_x values below,
-// or it is > 0 and is an HCI command status value (see hci_include/hci_err.h)
-typedef int hci_result_t;
-#define HCI_OK                 (0)
-#define HCI_RESPONSE_TIMEOUT  (-1)
-#define HCI_WRITE_TIMEOUT     (-2)
-#define HCI_READ_ERROR        (-3)
-#define HCI_WRITE_ERROR       (-4)
-#define HCI_ATT_ERROR         (-5)
-#define HCI_PACKET_SIZE_ERROR (-6)
-
-extern void bleio_hci_reset(void);
-
-void hci_check_error(hci_result_t result);
-
-hci_result_t hci_disconnect(uint16_t handle);
-
-hci_result_t hci_le_cancel_conn(void);
-hci_result_t hci_le_conn_update(uint16_t handle, uint16_t conn_interval_min, uint16_t conn_interval_max, uint16_t conn_latency, uint16_t supervision_timeout);
-hci_result_t hci_le_create_conn(uint16_t scan_interval, uint16_t scan_window, uint8_t filter_policy, bt_addr_le_t *peer_addr, uint8_t own_addr_type, uint16_t conn_interval_min, uint16_t conn_interval_max, uint16_t conn_latency, uint16_t supervision_timeout, uint16_t min_ce_len, uint16_t max_ce_len);
-
-hci_result_t hci_le_read_buffer_size(uint16_t *le_max_len, uint8_t *le_max_num);
-hci_result_t hci_le_read_maximum_advertising_data_length(uint16_t *max_adv_data_len);
-hci_result_t hci_le_read_local_supported_features(uint8_t features[8]);
-
-hci_result_t hci_le_set_advertising_data(uint8_t length, uint8_t data[]);
-hci_result_t hci_le_set_advertising_enable(uint8_t enable);
-hci_result_t hci_le_set_advertising_parameters(uint16_t min_interval, uint16_t max_interval, uint8_t type, uint8_t own_addr_type, bt_addr_le_t *direct_addr, uint8_t channel_map, uint8_t filter_policy);
-
-hci_result_t hci_le_set_extended_advertising_data(uint8_t handle, uint8_t op, uint8_t frag_pref, uint8_t len, uint8_t data[]);
-hci_result_t hci_le_set_extended_advertising_enable(uint8_t enable, uint8_t set_num, uint8_t handle[], uint16_t duration[], uint8_t max_ext_adv_evts[]);
-hci_result_t hci_le_set_extended_advertising_parameters(uint8_t handle, uint16_t props, uint32_t prim_min_interval, uint32_t prim_max_interval, uint8_t prim_channel_map, uint8_t own_addr_type, bt_addr_le_t *peer_addr, uint8_t filter_policy, int8_t tx_power, uint8_t prim_adv_phy, uint8_t sec_adv_max_skip, uint8_t sec_adv_phy, uint8_t sid, uint8_t scan_req_notify_enable);
-
-hci_result_t hci_le_set_random_address(uint8_t addr[6]);
-hci_result_t hci_le_set_scan_enable(uint8_t enable, uint8_t filter_dup);
-hci_result_t hci_le_set_scan_parameters(uint8_t scan_type, uint16_t interval, uint16_t window, uint8_t addr_type, uint8_t filter_policy);
-hci_result_t hci_le_set_scan_response_data(uint8_t length, uint8_t data[]);
-
-hci_result_t hci_poll_for_incoming_pkt(void);
-
-hci_result_t hci_read_bd_addr(bt_addr_t *addr);
-hci_result_t hci_read_buffer_size(uint16_t *acl_max_len, uint8_t *sco_max_len, uint16_t *acl_max_num, uint16_t *sco_max_num);
-hci_result_t hci_read_local_version(uint8_t *hci_version, uint16_t *hci_revision, uint8_t *lmp_version, uint16_t *manufacturer, uint16_t *lmp_subversion);
-hci_result_t hci_read_rssi(uint16_t handle, int *rssi);
-
-hci_result_t hci_reset(void);
-
-hci_result_t hci_send_acl_pkt(uint16_t handle, uint8_t cid, uint16_t data_len, uint8_t *data);
-hci_result_t hci_set_event_mask(uint64_t event_mask);
-
-#endif // MICROPY_INCLUDED_DEVICES_BLE_HCI_COMMON_HAL_BLEIO_HCI_H

devices/ble_hci/common-hal/_bleio/hci_debug.c

@@ -1,549 +0,0 @@
-/*
- * This file is part of the MicroPython project, http://micropython.org/
- *
- * The MIT License (MIT)
- *
- * Copyright (c) 2020 Dan Halbert for Adafruit Industries
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-// This file is #include'd in hci.c when HCI_DEBUG is non-zero.
-
-STATIC const char *att_opcode_name(uint16_t opcode) {
-    switch (opcode) {
-        case BT_ATT_OP_ERROR_RSP:
-            return "ERROR_RSP";
-        case BT_ATT_OP_MTU_REQ:
-            return "MTU_REQ";
-        case BT_ATT_OP_MTU_RSP:
-            return "MTU_RSP";
-        case BT_ATT_OP_FIND_INFO_REQ:
-            return "FIND_INFO_REQ";
-        case BT_ATT_OP_FIND_INFO_RSP:
-            return "FIND_INFO_RSP";
-        case BT_ATT_OP_FIND_TYPE_REQ:
-            return "FIND_TYPE_REQ";
-        case BT_ATT_OP_FIND_TYPE_RSP:
-            return "FIND_TYPE_RSP";
-        case BT_ATT_OP_READ_TYPE_REQ:
-            return "READ_TYPE_REQ";
-        case BT_ATT_OP_READ_TYPE_RSP:
-            return "READ_TYPE_RSP";
-        case BT_ATT_OP_READ_REQ:
-            return "READ_REQ";
-        case BT_ATT_OP_READ_RSP:
-            return "READ_RSP";
-        case BT_ATT_OP_READ_BLOB_REQ:
-            return "READ_BLOB_REQ";
-        case BT_ATT_OP_READ_BLOB_RSP:
-            return "READ_BLOB_RSP";
-        case BT_ATT_OP_READ_MULT_REQ:
-            return "READ_MULT_REQ";
-        case BT_ATT_OP_READ_MULT_RSP:
-            return "READ_MULT_RSP";
-        case BT_ATT_OP_READ_GROUP_REQ:
-            return "READ_GROUP_REQ";
-        case BT_ATT_OP_READ_GROUP_RSP:
-            return "READ_GROUP_RSP";
-        case BT_ATT_OP_WRITE_REQ:
-            return "WRITE_REQ";
-        case BT_ATT_OP_WRITE_RSP:
-            return "WRITE_RSP";
-        case BT_ATT_OP_PREPARE_WRITE_REQ:
-            return "PREPARE_WRITE_REQ";
-        case BT_ATT_OP_PREPARE_WRITE_RSP:
-            return "PREPARE_WRITE_RSP";
-        case BT_ATT_OP_EXEC_WRITE_REQ:
-            return "EXEC_WRITE_REQ";
-        case BT_ATT_OP_EXEC_WRITE_RSP:
-            return "EXEC_WRITE_RSP";
-        case BT_ATT_OP_NOTIFY:
-            return "NOTIFY";
-        case BT_ATT_OP_INDICATE:
-            return "INDICATE";
-        case BT_ATT_OP_CONFIRM:
-            return "CONFIRM";
-        case BT_ATT_OP_READ_MULT_VL_REQ:
-            return "READ_MULT_VL_REQ";
-        case BT_ATT_OP_READ_MULT_VL_RSP:
-            return "READ_MULT_VL_RSP";
-        case BT_ATT_OP_NOTIFY_MULT:
-            return "NOTIFY_MULT";
-        case BT_ATT_OP_WRITE_CMD:
-            return "WRITE_CMD";
-        case BT_ATT_OP_SIGNED_WRITE_CMD:
-            return "SIGNED_WRITE_CMD";
-        default:
-            return "";
-    }
-}
-
-STATIC const char *hci_evt_name(uint8_t evt) {
-    switch (evt) {
-        case BT_HCI_EVT_UNKNOWN:
-            return "UNKNOWN";
-        case BT_HCI_EVT_VENDOR:
-            return "VENDOR";
-        case BT_HCI_EVT_INQUIRY_COMPLETE:
-            return "INQUIRY_COMPLETE";
-        case BT_HCI_EVT_CONN_COMPLETE:
-            return "CONN_COMPLETE";
-        case BT_HCI_EVT_CONN_REQUEST:
-            return "CONN_REQUEST";
-        case BT_HCI_EVT_DISCONN_COMPLETE:
-            return "DISCONN_COMPLETE";
-        case BT_HCI_EVT_AUTH_COMPLETE:
-            return "AUTH_COMPLETE";
-        case BT_HCI_EVT_REMOTE_NAME_REQ_COMPLETE:
-            return "REMOTE_NAME_REQ_COMPLETE";
-        case BT_HCI_EVT_ENCRYPT_CHANGE:
-            return "ENCRYPT_CHANGE";
-        case BT_HCI_EVT_REMOTE_FEATURES:
-            return "REMOTE_FEATURES";
-        case BT_HCI_EVT_REMOTE_VERSION_INFO:
-            return "REMOTE_VERSION_INFO";
-        case BT_HCI_EVT_CMD_COMPLETE:
-            return "CMD_COMPLETE";
-        case BT_HCI_EVT_CMD_STATUS:
-            return "CMD_STATUS";
-        case BT_HCI_EVT_ROLE_CHANGE:
-            return "ROLE_CHANGE";
-        case BT_HCI_EVT_NUM_COMPLETED_PACKETS:
-            return "NUM_COMPLETED_PACKETS";
-        case BT_HCI_EVT_PIN_CODE_REQ:
-            return "PIN_CODE_REQ";
-        case BT_HCI_EVT_LINK_KEY_REQ:
-            return "LINK_KEY_REQ";
-        case BT_HCI_EVT_LINK_KEY_NOTIFY:
-            return "LINK_KEY_NOTIFY";
-        case BT_HCI_EVT_DATA_BUF_OVERFLOW:
-            return "DATA_BUF_OVERFLOW";
-        case BT_HCI_EVT_INQUIRY_RESULT_WITH_RSSI:
-            return "INQUIRY_RESULT_WITH_RSSI";
-        case BT_HCI_EVT_REMOTE_EXT_FEATURES:
-            return "REMOTE_EXT_FEATURES";
-        case BT_HCI_EVT_SYNC_CONN_COMPLETE:
-            return "SYNC_CONN_COMPLETE";
-        case BT_HCI_EVT_EXTENDED_INQUIRY_RESULT:
-            return "EXTENDED_INQUIRY_RESULT";
-        case BT_HCI_EVT_ENCRYPT_KEY_REFRESH_COMPLETE:
-            return "ENCRYPT_KEY_REFRESH_COMPLETE";
-        case BT_HCI_EVT_IO_CAPA_REQ:
-            return "IO_CAPA_REQ";
-        case BT_HCI_EVT_IO_CAPA_RESP:
-            return "IO_CAPA_RESP";
-        case BT_HCI_EVT_USER_CONFIRM_REQ:
-            return "USER_CONFIRM_REQ";
-        case BT_HCI_EVT_USER_PASSKEY_REQ:
-            return "USER_PASSKEY_REQ";
-        case BT_HCI_EVT_SSP_COMPLETE:
-            return "SSP_COMPLETE";
-        case BT_HCI_EVT_USER_PASSKEY_NOTIFY:
-            return "USER_PASSKEY_NOTIFY";
-        case BT_HCI_EVT_LE_META_EVENT:
-            return "LE_META_EVENT";
-        case BT_HCI_EVT_AUTH_PAYLOAD_TIMEOUT_EXP:
-            return "AUTH_PAYLOAD_TIMEOUT_EXP";
-        default:
-            return "";
-    }
-}
-
-STATIC const char *hci_evt_le_name(uint8_t evt_le) {
-    switch (evt_le) {
-        case BT_HCI_EVT_LE_CONN_COMPLETE:
-            return "LE_CONN_COMPLETE";
-        case BT_HCI_EVT_LE_ADVERTISING_REPORT:
-            return "LE_ADVERTISING_REPORT";
-        case BT_HCI_EVT_LE_CONN_UPDATE_COMPLETE:
-            return "LE_CONN_UPDATE_COMPLETE";
-        case BT_HCI_EVT_LE_LTK_REQUEST:
-            return "LE_LTK_REQUEST";
-        case BT_HCI_EVT_LE_CONN_PARAM_REQ:
-            return "LE_CONN_PARAM_REQ";
-        case BT_HCI_EVT_LE_DATA_LEN_CHANGE:
-            return "LE_DATA_LEN_CHANGE";
-        case BT_HCI_EVT_LE_P256_PUBLIC_KEY_COMPLETE:
-            return "LE_P256_PUBLIC_KEY_COMPLETE";
-        case BT_HCI_EVT_LE_GENERATE_DHKEY_COMPLETE:
-            return "LE_GENERATE_DHKEY_COMPLETE";
-        case BT_HCI_EVT_LE_ENH_CONN_COMPLETE:
-            return "LE_ENH_CONN_COMPLETE";
-        case BT_HCI_EVT_LE_DIRECT_ADV_REPORT:
-            return "LE_DIRECT_ADV_REPORT";
-        case BT_HCI_EVT_LE_PHY_UPDATE_COMPLETE:
-            return "LE_PHY_UPDATE_COMPLETE";
-        case BT_HCI_EVT_LE_EXT_ADVERTISING_REPORT:
-            return "LE_EXT_ADVERTISING_REPORT";
-        case BT_HCI_EVT_LE_PER_ADV_SYNC_ESTABLISHED:
-            return "LE_PER_ADV_SYNC_ESTABLISHED";
-        case BT_HCI_EVT_LE_PER_ADVERTISING_REPORT:
-            return "LE_PER_ADVERTISING_REPORT";
-        case BT_HCI_EVT_LE_PER_ADV_SYNC_LOST:
-            return "LE_PER_ADV_SYNC_LOST";
-        case BT_HCI_EVT_LE_SCAN_TIMEOUT:
-            return "LE_SCAN_TIMEOUT";
-        case BT_HCI_EVT_LE_ADV_SET_TERMINATED:
-            return "LE_ADV_SET_TERMINATED";
-        case BT_HCI_EVT_LE_SCAN_REQ_RECEIVED:
-            return "LE_SCAN_REQ_RECEIVED";
-        case BT_HCI_EVT_LE_CHAN_SEL_ALGO:
-            return "LE_CHAN_SEL_ALGO";
-        default:
-            return "";
-    }
-}
-
-STATIC const char *hci_opcode_name(uint16_t opcode) {
-    switch (opcode) {
-        case BT_OP_NOP:
-            return "NOP";
-        case BT_HCI_OP_INQUIRY:
-            return "INQUIRY";
-        case BT_HCI_OP_INQUIRY_CANCEL:
-            return "INQUIRY_CANCEL";
-        case BT_HCI_OP_CONNECT:
-            return "CONNECT";
-        case BT_HCI_OP_DISCONNECT:
-            return "DISCONNECT";
-        case BT_HCI_OP_CONNECT_CANCEL:
-            return "CONNECT_CANCEL";
-        case BT_HCI_OP_ACCEPT_CONN_REQ:
-            return "ACCEPT_CONN_REQ";
-        case BT_HCI_OP_SETUP_SYNC_CONN:
-            return "SETUP_SYNC_CONN";
-        case BT_HCI_OP_ACCEPT_SYNC_CONN_REQ:
-            return "ACCEPT_SYNC_CONN_REQ";
-        case BT_HCI_OP_REJECT_CONN_REQ:
-            return "REJECT_CONN_REQ";
-        case BT_HCI_OP_LINK_KEY_REPLY:
-            return "LINK_KEY_REPLY";
-        case BT_HCI_OP_LINK_KEY_NEG_REPLY:
-            return "LINK_KEY_NEG_REPLY";
-        case BT_HCI_OP_PIN_CODE_REPLY:
-            return "PIN_CODE_REPLY";
-        case BT_HCI_OP_PIN_CODE_NEG_REPLY:
-            return "PIN_CODE_NEG_REPLY";
-        case BT_HCI_OP_AUTH_REQUESTED:
-            return "AUTH_REQUESTED";
-        case BT_HCI_OP_SET_CONN_ENCRYPT:
-            return "SET_CONN_ENCRYPT";
-        case BT_HCI_OP_REMOTE_NAME_REQUEST:
-            return "REMOTE_NAME_REQUEST";
-        case BT_HCI_OP_REMOTE_NAME_CANCEL:
-            return "REMOTE_NAME_CANCEL";
-        case BT_HCI_OP_READ_REMOTE_FEATURES:
-            return "READ_REMOTE_FEATURES";
-        case BT_HCI_OP_READ_REMOTE_EXT_FEATURES:
-            return "READ_REMOTE_EXT_FEATURES";
-        case BT_HCI_OP_READ_REMOTE_VERSION_INFO:
-            return "READ_REMOTE_VERSION_INFO";
-        case BT_HCI_OP_IO_CAPABILITY_REPLY:
-            return "IO_CAPABILITY_REPLY";
-        case BT_HCI_OP_USER_CONFIRM_REPLY:
-            return "USER_CONFIRM_REPLY";
-        case BT_HCI_OP_USER_CONFIRM_NEG_REPLY:
-            return "USER_CONFIRM_NEG_REPLY";
-        case BT_HCI_OP_USER_PASSKEY_REPLY:
-            return "USER_PASSKEY_REPLY";
-        case BT_HCI_OP_USER_PASSKEY_NEG_REPLY:
-            return "USER_PASSKEY_NEG_REPLY";
-        case BT_HCI_OP_IO_CAPABILITY_NEG_REPLY:
-            return "IO_CAPABILITY_NEG_REPLY";
-        case BT_HCI_OP_SET_EVENT_MASK:
-            return "SET_EVENT_MASK";
-        case BT_HCI_OP_RESET:
-            return "RESET";
-        case BT_HCI_OP_WRITE_LOCAL_NAME:
-            return "WRITE_LOCAL_NAME";
-        case BT_HCI_OP_WRITE_PAGE_TIMEOUT:
-            return "WRITE_PAGE_TIMEOUT";
-        case BT_HCI_OP_WRITE_SCAN_ENABLE:
-            return "WRITE_SCAN_ENABLE";
-        case BT_HCI_OP_READ_TX_POWER_LEVEL:
-            return "READ_TX_POWER_LEVEL";
-        case BT_HCI_OP_SET_CTL_TO_HOST_FLOW:
-            return "SET_CTL_TO_HOST_FLOW";
-        case BT_HCI_OP_HOST_BUFFER_SIZE:
-            return "HOST_BUFFER_SIZE";
-        case BT_HCI_OP_HOST_NUM_COMPLETED_PACKETS:
-            return "HOST_NUM_COMPLETED_PACKETS";
-        case BT_HCI_OP_WRITE_INQUIRY_MODE:
-            return "WRITE_INQUIRY_MODE";
-        case BT_HCI_OP_WRITE_SSP_MODE:
-            return "WRITE_SSP_MODE";
-        case BT_HCI_OP_SET_EVENT_MASK_PAGE_2:
-            return "SET_EVENT_MASK_PAGE_2";
-        case BT_HCI_OP_LE_WRITE_LE_HOST_SUPP:
-            return "LE_WRITE_LE_HOST_SUPP";
-        case BT_HCI_OP_WRITE_SC_HOST_SUPP:
-            return "WRITE_SC_HOST_SUPP";
-        case BT_HCI_OP_READ_AUTH_PAYLOAD_TIMEOUT:
-            return "READ_AUTH_PAYLOAD_TIMEOUT";
-        case BT_HCI_OP_WRITE_AUTH_PAYLOAD_TIMEOUT:
-            return "WRITE_AUTH_PAYLOAD_TIMEOUT";
-        case BT_HCI_OP_READ_LOCAL_VERSION_INFO:
-            return "READ_LOCAL_VERSION_INFO";
-        case BT_HCI_OP_READ_SUPPORTED_COMMANDS:
-            return "READ_SUPPORTED_COMMANDS";
-        case BT_HCI_OP_READ_LOCAL_EXT_FEATURES:
-            return "READ_LOCAL_EXT_FEATURES";
-        case BT_HCI_OP_READ_LOCAL_FEATURES:
-            return "READ_LOCAL_FEATURES";
-        case BT_HCI_OP_READ_BUFFER_SIZE:
-            return "READ_BUFFER_SIZE";
-        case BT_HCI_OP_READ_BD_ADDR:
-            return "READ_BD_ADDR";
-        case BT_HCI_OP_READ_RSSI:
-            return "READ_RSSI";
-        case BT_HCI_OP_READ_ENCRYPTION_KEY_SIZE:
-            return "READ_ENCRYPTION_KEY_SIZE";
-        case BT_HCI_OP_LE_SET_EVENT_MASK:
-            return "LE_SET_EVENT_MASK";
-        case BT_HCI_OP_LE_READ_BUFFER_SIZE:
-            return "LE_READ_BUFFER_SIZE";
-        case BT_HCI_OP_LE_READ_LOCAL_FEATURES:
-            return "LE_READ_LOCAL_FEATURES";
-        case BT_HCI_OP_LE_SET_RANDOM_ADDRESS:
-            return "LE_SET_RANDOM_ADDRESS";
-        case BT_HCI_OP_LE_SET_ADV_PARAM:
-            return "LE_SET_ADV_PARAM";
-        case BT_HCI_OP_LE_READ_ADV_CHAN_TX_POWER:
-            return "LE_READ_ADV_CHAN_TX_POWER";
-        case BT_HCI_OP_LE_SET_ADV_DATA:
-            return "LE_SET_ADV_DATA";
-        case BT_HCI_OP_LE_SET_SCAN_RSP_DATA:
-            return "LE_SET_SCAN_RSP_DATA";
-        case BT_HCI_OP_LE_SET_ADV_ENABLE:
-            return "LE_SET_ADV_ENABLE";
-        case BT_HCI_OP_LE_SET_SCAN_PARAM:
-            return "LE_SET_SCAN_PARAM";
-        case BT_HCI_OP_LE_SET_SCAN_ENABLE:
-            return "LE_SET_SCAN_ENABLE";
-        case BT_HCI_OP_LE_CREATE_CONN:
-            return "LE_CREATE_CONN";
-        case BT_HCI_OP_LE_CREATE_CONN_CANCEL:
-            return "LE_CREATE_CONN_CANCEL";
-        case BT_HCI_OP_LE_READ_WL_SIZE:
-            return "LE_READ_WL_SIZE";
-        case BT_HCI_OP_LE_CLEAR_WL:
-            return "LE_CLEAR_WL";
-        case BT_HCI_OP_LE_ADD_DEV_TO_WL:
-            return "LE_ADD_DEV_TO_WL";
-        case BT_HCI_OP_LE_REM_DEV_FROM_WL:
-            return "LE_REM_DEV_FROM_WL";
-        case BT_HCI_OP_LE_CONN_UPDATE:
-            return "LE_CONN_UPDATE";
-        case BT_HCI_OP_LE_SET_HOST_CHAN_CLASSIF:
-            return "LE_SET_HOST_CHAN_CLASSIF";
-        case BT_HCI_OP_LE_READ_CHAN_MAP:
-            return "LE_READ_CHAN_MAP";
-        case BT_HCI_OP_LE_READ_REMOTE_FEATURES:
-            return "LE_READ_REMOTE_FEATURES";
-        case BT_HCI_OP_LE_ENCRYPT:
-            return "LE_ENCRYPT";
-        case BT_HCI_OP_LE_RAND:
-            return "LE_RAND";
-        case BT_HCI_OP_LE_START_ENCRYPTION:
-            return "LE_START_ENCRYPTION";
-        case BT_HCI_OP_LE_LTK_REQ_REPLY:
-            return "LE_LTK_REQ_REPLY";
-        case BT_HCI_OP_LE_LTK_REQ_NEG_REPLY:
-            return "LE_LTK_REQ_NEG_REPLY";
-        case BT_HCI_OP_LE_READ_SUPP_STATES:
-            return "LE_READ_SUPP_STATES";
-        case BT_HCI_OP_LE_RX_TEST:
-            return "LE_RX_TEST";
-        case BT_HCI_OP_LE_TX_TEST:
-            return "LE_TX_TEST";
-        case BT_HCI_OP_LE_TEST_END:
-            return "LE_TEST_END";
-        case BT_HCI_OP_LE_CONN_PARAM_REQ_REPLY:
-            return "LE_CONN_PARAM_REQ_REPLY";
-        case BT_HCI_OP_LE_CONN_PARAM_REQ_NEG_REPLY:
-            return "LE_CONN_PARAM_REQ_NEG_REPLY";
-        case BT_HCI_OP_LE_SET_DATA_LEN:
-            return "LE_SET_DATA_LEN";
-        case BT_HCI_OP_LE_READ_DEFAULT_DATA_LEN:
-            return "LE_READ_DEFAULT_DATA_LEN";
-        case BT_HCI_OP_LE_WRITE_DEFAULT_DATA_LEN:
-            return "LE_WRITE_DEFAULT_DATA_LEN";
-        case BT_HCI_OP_LE_P256_PUBLIC_KEY:
-            return "LE_P256_PUBLIC_KEY";
-        case BT_HCI_OP_LE_GENERATE_DHKEY:
-            return "LE_GENERATE_DHKEY";
-        case BT_HCI_OP_LE_ADD_DEV_TO_RL:
-            return "LE_ADD_DEV_TO_RL";
-        case BT_HCI_OP_LE_REM_DEV_FROM_RL:
-            return "LE_REM_DEV_FROM_RL";
-        case BT_HCI_OP_LE_CLEAR_RL:
-            return "LE_CLEAR_RL";
-        case BT_HCI_OP_LE_READ_RL_SIZE:
-            return "LE_READ_RL_SIZE";
-        case BT_HCI_OP_LE_READ_PEER_RPA:
-            return "LE_READ_PEER_RPA";
-        case BT_HCI_OP_LE_READ_LOCAL_RPA:
-            return "LE_READ_LOCAL_RPA";
-        case BT_HCI_OP_LE_SET_ADDR_RES_ENABLE:
-            return "LE_SET_ADDR_RES_ENABLE";
-        case BT_HCI_OP_LE_SET_RPA_TIMEOUT:
-            return "LE_SET_RPA_TIMEOUT";
-        case BT_HCI_OP_LE_READ_MAX_DATA_LEN:
-            return "LE_READ_MAX_DATA_LEN";
-        case BT_HCI_OP_LE_READ_PHY:
-            return "LE_READ_PHY";
-        case BT_HCI_OP_LE_SET_DEFAULT_PHY:
-            return "LE_SET_DEFAULT_PHY";
-        case BT_HCI_OP_LE_SET_PHY:
-            return "LE_SET_PHY";
-        case BT_HCI_OP_LE_ENH_RX_TEST:
-            return "LE_ENH_RX_TEST";
-        case BT_HCI_OP_LE_ENH_TX_TEST:
-            return "LE_ENH_TX_TEST";
-        case BT_HCI_OP_LE_SET_ADV_SET_RANDOM_ADDR:
-            return "LE_SET_ADV_SET_RANDOM_ADDR";
-        case BT_HCI_OP_LE_SET_EXT_ADV_PARAM:
-            return "LE_SET_EXT_ADV_PARAM";
-        case BT_HCI_OP_LE_SET_EXT_ADV_DATA:
-            return "LE_SET_EXT_ADV_DATA";
-        case BT_HCI_OP_LE_SET_EXT_SCAN_RSP_DATA:
-            return "LE_SET_EXT_SCAN_RSP_DATA";
-        case BT_HCI_OP_LE_SET_EXT_ADV_ENABLE:
-            return "LE_SET_EXT_ADV_ENABLE";
-        case BT_HCI_OP_LE_READ_MAX_ADV_DATA_LEN:
-            return "LE_READ_MAX_ADV_DATA_LEN";
-        case BT_HCI_OP_LE_READ_NUM_ADV_SETS:
-            return "LE_READ_NUM_ADV_SETS";
-        case BT_HCI_OP_LE_REMOVE_ADV_SET:
-            return "LE_REMOVE_ADV_SET";
-        case BT_HCI_OP_CLEAR_ADV_SETS:
-            return "CLEAR_ADV_SETS";
-        case BT_HCI_OP_LE_SET_PER_ADV_PARAM:
-            return "LE_SET_PER_ADV_PARAM";
-        case BT_HCI_OP_LE_SET_PER_ADV_DATA:
-            return "LE_SET_PER_ADV_DATA";
-        case BT_HCI_OP_LE_SET_PER_ADV_ENABLE:
-            return "LE_SET_PER_ADV_ENABLE";
-        case BT_HCI_OP_LE_SET_EXT_SCAN_PARAM:
-            return "LE_SET_EXT_SCAN_PARAM";
-        case BT_HCI_OP_LE_SET_EXT_SCAN_ENABLE:
-            return "LE_SET_EXT_SCAN_ENABLE";
-        case BT_HCI_OP_LE_EXT_CREATE_CONN:
-            return "LE_EXT_CREATE_CONN";
-        case BT_HCI_OP_LE_PER_ADV_CREATE_SYNC:
-            return "LE_PER_ADV_CREATE_SYNC";
-        case BT_HCI_OP_LE_PER_ADV_CREATE_SYNC_CANCEL:
-            return "LE_PER_ADV_CREATE_SYNC_CANCEL";
-        case BT_HCI_OP_LE_PER_ADV_TERMINATE_SYNC:
-            return "LE_PER_ADV_TERMINATE_SYNC";
-        case BT_HCI_OP_LE_ADD_DEV_TO_PER_ADV_LIST:
-            return "LE_ADD_DEV_TO_PER_ADV_LIST";
-        case BT_HCI_OP_LE_REM_DEV_FROM_PER_ADV_LIST:
-            return "LE_REM_DEV_FROM_PER_ADV_LIST";
-        case BT_HCI_OP_LE_CLEAR_PER_ADV_LIST:
-            return "LE_CLEAR_PER_ADV_LIST";
-        case BT_HCI_OP_LE_READ_PER_ADV_LIST_SIZE:
-            return "LE_READ_PER_ADV_LIST_SIZE";
-        case BT_HCI_OP_LE_READ_TX_POWER:
-            return "LE_READ_TX_POWER";
-        case BT_HCI_OP_LE_READ_RF_PATH_COMP:
-            return "LE_READ_RF_PATH_COMP";
-        case BT_HCI_OP_LE_WRITE_RF_PATH_COMP:
-            return "LE_WRITE_RF_PATH_COMP";
-        case BT_HCI_OP_LE_SET_PRIVACY_MODE:
-            return "LE_SET_PRIVACY_MODE";
-        default:
-            return "";
-    }
-}
-
-
-STATIC void dump_cmd_pkt(bool tx, uint8_t pkt_len, uint8_t pkt_data[]) {
-    h4_hci_cmd_pkt_t *pkt = (h4_hci_cmd_pkt_t *)pkt_data;
-    mp_printf(&mp_plat_print,
-        "%s HCI COMMAND (%x) op:  %s (%04x), len: %d, data: ",
-        tx ? "TX->" : "RX<-",
-        pkt->pkt_type,
-        hci_opcode_name(pkt->opcode), pkt->opcode, pkt->param_len);
-    for (size_t i = 0; i < pkt->param_len; i++) {
-        mp_printf(&mp_plat_print, "%02x ", pkt->params[i]);
-    }
-    if (pkt_len != sizeof(h4_hci_cmd_pkt_t) + pkt->param_len) {
-        mp_printf(&mp_plat_print, "  LENGTH MISMATCH, pkt_len: %d", pkt_len);
-    }
-    mp_printf(&mp_plat_print, "\n");
-}
-
-STATIC void dump_acl_pkt(bool tx, uint8_t pkt_len, uint8_t pkt_data[]) {
-    h4_hci_acl_pkt_t *pkt = (h4_hci_acl_pkt_t *)pkt_data;
-    acl_data_t *acl = (acl_data_t *)pkt->data;
-
-    mp_printf(&mp_plat_print,
-        "%s HCI ACLDATA (%x) ",
-        tx ? "TX->" : "RX<-", pkt->pkt_type);
-
-    if (pkt->pb != ACL_DATA_PB_MIDDLE && acl->cid == BT_L2CAP_CID_ATT) {
-        // This is the start of a fragmented acl_data packet or is a full packet,
-        // and is an ATT protocol packet.
-        mp_printf(&mp_plat_print, "att: %s (%02x), ", att_opcode_name(acl->acl_data[0]), acl->acl_data[0]);
-    }
-
-    mp_printf(&mp_plat_print,
-        "handle: %04x, pb: %d, bc: %d, data_len: %d, ",
-        pkt->handle, pkt->pb, pkt->bc, pkt->data_len);
-
-    if (pkt->pb != ACL_DATA_PB_MIDDLE) {
-        // This is the start of a fragmented acl_data packet or is a full packet.
-        mp_printf(&mp_plat_print,
-            "acl data_len: %d, cid: %04x, data: ",
-            acl->acl_data_len, acl->cid);
-        for (size_t i = 0; i < acl->acl_data_len; i++) {
-            mp_printf(&mp_plat_print, "%02x ", acl->acl_data[i]);
-        }
-    } else {
-        for (size_t i = 0; i < pkt->data_len; i++) {
-            mp_printf(&mp_plat_print, "more data: %02x ", pkt->data[i]);
-        }
-    }
-
-    if (pkt_len != sizeof(h4_hci_acl_pkt_t) + pkt->data_len) {
-        mp_printf(&mp_plat_print, "  LENGTH MISMATCH, pkt_len: %d", pkt_len);
-    }
-    mp_printf(&mp_plat_print, "\n");
-}
-
-STATIC void dump_evt_pkt(bool tx, uint8_t pkt_len, uint8_t pkt_data[]) {
-    h4_hci_evt_pkt_t *pkt = (h4_hci_evt_pkt_t *)pkt_data;
-    mp_printf(&mp_plat_print,
-        "%s HCI EVENT   (%x) evt: %s (%02x),  param_len: %d,  data: ",
-        tx ? "TX->" : "RX<-",
-        pkt->pkt_type,
-        pkt->evt == BT_HCI_EVT_LE_META_EVENT
-                ? hci_evt_le_name(pkt->params[0])
-                : hci_evt_name(pkt->evt),
-        pkt->evt, pkt->param_len);
-    for (size_t i = 0; i < pkt->param_len; i++) {
-        mp_printf(&mp_plat_print, "%02x ", pkt->params[i]);
-    }
-    if (pkt_len != sizeof(h4_hci_evt_pkt_t) + pkt->param_len) {
-        mp_printf(&mp_plat_print, "  LENGTH MISMATCH, pkt_len: %d", pkt_len);
-    }
-    mp_printf(&mp_plat_print, "\n");
-}

devices/ble_hci/common-hal/_bleio/hci_include/NOTE.txt

@@ -1,2 +0,0 @@
-The HCI-related include files here were copied from the Zephyr project, from this commit:
-https://github.com/zephyrproject-rtos/zephyr/tree/0a87f9359edf1ec1c169626df3e19c2b4a4e9646/include/bluetooth

devices/ble_hci/common-hal/_bleio/hci_include/addr.h

@@ -1,95 +0,0 @@
-// CircuitPython: Adapted from Zephyer include files.
-/** @file
- *  @brief Bluetooth device address definitions and utilities.
- */
-
-/*
- * Copyright (c) 2019 Nordic Semiconductor ASA
- * Copyright 2020 Dan Halbert for Adafruit Industries
- *
- * SPDX-License-Identifier: Apache-2.0
- */
-#ifndef ZEPHYR_INCLUDE_BLUETOOTH_ADDR_H_
-#define ZEPHYR_INCLUDE_BLUETOOTH_ADDR_H_
-
-#include <stdbool.h>
-#include <string.h>
-
-/**
- * @brief Bluetooth device address definitions and utilities.
- * @defgroup bt_addr Device Address
- * @ingroup bluetooth
- * @{
- */
-
-#define BT_ADDR_LE_PUBLIC       0x00
-#define BT_ADDR_LE_RANDOM       0x01
-#define BT_ADDR_LE_PUBLIC_ID    0x02
-#define BT_ADDR_LE_RANDOM_ID    0x03
-
-/** Bluetooth Device Address */
-typedef struct {
-    uint8_t val[6];
-} bt_addr_t;
-
-/** Bluetooth LE Device Address */
-typedef struct {
-    uint8_t type;
-    bt_addr_t a;
-} bt_addr_le_t;
-
-#define BT_ADDR_ANY     ((bt_addr_t[]) { { { 0, 0, 0, 0, 0, 0 } } })
-#define BT_ADDR_NONE    ((bt_addr_t[]) { { \
-                                             { 0xff, 0xff, 0xff, 0xff, 0xff, 0xff } } })
-#define BT_ADDR_LE_ANY  ((bt_addr_le_t[]) { { 0, { { 0, 0, 0, 0, 0, 0 } } } })
-#define BT_ADDR_LE_NONE ((bt_addr_le_t[]) { { 0, \
-                                              { { 0xff, 0xff, 0xff, 0xff, 0xff, 0xff } } } })
-
-static inline int bt_addr_cmp(const bt_addr_t *a, const bt_addr_t *b) {
-    return memcmp(a, b, sizeof(*a));
-}
-
-static inline int bt_addr_le_cmp(const bt_addr_le_t *a, const bt_addr_le_t *b) {
-    return memcmp(a, b, sizeof(*a));
-}
-
-static inline void bt_addr_copy(bt_addr_t *dst, const bt_addr_t *src) {
-    memcpy(dst, src, sizeof(*dst));
-}
-
-static inline void bt_addr_le_copy(bt_addr_le_t *dst, const bt_addr_le_t *src) {
-    memcpy(dst, src, sizeof(*dst));
-}
-
-#define BT_ADDR_IS_RPA(a)     (((a)->val[5] & 0xc0) == 0x40)
-#define BT_ADDR_IS_NRPA(a)    (((a)->val[5] & 0xc0) == 0x00)
-#define BT_ADDR_IS_STATIC(a)  (((a)->val[5] & 0xc0) == 0xc0)
-
-#define BT_ADDR_SET_RPA(a)    ((a)->val[5] = (((a)->val[5] & 0x3f) | 0x40))
-#define BT_ADDR_SET_NRPA(a)   ((a)->val[5] &= 0x3f)
-#define BT_ADDR_SET_STATIC(a) ((a)->val[5] |= 0xc0)
-
-int bt_addr_le_create_nrpa(bt_addr_le_t *addr);
-int bt_addr_le_create_static(bt_addr_le_t *addr);
-
-static inline bool bt_addr_le_is_rpa(const bt_addr_le_t *addr) {
-    if (addr->type != BT_ADDR_LE_RANDOM) {
-        return false;
-    }
-
-    return BT_ADDR_IS_RPA(&addr->a);
-}
-
-static inline bool bt_addr_le_is_identity(const bt_addr_le_t *addr) {
-    if (addr->type == BT_ADDR_LE_PUBLIC) {
-        return true;
-    }
-
-    return BT_ADDR_IS_STATIC(&addr->a);
-}
-
-/**
- * @}
- */
-
-#endif /* ZEPHYR_INCLUDE_BLUETOOTH_ADDR_H_ */

devices/ble_hci/common-hal/_bleio/hci_include/att.h

@@ -1,41 +0,0 @@
-// CircuitPython: Adapted from Zephyr include file.
-/** @file
- *  @brief Attribute Protocol handling.
- */
-
-/*
- * Copyright (c) 2016 Intel Corporation
- *
- * SPDX-License-Identifier: Apache-2.0
- */
-#ifndef ZEPHYR_INCLUDE_BLUETOOTH_ATT_H_
-#define ZEPHYR_INCLUDE_BLUETOOTH_ATT_H_
-
-/* Error codes for Error response PDU */
-#define BT_ATT_ERR_INVALID_HANDLE               0x01
-#define BT_ATT_ERR_READ_NOT_PERMITTED           0x02
-#define BT_ATT_ERR_WRITE_NOT_PERMITTED          0x03
-#define BT_ATT_ERR_INVALID_PDU                  0x04
-#define BT_ATT_ERR_AUTHENTICATION               0x05
-#define BT_ATT_ERR_NOT_SUPPORTED                0x06
-#define BT_ATT_ERR_INVALID_OFFSET               0x07
-#define BT_ATT_ERR_AUTHORIZATION                0x08
-#define BT_ATT_ERR_PREPARE_QUEUE_FULL           0x09
-#define BT_ATT_ERR_ATTRIBUTE_NOT_FOUND          0x0a
-#define BT_ATT_ERR_ATTRIBUTE_NOT_LONG           0x0b
-#define BT_ATT_ERR_ENCRYPTION_KEY_SIZE          0x0c
-#define BT_ATT_ERR_INVALID_ATTRIBUTE_LEN        0x0d
-#define BT_ATT_ERR_UNLIKELY                     0x0e
-#define BT_ATT_ERR_INSUFFICIENT_ENCRYPTION      0x0f
-#define BT_ATT_ERR_UNSUPPORTED_GROUP_TYPE       0x10
-#define BT_ATT_ERR_INSUFFICIENT_RESOURCES       0x11
-#define BT_ATT_ERR_DB_OUT_OF_SYNC               0x12
-#define BT_ATT_ERR_VALUE_NOT_ALLOWED            0x13
-
-/* Common Profile Error Codes (from CSS) */
-#define BT_ATT_ERR_WRITE_REQ_REJECTED           0xfc
-#define BT_ATT_ERR_CCC_IMPROPER_CONF            0xfd
-#define BT_ATT_ERR_PROCEDURE_IN_PROGRESS        0xfe
-#define BT_ATT_ERR_OUT_OF_RANGE                 0xff
-
-#endif /* ZEPHYR_INCLUDE_BLUETOOTH_ATT_H_ */

devices/ble_hci/common-hal/_bleio/hci_include/att_internal.h

@@ -1,272 +0,0 @@
-// CircuitPython: Adapted from Zephyr include file.
-
-/* att_internal.h - Attribute protocol handling */
-
-/*
- * Copyright (c) 2015-2016 Intel Corporation
- *
- * SPDX-License-Identifier: Apache-2.0
- */
-
-
-#include <stdbool.h>
-// for __packed
-#include <sys/cdefs.h>
-
-#define BT_EATT_PSM             0x27
-#define BT_ATT_DEFAULT_LE_MTU   23
-#define BT_ATT_TIMEOUT          K_SECONDS(30)
-
-// FIX #if BT_L2CAP_RX_MTU < CONFIG_BT_L2CAP_TX_MTU
-// #define BT_ATT_MTU BT_L2CAP_RX_MTU
-// #else
-// #define BT_ATT_MTU CONFIG_BT_L2CAP_TX_MTU
-// #endif
-
-struct bt_att_hdr {
-    uint8_t code;
-} __packed;
-
-#define BT_ATT_OP_ERROR_RSP                     0x01
-struct bt_att_error_rsp {
-    uint8_t request;
-    uint16_t handle;
-    uint8_t error;
-} __packed;
-
-#define BT_ATT_OP_MTU_REQ                       0x02
-struct bt_att_exchange_mtu_req {
-    uint16_t mtu;
-} __packed;
-
-#define BT_ATT_OP_MTU_RSP                       0x03
-struct bt_att_exchange_mtu_rsp {
-    uint16_t mtu;
-} __packed;
-
-/* Find Information Request */
-#define BT_ATT_OP_FIND_INFO_REQ                 0x04
-struct bt_att_find_info_req {
-    uint16_t start_handle;
-    uint16_t end_handle;
-} __packed;
-
-/* Format field values for BT_ATT_OP_FIND_INFO_RSP */
-#define BT_ATT_INFO_16                          0x01
-#define BT_ATT_INFO_128                         0x02
-
-struct bt_att_info_16 {
-    uint16_t handle;
-    uint16_t uuid;
-} __packed;
-
-struct bt_att_info_128 {
-    uint16_t handle;
-    uint8_t uuid[16];
-} __packed;
-
-/* Find Information Response */
-#define BT_ATT_OP_FIND_INFO_RSP                 0x05
-struct bt_att_find_info_rsp {
-    uint8_t format;
-    uint8_t info[];
-} __packed;
-
-/* Find By Type Value Request */
-#define BT_ATT_OP_FIND_TYPE_REQ                 0x06
-struct bt_att_find_type_req {
-    uint16_t start_handle;
-    uint16_t end_handle;
-    uint16_t type;
-    uint8_t value[];
-} __packed;
-
-struct bt_att_handle_group {
-    uint16_t start_handle;
-    uint16_t end_handle;
-} __packed;
-
-/* Find By Type Value Response */
-#define BT_ATT_OP_FIND_TYPE_RSP                 0x07
-struct bt_att_find_type_rsp {
-    uint8_t _dummy[0];
-    struct bt_att_handle_group list[];
-} __packed;
-
-/* Read By Type Request */
-#define BT_ATT_OP_READ_TYPE_REQ                 0x08
-struct bt_att_read_type_req {
-    uint16_t start_handle;
-    uint16_t end_handle;
-    uint8_t uuid[];
-} __packed;
-
-struct bt_att_data {
-    uint16_t handle;
-    uint8_t value[];
-} __packed;
-
-/* Read By Type Response */
-#define BT_ATT_OP_READ_TYPE_RSP                 0x09
-struct bt_att_read_type_rsp {
-    uint8_t len;
-    struct bt_att_data data[];
-} __packed;
-
-/* Read Request */
-#define BT_ATT_OP_READ_REQ                      0x0a
-struct bt_att_read_req {
-    uint16_t handle;
-} __packed;
-
-/* Read Response */
-#define BT_ATT_OP_READ_RSP                      0x0b
-struct bt_att_read_rsp {
-    uint8_t _dummy[0];
-    uint8_t value[];
-} __packed;
-
-/* Read Blob Request */
-#define BT_ATT_OP_READ_BLOB_REQ                 0x0c
-struct bt_att_read_blob_req {
-    uint16_t handle;
-    uint16_t offset;
-} __packed;
-
-/* Read Blob Response */
-#define BT_ATT_OP_READ_BLOB_RSP                 0x0d
-struct bt_att_read_blob_rsp {
-    uint8_t _dummy[0];
-    uint8_t value[];
-} __packed;
-
-/* Read Multiple Request */
-#define BT_ATT_READ_MULT_MIN_LEN_REQ            0x04
-
-#define BT_ATT_OP_READ_MULT_REQ                 0x0e
-struct bt_att_read_mult_req {
-    uint8_t _dummy[0];
-    uint16_t handles[];
-} __packed;
-
-/* Read Multiple Respose */
-#define BT_ATT_OP_READ_MULT_RSP                 0x0f
-struct bt_att_read_mult_rsp {
-    uint8_t _dummy[0];
-    uint8_t value[];
-} __packed;
-
-/* Read by Group Type Request */
-#define BT_ATT_OP_READ_GROUP_REQ                0x10
-struct bt_att_read_group_req {
-    uint16_t start_handle;
-    uint16_t end_handle;
-    uint8_t uuid[];
-} __packed;
-
-struct bt_att_group_data {
-    uint16_t start_handle;
-    uint16_t end_handle;
-    uint8_t value[];
-} __packed;
-
-/* Read by Group Type Response */
-#define BT_ATT_OP_READ_GROUP_RSP                0x11
-struct bt_att_read_group_rsp {
-    uint8_t len;
-    struct bt_att_group_data data[];
-} __packed;
-
-/* Write Request */
-#define BT_ATT_OP_WRITE_REQ                     0x12
-struct bt_att_write_req {
-    uint16_t handle;
-    uint8_t value[];
-} __packed;
-
-/* Write Response */
-#define BT_ATT_OP_WRITE_RSP                     0x13
-
-/* Prepare Write Request */
-#define BT_ATT_OP_PREPARE_WRITE_REQ             0x16
-struct bt_att_prepare_write_req {
-    uint16_t handle;
-    uint16_t offset;
-    uint8_t value[];
-} __packed;
-
-/* Prepare Write Respond */
-#define BT_ATT_OP_PREPARE_WRITE_RSP             0x17
-struct bt_att_prepare_write_rsp {
-    uint16_t handle;
-    uint16_t offset;
-    uint8_t value[];
-} __packed;
-
-/* Execute Write Request */
-#define BT_ATT_FLAG_CANCEL                      0x00
-#define BT_ATT_FLAG_EXEC                        0x01
-
-#define BT_ATT_OP_EXEC_WRITE_REQ                0x18
-struct bt_att_exec_write_req {
-    uint8_t flags;
-} __packed;
-
-/* Execute Write Response */
-#define BT_ATT_OP_EXEC_WRITE_RSP                0x19
-
-/* Handle Value Notification */
-#define BT_ATT_OP_NOTIFY                        0x1b
-struct bt_att_notify {
-    uint16_t handle;
-    uint8_t value[];
-} __packed;
-
-/* Handle Value Indication */
-#define BT_ATT_OP_INDICATE                      0x1d
-struct bt_att_indicate {
-    uint16_t handle;
-    uint8_t value[];
-} __packed;
-
-/* Handle Value Confirm */
-#define BT_ATT_OP_CONFIRM                       0x1e
-
-struct bt_att_signature {
-    uint8_t value[12];
-} __packed;
-
-#define BT_ATT_OP_READ_MULT_VL_REQ              0x20
-struct bt_att_read_mult_vl_req {
-    uint8_t _dummy[0];
-    uint16_t handles[];
-} __packed;
-
-/* Read Multiple Respose */
-#define BT_ATT_OP_READ_MULT_VL_RSP              0x21
-struct bt_att_read_mult_vl_rsp {
-    uint16_t len;
-    uint8_t value[];
-} __packed;
-
-/* Handle Multiple Value Notification */
-#define BT_ATT_OP_NOTIFY_MULT                   0x23
-struct bt_att_notify_mult {
-    uint16_t handle;
-    uint16_t len;
-    uint8_t value[];
-} __packed;
-
-/* Write Command */
-#define BT_ATT_OP_WRITE_CMD                     0x52
-struct bt_att_write_cmd {
-    uint16_t handle;
-    uint8_t value[];
-} __packed;
-
-/* Signed Write Command */
-#define BT_ATT_OP_SIGNED_WRITE_CMD              0xd2
-struct bt_att_signed_write_cmd {
-    uint16_t handle;
-    uint8_t value[];
-} __packed;

devices/ble_hci/common-hal/_bleio/hci_include/hci_err.h

@@ -1,92 +0,0 @@
-/** @file
- *  @brief Bluetooth Host Control Interface status codes.
- */
-
-/*
- * Copyright (c) 2019 Nordic Semiconductor ASA
- *
- * SPDX-License-Identifier: Apache-2.0
- */
-#ifndef ZEPHYR_INCLUDE_BLUETOOTH_HCI_STATUS_H_
-#define ZEPHYR_INCLUDE_BLUETOOTH_HCI_STATUS_H_
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-/** HCI Error Codes, BT Core Spec v5.2 [Vol 1, Part F]. */
-#define BT_HCI_ERR_SUCCESS                      0x00
-#define BT_HCI_ERR_UNKNOWN_CMD                  0x01
-#define BT_HCI_ERR_UNKNOWN_CONN_ID              0x02
-#define BT_HCI_ERR_HW_FAILURE                   0x03
-#define BT_HCI_ERR_PAGE_TIMEOUT                 0x04
-#define BT_HCI_ERR_AUTH_FAIL                    0x05
-#define BT_HCI_ERR_PIN_OR_KEY_MISSING           0x06
-#define BT_HCI_ERR_MEM_CAPACITY_EXCEEDED        0x07
-#define BT_HCI_ERR_CONN_TIMEOUT                 0x08
-#define BT_HCI_ERR_CONN_LIMIT_EXCEEDED          0x09
-#define BT_HCI_ERR_SYNC_CONN_LIMIT_EXCEEDED     0x0a
-#define BT_HCI_ERR_CONN_ALREADY_EXISTS          0x0b
-#define BT_HCI_ERR_CMD_DISALLOWED               0x0c
-#define BT_HCI_ERR_INSUFFICIENT_RESOURCES       0x0d
-#define BT_HCI_ERR_INSUFFICIENT_SECURITY        0x0e
-#define BT_HCI_ERR_BD_ADDR_UNACCEPTABLE         0x0f
-#define BT_HCI_ERR_CONN_ACCEPT_TIMEOUT          0x10
-#define BT_HCI_ERR_UNSUPP_FEATURE_PARAM_VAL     0x11
-#define BT_HCI_ERR_INVALID_PARAM                0x12
-#define BT_HCI_ERR_REMOTE_USER_TERM_CONN        0x13
-#define BT_HCI_ERR_REMOTE_LOW_RESOURCES         0x14
-#define BT_HCI_ERR_REMOTE_POWER_OFF             0x15
-#define BT_HCI_ERR_LOCALHOST_TERM_CONN          0x16
-#define BT_HCI_ERR_REPEATED_ATTEMPTS            0x17
-#define BT_HCI_ERR_PAIRING_NOT_ALLOWED          0x18
-#define BT_HCI_ERR_UNKNOWN_LMP_PDU              0x19
-#define BT_HCI_ERR_UNSUPP_REMOTE_FEATURE        0x1a
-#define BT_HCI_ERR_SCO_OFFSET_REJECTED          0x1b
-#define BT_HCI_ERR_SCO_INTERVAL_REJECTED        0x1c
-#define BT_HCI_ERR_SCO_AIR_MODE_REJECTED        0x1d
-#define BT_HCI_ERR_INVALID_LL_PARAM             0x1e
-#define BT_HCI_ERR_UNSPECIFIED                  0x1f
-#define BT_HCI_ERR_UNSUPP_LL_PARAM_VAL          0x20
-#define BT_HCI_ERR_ROLE_CHANGE_NOT_ALLOWED      0x21
-#define BT_HCI_ERR_LL_RESP_TIMEOUT              0x22
-#define BT_HCI_ERR_LL_PROC_COLLISION            0x23
-#define BT_HCI_ERR_LMP_PDU_NOT_ALLOWED          0x24
-#define BT_HCI_ERR_ENC_MODE_NOT_ACCEPTABLE      0x25
-#define BT_HCI_ERR_LINK_KEY_CANNOT_BE_CHANGED   0x26
-#define BT_HCI_ERR_REQUESTED_QOS_NOT_SUPPORTED  0x27
-#define BT_HCI_ERR_INSTANT_PASSED               0x28
-#define BT_HCI_ERR_PAIRING_NOT_SUPPORTED        0x29
-#define BT_HCI_ERR_DIFF_TRANS_COLLISION         0x2a
-#define BT_HCI_ERR_QOS_UNACCEPTABLE_PARAM       0x2c
-#define BT_HCI_ERR_QOS_REJECTED                 0x2d
-#define BT_HCI_ERR_CHAN_ASSESS_NOT_SUPPORTED    0x2e
-#define BT_HCI_ERR_INSUFF_SECURITY              0x2f
-#define BT_HCI_ERR_PARAM_OUT_OF_MANDATORY_RANGE 0x30
-#define BT_HCI_ERR_ROLE_SWITCH_PENDING          0x32
-#define BT_HCI_ERR_RESERVED_SLOT_VIOLATION      0x34
-#define BT_HCI_ERR_ROLE_SWITCH_FAILED           0x35
-#define BT_HCI_ERR_EXT_INQ_RESP_TOO_LARGE       0x36
-#define BT_HCI_ERR_SIMPLE_PAIR_NOT_SUPP_BY_HOST 0x37
-#define BT_HCI_ERR_HOST_BUSY_PAIRING            0x38
-#define BT_HCI_ERR_CONN_REJECTED_DUE_TO_NO_CHAN 0x39
-#define BT_HCI_ERR_CONTROLLER_BUSY              0x3a
-#define BT_HCI_ERR_UNACCEPT_CONN_PARAM          0x3b
-#define BT_HCI_ERR_ADV_TIMEOUT                  0x3c
-#define BT_HCI_ERR_TERM_DUE_TO_MIC_FAIL         0x3d
-#define BT_HCI_ERR_CONN_FAIL_TO_ESTAB           0x3e
-#define BT_HCI_ERR_MAC_CONN_FAILED              0x3f
-#define BT_HCI_ERR_CLOCK_ADJUST_REJECTED        0x40
-#define BT_HCI_ERR_SUBMAP_NOT_DEFINED           0x41
-#define BT_HCI_ERR_UNKNOWN_ADV_IDENTIFIER       0x42
-#define BT_HCI_ERR_LIMIT_REACHED                0x43
-#define BT_HCI_ERR_OP_CANCELLED_BY_HOST         0x44
-#define BT_HCI_ERR_PACKET_TOO_LONG              0x45
-
-#define BT_HCI_ERR_AUTHENTICATION_FAIL __DEPRECATED_MACRO BT_HCI_ERR_AUTH_FAIL
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif /* ZEPHYR_INCLUDE_BLUETOOTH_HCI_STATUS_H_ */

devices/ble_hci/common-hal/_bleio/hci_include/hci_raw.h

@@ -1,152 +0,0 @@
-/** @file
- *  @brief Bluetooth HCI RAW channel handling
- */
-
-/*
- * Copyright (c) 2016 Intel Corporation
- *
- * SPDX-License-Identifier: Apache-2.0
- */
-#ifndef ZEPHYR_INCLUDE_BLUETOOTH_HCI_RAW_H_
-#define ZEPHYR_INCLUDE_BLUETOOTH_HCI_RAW_H_
-
-/**
- * @brief HCI RAW channel
- * @defgroup hci_raw HCI RAW channel
- * @ingroup bluetooth
- * @{
- */
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-#if defined(CONFIG_BT_CTLR_TX_BUFFER_SIZE)
-#define BT_L2CAP_MTU (CONFIG_BT_CTLR_TX_BUFFER_SIZE - BT_L2CAP_HDR_SIZE)
-#else
-#define BT_L2CAP_MTU 65 /* 64-byte public key + opcode */
-#endif /* CONFIG_BT_CTLR */
-
-/** Data size needed for ACL buffers */
-#define BT_BUF_ACL_SIZE BT_L2CAP_BUF_SIZE(BT_L2CAP_MTU)
-
-#if defined(CONFIG_BT_CTLR_TX_BUFFERS)
-#define BT_HCI_ACL_COUNT CONFIG_BT_CTLR_TX_BUFFERS
-#else
-#define BT_HCI_ACL_COUNT 6
-#endif
-
-#define BT_BUF_TX_SIZE MAX(BT_BUF_RX_SIZE, BT_BUF_ACL_SIZE)
-
-/** @brief Send packet to the Bluetooth controller
- *
- * Send packet to the Bluetooth controller. Caller needs to
- * implement netbuf pool.
- *
- * @param buf netbuf packet to be send
- *
- * @return Zero on success or (negative) error code otherwise.
- */
-int bt_send(struct net_buf *buf);
-
-enum {
-    /** Passthrough mode
-     *
-     *  While in this mode the buffers are passed as is between the stack
-     *  and the driver.
-     */
-    BT_HCI_RAW_MODE_PASSTHROUGH = 0x00,
-
-    /** H:4 mode
-     *
-     *  While in this mode H:4 headers will added into the buffers
-     *  according to the buffer type when coming from the stack and will be
-     *  removed and used to set the buffer type.
-     */
-    BT_HCI_RAW_MODE_H4 = 0x01,
-};
-
-/** @brief Set Bluetooth RAW channel mode
- *
- *  Set access mode of Bluetooth RAW channel.
- *
- *  @param mode Access mode.
- *
- *  @return Zero on success or (negative) error code otherwise.
- */
-int bt_hci_raw_set_mode(uint8_t mode);
-
-/** @brief Get Bluetooth RAW channel mode
- *
- *  Get access mode of Bluetooth RAW channel.
- *
- *  @return Access mode.
- */
-uint8_t bt_hci_raw_get_mode(void);
-
-#define BT_HCI_ERR_EXT_HANDLED  0xff
-
-/** Helper macro to define a command extension
- *
- *  @param _op Opcode of the command.
- *  @param _min_len Minimal length of the command.
- *  @param _func Handler function to be called.
- */
-#define BT_HCI_RAW_CMD_EXT(_op, _min_len, _func) \
-    { \
-        .op = _op, \
-        .min_len = _min_len, \
-        .func = _func, \
-    }
-
-struct bt_hci_raw_cmd_ext {
-    /** Opcode of the command */
-    uint16_t op;
-
-    /** Minimal length of the command */
-    size_t min_len;
-
-    /** Handler function.
-     *
-     *  Handler function to be called when a command is intercepted.
-     *
-     *  @param buf Buffer containing the command.
-     *
-     *  @return HCI Status code or BT_HCI_ERR_EXT_HANDLED if command has
-     *  been handled already and a response has been sent as oppose to
-     *  BT_HCI_ERR_SUCCESS which just indicates that the command can be
-     *  sent to the controller to be processed.
-     */
-    uint8_t (*func)(struct net_buf *buf);
-};
-
-/** @brief Register Bluetooth RAW command extension table
- *
- *  Register Bluetooth RAW channel command extension table, opcodes in this
- *  table are intercepted to sent to the handler function.
- *
- *  @param cmds Pointer to the command extension table.
- *  @param size Size of the command extension table.
- */
-void bt_hci_raw_cmd_ext_register(struct bt_hci_raw_cmd_ext *cmds, size_t size);
-
-/** @brief Enable Bluetooth RAW channel:
- *
- *  Enable Bluetooth RAW HCI channel.
- *
- *  @param rx_queue netbuf queue where HCI packets received from the Bluetooth
- *  controller are to be queued. The queue is defined in the caller while
- *  the available buffers pools are handled in the stack.
- *
- *  @return Zero on success or (negative) error code otherwise.
- */
-int bt_enable_raw(struct k_fifo *rx_queue);
-
-#ifdef __cplusplus
-}
-#endif
-/**
- * @}
- */
-
-#endif /* ZEPHYR_INCLUDE_BLUETOOTH_HCI_RAW_H_ */

devices/ble_hci/common-hal/_bleio/hci_include/hci_vs.h

@@ -1,379 +0,0 @@
-/* hci_vs.h - Bluetooth Host Control Interface Vendor Specific definitions */
-
-/*
- * Copyright (c) 2017-2018 Nordic Semiconductor ASA
- * Copyright (c) 2015-2016 Intel Corporation
- *
- * SPDX-License-Identifier: Apache-2.0
- */
-#ifndef ZEPHYR_INCLUDE_BLUETOOTH_HCI_VS_H_
-#define ZEPHYR_INCLUDE_BLUETOOTH_HCI_VS_H_
-
-#include <bluetooth/hci.h>
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-#define BT_VS_CMD_BIT_VERSION                       0
-#define BT_VS_CMD_BIT_SUP_CMD                       1
-#define BT_VS_CMD_BIT_SUP_FEAT                      2
-#define BT_VS_CMD_BIT_SET_EVT_MASK                  3
-#define BT_VS_CMD_BIT_RESET                         4
-#define BT_VS_CMD_BIT_WRITE_BDADDR                  5
-#define BT_VS_CMD_BIT_SET_TRACE_ENABLE              6
-#define BT_VS_CMD_BIT_READ_BUILD_INFO               7
-#define BT_VS_CMD_BIT_READ_STATIC_ADDRS             8
-#define BT_VS_CMD_BIT_READ_KEY_ROOTS                9
-#define BT_VS_CMD_BIT_READ_CHIP_TEMP               10
-#define BT_VS_CMD_BIT_READ_HOST_STACK_CMD          11
-#define BT_VS_CMD_BIT_SET_SCAN_REP_ENABLE          12
-#define BT_VS_CMD_BIT_WRITE_TX_POWER               13
-#define BT_VS_CMD_BIT_READ_TX_POWER                14
-
-#define BT_VS_CMD_SUP_FEAT(cmd)                 BT_LE_FEAT_TEST(cmd, \
-    BT_VS_CMD_BIT_SUP_FEAT)
-#define BT_VS_CMD_READ_STATIC_ADDRS(cmd)        BT_LE_FEAT_TEST(cmd, \
-    BT_VS_CMD_BIT_READ_STATIC_ADDRS)
-#define BT_VS_CMD_READ_KEY_ROOTS(cmd)           BT_LE_FEAT_TEST(cmd, \
-    BT_VS_CMD_BIT_READ_KEY_ROOTS)
-
-#define BT_HCI_VS_HW_PLAT_INTEL                 0x0001
-#define BT_HCI_VS_HW_PLAT_NORDIC                0x0002
-#define BT_HCI_VS_HW_PLAT_NXP                   0x0003
-
-#define BT_HCI_VS_HW_VAR_NORDIC_NRF51X          0x0001
-#define BT_HCI_VS_HW_VAR_NORDIC_NRF52X          0x0002
-#define BT_HCI_VS_HW_VAR_NORDIC_NRF53X          0x0003
-
-#define BT_HCI_VS_FW_VAR_STANDARD_CTLR          0x0001
-#define BT_HCI_VS_FW_VAR_VS_CTLR                0x0002
-#define BT_HCI_VS_FW_VAR_FW_LOADER              0x0003
-#define BT_HCI_VS_FW_VAR_RESCUE_IMG             0x0004
-#define BT_HCI_OP_VS_READ_VERSION_INFO          BT_OP(BT_OGF_VS, 0x0001)
-struct bt_hci_rp_vs_read_version_info {
-    uint8_t status;
-    uint16_t hw_platform;
-    uint16_t hw_variant;
-    uint8_t fw_variant;
-    uint8_t fw_version;
-    uint16_t fw_revision;
-    uint32_t fw_build;
-} __packed;
-
-#define BT_HCI_OP_VS_READ_SUPPORTED_COMMANDS    BT_OP(BT_OGF_VS, 0x0002)
-struct bt_hci_rp_vs_read_supported_commands {
-    uint8_t status;
-    uint8_t commands[64];
-} __packed;
-
-#define BT_HCI_OP_VS_READ_SUPPORTED_FEATURES    BT_OP(BT_OGF_VS, 0x0003)
-struct bt_hci_rp_vs_read_supported_features {
-    uint8_t status;
-    uint8_t features[8];
-} __packed;
-
-#define BT_HCI_OP_VS_SET_EVENT_MASK             BT_OP(BT_OGF_VS, 0x0004)
-struct bt_hci_cp_vs_set_event_mask {
-    uint8_t event_mask[8];
-} __packed;
-
-#define BT_HCI_VS_RESET_SOFT                    0x00
-#define BT_HCI_VS_RESET_HARD                    0x01
-#define BT_HCI_OP_VS_RESET                      BT_OP(BT_OGF_VS, 0x0005)
-struct bt_hci_cp_vs_reset {
-    uint8_t type;
-} __packed;
-
-#define BT_HCI_OP_VS_WRITE_BD_ADDR              BT_OP(BT_OGF_VS, 0x0006)
-struct bt_hci_cp_vs_write_bd_addr {
-    bt_addr_t bdaddr;
-} __packed;
-
-#define BT_HCI_VS_TRACE_DISABLED                0x00
-#define BT_HCI_VS_TRACE_ENABLED                 0x01
-
-#define BT_HCI_VS_TRACE_HCI_EVTS                0x00
-#define BT_HCI_VS_TRACE_VDC                     0x01
-#define BT_HCI_OP_VS_SET_TRACE_ENABLE           BT_OP(BT_OGF_VS, 0x0007)
-struct bt_hci_cp_vs_set_trace_enable {
-    uint8_t enable;
-    uint8_t type;
-} __packed;
-
-#define BT_HCI_OP_VS_READ_BUILD_INFO            BT_OP(BT_OGF_VS, 0x0008)
-struct bt_hci_rp_vs_read_build_info {
-    uint8_t status;
-    uint8_t info[];
-} __packed;
-
-struct bt_hci_vs_static_addr {
-    bt_addr_t bdaddr;
-    uint8_t ir[16];
-} __packed;
-
-#define BT_HCI_OP_VS_READ_STATIC_ADDRS          BT_OP(BT_OGF_VS, 0x0009)
-struct bt_hci_rp_vs_read_static_addrs {
-    uint8_t status;
-    uint8_t num_addrs;
-    struct bt_hci_vs_static_addr a[];
-} __packed;
-
-#define BT_HCI_OP_VS_READ_KEY_HIERARCHY_ROOTS   BT_OP(BT_OGF_VS, 0x000a)
-struct bt_hci_rp_vs_read_key_hierarchy_roots {
-    uint8_t status;
-    uint8_t ir[16];
-    uint8_t er[16];
-} __packed;
-
-#define BT_HCI_OP_VS_READ_CHIP_TEMP             BT_OP(BT_OGF_VS, 0x000b)
-struct bt_hci_rp_vs_read_chip_temp {
-    uint8_t status;
-    int8_t temps;
-} __packed;
-
-struct bt_hci_vs_cmd {
-    uint16_t vendor_id;
-    uint16_t opcode_base;
-} __packed;
-
-#define BT_HCI_VS_VID_ANDROID                   0x0001
-#define BT_HCI_VS_VID_MICROSOFT                 0x0002
-#define BT_HCI_OP_VS_READ_HOST_STACK_CMDS       BT_OP(BT_OGF_VS, 0x000c)
-struct bt_hci_rp_vs_read_host_stack_cmds {
-    uint8_t status;
-    uint8_t num_cmds;
-    struct bt_hci_vs_cmd c[];
-} __packed;
-
-#define BT_HCI_VS_SCAN_REQ_REPORTS_DISABLED     0x00
-#define BT_HCI_VS_SCAN_REQ_REPORTS_ENABLED      0x01
-#define BT_HCI_OP_VS_SET_SCAN_REQ_REPORTS       BT_OP(BT_OGF_VS, 0x000d)
-struct bt_hci_cp_vs_set_scan_req_reports {
-    uint8_t enable;
-} __packed;
-
-#define BT_HCI_VS_LL_HANDLE_TYPE_ADV       0x00
-#define BT_HCI_VS_LL_HANDLE_TYPE_SCAN      0x01
-#define BT_HCI_VS_LL_HANDLE_TYPE_CONN      0x02
-#define BT_HCI_VS_LL_TX_POWER_LEVEL_NO_PREF     0x7F
-#define BT_HCI_OP_VS_WRITE_TX_POWER_LEVEL       BT_OP(BT_OGF_VS, 0x000e)
-struct bt_hci_cp_vs_write_tx_power_level {
-    uint8_t handle_type;
-    uint16_t handle;
-    int8_t tx_power_level;
-} __packed;
-
-struct bt_hci_rp_vs_write_tx_power_level {
-    uint8_t status;
-    uint8_t handle_type;
-    uint16_t handle;
-    int8_t selected_tx_power;
-} __packed;
-
-#define BT_HCI_OP_VS_READ_TX_POWER_LEVEL        BT_OP(BT_OGF_VS, 0x000f)
-struct bt_hci_cp_vs_read_tx_power_level {
-    uint8_t handle_type;
-    uint16_t handle;
-} __packed;
-
-struct bt_hci_rp_vs_read_tx_power_level {
-    uint8_t status;
-    uint8_t handle_type;
-    uint16_t handle;
-    int8_t tx_power_level;
-} __packed;
-
-#define BT_HCI_OP_VS_READ_USB_TRANSPORT_MODE    BT_OP(BT_OGF_VS, 0x0010)
-
-struct bt_hci_rp_vs_read_usb_transport_mode {
-    uint8_t status;
-    uint8_t num_supported_modes;
-    uint8_t supported_mode[];
-} __packed;
-
-#define BT_HCI_VS_USB_H2_MODE                  0x00
-#define BT_HCI_VS_USB_H4_MODE                  0x01
-
-#define BT_HCI_OP_VS_SET_USB_TRANSPORT_MODE    BT_OP(BT_OGF_VS, 0x0011)
-
-struct bt_hci_cp_vs_set_usb_transport_mode {
-    uint8_t mode;
-} __packed;
-
-/* Events */
-
-struct bt_hci_evt_vs {
-    uint8_t subevent;
-} __packed;
-
-#define BT_HCI_EVT_VS_FATAL_ERROR              0x02
-struct bt_hci_evt_vs_fatal_error {
-    uint64_t pc;
-    uint8_t err_info[];
-} __packed;
-
-#define BT_HCI_VS_TRACE_LMP_TX                 0x01
-#define BT_HCI_VS_TRACE_LMP_RX                 0x02
-#define BT_HCI_VS_TRACE_LLCP_TX                0x03
-#define BT_HCI_VS_TRACE_LLCP_RX                0x04
-#define BT_HCI_VS_TRACE_LE_CONN_IND            0x05
-#define BT_HCI_EVT_VS_TRACE_INFO               0x03
-struct bt_hci_evt_vs_trace_info {
-    uint8_t type;
-    uint8_t data[];
-} __packed;
-
-#define BT_HCI_EVT_VS_SCAN_REQ_RX              0x04
-struct bt_hci_evt_vs_scan_req_rx {
-    bt_addr_le_t addr;
-    int8_t rssi;
-} __packed;
-
-/* Event mask bits */
-
-#define BT_EVT_MASK_VS_FATAL_ERROR             BT_EVT_BIT(1)
-#define BT_EVT_MASK_VS_TRACE_INFO              BT_EVT_BIT(2)
-#define BT_EVT_MASK_VS_SCAN_REQ_RX             BT_EVT_BIT(3)
-
-/* Mesh HCI commands */
-#define BT_HCI_MESH_REVISION                   0x01
-
-#define BT_HCI_OP_VS_MESH                      BT_OP(BT_OGF_VS, 0x0042)
-#define BT_HCI_MESH_EVT_PREFIX                 0xF0
-
-struct bt_hci_cp_mesh {
-    uint8_t opcode;
-} __packed;
-
-#define BT_HCI_OC_MESH_GET_OPTS                0x00
-struct bt_hci_rp_mesh_get_opts {
-    uint8_t status;
-    uint8_t opcode;
-    uint8_t revision;
-    uint8_t ch_map;
-    int8_t min_tx_power;
-    int8_t max_tx_power;
-    uint8_t max_scan_filter;
-    uint8_t max_filter_pattern;
-    uint8_t max_adv_slot;
-    uint8_t max_tx_window;
-    uint8_t evt_prefix_len;
-    uint8_t evt_prefix;
-} __packed;
-
-#define BT_HCI_MESH_PATTERN_LEN_MAX            0x0f
-
-#define BT_HCI_OC_MESH_SET_SCAN_FILTER         0x01
-struct bt_hci_mesh_pattern {
-    uint8_t pattern_len;
-    uint8_t pattern[];
-} __packed;
-
-struct bt_hci_cp_mesh_set_scan_filter {
-    uint8_t scan_filter;
-    uint8_t filter_dup;
-    uint8_t num_patterns;
-    struct    bt_hci_mesh_pattern patterns[];
-} __packed;
-struct bt_hci_rp_mesh_set_scan_filter {
-    uint8_t status;
-    uint8_t opcode;
-    uint8_t scan_filter;
-} __packed;
-
-#define BT_HCI_OC_MESH_ADVERTISE               0x02
-struct bt_hci_cp_mesh_advertise {
-    uint8_t adv_slot;
-    uint8_t own_addr_type;
-    bt_addr_t random_addr;
-    uint8_t ch_map;
-    int8_t tx_power;
-    uint8_t min_tx_delay;
-    uint8_t max_tx_delay;
-    uint8_t retx_count;
-    uint8_t retx_interval;
-    uint8_t scan_delay;
-    uint16_t scan_duration;
-    uint8_t scan_filter;
-    uint8_t data_len;
-    uint8_t data[31];
-} __packed;
-struct bt_hci_rp_mesh_advertise {
-    uint8_t status;
-    uint8_t opcode;
-    uint8_t adv_slot;
-} __packed;
-
-#define BT_HCI_OC_MESH_ADVERTISE_TIMED         0x03
-struct bt_hci_cp_mesh_advertise_timed {
-    uint8_t adv_slot;
-    uint8_t own_addr_type;
-    bt_addr_t random_addr;
-    uint8_t ch_map;
-    int8_t tx_power;
-    uint8_t retx_count;
-    uint8_t retx_interval;
-    uint32_t instant;
-    uint16_t tx_delay;
-    uint16_t tx_window;
-    uint8_t data_len;
-    uint8_t data[31];
-} __packed;
-struct bt_hci_rp_mesh_advertise_timed {
-    uint8_t status;
-    uint8_t opcode;
-    uint8_t adv_slot;
-} __packed;
-
-#define BT_HCI_OC_MESH_ADVERTISE_CANCEL        0x04
-struct bt_hci_cp_mesh_advertise_cancel {
-    uint8_t adv_slot;
-} __packed;
-struct bt_hci_rp_mesh_advertise_cancel {
-    uint8_t status;
-    uint8_t opcode;
-    uint8_t adv_slot;
-} __packed;
-
-#define BT_HCI_OC_MESH_SET_SCANNING            0x05
-struct bt_hci_cp_mesh_set_scanning {
-    uint8_t enable;
-    uint8_t ch_map;
-    uint8_t scan_filter;
-} __packed;
-struct bt_hci_rp_mesh_set_scanning {
-    uint8_t status;
-    uint8_t opcode;
-} __packed;
-
-/* Events */
-struct bt_hci_evt_mesh {
-    uint8_t prefix;
-    uint8_t subevent;
-} __packed;
-
-#define BT_HCI_EVT_MESH_ADV_COMPLETE           0x00
-struct bt_hci_evt_mesh_adv_complete {
-    uint8_t adv_slot;
-} __packed;
-
-#define BT_HCI_EVT_MESH_SCANNING_REPORT        0x01
-struct bt_hci_evt_mesh_scan_report {
-    bt_addr_le_t addr;
-    uint8_t chan;
-    int8_t rssi;
-    uint32_t instant;
-    uint8_t data_len;
-    uint8_t data[];
-} __packed;
-struct bt_hci_evt_mesh_scanning_report {
-    uint8_t num_reports;
-    struct bt_hci_evt_mesh_scan_report reports[];
-} __packed;
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif /* ZEPHYR_INCLUDE_BLUETOOTH_HCI_VS_H_ */

devices/ble_hci/common-hal/_bleio/hci_include/l2cap_internal.h

@@ -1,230 +0,0 @@
-// CircuitPython: Adapted from Zephyr include file.
-
-/** @file
- *  @brief Internal APIs for Bluetooth L2CAP handling.
- */
-
-/*
- * Copyright (c) 2015-2016 Intel Corporation
- *
- * SPDX-License-Identifier: Apache-2.0
- */
-
-#include <stdbool.h>
-// for __packed
-#include <string.h>
-
-enum l2cap_conn_list_action {
-    BT_L2CAP_CHAN_LOOKUP,
-    BT_L2CAP_CHAN_DETACH,
-};
-
-#define BT_L2CAP_CID_BR_SIG             0x0001
-#define BT_L2CAP_CID_ATT                0x0004
-#define BT_L2CAP_CID_LE_SIG             0x0005
-#define BT_L2CAP_CID_SMP                0x0006
-#define BT_L2CAP_CID_BR_SMP             0x0007
-
-#define BT_L2CAP_PSM_RFCOMM             0x0003
-
-struct bt_l2cap_hdr {
-    uint16_t len;
-    uint16_t cid;
-} __packed;
-
-struct bt_l2cap_sig_hdr {
-    uint8_t code;
-    uint8_t ident;
-    uint16_t len;
-} __packed;
-
-#define BT_L2CAP_REJ_NOT_UNDERSTOOD     0x0000
-#define BT_L2CAP_REJ_MTU_EXCEEDED       0x0001
-#define BT_L2CAP_REJ_INVALID_CID        0x0002
-
-#define BT_L2CAP_CMD_REJECT             0x01
-struct bt_l2cap_cmd_reject {
-    uint16_t reason;
-    uint8_t data[];
-} __packed;
-
-struct bt_l2cap_cmd_reject_cid_data {
-    uint16_t scid;
-    uint16_t dcid;
-} __packed;
-
-#define BT_L2CAP_CONN_REQ               0x02
-struct bt_l2cap_conn_req {
-    uint16_t psm;
-    uint16_t scid;
-} __packed;
-
-/* command statuses in reposnse */
-#define BT_L2CAP_CS_NO_INFO             0x0000
-#define BT_L2CAP_CS_AUTHEN_PEND         0x0001
-
-/* valid results in conn response on BR/EDR */
-#define BT_L2CAP_BR_SUCCESS             0x0000
-#define BT_L2CAP_BR_PENDING             0x0001
-#define BT_L2CAP_BR_ERR_PSM_NOT_SUPP    0x0002
-#define BT_L2CAP_BR_ERR_SEC_BLOCK       0x0003
-#define BT_L2CAP_BR_ERR_NO_RESOURCES    0x0004
-#define BT_L2CAP_BR_ERR_INVALID_SCID    0x0006
-#define BT_L2CAP_BR_ERR_SCID_IN_USE     0x0007
-
-#define BT_L2CAP_CONN_RSP               0x03
-struct bt_l2cap_conn_rsp {
-    uint16_t dcid;
-    uint16_t scid;
-    uint16_t result;
-    uint16_t status;
-} __packed;
-
-#define BT_L2CAP_CONF_SUCCESS           0x0000
-#define BT_L2CAP_CONF_UNACCEPT          0x0001
-#define BT_L2CAP_CONF_REJECT            0x0002
-
-#define BT_L2CAP_CONF_REQ               0x04
-struct bt_l2cap_conf_req {
-    uint16_t dcid;
-    uint16_t flags;
-    uint8_t data[];
-} __packed;
-
-#define BT_L2CAP_CONF_RSP               0x05
-struct bt_l2cap_conf_rsp {
-    uint16_t scid;
-    uint16_t flags;
-    uint16_t result;
-    uint8_t data[];
-} __packed;
-
-/* Option type used by MTU config request data */
-#define BT_L2CAP_CONF_OPT_MTU           0x01
-/* Options bits selecting most significant bit (hint) in type field */
-#define BT_L2CAP_CONF_HINT              0x80
-#define BT_L2CAP_CONF_MASK              0x7f
-
-struct bt_l2cap_conf_opt {
-    uint8_t type;
-    uint8_t len;
-    uint8_t data[];
-} __packed;
-
-#define BT_L2CAP_DISCONN_REQ            0x06
-struct bt_l2cap_disconn_req {
-    uint16_t dcid;
-    uint16_t scid;
-} __packed;
-
-#define BT_L2CAP_DISCONN_RSP            0x07
-struct bt_l2cap_disconn_rsp {
-    uint16_t dcid;
-    uint16_t scid;
-} __packed;
-
-#define BT_L2CAP_INFO_FEAT_MASK         0x0002
-#define BT_L2CAP_INFO_FIXED_CHAN        0x0003
-
-#define BT_L2CAP_INFO_REQ               0x0a
-struct bt_l2cap_info_req {
-    uint16_t type;
-} __packed;
-
-/* info result */
-#define BT_L2CAP_INFO_SUCCESS           0x0000
-#define BT_L2CAP_INFO_NOTSUPP           0x0001
-
-#define BT_L2CAP_INFO_RSP               0x0b
-struct bt_l2cap_info_rsp {
-    uint16_t type;
-    uint16_t result;
-    uint8_t data[];
-} __packed;
-
-#define BT_L2CAP_CONN_PARAM_REQ         0x12
-struct bt_l2cap_conn_param_req {
-    uint16_t min_interval;
-    uint16_t max_interval;
-    uint16_t latency;
-    uint16_t timeout;
-} __packed;
-
-#define BT_L2CAP_CONN_PARAM_ACCEPTED    0x0000
-#define BT_L2CAP_CONN_PARAM_REJECTED    0x0001
-
-#define BT_L2CAP_CONN_PARAM_RSP         0x13
-struct bt_l2cap_conn_param_rsp {
-    uint16_t result;
-} __packed;
-
-#define BT_L2CAP_LE_CONN_REQ            0x14
-struct bt_l2cap_le_conn_req {
-    uint16_t psm;
-    uint16_t scid;
-    uint16_t mtu;
-    uint16_t mps;
-    uint16_t credits;
-} __packed;
-
-/* valid results in conn response on LE */
-#define BT_L2CAP_LE_SUCCESS             0x0000
-#define BT_L2CAP_LE_ERR_PSM_NOT_SUPP    0x0002
-#define BT_L2CAP_LE_ERR_NO_RESOURCES    0x0004
-#define BT_L2CAP_LE_ERR_AUTHENTICATION  0x0005
-#define BT_L2CAP_LE_ERR_AUTHORIZATION   0x0006
-#define BT_L2CAP_LE_ERR_KEY_SIZE        0x0007
-#define BT_L2CAP_LE_ERR_ENCRYPTION      0x0008
-#define BT_L2CAP_LE_ERR_INVALID_SCID    0x0009
-#define BT_L2CAP_LE_ERR_SCID_IN_USE     0x000A
-#define BT_L2CAP_LE_ERR_UNACCEPT_PARAMS 0x000B
-#define BT_L2CAP_LE_ERR_INVALID_PARAMS  0x000C
-
-#define BT_L2CAP_LE_CONN_RSP            0x15
-struct bt_l2cap_le_conn_rsp {
-    uint16_t dcid;
-    uint16_t mtu;
-    uint16_t mps;
-    uint16_t credits;
-    uint16_t result;
-} __packed;
-
-#define BT_L2CAP_LE_CREDITS             0x16
-struct bt_l2cap_le_credits {
-    uint16_t cid;
-    uint16_t credits;
-} __packed;
-
-#define BT_L2CAP_ECRED_CONN_REQ         0x17
-struct bt_l2cap_ecred_conn_req {
-    uint16_t psm;
-    uint16_t mtu;
-    uint16_t mps;
-    uint16_t credits;
-    uint16_t scid[];
-} __packed;
-
-#define BT_L2CAP_ECRED_CONN_RSP         0x18
-struct bt_l2cap_ecred_conn_rsp {
-    uint16_t mtu;
-    uint16_t mps;
-    uint16_t credits;
-    uint16_t result;
-    uint16_t dcid[];
-} __packed;
-
-#define BT_L2CAP_ECRED_RECONF_REQ       0x19
-struct bt_l2cap_ecred_reconf_req {
-    uint16_t mtu;
-    uint16_t mps;
-    uint16_t scid[];
-} __packed;
-
-#define BT_L2CAP_RECONF_SUCCESS         0x0000
-#define BT_L2CAP_RECONF_INVALID_MTU     0x0001
-#define BT_L2CAP_RECONF_INVALID_MPS     0x0002
-
-#define BT_L2CAP_ECRED_RECONF_RSP       0x1a
-struct bt_l2cap_ecred_reconf_rsp {
-    uint16_t result;
-} __packed;

devices/ble_hci/supervisor/bluetooth.c

@@ -1,29 +0,0 @@
-/*
- * This file is part of the MicroPython project, http://micropython.org/
- *
- * The MIT License (MIT)
- *
- * Copyright (c) 2019 Scott Shawcroft for Adafruit Industries
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-#if CIRCUITPY_BLE_FILE_SERVICE
-#error CIRCUITPY_BLE_FILE_SERVICE not implemented for CIRCUITPY_BLEIO_HCI
-#endif

devices/ble_hci/supervisor/bluetooth.h

@@ -1,34 +0,0 @@
-/*
- * This file is part of the MicroPython project, http://micropython.org/
- *
- * The MIT License (MIT)
- *
- * Copyright (c) 2019 Scott Shawcroft for Adafruit Industries
- *
- * Permission is hereby granted, free of charge, to any person obtaining a copy
- * of this software and associated documentation files (the "Software"), to deal
- * in the Software without restriction, including without limitation the rights
- * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
- * copies of the Software, and to permit persons to whom the Software is
- * furnished to do so, subject to the following conditions:
- *
- * The above copyright notice and this permission notice shall be included in
- * all copies or substantial portions of the Software.
- *
- * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
- * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
- * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
- * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
- * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
- * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
- * THE SOFTWARE.
- */
-
-#ifndef MICROPY_INCLUDED_DEVICE_BLE_HCI_SUPERVISOR_BLUETOOTH_H
-#define MICROPY_INCLUDED_DEVICE_BLE_HCI_SUPERVISOR_BLUETOOTH_H
-
-void supervisor_start_bluetooth(void);
-bool supervisor_bluetooth_hook(ble_evt_t *ble_evt);
-void supervisor_bluetooth_background(void);
-
-#endif // MICROPY_INCLUDED_DEVICE_BLE_HCI_SUPERVISOR_BLUETOOTH_H

docs/Makefile

@@ -0,0 +1,191 @@
+# Makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+PYTHON        = python3
+SPHINXOPTS    =
+SPHINXBUILD   = sphinx-build
+PAPER         =
+BUILDDIR      = build/$(MICROPY_PORT)
+CPYDIFFDIR    = ../tools
+CPYDIFF       = gen-cpydiff.py
+GENRSTDIR     = genrst
+# Run "make FORCE= ..." to avoid rebuilding from scratch (and risk
+# producing incorrect docs).
+FORCE         = -E
+
+# User-friendly check for sphinx-build
+ifeq ($(shell which $(SPHINXBUILD) >/dev/null 2>&1; echo $$?), 1)
+$(error The '$(SPHINXBUILD)' command was not found. Make sure you have Sphinx installed, then set the SPHINXBUILD environment variable to point to the full path of the '$(SPHINXBUILD)' executable. Alternatively you can add the directory with the executable to your PATH. If you don't have Sphinx installed, grab it from http://sphinx-doc.org/)
+endif
+
+# Internal variables.
+PAPEROPT_a4     = -D latex_paper_size=a4
+PAPEROPT_letter = -D latex_paper_size=letter
+ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
+# the i18n builder cannot share the environment and doctrees with the others
+I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
+
+.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext
+
+help:
+	@echo "Please use \`make <target>' where <target> is one of"
+	@echo "  html       to make standalone HTML files"
+	@echo "  dirhtml    to make HTML files named index.html in directories"
+	@echo "  singlehtml to make a single large HTML file"
+	@echo "  pickle     to make pickle files"
+	@echo "  json       to make JSON files"
+	@echo "  htmlhelp   to make HTML files and a HTML help project"
+	@echo "  qthelp     to make HTML files and a qthelp project"
+	@echo "  devhelp    to make HTML files and a Devhelp project"
+	@echo "  epub       to make an epub"
+	@echo "  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
+	@echo "  latexpdf   to make LaTeX files and run them through pdflatex"
+	@echo "  latexpdfja to make LaTeX files and run them through platex/dvipdfmx"
+	@echo "  text       to make text files"
+	@echo "  man        to make manual pages"
+	@echo "  texinfo    to make Texinfo files"
+	@echo "  info       to make Texinfo files and run them through makeinfo"
+	@echo "  gettext    to make PO message catalogs"
+	@echo "  changes    to make an overview of all changed/added/deprecated items"
+	@echo "  xml        to make Docutils-native XML files"
+	@echo "  pseudoxml  to make pseudoxml-XML files for display purposes"
+	@echo "  linkcheck  to check all external links for integrity"
+	@echo "  doctest    to run all doctests embedded in the documentation (if enabled)"
+	@echo "  cpydiff    to generate the MicroPython differences from CPython"
+
+clean:
+	rm -rf $(BUILDDIR)/*
+	rm -f $(GENRSTDIR)/*
+
+cpydiff:
+	@echo "Generating MicroPython Differences."
+	rm -f $(GENRSTDIR)/*
+	cd $(CPYDIFFDIR) && $(PYTHON) $(CPYDIFF)
+
+html: cpydiff
+	$(SPHINXBUILD) $(FORCE) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
+
+dirhtml:
+	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
+
+singlehtml:
+	$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
+	@echo
+	@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
+
+pickle:
+	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
+	@echo
+	@echo "Build finished; now you can process the pickle files."
+
+json:
+	$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
+	@echo
+	@echo "Build finished; now you can process the JSON files."
+
+htmlhelp:
+	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
+	@echo
+	@echo "Build finished; now you can run HTML Help Workshop with the" \
+	      ".hhp project file in $(BUILDDIR)/htmlhelp."
+
+qthelp:
+	$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
+	@echo
+	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
+	      ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
+	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/MicroPython.qhcp"
+	@echo "To view the help file:"
+	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/MicroPython.qhc"
+
+devhelp:
+	$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
+	@echo
+	@echo "Build finished."
+	@echo "To view the help file:"
+	@echo "# mkdir -p $$HOME/.local/share/devhelp/MicroPython"
+	@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/MicroPython"
+	@echo "# devhelp"
+
+epub:
+	$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
+	@echo
+	@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
+
+latex: cpydiff
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo
+	@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
+	@echo "Run \`make' in that directory to run these through (pdf)latex" \
+	      "(use \`make latexpdf' here to do that automatically)."
+
+latexpdf: cpydiff
+	$(SPHINXBUILD) $(FORCE) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo "Running LaTeX files through pdflatex..."
+	$(MAKE) -C $(BUILDDIR)/latex all-pdf
+	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
+
+latexpdfja: cpydiff
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo "Running LaTeX files through platex and dvipdfmx..."
+	$(MAKE) -C $(BUILDDIR)/latex all-pdf-ja
+	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
+
+text:
+	$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
+	@echo
+	@echo "Build finished. The text files are in $(BUILDDIR)/text."
+
+man:
+	$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
+	@echo
+	@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
+
+texinfo:
+	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
+	@echo
+	@echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo."
+	@echo "Run \`make' in that directory to run these through makeinfo" \
+	      "(use \`make info' here to do that automatically)."
+
+info:
+	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
+	@echo "Running Texinfo files through makeinfo..."
+	make -C $(BUILDDIR)/texinfo info
+	@echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo."
+
+gettext:
+	$(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
+	@echo
+	@echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."
+
+changes:
+	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
+	@echo
+	@echo "The overview file is in $(BUILDDIR)/changes."
+
+linkcheck:
+	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
+	@echo
+	@echo "Link check complete; look for any errors in the above output " \
+	      "or in $(BUILDDIR)/linkcheck/output.txt."
+
+doctest:
+	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
+	@echo "Testing of doctests in the sources finished, look at the " \
+	      "results in $(BUILDDIR)/doctest/output.txt."
+
+xml:
+	$(SPHINXBUILD) -b xml $(ALLSPHINXOPTS) $(BUILDDIR)/xml
+	@echo
+	@echo "Build finished. The XML files are in $(BUILDDIR)/xml."
+
+pseudoxml:
+	$(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/pseudoxml
+	@echo
+	@echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml."

docs/README.md

@@ -5,7 +5,7 @@ The latest documentation can be found at:
 http://circuitpython.readthedocs.io/en/latest/
 
 The documentation you see there is generated from the files in the whole tree:
-https://github.com/adafruit/circuitpython/tree/main
+https://github.com/adafruit/circuitpython/tree/master
 
 Building the documentation locally
 ----------------------------------
@@ -22,27 +22,6 @@ preferably in a virtualenv:
 
 In `circuitpython/`, build the docs:
 
-    make html
+    sphinx-build -v -b html . _build/html
 
 You'll find the index page at `_build/html/index.html`.
-
-### More flexibility
-
-Running `make` by itself will list out the multiple doc generating commands available.
-
-All commands will, by default, run with `-E` (forces a rebuild from scratch of docs) and `-v` (verbosity level 1).  This can be customized as desired:
-
-    # will turn OFF the force rebuild
-    make html FORCE=
-
-    # will turn OFF the verbosity
-    make html VERBOSE=
-
-    # will turn OFF the force rebuild and make it doubly verbose when running
-    make html FORCE= VERBOSE="-v -v"
-
-You can also pass other options to sphinx by using `SPHINXOPTS`.
-
-    make html SPHINXOPTS="-T"
-
-For more flexibility and customization, take a look at the Makefile for all variables you can pass in and overwrite.

docs/autoapi/templates/python/module.rst

@@ -1,92 +0,0 @@
-{% if not obj.display %}
-:orphan:
-
-{% endif %}
-:mod:`{{ obj.name }}`
-======={{ "=" * obj.name|length }}
-
-.. py:module:: {{ obj.name }}
-
-{% if obj.docstring %}
-.. autoapi-nested-parse::
-
-   {{ obj.docstring|prepare_docstring|indent(3) }}
-
-{% endif %}
-
-{% block subpackages %}
-{% set visible_subpackages = obj.subpackages|selectattr("display")|list %}
-{% if visible_subpackages %}
-.. toctree::
-   :maxdepth: 2
-
-{% for subpackage in visible_subpackages %}
-   {{ subpackage.short_name }}/index.rst
-{% endfor %}
-
-
-{% endif %}
-{% endblock %}
-{% block submodules %}
-{% set visible_submodules = obj.submodules|selectattr("display")|list %}
-{% if visible_submodules %}
-
-.. toctree::
-   :titlesonly:
-   :maxdepth: 1
-
-{% for submodule in visible_submodules %}
-   {{ submodule.short_name }}/index.rst
-{% endfor %}
-
-
-{% endif %}
-{% endblock %}
-{% block content %}
-{% if obj.all is not none %}
-{% set visible_children = obj.children|selectattr("short_name", "in", obj.all)|list %}
-{% elif obj.type is equalto("package") %}
-{% set visible_children = obj.children|selectattr("display")|list %}
-{% else %}
-{% set visible_children = obj.children|selectattr("display")|rejectattr("imported")|list %}
-{% endif %}
-{% if visible_children %}
-
-{% set visible_classes = visible_children|selectattr("type", "equalto", "class")|list %}
-{% set visible_functions = visible_children|selectattr("type", "equalto", "function")|list %}
-{% if "show-module-summary" in autoapi_options and (visible_classes or visible_functions) %}
-{% block classes %}
-{% if visible_classes %}
-Classes
-~~~~~~~
-
-.. autoapisummary::
-
-{% for klass in visible_classes %}
-   {{ klass.id }}
-{% endfor %}
-
-
-{% endif %}
-{% endblock %}
-
-{% block functions %}
-{% if visible_functions %}
-Functions
-~~~~~~~~~
-
-.. autoapisummary::
-
-{% for function in visible_functions %}
-   {{ function.id }}
-{% endfor %}
-
-
-{% endif %}
-{% endblock %}
-{% endif %}
-{% for obj_item in visible_children %}
-{{ obj_item.rendered|indent(0) }}
-{% endfor %}
-{% endif %}
-{% endblock %}

docs/c2rst.py

@@ -0,0 +1,18 @@
+import sphinx.parsers
+
+class CStrip(sphinx.parsers.Parser):
+    def __init__(self):
+        self.rst_parser = sphinx.parsers.RSTParser()
+
+    def parse(self, inputstring, document):
+        # This setting is missing starting with Sphinx 1.7.1 so we set it ourself.
+        document.settings.tab_width = 4
+        stripped = []
+        for line in inputstring.split("\n"):
+            line = line.strip()
+            if line == "//|":
+                stripped.append("")
+            elif line.startswith("//| "):
+                stripped.append(line[len("//| "):])
+        stripped = "\r\n".join(stripped)
+        self.rst_parser.parse(stripped, document)

docs/design_guide.rst

@@ -1,11 +1,9 @@
-.. role:: strike
-
 Design Guide
 ============
 
 This guide covers a variety of development practices for CircuitPython core and library APIs. These
 APIs are both `built-into CircuitPython
-<https://github.com/adafruit/circuitpython/tree/main/shared-bindings>`_ and those that are
+<https://github.com/adafruit/circuitpython/tree/master/shared-bindings>`_ and those that are
 `distributed on GitHub <https://github.com/search?utf8=%E2%9C%93&q=topic%3Acircuitpython&type=>`_
 and in the `Adafruit <https://github.com/adafruit/Adafruit_CircuitPython_Bundle>`_ and `Community
 <https://github.com/adafruit/CircuitPython_Community_Bundle/>`_ bundles. Consistency with these
@@ -18,7 +16,7 @@ Start libraries with the cookiecutter
 Cookiecutter is a tool that lets you bootstrap a new repo based on another repo.
 We've made one `here <https://github.com/adafruit/cookiecutter-adafruit-circuitpython>`_
 for CircuitPython libraries that include configs for Travis CI and ReadTheDocs
-along with a setup.py, license, code of conduct, readme among other files.
+along with a setup.py, license, code of conduct and readme.
 
 .. code-block::sh
 
@@ -48,41 +46,6 @@ not have the ``adafruit_`` module or package prefix.
 
 Both should have the CircuitPython repository topic on GitHub.
 
-Terminology
------------
-
-As our Code of Conduct states, we strive to use "welcoming and inclusive
-language." Whether it is in documentation or in code, the words we use matter.
-This means we disfavor language that due to historical and social context can
-make community members and potential community members feel unwelcome.
-
-There are specific terms to avoid except where technical limitations require it.
-While specific cases may call for other terms, consider using these suggested
-terms first:
-
-+--------------------+---------------------+
-| Preferred          | Deprecated          |
-+====================+=====================+
-| Main (device)      | :strike:`Master`    |
-+--------------------+---------------------+
-| Peripheral         | :strike:`Slave`     |
-+--------------------+                     +
-| Sensor             |                     |
-+--------------------+                     +
-| Secondary (device) |                     |
-+--------------------+---------------------+
-| Denylist           | :strike:`Blacklist` |
-+--------------------+---------------------+
-| Allowlist          | :strike:`Whitelist` |
-+--------------------+---------------------+
-
-Note that "technical limitations" refers e.g., to the situation where an
-upstream library or URL has to contain those substrings in order to work.
-However, when it comes to documentation and the names of parameters and
-properties in CircuitPython, we will use alternate terms even if this breaks
-tradition with past practice.
-
-
 .. _lifetime-and-contextmanagers:
 
 Lifetime and ContextManagers
@@ -97,7 +60,6 @@ For example, a user can then use ``deinit()```::
 
     import digitalio
     import board
-    import time
 
     led = digitalio.DigitalInOut(board.D13)
     led.direction = digitalio.Direction.OUTPUT
@@ -117,7 +79,6 @@ Alternatively, using a ``with`` statement ensures that the hardware is deinitial
 
     import digitalio
     import board
-    import time
 
     with digitalio.DigitalInOut(board.D13) as led:
         led.direction = digitalio.Direction.OUTPUT
@@ -165,24 +126,6 @@ use what.
 Here is more info on properties from
 `Python <https://docs.python.org/3/library/functions.html#property>`_.
 
-Exceptions and asserts
---------------------------------------------------------------------------------
-
-Raise an appropriate `Exception <https://docs.python.org/3/library/exceptions.html#bltin-exceptions>`_,
-along with a useful message, whenever a critical test or other condition fails.
-
-Example::
-
-    if not 0 <= pin <= 7:
-        raise ValueError("Pin number must be 0-7.")
-
-If memory is constrained and a more compact method is needed, use `assert`
-instead.
-
-Example::
-
-    assert 0 <= pin <= 7, "Pin number must be 0-7."
-
 Design for compatibility with CPython
 --------------------------------------------------------------------------------
 
@@ -252,7 +195,7 @@ At the class level document what class does and how to initialize it::
         """DS3231 real-time clock.
 
            :param ~busio.I2C i2c_bus: The I2C bus the DS3231 is connected to.
-           :param int address: The I2C address of the device. Defaults to :const:`0x40`
+           :param int address: The I2C address of the device.
         """
 
         def __init__(self, i2c_bus, address=0x40):
@@ -267,7 +210,7 @@ Renders as:
     DS3231 real-time clock.
 
     :param ~busio.I2C i2c_bus: The I2C bus the DS3231 is connected to.
-    :param int address: The I2C address of the device. Defaults to :const:`0x40`
+    :param int address: The I2C address of the device.
 
 Attributes
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -439,7 +382,7 @@ SPI Example
           """Widget's one register."""
           with self.spi_device as spi:
               spi.write(b'0x00')
-              spi.readinto(self.buf)
+              i2c.readinto(self.buf)
           return self.buf[0]
 
 Use composition
@@ -480,7 +423,7 @@ like properties for state even if it sacrifices a bit of speed.
 Avoid allocations in drivers
 --------------------------------------------------------------------------------
 
-Although Python doesn't require managing memory, it's still a good practice for
+Although Python doesn't require managing memory, its still a good practice for
 library writers to think about memory allocations. Avoid them in drivers if
 you can because you never know how much something will be called. Fewer
 allocations means less time spent cleaning up. So, where you can, prefer
@@ -489,7 +432,7 @@ object with methods that read or write into the buffer instead of creating new
 objects. Unified hardware API classes such as `busio.SPI` are design to read and
 write to subsections of buffers.
 
-It's ok to allocate an object to return to the user. Just beware of causing more
+Its ok to allocate an object to return to the user. Just beware of causing more
 than one allocation per call due to internal logic.
 
 **However**, this is a memory tradeoff so do not do it for large or rarely used
@@ -498,32 +441,10 @@ buffers.
 Examples
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-struct.pack
+ustruct.pack
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Use `struct.pack_into` instead of `struct.pack`.
-
-Use of MicroPython ``const()``
---------------------------------------------------------------------------------
-The MicroPython ``const()`` feature, as discussed in `this forum post
-<https://forum.micropython.org/viewtopic.php?t=450>`_, and in `this issue thread
-<https://github.com/micropython/micropython/issues/573>`_, provides some
-optimizations that can be useful on smaller, memory constrained devices. However,
-when using ``const()``, keep in mind these general guide lines:
-
-- Always use via an import, ex: ``from micropython import const``
-- Limit use to global (module level) variables only.
-- If user will not need access to variable, prefix name with a leading
-  underscore, ex: ``_SOME_CONST``.
-
-Libraries Examples
-------------------
-When adding examples, cookiecutter will add a ``<name>_simpletest.py`` file in the examples directory for you.
-Be sure to include code with the library minimal functionalities to work on a device.
-You could other examples if needed featuring different
-functionalities of the library.
-If you add additional examples, be sure to include them in the ``examples.rst``. Naming of the examples
-files should use the name of the library followed by a description, using underscore to separate them.
+Use `ustruct.pack_into` instead of `ustruct.pack`.
 
 Sensor properties and units
 --------------------------------------------------------------------------------
@@ -545,17 +466,13 @@ properties.
 +-----------------------+-----------------------+-------------------------------------------------------------------------+
 | ``gyro``              | (float, float, float) | x, y, z radians per second                                              |
 +-----------------------+-----------------------+-------------------------------------------------------------------------+
-| ``temperature``       | float                 | degrees Celsius                                                         |
+| ``temperature``       | float                 | degrees centigrade                                                      |
 +-----------------------+-----------------------+-------------------------------------------------------------------------+
-| ``CO2``               | float                 | measured CO2 in ppm                                                     |
-+-----------------------+-----------------------+-------------------------------------------------------------------------+
-| ``eCO2``              | float                 | equivalent/estimated CO2 in ppm (estimated from some other measurement) |
+| ``eCO2``              | float                 | equivalent CO2 in ppm                                                   |
 +-----------------------+-----------------------+-------------------------------------------------------------------------+
 | ``TVOC``              | float                 | Total Volatile Organic Compounds in ppb                                 |
 +-----------------------+-----------------------+-------------------------------------------------------------------------+
-| ``distance``          | float                 | centimeters (cm)                                                        |
-+-----------------------+-----------------------+-------------------------------------------------------------------------+
-| ``proximity``         | int                   | non-unit-specific proximity values (monotonic but not actual distance)  |
+| ``distance``          | float                 | centimeters                                                             |
 +-----------------------+-----------------------+-------------------------------------------------------------------------+
 | ``light``             | float                 | non-unit-specific light levels (should be monotonic but is not lux)     |
 +-----------------------+-----------------------+-------------------------------------------------------------------------+
@@ -577,16 +494,12 @@ properties.
 +-----------------------+-----------------------+-------------------------------------------------------------------------+
 | ``duty_cycle``        | int                   | 16-bit PWM duty cycle (regardless of output resolution)                 |
 +-----------------------+-----------------------+-------------------------------------------------------------------------+
-| ``frequency``         | int                   | Hertz (Hz)                                                              |
+| ``frequency``         | int                   | Hertz                                                                   |
 +-----------------------+-----------------------+-------------------------------------------------------------------------+
 | ``value``             | bool                  | Digital logic                                                           |
 +-----------------------+-----------------------+-------------------------------------------------------------------------+
 | ``value``             | int                   | 16-bit Analog value, unit-less                                          |
 +-----------------------+-----------------------+-------------------------------------------------------------------------+
-| ``weight``            | float                 | grams (g)                                                               |
-+-----------------------+-----------------------+-------------------------------------------------------------------------+
-| ``sound_level``       | float                 | non-unit-specific sound level (monotonic but not actual decibels)       |
-+-----------------------+-----------------------+-------------------------------------------------------------------------+
 
 Adding native modules
 --------------------------------------------------------------------------------
@@ -601,11 +514,12 @@ mimic the structure in ``shared-bindings``.
 To test your native modules or core enhancements, follow these Adafruit Learning Guides
 for building local firmware to flash onto your device(s):
 
-`Build CircuitPython <https://learn.adafruit.com/building-circuitpython>`_
+`SAMD21 - Build Firmware Learning Guide <https://learn.adafruit.com/micropython-for-samd21/build-firmware>`_
 
+`ESP8266 - Build Firmware Learning Guide <https://learn.adafruit.com/building-and-running-micropython-on-the-esp8266/overview>`_
 
 MicroPython compatibility
 --------------------------------------------------------------------------------
 
 Keeping compatibility with MicroPython isn't a high priority. It should be done
-when it's not in conflict with any of the above goals.
+when its not in conflict with any of the above goals.

docs/drivers.rst

@@ -1,33 +1,218 @@
-Additional CircuitPython Libraries and Drivers on GitHub
-=========================================================
+.. _adafruit-libndrivers:
+
+Additional Adafruit Libraries and Drivers on GitHub
+===================================================
 
 These are libraries and drivers available in separate GitHub repos. They are
 designed for use with CircuitPython and may or may not work with
 `MicroPython <https://micropython.org>`_.
 
+.. _bundle_installation:
 
-Adafruit CircuitPython Library Bundle
---------------------------------------
+Bundle
+------
 
 We provide a bundle of all our libraries to ease installation of drivers and
 their dependencies. The bundle is primarily geared to the Adafruit Express line
 of boards which feature a relatively large external flash. With Express boards,
-it's easy to copy them all onto the filesystem. However, if you don't have
+its easy to copy them all onto the filesystem. However, if you don't have
 enough space simply copy things over as they are needed.
 
-- The Adafruit bundles are available on GitHub: <https://github.com/adafruit/Adafruit_CircuitPython_Bundle/releases>.
+The bundles are available `on GitHub <https://github.com/adafruit/Adafruit_CircuitPython_Bundle/releases>`_.
 
-- Documentation for the bundle, which includes links to documentation for all
-  libraries, is available here: <https://circuitpython.readthedocs.io/projects/bundle/en/latest/>.
+To install them:
+
+#. `Download <https://github.com/adafruit/Adafruit_CircuitPython_Bundle/releases>`_
+   and unzip the latest zip that's not a source zip.
+#. Copy the ``lib`` folder to the ``CIRCUITPY`` or ``MICROPYTHON``.
+
+Foundational
+------------
+
+These libraries provide critical functionality to many of the drivers below. It
+is recommended to always have them installed onto the CircuitPython file system in
+the ``lib/`` directory. Some drivers may not work without them.
+
+.. toctree::
+
+   Register Library <https://circuitpython.readthedocs.io/projects/register/en/latest/>
+   BusDevice Library <https://circuitpython.readthedocs.io/projects/busdevice/en/latest/>
+
+Board-specific Helpers
+----------------------
+
+These libraries tie lower-level libraries together to provide an easy, out-of-box experience for
+specific boards.
+
+.. toctree::
+
+    Adafruit CircuitPlayground Express <https://circuitpython.readthedocs.io/projects/circuitplayground/en/latest/>
+    Adafruit FeatherWings <https://circuitpython.readthedocs.io/projects/featherwing/en/latest/>
+
+Helper Libraries
+-----------------
+
+These libraries build on top of the low level APIs to simplify common tasks.
+
+.. toctree::
+
+    USB Human Interface Device (Keyboard and Mouse) <https://circuitpython.readthedocs.io/projects/hid/en/latest/>
+    Waveform Generation <https://circuitpython.readthedocs.io/projects/waveform/en/latest/>
+    OneWire <https://circuitpython.readthedocs.io/projects/onewire/en/latest/>
+    Ring Tone Text Transfer Language (RTTTL) <https://circuitpython.readthedocs.io/projects/rtttl/en/latest/>
+    InfraRed Remote <https://circuitpython.readthedocs.io/projects/irremote/en/latest/>
+    Fancy LED (similar to FastLED) <https://circuitpython.readthedocs.io/projects/fancyled/en/latest/>
+    SimpleIO <https://circuitpython.readthedocs.io/projects/simpleio/en/latest/>
+    AVR programming <https://circuitpython.readthedocs.io/projects/avrprog/en/latest/>
+    DC Motor and Servo <https://circuitpython.readthedocs.io/projects/motor/en/latest/>
+    SD Card <https://circuitpython.readthedocs.io/projects/sd/en/latest/>
+
+Blinky
+--------
+
+Multi-color led drivers.
+
+.. toctree::
+
+    NeoPixel <https://circuitpython.readthedocs.io/projects/neopixel/en/latest/>
+    DotStar <https://circuitpython.readthedocs.io/projects/dotstar/en/latest/>
+    WS2801 <https://circuitpython.readthedocs.io/projects/ws2801/en/latest/>
+
+Displays
+-------------
+
+Drivers used to display information. Either pixel or segment based.
+
+.. toctree::
+
+    RGB Displays <https://circuitpython.readthedocs.io/projects/rgb_display/en/latest/>
+    Character LCD <https://circuitpython.readthedocs.io/projects/charlcd/en/latest/>
+    HT16K33 LED Matrices and Segment Displays <https://circuitpython.readthedocs.io/projects/ht16k33/en/latest/>
+    IS31FL3731 Charlieplexed LED Matrix <https://circuitpython.readthedocs.io/projects/is31fl3731/en/latest/>
+    MAX7219 LED Matrix <https://circuitpython.readthedocs.io/projects/max7219/en/latest/>
+    SSD1306 OLED Driver <https://circuitpython.readthedocs.io/projects/ssd1306/en/latest/>
+
+Real-time clocks
+-----------------
+
+Chips that keep current calendar time with a backup battery. The current date and time is available
+through ``datetime``.
+
+.. toctree::
+
+    DS1307 Real-time Clock (5V RTC Breakout) <https://circuitpython.readthedocs.io/projects/ds1307/en/latest/>
+    DS3231 Real-time Clock (Precision RTC) <https://circuitpython.readthedocs.io/projects/ds3231/en/latest/>
+    PCF8523 Real-time Clock (Adalogger RTC) <https://circuitpython.readthedocs.io/projects/pcf8523/en/latest/>
+
+Motion Sensors
+----------------
+
+Motion relating sensing including ``acceleration``, ``magnetic``, ``gyro``, and ``orientation``.
+
+.. toctree::
+
+    BNO055 Accelerometer, Magnetometer, Gyroscope and Absolution Orientation <https://circuitpython.readthedocs.io/projects/bno055/en/latest/>
+    FXAS21002C Gyroscope <https://circuitpython.readthedocs.io/projects/fxas21002c/en/latest/>
+    FXOS8700 Accelerometer <https://circuitpython.readthedocs.io/projects/fxos8700/en/latest/>
+    GPS Global Position <https://circuitpython.readthedocs.io/projects/gps/en/latest/>
+    LIS3DH Accelerometer <https://circuitpython.readthedocs.io/projects/lis3dh/en/latest/>
+    LSM303 Accelerometer and Magnetometer <https://circuitpython.readthedocs.io/projects/lsm303/en/latest/>
+    LSM9DS0 Accelerometer, Magnetometer, Gyroscope and Temperature <https://circuitpython.readthedocs.io/projects/lsm9ds0/en/latest/>
+    LSM9DS1 Accelerometer, Magnetometer, Gyroscope and Temperature <https://circuitpython.readthedocs.io/projects/lsm9ds1/en/latest/>
+    MMA8451 3 axis accelerometer <https://circuitpython.readthedocs.io/projects/mma8451/en/latest/>
+
+Environmental Sensors
+----------------------
+
+Sense attributes of the environment including ``temperature``, ``relative_humidity``, ``pressure``,
+equivalent carbon dioxide (``eco2`` / ``eCO2``), and total volatile organic compounds (``tvoc`` /
+``TVOC``).
+
+.. toctree::
+
+    AM2320 Temperature and Humidity <https://circuitpython.readthedocs.io/projects/am2320/en/latest/>
+    BME280 Temperature, Humidity and Pressure <https://circuitpython.readthedocs.io/projects/bme280/en/latest/>
+    BME680 Temperature, Humidity, Pressure and Gas <https://circuitpython.readthedocs.io/projects/bme680/en/latest/>
+    BMP280 Barometric Pressure and Altitude <https://circuitpython.readthedocs.io/projects/bmp280/en/latest/>
+    CCS811 Air Quality <https://circuitpython.readthedocs.io/projects/ccs811/en/latest/>
+    DHT Temperature and Humidity <https://circuitpython.readthedocs.io/projects/dht/en/latest/>
+    DS18x20 Temperature <https://circuitpython.readthedocs.io/projects/ds18x20/en/latest/>
+    MAX31865 Thermocouple Amplifier, Temperature <https://circuitpython.readthedocs.io/projects/max31865/en/latest/>
+    MAX31855 Thermocouple Amplifier, Temperature <https://circuitpython.readthedocs.io/projects/max31855/en/latest/>
+    MCP9808 Temperature <https://circuitpython.readthedocs.io/projects/mcp9808/en/latest/>
+    MPL3115A2 Barometric Pressure, Altitude and Temperature Sensor <https://circuitpython.readthedocs.io/projects/mpl3115a2/en/latest/>
+    SGP30 Air Quality <https://circuitpython.readthedocs.io/projects/sgp30/en/latest/>
+    SHT31-D Temperature and Humidity <https://circuitpython.readthedocs.io/projects/sht31d/en/latest/>
+    Si7021 Temperature and Humidity <https://circuitpython.readthedocs.io/projects/si7021/en/latest/>
+    Thermistor Temperature <https://circuitpython.readthedocs.io/projects/thermistor/en/latest/>
+
+Light Sensors
+---------------
+
+These sensors detect light related attributes such as ``color``, ``light`` (unit-less), and
+``lux`` (light in SI lux).
+
+.. toctree::
+
+    APDS9960 Proximity, Light, RGB, and Gesture <https://circuitpython.readthedocs.io/projects/apds9960/en/latest/>
+    AS726x Color Spectrum Sensor <https://circuitpython.readthedocs.io/projects/as726x/en/latest/>
+    TCS34725 Color Sensor <https://circuitpython.readthedocs.io/projects/tcs34725/en/latest/>
+    TSL2561 Light Sensor <https://circuitpython.readthedocs.io/projects/tsl2561/en/latest/>
+    TSL2591 High Dynamic Range Light Sensor <https://circuitpython.readthedocs.io/projects/tsl2591/en/latest/>
+    VCNL4010 Proximity and Light <https://circuitpython.readthedocs.io/projects/vcnl4010/en/latest/>
+    VEML6070 UV Index <https://circuitpython.readthedocs.io/projects/veml6070/en/latest/>
+
+Distance Sensors
+------------------
+
+These sensors measure the ``distance`` to another object and may also measure light level (``light`` and ``lux``).
+
+.. toctree::
+
+    VL6180x 5 - 100 mm <https://circuitpython.readthedocs.io/projects/vl6180x/en/latest/>
+    VL53L0x ~30 - 1000 mm <https://circuitpython.readthedocs.io/projects/vl53l0x/en/latest/>
+
+Radio
+--------
+
+These chips communicate to other's over radio.
+
+.. toctree::
+
+    RFM9x LoRa <https://circuitpython.readthedocs.io/projects/rfm9x/en/latest/>
+    RFM69 Packet Radio <https://circuitpython.readthedocs.io/projects/rfm69/en/latest/>
+
+IO Expansion
+--------------
+
+These provide functionality similar to `analogio`, `digitalio`, `pulseio`, and `touchio`.
+
+.. toctree::
+
+    Adafruit SeeSaw <https://circuitpython.readthedocs.io/projects/seesaw/en/latest/>
+    ADS1x15 Analog-to-Digital Converter  <https://circuitpython.readthedocs.io/projects/ads1x15/en/latest/>
+    DS2413 OneWire GPIO Expander <https://circuitpython.readthedocs.io/projects/ds2413/en/latest/>
+    FocalTech Capacitive Touch <https://circuitpython.readthedocs.io/projects/focaltouch/en/latest/>
+    MCP230xx GPIO Expander <https://circuitpython.readthedocs.io/projects/mcp230xx/en/latest/>
+    MCP4725 Digital-to-Analog Converter <https://circuitpython.readthedocs.io/projects/mcp4725/en/latest/>
+    PCA9685 16 x 12-bit PWM Driver <https://circuitpython.readthedocs.io/projects/pca9685/en/latest/>
+    TLC5947 24 x 12-bit PWM Driver <https://circuitpython.readthedocs.io/projects/tlc5947/en/latest/>
+    TLC59711 12 x 16-bit PWM Driver <https://circuitpython.readthedocs.io/projects/tlc59711/en/latest/>
+    MPR121 Capacitive Touch Sensor <https://circuitpython.readthedocs.io/projects/mpr121/en/latest/>
 
 
-CircuitPython Community Library Bundle
----------------------------------------
+Miscellaneous
+----------------
 
-This bundle contains non-Adafruit sponsored libraries, that are written and submitted
-by members of the community.
+.. toctree::
 
-- The Community bundles are available on GitHub: <https://github.com/adafruit/CircuitPython_Community_Bundle/releases>.
-
-- Documentation is not available on ReadTheDocs at this time. See each library for any
-  included documentation.
+    Si4713 Stereo FM Transmitter <https://circuitpython.readthedocs.io/projects/si4713/en/latest/>
+    AMG88xx Grid-Eye IR Camera <https://circuitpython.readthedocs.io/projects/amg88xx/en/latest/>
+    Trellis 4x4 Keypad <https://circuitpython.readthedocs.io/projects/trellis/en/latest/>
+    DRV2605 Haptic Motor Controller <https://circuitpython.readthedocs.io/projects/drv2605/en/latest/>
+    MAX9744 Audio Amplifier  <https://circuitpython.readthedocs.io/projects/max9744/en/latest/>
+    Si5351 Clock Generator <https://circuitpython.readthedocs.io/projects/si5351/en/latest/>
+    Thermal Printer <https://circuitpython.readthedocs.io/projects/thermal_printer/en/latest/>
+    VC0706 TTL Camera <https://circuitpython.readthedocs.io/projects/vc0706/en/latest/>
+    INA219 High Side Current <https://circuitpython.readthedocs.io/projects/ina219/en/latest/>
+    Fingerprint <https://circuitpython.readthedocs.io/projects/fingerprint/en/latest/>

docs/index.rst

@@ -43,10 +43,8 @@ Full Table of Contents
 
    ../README
    ../CONTRIBUTING
-   ../BUILDING
    ../CODE_OF_CONDUCT
    ../license.rst
-   ../WEBUSB_README
 
 Indices and tables
 ==================

docs/library/array.rst

@@ -1,7 +1,9 @@
-:mod:`uarray` -- arrays of numeric data
-=======================================
+:mod:`array` -- arrays of numeric data
+======================================
 
-.. module:: uarray
+.. include:: ../templates/unsupported_in_circuitpython.inc
+
+.. module:: array
    :synopsis: efficient arrays of numeric data
 
 |see_cpython_module| :mod:`cpython:array`.
@@ -13,7 +15,7 @@ floating-point support).
 Classes
 -------
 
-.. class:: array(typecode, [iterable])
+.. class:: array.array(typecode, [iterable])
 
     Create array with elements of given type. Initial contents of the
     array are given by an `iterable`. If it is not provided, an empty
@@ -21,9 +23,9 @@ Classes
 
     .. method:: append(val)
 
-        Append new element ``val`` to the end of array, growing it.
+        Append new element to the end of array, growing it.
 
     .. method:: extend(iterable)
 
-        Append new elements as contained in `iterable` to the end of
+        Append new elements as contained in an iterable to the end of
         array, growing it.

docs/library/binascii.rst

@@ -1,40 +0,0 @@
-:mod:`binascii` -- binary/ASCII conversions
-============================================
-
-.. module:: binascii
-   :synopsis: binary/ASCII conversions
-
-|see_cpython_module| :mod:`cpython:binascii`.
-
-This module implements conversions between binary data and various
-encodings of it in ASCII form (in both directions).
-
-Functions
----------
-
-.. function:: hexlify(data, [sep])
-
-   Convert binary data to hexadecimal representation. Returns bytes string.
-
-   .. admonition:: Difference to CPython
-      :class: attention
-
-      If additional argument, *sep* is supplied, it is used as a separator
-      between hexadecimal values.
-
-.. function:: unhexlify(data)
-
-   Convert hexadecimal data to binary representation. Returns bytes string.
-   (i.e. inverse of hexlify)
-
-.. function:: a2b_base64(data)
-
-   Decode base64-encoded data, ignoring invalid characters in the input.
-   Conforms to `RFC 2045 s.6.8 <https://tools.ietf.org/html/rfc2045#section-6.8>`_.
-   Returns a bytes object.
-
-.. function:: b2a_base64(data)
-
-   Encode binary data in base64 format, as in `RFC 3548
-   <https://tools.ietf.org/html/rfc3548.html>`_. Returns the encoded data
-   followed by a newline character, as a bytes object.

docs/library/btree.rst

@@ -7,7 +7,7 @@
    :synopsis: simple BTree database
 
 The ``btree`` module implements a simple key-value database using external
-storage (disk files, or in general case, a random-access ``stream``). Keys are
+storage (disk files, or in general case, a random-access stream). Keys are
 stored sorted in the database, and besides efficient retrieval by a key
 value, a database also supports efficient ordered range scans (retrieval
 of values with the keys in a given range). On the application interface

docs/library/builtins.rst

@@ -1,14 +1,18 @@
 Builtin functions and exceptions
 ================================
 
+.. warning::
+
+    These builtins are inherited from MicroPython and may not work in CircuitPython
+    as documented or at all! If work differently from CPython, then their behavior
+    may change.
+
 All builtin functions and exceptions are described here. They are also
 available via ``builtins`` module.
 
 Functions and types
 -------------------
 
-Not all of these functions and types are turned on in all CircuitPython ports, for space reasons.
-
 .. function:: abs()
 
 .. function:: all()
@@ -58,8 +62,6 @@ Not all of these functions and types are turned on in all CircuitPython ports, f
 
 .. class:: frozenset()
 
-`frozenset()` is not enabled on non-Express CircuitPython boards.
-
 .. function:: getattr()
 
 .. function:: globals()
@@ -78,12 +80,12 @@ Not all of these functions and types are turned on in all CircuitPython ports, f
 
    .. classmethod:: from_bytes(bytes, byteorder)
 
-      In CircuitPython, ``byteorder`` parameter must be positional (this is
+      In MicroPython, `byteorder` parameter must be positional (this is
       compatible with CPython).
 
    .. method:: to_bytes(size, byteorder)
 
-      In CircuitPython, ``byteorder`` parameter must be positional (this is
+      In MicroPython, `byteorder` parameter must be positional (this is
       compatible with CPython).
 
 .. function:: isinstance()
@@ -128,8 +130,6 @@ Not all of these functions and types are turned on in all CircuitPython ports, f
 
 .. function:: reversed()
 
-`reversed()` is not enabled on non-Express CircuitPython boards.
-
 .. function:: round()
 
 .. class:: set()
@@ -182,27 +182,23 @@ Exceptions
 
 .. exception:: OSError
 
-    |see_cpython| :py:class:`cpython:OSError`. CircuitPython doesn't implement the ``errno``
+    |see_cpython| `OSError`. MicroPython doesn't implement ``errno``
     attribute, instead use the standard way to access exception arguments:
     ``exc.args[0]``.
 
 .. exception:: RuntimeError
 
-.. exception:: ReloadException
-
-   `ReloadException` is used internally to deal with soft restarts.
-
 .. exception:: StopIteration
 
 .. exception:: SyntaxError
 
 .. exception:: SystemExit
 
-    |see_cpython| :py:class:`cpython:SystemExit`.
+    |see_cpython| :py:class:`python:SystemExit`.
 
 .. exception:: TypeError
 
-    |see_cpython| :py:class:`cpython:TypeError`.
+    |see_cpython| :py:class:`python:TypeError`.
 
 .. exception:: ValueError
 

docs/library/collections.rst

@@ -1,84 +0,0 @@
-:mod:`collections` -- collection and container types
-=====================================================
-
-.. include:: ../templates/unsupported_in_circuitpython.inc
-
-.. module:: collections
-   :synopsis: collection and container types
-
-|see_cpython_module| :mod:`cpython:collections`.
-
-This module implements advanced collection and container types to
-hold/accumulate various objects.
-
-Classes
--------
-
-.. function:: deque(iterable, maxlen[, flags])
-
-    Deques (double-ended queues) are a list-like container that support O(1)
-    appends and pops from either side of the deque.  New deques are created
-    using the following arguments:
-
-        - *iterable* must be the empty tuple, and the new deque is created empty.
-
-        - *maxlen* must be specified and the deque will be bounded to this
-          maximum length.  Once the deque is full, any new items added will
-          discard items from the opposite end.
-
-        - The optional *flags* can be 1 to check for overflow when adding items.
-
-    As well as supporting `bool` and `len`, deque objects have the following
-    methods:
-
-    .. method:: deque.append(x)
-
-        Add *x* to the right side of the deque.
-        Raises IndexError if overflow checking is enabled and there is no more room left.
-
-    .. method:: deque.popleft()
-
-        Remove and return an item from the left side of the deque.
-        Raises IndexError if no items are present.
-
-.. function:: namedtuple(name, fields)
-
-    This is factory function to create a new namedtuple type with a specific
-    name and set of fields. A namedtuple is a subclass of tuple which allows
-    to access its fields not just by numeric index, but also with an attribute
-    access syntax using symbolic field names. Fields is a sequence of strings
-    specifying field names. For compatibility with CPython it can also be a
-    a string with space-separated field named (but this is less efficient).
-    Example of use::
-
-        from collections import namedtuple
-
-        MyTuple = namedtuple("MyTuple", ("id", "name"))
-        t1 = MyTuple(1, "foo")
-        t2 = MyTuple(2, "bar")
-        print(t1.name)
-        assert t2.name == t2[1]
-
-.. function:: OrderedDict(...)
-
-    ``dict`` type subclass which remembers and preserves the order of keys
-    added. When ordered dict is iterated over, keys/items are returned in
-    the order they were added::
-
-        from collections import OrderedDict
-
-        # To make benefit of ordered keys, OrderedDict should be initialized
-        # from sequence of (key, value) pairs.
-        d = OrderedDict([("z", 1), ("a", 2)])
-        # More items can be added as usual
-        d["w"] = 5
-        d["b"] = 3
-        for k, v in d.items():
-            print(k, v)
-
-    Output::
-
-        z 1
-        a 2
-        w 5
-        b 3

docs/library/errno.rst

@@ -1,32 +0,0 @@
-:mod:`errno` -- system error codes
-===================================
-
-.. module:: errno
-   :synopsis: system error codes
-
-|see_cpython_module| :mod:`cpython:errno`.
-
-This module provides access to symbolic error codes for `OSError` exception.
-
-Constants
----------
-
-.. data:: EEXIST, EAGAIN, etc.
-
-    Error codes, based on ANSI C/POSIX standard. All error codes start with
-    "E". Errors are usually accessible as ``exc.args[0]``
-    where ``exc`` is an instance of `OSError`. Usage example::
-
-        try:
-            os.mkdir("my_dir")
-        except OSError as exc:
-            if exc.args[0] == errno.EEXIST:
-                print("Directory already exists")
-
-.. data:: errorcode
-
-    Dictionary mapping numeric error codes to strings with symbolic error
-    code (see above)::
-
-        >>> print(errno.errorcode[uerrno.EEXIST])
-        EEXIST

docs/library/esp.rst

@@ -0,0 +1,85 @@
+:mod:`esp` --- functions related to the ESP8266
+===============================================
+
+.. include:: ../templates/unsupported_in_circuitpython.inc
+
+.. module:: esp
+    :synopsis: functions related to the ESP8266
+
+The ``esp`` module contains specific functions related to the ESP8266 module.
+
+
+Functions
+---------
+
+.. function:: sleep_type([sleep_type])
+
+    Get or set the sleep type.
+
+    If the *sleep_type* parameter is provided, sets the sleep type to its
+    value. If the function is called without parameters, returns the current
+    sleep type.
+
+    The possible sleep types are defined as constants:
+
+        * ``SLEEP_NONE`` -- all functions enabled,
+        * ``SLEEP_MODEM`` -- modem sleep, shuts down the WiFi Modem circuit.
+        * ``SLEEP_LIGHT`` -- light sleep, shuts down the WiFi Modem circuit
+          and suspends the processor periodically.
+
+    The system enters the set sleep mode automatically when possible.
+
+.. function:: deepsleep(time=0)
+
+    Enter deep sleep.
+
+    The whole module powers down, except for the RTC clock circuit, which can
+    be used to restart the module after the specified time if the pin 16 is
+    connected to the reset pin. Otherwise the module will sleep until manually
+    reset.
+
+.. function:: flash_id()
+
+    Read the device ID of the flash memory.
+
+.. function:: flash_read(byte_offset, length_or_buffer)
+
+.. function:: flash_write(byte_offset, bytes)
+
+.. function:: flash_erase(sector_no)
+
+.. function:: set_native_code_location(start, length)
+
+    Set the location that native code will be placed for execution after it is
+    compiled.  Native code is emitted when the ``@micropython.native``,
+    ``@micropython.viper`` and ``@micropython.asm_xtensa`` decorators are applied
+    to a function.  The ESP8266 must execute code from either iRAM or the lower
+    1MByte of flash (which is memory mapped), and this function controls the
+    location.
+
+    If *start* and *length* are both ``None`` then the native code location is
+    set to the unused portion of memory at the end of the iRAM1 region.  The
+    size of this unused portion depends on the firmware and is typically quite
+    small (around 500 bytes), and is enough to store a few very small
+    functions.  The advantage of using this iRAM1 region is that it does not
+    get worn out by writing to it.
+
+    If neither *start* nor *length* are ``None`` then they should be integers.
+    *start* should specify the byte offset from the beginning of the flash at
+    which native code should be stored.  *length* specifies how many bytes of
+    flash from *start* can be used to store native code.  *start* and *length*
+    should be multiples of the sector size (being 4096 bytes).  The flash will
+    be automatically erased before writing to it so be sure to use a region of
+    flash that is not otherwise used, for example by the firmware or the
+    filesystem.
+
+    When using the flash to store native code *start+length* must be less
+    than or equal to 1MByte.  Note that the flash can be worn out if repeated
+    erasures (and writes) are made so use this feature sparingly.
+    In particular, native code needs to be recompiled and rewritten to flash
+    on each boot (including wake from deepsleep).
+
+    In both cases above, using iRAM1 or flash, if there is no more room left
+    in the specified region then the use of a native decorator on a function
+    will lead to `MemoryError` exception being raised during compilation of
+    that function.

docs/library/framebuf.rst

@@ -21,7 +21,7 @@ For example::
     import framebuf
 
     # FrameBuffer needs 2 bytes for every RGB565 pixel
-    fbuf = framebuf.FrameBuffer(bytearray(10 * 100 * 2), 10, 100, framebuf.RGB565)
+    fbuf = FrameBuffer(bytearray(10 * 100 * 2), 10, 100, framebuf.RGB565)
 
     fbuf.fill(0)
     fbuf.text('MicroPython!', 0, 0, 0xffff)
@@ -150,14 +150,6 @@ Constants
 
     Red Green Blue (16-bit, 5+6+5) color format
 
-.. data:: framebuf.GS2_HMSB
-
-    Grayscale (2-bit) color format
-
 .. data:: framebuf.GS4_HMSB
 
     Grayscale (4-bit) color format
-
-.. data:: framebuf.GS8
-
-    Grayscale (8-bit) color format

docs/library/gc.rst

@@ -31,7 +31,7 @@ Functions
    .. admonition:: Difference to CPython
       :class: attention
 
-      This function is a MicroPython extension.
+      This function is MicroPython extension.
 
 .. function:: mem_free()
 
@@ -41,7 +41,7 @@ Functions
    .. admonition:: Difference to CPython
       :class: attention
 
-      This function is a MicroPython extension.
+      This function is MicroPython extension.
 
 .. function:: threshold([amount])
 
@@ -63,6 +63,6 @@ Functions
    .. admonition:: Difference to CPython
       :class: attention
 
-      This function is a a MicroPython extension. CPython has a similar
+      This function is a MicroPython extension. CPython has a similar
       function - ``set_threshold()``, but due to different GC
       implementations, its signature and semantics are different.

docs/library/hashlib.rst

@@ -1,59 +0,0 @@
-:mod:`hashlib` -- hashing algorithms
-=====================================
-
-.. include:: ../templates/unsupported_in_circuitpython.inc
-
-.. module:: hashlib
-   :synopsis: hashing algorithms
-
-|see_cpython_module| :mod:`cpython:hashlib`.
-
-This module implements binary data hashing algorithms. The exact inventory
-of available algorithms depends on a board. Among the algorithms which may
-be implemented:
-
-* SHA256 - The current generation, modern hashing algorithm (of SHA2 series).
-  It is suitable for cryptographically-secure purposes. Included in the
-  MicroPython core and any board is recommended to provide this, unless
-  it has particular code size constraints.
-
-* SHA1 - A previous generation algorithm. Not recommended for new usages,
-  but SHA1 is a part of number of Internet standards and existing
-  applications, so boards targeting network connectivity and
-  interoperability will try to provide this.
-
-* MD5 - A legacy algorithm, not considered cryptographically secure. Only
-  selected boards, targeting interoperability with legacy applications,
-  will offer this.
-
-Constructors
-------------
-
-.. class:: hashlib.sha256([data])
-
-    Create an SHA256 hasher object and optionally feed ``data`` into it.
-
-.. class:: hashlib.sha1([data])
-
-    Create an SHA1 hasher object and optionally feed ``data`` into it.
-
-.. class:: hashlib.md5([data])
-
-    Create an MD5 hasher object and optionally feed ``data`` into it.
-
-Methods
--------
-
-.. method:: hash.update(data)
-
-   Feed more binary data into hash.
-
-.. method:: hash.digest()
-
-   Return hash for all data passed through hash, as a bytes object. After this
-   method is called, more data cannot be fed into the hash any longer.
-
-.. method:: hash.hexdigest()
-
-   This method is NOT implemented. Use ``binascii.hexlify(hash.digest())``
-   to achieve a similar effect.

docs/library/index.rst

@@ -3,59 +3,43 @@
 MicroPython libraries
 =====================
 
+.. warning::
+
+    These modules are inherited from MicroPython and may not work in CircuitPython
+    as documented or at all! If they do work, they may change at any time.
+
+
 Python standard libraries and micro-libraries
 ---------------------------------------------
 
-The libraries below are inherited from MicroPython.
-They are similar to the standard Python libraries with the same name.
-They implement a subset of or a variant of the corresponding
-standard Python library.
-
-CircuitPython's long-term goal is that code written in CircuitPython
-using Python standard libraries will be runnable on CPython without changes.
-
-These libraries are not enabled on CircuitPython builds with
-limited flash memory, usually on non-Express builds:
-``binascii``, ``errno``, ``json``, ``re``.
-
-These libraries are not currently enabled in any CircuitPython build, but may be in the future,
-with the ``u`` prefix dropped:
-``uctypes``, ``uhashlib``, ``uzlib``.
 
 .. toctree::
    :maxdepth: 1
 
    builtins.rst
-   uheapq.rst
    array.rst
-   binascii.rst
-   collections.rst
-   errno.rst
    gc.rst
-   hashlib.rst
-   io.rst
-   json.rst
-   re.rst
    sys.rst
-   uctypes.rst
+   ubinascii.rst
+   ucollections.rst
+   uerrno.rst
+   uhashlib.rst
+   uheapq.rst
+   uio.rst
+   ujson.rst
+   ure.rst
    uselect.rst
+   usocket.rst
+   ussl.rst
+   ustruct.rst
    uzlib.rst
 
-Omitted functions in the ``string`` library
--------------------------------------------
 
-A few string operations are not enabled on small builds
-(usually non-Express), due to limited flash memory:
-``string.center()``, ``string.partition()``, ``string.splitlines()``,
-``string.reversed()``.
+MicroPython-specific libraries
+------------------------------
 
-
-CircuitPython/MicroPython-specific libraries
---------------------------------------------
-
-Functionality specific to the CircuitPython/MicroPython implementation is available in
-the following libraries. These libraries may change significantly or be removed in future
-versions of CircuitPython.
+Functionality specific to the MicroPython implementation is available in
+the following libraries.
 
 .. toctree::
    :maxdepth: 1
@@ -63,3 +47,15 @@ versions of CircuitPython.
    btree.rst
    framebuf.rst
    micropython.rst
+   network.rst
+   uctypes.rst
+
+Libraries specific to the ESP8266
+---------------------------------
+
+The following libraries are specific to the ESP8266.
+
+.. toctree::
+  :maxdepth: 2
+
+  esp.rst

docs/library/io.rst

@@ -1,114 +0,0 @@
-:mod:`io` -- input/output streams
-==================================
-
-.. module:: io
-   :synopsis: input/output streams
-
-|see_cpython_module| :mod:`cpython:io`.
-
-This module contains additional types of ``stream`` (file-like) objects
-and helper functions.
-
-Conceptual hierarchy
---------------------
-
-.. admonition:: Difference to CPython
-   :class: attention
-
-   Conceptual hierarchy of stream base classes is simplified in MicroPython,
-   as described in this section.
-
-(Abstract) base stream classes, which serve as a foundation for behavior
-of all the concrete classes, adhere to few dichotomies (pair-wise
-classifications) in CPython. In MicroPython, they are somewhat simplified
-and made implicit to achieve higher efficiencies and save resources.
-
-An important dichotomy in CPython is unbuffered vs buffered streams. In
-MicroPython, all streams are currently unbuffered. This is because all
-modern OSes, and even many RTOSes and filesystem drivers already perform
-buffering on their side. Adding another layer of buffering is counter-
-productive (an issue known as "bufferbloat") and takes precious memory.
-Note that there still cases where buffering may be useful, so we may
-introduce optional buffering support at a later time.
-
-But in CPython, another important dichotomy is tied with "bufferedness" -
-it's whether a stream may incur short read/writes or not. A short read
-is when a user asks e.g. 10 bytes from a stream, but gets less, similarly
-for writes. In CPython, unbuffered streams are automatically short
-operation susceptible, while buffered are guarantee against them. The
-no short read/writes is an important trait, as it allows to develop
-more concise and efficient programs - something which is highly desirable
-for MicroPython. So, while MicroPython doesn't support buffered streams,
-it still provides for no-short-operations streams. Whether there will
-be short operations or not depends on each particular class' needs, but
-developers are strongly advised to favor no-short-operations behavior
-for the reasons stated above. For example, MicroPython sockets are
-guaranteed to avoid short read/writes. Actually, at this time, there is
-no example of a short-operations stream class in the core, and one would
-be a port-specific class, where such a need is governed by hardware
-peculiarities.
-
-The no-short-operations behavior gets tricky in case of non-blocking
-streams, blocking vs non-blocking behavior being another CPython dichotomy,
-fully supported by MicroPython. Non-blocking streams never wait for
-data either to arrive or be written - they read/write whatever possible,
-or signal lack of data (or ability to write data). Clearly, this conflicts
-with "no-short-operations" policy, and indeed, a case of non-blocking
-buffered (and this no-short-ops) streams is convoluted in CPython - in
-some places, such combination is prohibited, in some it's undefined or
-just not documented, in some cases it raises verbose exceptions. The
-matter is much simpler in MicroPython: non-blocking stream are important
-for efficient asynchronous operations, so this property prevails on
-the "no-short-ops" one. So, while blocking streams will avoid short
-reads/writes whenever possible (the only case to get a short read is
-if end of file is reached, or in case of error (but errors don't
-return short data, but raise exceptions)), non-blocking streams may
-produce short data to avoid blocking the operation.
-
-The final dichotomy is binary vs text streams. MicroPython of course
-supports these, but while in CPython text streams are inherently
-buffered, they aren't in MicroPython. (Indeed, that's one of the cases
-for which we may introduce buffering support.)
-
-Note that for efficiency, MicroPython doesn't provide abstract base
-classes corresponding to the hierarchy above, and it's not possible
-to implement, or subclass, a stream class in pure Python.
-
-Functions
----------
-
-.. function:: open(name, mode='r', **kwargs)
-
-    Open a file. Builtin ``open()`` function is aliased to this function.
-    All ports (which provide access to file system) are required to support
-    ``mode`` parameter, but support for other arguments vary by port.
-
-Classes
--------
-
-.. class:: FileIO(...)
-
-    This is type of a file open in binary mode, e.g. using ``open(name, "rb")``.
-    You should not instantiate this class directly.
-
-.. class:: TextIOWrapper(...)
-
-    This is type of a file open in text mode, e.g. using ``open(name, "rt")``.
-    You should not instantiate this class directly.
-
-.. class:: StringIO([string])
-.. class:: BytesIO([string])
-
-    In-memory file-like objects for input/output. `StringIO` is used for
-    text-mode I/O (similar to a normal file opened with "t" modifier).
-    `BytesIO` is used for binary-mode I/O (similar to a normal file
-    opened with "b" modifier). Initial contents of file-like objects
-    can be specified with `string` parameter (should be normal string
-    for `StringIO` or bytes object for `BytesIO`). All the usual file
-    methods like ``read()``, ``write()``, ``seek()``, ``flush()``,
-    ``close()`` are available on these objects, and additionally, a
-    following method:
-
-    .. method:: getvalue()
-
-        Get the current contents of the underlying buffer which holds data.

docs/library/json.rst

@@ -1,35 +0,0 @@
-:mod:`json` -- JSON encoding and decoding
-==========================================
-
-.. module:: json
-   :synopsis: JSON encoding and decoding
-
-|see_cpython_module| :mod:`cpython:json`.
-
-This modules allows to convert between Python objects and the JSON
-data format.
-
-Functions
----------
-
-.. function:: dump(obj, stream)
-
-   Serialise ``obj`` to a JSON string, writing it to the given *stream*.
-
-.. function:: dumps(obj)
-
-   Return ``obj`` represented as a JSON string.
-
-.. function:: load(stream)
-
-   Parse the given ``stream``, interpreting it as a JSON string and
-   deserialising the data to a Python object.  The resulting object is
-   returned.
-
-   Parsing continues until end-of-file is encountered.
-   A :exc:`ValueError` is raised if the data in ``stream`` is not correctly formed.
-
-.. function:: loads(str)
-
-   Parse the JSON *str* and return an object.  Raises :exc:`ValueError` if the
-   string is not correctly formed.

docs/library/micropython.rst

@@ -35,17 +35,16 @@ Functions
    compilation of scripts, and returns ``None``.  Otherwise it returns the current
    optimisation level.
 
-   The optimisation level controls the following compilation features:
+.. function:: alloc_emergency_exception_buf(size)
 
-   - Assertions: at level 0 assertion statements are enabled and compiled into the
-     bytecode; at levels 1 and higher assertions are not compiled.
-   - Built-in ``__debug__`` variable: at level 0 this variable expands to ``True``;
-     at levels 1 and higher it expands to ``False``.
-   - Source-code line numbers: at levels 0, 1 and 2 source-code line number are
-     stored along with the bytecode so that exceptions can report the line number
-     they occurred at; at levels 3 and higher line numbers are not stored.
+   Allocate *size* bytes of RAM for the emergency exception buffer (a good
+   size is around 100 bytes).  The buffer is used to create exceptions in cases
+   when normal RAM allocation would fail (eg within an interrupt handler) and
+   therefore give useful traceback information in these situations.
 
-   The default optimisation level is usually level 0.
+   A good way to use this function is to put it at the start of your main script
+   (eg ``boot.py`` or ``main.py``) and then the emergency exception buffer will be active
+   for all the code following it.
 
 .. function:: mem_info([verbose])
 
@@ -81,9 +80,6 @@ Functions
    in a row and the lock-depth will increase, and then `heap_unlock()` must be
    called the same number of times to make the heap available again.
 
-   If the REPL becomes active with the heap locked then it will be forcefully
-   unlocked.
-
 .. function:: kbd_intr(chr)
 
    Set the character that will raise a `KeyboardInterrupt` exception.  By
@@ -118,12 +114,5 @@ Functions
    the heap may be locked) and scheduling a function to call later will lift
    those restrictions.
 
-   Note: If `schedule()` is called from a preempting IRQ, when memory
-   allocation is not allowed and the callback to be passed to `schedule()` is
-   a bound method, passing this directly will fail. This is because creating a
-   reference to a bound method causes memory allocation. A solution is to
-   create a reference to the method in the class constructor and to pass that
-   reference to `schedule()`.
-
-   There is a finite queue to hold the scheduled functions and `schedule()`
-   will raise a `RuntimeError` if the queue is full.
+   There is a finite stack to hold the scheduled functions and `schedule`
+   will raise a `RuntimeError` if the stack is full.

docs/library/network.rst

@@ -0,0 +1,277 @@
+****************************************
+:mod:`network` --- network configuration
+****************************************
+
+.. include:: ../templates/unsupported_in_circuitpython.inc
+
+.. module:: network
+   :synopsis: network configuration
+
+This module provides network drivers and routing configuration. To use this
+module, a MicroPython variant/build with network capabilities must be installed.
+Network drivers for specific hardware are available within this module and are
+used to configure hardware network interface(s). Network services provided
+by configured interfaces are then available for use via the :mod:`usocket`
+module.
+
+For example::
+
+    # connect/ show IP config a specific network interface
+    # see below for examples of specific drivers
+    import network
+    import utime
+    nic = network.Driver(...)
+    if not nic.isconnected():
+        nic.connect()
+        print("Waiting for connection...")
+        while not nic.isconnected():
+            utime.sleep(1)
+    print(nic.ifconfig())
+
+    # now use usocket as usual
+    import usocket as socket
+    addr = socket.getaddrinfo('micropython.org', 80)[0][-1]
+    s = socket.socket()
+    s.connect(addr)
+    s.send(b'GET / HTTP/1.1\r\nHost: micropython.org\r\n\r\n')
+    data = s.recv(1000)
+    s.close()
+
+Common network adapter interface
+================================
+
+This section describes an (implied) abstract base class for all network
+interface classes implemented by ``MicroPython ports <MicroPython port>``
+for different hardware. This means that MicroPython does not actually
+provide ``AbstractNIC`` class, but any actual NIC class, as described
+in the following sections, implements methods as described here.
+
+.. class:: AbstractNIC(id=None, ...)
+
+Instantiate a network interface object. Parameters are network interface
+dependent. If there are more than one interface of the same type, the first
+parameter should be `id`.
+
+    .. method:: active([is_active])
+
+        Activate ("up") or deactivate ("down") the network interface, if
+        a boolean argument is passed. Otherwise, query current state if
+        no argument is provided. Most other methods require an active
+        interface (behavior of calling them on inactive interface is
+        undefined).
+
+    .. method:: connect([service_id, key=None, \*, ...])
+
+       Connect the interface to a network. This method is optional, and
+       available only for interfaces which are not "always connected".
+       If no parameters are given, connect to the default (or the only)
+       service. If a single parameter is given, it is the primary identifier
+       of a service to connect to. It may be accompanied by a key
+       (password) required to access said service. There can be further
+       arbitrary keyword-only parameters, depending on the networking medium
+       type and/or particular device. Parameters can be used to: a)
+       specify alternative service identifer types; b) provide additional
+       connection parameters. For various medium types, there are different
+       sets of predefined/recommended parameters, among them:
+
+       * WiFi: *bssid* keyword to connect to a specific BSSID (MAC address)
+
+    .. method:: disconnect()
+
+       Disconnect from network.
+
+    .. method:: isconnected()
+
+       Returns ``True`` if connected to network, otherwise returns ``False``.
+
+    .. method:: scan(\*, ...)
+
+       Scan for the available network services/connections. Returns a
+       list of tuples with discovered service parameters. For various
+       network media, there are different variants of predefined/
+       recommended tuple formats, among them:
+
+       * WiFi: (ssid, bssid, channel, RSSI, authmode, hidden). There
+         may be further fields, specific to a particular device.
+
+       The function may accept additional keyword arguments to filter scan
+       results (e.g. scan for a particular service, on a particular channel,
+       for services of a particular set, etc.), and to affect scan
+       duration and other parameters. Where possible, parameter names
+       should match those in connect().
+
+    .. method:: status()
+
+       Return detailed status of the interface, values are dependent
+       on the network medium/technology.
+
+    .. method:: ifconfig([(ip, subnet, gateway, dns)])
+
+       Get/set IP-level network interface parameters: IP address, subnet mask,
+       gateway and DNS server. When called with no arguments, this method returns
+       a 4-tuple with the above information. To set the above values, pass a
+       4-tuple with the required information.  For example::
+
+        nic.ifconfig(('192.168.0.4', '255.255.255.0', '192.168.0.1', '8.8.8.8'))
+
+    .. method:: config('param')
+                config(param=value, ...)
+
+       Get or set general network interface parameters. These methods allow to work
+       with additional parameters beyond standard IP configuration (as dealt with by
+       `ifconfig()`). These include network-specific and hardware-specific
+       parameters and status values. For setting parameters, the keyword argument
+       syntax should be used, and multiple parameters can be set at once. For
+       querying, a parameter name should be quoted as a string, and only one
+       parameter can be queried at a time::
+
+        # Set WiFi access point name (formally known as ESSID) and WiFi channel
+        ap.config(essid='My AP', channel=11)
+        # Query params one by one
+        print(ap.config('essid'))
+        print(ap.config('channel'))
+        # Extended status information also available this way
+        print(sta.config('rssi'))
+
+.. _network.WLAN:
+
+Functions
+=========
+
+.. function:: phy_mode([mode])
+
+    Get or set the PHY mode.
+
+    If the *mode* parameter is provided, sets the mode to its value. If
+    the function is called without parameters, returns the current mode.
+
+    The possible modes are defined as constants:
+        * ``MODE_11B`` -- IEEE 802.11b,
+        * ``MODE_11G`` -- IEEE 802.11g,
+        * ``MODE_11N`` -- IEEE 802.11n.
+
+class WLAN
+==========
+
+This class provides a driver for WiFi network processor in the ESP8266.  Example usage::
+
+    import network
+    # enable station interface and connect to WiFi access point
+    nic = network.WLAN(network.STA_IF)
+    nic.active(True)
+    nic.connect('your-ssid', 'your-password')
+    # now use sockets as usual
+
+Constructors
+------------
+.. class:: WLAN(interface_id)
+
+Create a WLAN network interface object. Supported interfaces are
+``network.STA_IF`` (station aka client, connects to upstream WiFi access
+points) and ``network.AP_IF`` (access point, allows other WiFi clients to
+connect). Availability of the methods below depends on interface type.
+For example, only STA interface may `connect()` to an access point.
+
+Methods
+-------
+
+.. method:: wlan.active([is_active])
+
+    Activate ("up") or deactivate ("down") network interface, if boolean
+    argument is passed. Otherwise, query current state if no argument is
+    provided. Most other methods require active interface.
+
+.. method:: wlan.connect(ssid=None, password=None, \*, bssid=None)
+
+    Connect to the specified wireless network, using the specified password.
+    If *bssid* is given then the connection will be restricted to the
+    access-point with that MAC address (the *ssid* must also be specified
+    in this case).
+
+.. method:: wlan.disconnect()
+
+    Disconnect from the currently connected wireless network.
+
+.. method:: wlan.scan()
+
+    Scan for the available wireless networks.
+
+    Scanning is only possible on STA interface. Returns list of tuples with
+    the information about WiFi access points:
+
+        (ssid, bssid, channel, RSSI, authmode, hidden)
+
+    *bssid* is hardware address of an access point, in binary form, returned as
+    bytes object. You can use `ubinascii.hexlify()` to convert it to ASCII form.
+
+    There are five values for authmode:
+
+        * 0 -- open
+        * 1 -- WEP
+        * 2 -- WPA-PSK
+        * 3 -- WPA2-PSK
+        * 4 -- WPA/WPA2-PSK
+
+    and two for hidden:
+
+        * 0 -- visible
+        * 1 -- hidden
+
+.. method:: wlan.status()
+
+    Return the current status of the wireless connection.
+
+    The possible statuses are defined as constants:
+
+        * ``STAT_IDLE`` -- no connection and no activity,
+        * ``STAT_CONNECTING`` -- connecting in progress,
+        * ``STAT_WRONG_PASSWORD`` -- failed due to incorrect password,
+        * ``STAT_NO_AP_FOUND`` -- failed because no access point replied,
+        * ``STAT_CONNECT_FAIL`` -- failed due to other problems,
+        * ``STAT_GOT_IP`` -- connection successful.
+
+.. method:: wlan.isconnected()
+
+    In case of STA mode, returns ``True`` if connected to a WiFi access
+    point and has a valid IP address.  In AP mode returns ``True`` when a
+    station is connected. Returns ``False`` otherwise.
+
+.. method:: wlan.ifconfig([(ip, subnet, gateway, dns)])
+
+   Get/set IP-level network interface parameters: IP address, subnet mask,
+   gateway and DNS server. When called with no arguments, this method returns
+   a 4-tuple with the above information. To set the above values, pass a
+   4-tuple with the required information.  For example::
+
+    nic.ifconfig(('192.168.0.4', '255.255.255.0', '192.168.0.1', '8.8.8.8'))
+
+.. method:: wlan.config('param')
+.. method:: wlan.config(param=value, ...)
+
+   Get or set general network interface parameters. These methods allow to work
+   with additional parameters beyond standard IP configuration (as dealt with by
+   `wlan.ifconfig()`). These include network-specific and hardware-specific
+   parameters. For setting parameters, keyword argument syntax should be used,
+   multiple parameters can be set at once. For querying, parameters name should
+   be quoted as a string, and only one parameter can be queries at time::
+
+    # Set WiFi access point name (formally known as ESSID) and WiFi channel
+    ap.config(essid='My AP', channel=11)
+    # Query params one by one
+    print(ap.config('essid'))
+    print(ap.config('channel'))
+
+   Following are commonly supported parameters (availability of a specific parameter
+   depends on network technology type, driver, and ``MicroPython port``).
+
+   =============  ===========
+   Parameter      Description
+   =============  ===========
+   mac            MAC address (bytes)
+   essid          WiFi access point name (string)
+   channel        WiFi channel (integer)
+   hidden         Whether ESSID is hidden (boolean)
+   authmode       Authentication mode supported (enumeration, see module constants)
+   password       Access password (string)
+   dhcp_hostname  The DHCP hostname to use
+   =============  ===========

docs/library/re.rst

@@ -1,201 +0,0 @@
-:mod:`re` -- simple regular expressions
-========================================
-
-.. module:: re
-   :synopsis: regular expressions
-
-|see_cpython_module| :mod:`cpython:re`.
-
-This module implements regular expression operations. Regular expression
-syntax supported is a subset of CPython ``re`` module (and actually is
-a subset of POSIX extended regular expressions).
-
-Supported operators and special sequences are:
-
-``.``
-   Match any character.
-
-``[...]``
-   Match set of characters. Individual characters and ranges are supported,
-   including negated sets (e.g. ``[^a-c]``).
-
-``^``
-   Match the start of the string.
-
-``$``
-   Match the end of the string.
-
-``?``
-   Match zero or one of the previous sub-pattern.
-
-``*``
-   Match zero or more of the previous sub-pattern.
-
-``+``
-   Match one or more of the previous sub-pattern.
-
-``??``
-   Non-greedy version of ``?``, match zero or one, with the preference
-   for zero.
-
-``*?``
-   Non-greedy version of ``*``, match zero or more, with the preference
-   for the shortest match.
-
-``+?``
-   Non-greedy version of ``+``, match one or more, with the preference
-   for the shortest match.
-
-``|``
-   Match either the left-hand side or the right-hand side sub-patterns of
-   this operator.
-
-``(...)``
-   Grouping. Each group is capturing (a substring it captures can be accessed
-   with `match.group()` method).
-
-``\d``
-   Matches digit. Equivalent to ``[0-9]``.
-
-``\D``
-   Matches non-digit. Equivalent to ``[^0-9]``.
-
-``\s``
-   Matches whitespace. Equivalent to ``[ \t-\r]``.
-
-``\S``
-   Matches non-whitespace. Equivalent to ``[^ \t-\r]``.
-
-``\w``
-   Matches "word characters" (ASCII only). Equivalent to ``[A-Za-z0-9_]``.
-
-``\W``
-   Matches non "word characters" (ASCII only). Equivalent to ``[^A-Za-z0-9_]``.
-
-``\``
-   Escape character. Any other character following the backslash, except
-   for those listed above, is taken literally. For example, ``\*`` is
-   equivalent to literal ``*`` (not treated as the ``*`` operator).
-   Note that ``\r``, ``\n``, etc. are not handled specially, and will be
-   equivalent to literal letters ``r``, ``n``, etc. Due to this, it's
-   not recommended to use raw Python strings (``r""``) for regular
-   expressions. For example, ``r"\r\n"`` when used as the regular
-   expression is equivalent to ``"rn"``. To match CR character followed
-   by LF, use ``"\r\n"``.
-
-**NOT SUPPORTED**:
-
-* counted repetitions (``{m,n}``)
-* named groups (``(?P<name>...)``)
-* non-capturing groups (``(?:...)``)
-* more advanced assertions (``\b``, ``\B``)
-* special character escapes like ``\r``, ``\n`` - use Python's own escaping
-  instead
-* etc.
-
-Example::
-
-    import ure
-
-    # As ure doesn't support escapes itself, use of r"" strings is not
-    # recommended.
-    regex = ure.compile("[\r\n]")
-
-    regex.split("line1\rline2\nline3\r\n")
-
-    # Result:
-    # ['line1', 'line2', 'line3', '', '']
-
-Functions
----------
-
-.. function:: compile(regex_str, [flags])
-
-   Compile regular expression, return `regex <regex>` object.
-
-.. function:: match(regex_str, string)
-
-   Compile *regex_str* and match against *string*. Match always happens
-   from starting position in a string.
-
-.. function:: search(regex_str, string)
-
-   Compile *regex_str* and search it in a *string*. Unlike `match`, this will search
-   string for first position which matches regex (which still may be
-   0 if regex is anchored).
-
-.. function:: sub(regex_str, replace, string, count=0, flags=0)
-
-   Compile *regex_str* and search for it in *string*, replacing all matches
-   with *replace*, and returning the new string.
-
-   *replace* can be a string or a function.  If it is a string then escape
-   sequences of the form ``\<number>`` and ``\g<number>`` can be used to
-   expand to the corresponding group (or an empty string for unmatched groups).
-   If *replace* is a function then it must take a single argument (the match)
-   and should return a replacement string.
-
-   If *count* is specified and non-zero then substitution will stop after
-   this many substitutions are made.  The *flags* argument is ignored.
-
-   Note: availability of this function depends on MicroPython port.
-
-.. data:: DEBUG
-
-   Flag value, display debug information about compiled expression.
-
-
-.. _regex:
-
-Regex objects
--------------
-
-Compiled regular expression. Instances of this class are created using
-`re.compile()`.
-
-.. method:: regex.match(string)
-            regex.search(string)
-            regex.sub(replace, string, count=0, flags=0)
-
-   Similar to the module-level functions :meth:`match`, :meth:`search`
-   and :meth:`sub`.
-   Using methods is (much) more efficient if the same regex is applied to
-   multiple strings.
-
-.. method:: regex.split(string, max_split=-1)
-
-   Split a *string* using regex. If *max_split* is given, it specifies
-   maximum number of splits to perform. Returns list of strings (there
-   may be up to *max_split+1* elements if it's specified).
-
-Match objects
--------------
-
-Match objects as returned by `match()` and `search()` methods, and passed
-to the replacement function in `sub()`.
-
-.. method:: match.group(index)
-
-   Return matching (sub)string. *index* is 0 for entire match,
-   1 and above for each capturing group. Only numeric groups are supported.
-
-.. method:: match.groups()
-
-   Return a tuple containing all the substrings of the groups of the match.
-
-   Note: availability of this method depends on MicroPython port.
-
-.. method:: match.start([index])
-            match.end([index])
-
-   Return the index in the original string of the start or end of the
-   substring group that was matched.  *index* defaults to the entire
-   group, otherwise it will select a group.
-
-   Note: availability of these methods depends on MicroPython port.
-
-.. method:: match.span([index])
-
-   Returns the 2-tuple ``(match.start(index), match.end(index))``.
-
-   Note: availability of this method depends on MicroPython port.

docs/library/sys.rst

@@ -17,19 +17,6 @@ Functions
    function raise as `SystemExit` exception. If an argument is given, its
    value given as an argument to `SystemExit`.
 
-.. function:: atexit(func)
-
-   Register *func* to be called upon termination.  *func* must be a callable
-   that takes no arguments, or ``None`` to disable the call.  The ``atexit``
-   function will return the previous value set by this function, which is
-   initially ``None``.
-
-   .. admonition:: Difference to CPython
-      :class: attention
-
-      This function is a MicroPython extension intended to provide similar
-      functionality to the :mod:`atexit` module in CPython.
-
 .. function:: print_exception(exc, file=sys.stdout)
 
    Print exception with a traceback to a file-like object *file* (or
@@ -58,12 +45,12 @@ Constants
 .. data:: implementation
 
    Object with information about the current Python implementation. For
-   CircuitPython, it has following attributes:
+   MicroPython, it has following attributes:
 
-   * *name* - string "circuitpython"
+   * *name* - string "micropython"
    * *version* - tuple (major, minor, micro), e.g. (1, 7, 0)
 
-   This object is the recommended way to distinguish CircuitPython from other
+   This object is the recommended way to distinguish MicroPython from other
    Python implementations (note that it still may not exist in the very
    minimal ports).
 
@@ -71,13 +58,13 @@ Constants
       :class: attention
 
       CPython mandates more attributes for this object, but the actual useful
-      bare minimum is implemented in CircuitPython.
+      bare minimum is implemented in MicroPython.
 
 .. data:: maxsize
 
    Maximum value which a native integer type can hold on the current platform,
-   or maximum value representable by CircuitPython integer type, if it's smaller
-   than platform max value (that is the case for CircuitPython ports without
+   or maximum value representable by MicroPython integer type, if it's smaller
+   than platform max value (that is the case for MicroPython ports without
    long int support).
 
    This attribute is useful for detecting "bitness" of a platform (32-bit vs
@@ -109,24 +96,24 @@ Constants
 
 .. data:: platform
 
-   The platform that CircuitPython is running on. For OS/RTOS ports, this is
+   The platform that MicroPython is running on. For OS/RTOS ports, this is
    usually an identifier of the OS, e.g. ``"linux"``. For baremetal ports it
-   is an identifier of the chip on a board, e.g. ``"MicroChip SAMD51"``.
-   It thus can be used to distinguish one board from another.
-   If you need to check whether your program runs on CircuitPython (vs other
+   is an identifier of a board, e.g. ``"pyboard"`` for the original MicroPython
+   reference board. It thus can be used to distinguish one board from another.
+   If you need to check whether your program runs on MicroPython (vs other
    Python implementation), use `sys.implementation` instead.
 
 .. data:: stderr
 
-   Standard error ``stream``.
+   Standard error stream.
 
 .. data:: stdin
 
-   Standard input ``stream``.
+   Standard input stream.
 
 .. data:: stdout
 
-   Standard output ``stream``.
+   Standard output stream.
 
 .. data:: version
 
@@ -135,9 +122,3 @@ Constants
 .. data:: version_info
 
    Python language version that this implementation conforms to, as a tuple of ints.
-
-    .. admonition:: Difference to CPython
-      :class: attention
-
-      Only the first three version numbers (major, minor, micro) are supported and
-      they can be referenced only by index, not by name.

docs/library/ubinascii.rst

@@ -0,0 +1,42 @@
+:mod:`ubinascii` -- binary/ASCII conversions
+============================================
+
+.. include:: ../templates/unsupported_in_circuitpython.inc
+
+.. module:: ubinascii
+   :synopsis: binary/ASCII conversions
+
+|see_cpython_module| :mod:`cpython:binascii`.
+
+This module implements conversions between binary data and various
+encodings of it in ASCII form (in both directions).
+
+Functions
+---------
+
+.. function:: hexlify(data, [sep])
+
+   Convert binary data to hexadecimal representation. Returns bytes string.
+
+   .. admonition:: Difference to CPython
+      :class: attention
+
+      If additional argument, *sep* is supplied, it is used as a separator
+      between hexadecimal values.
+
+.. function:: unhexlify(data)
+
+   Convert hexadecimal data to binary representation. Returns bytes string.
+   (i.e. inverse of hexlify)
+
+.. function:: a2b_base64(data)
+
+   Decode base64-encoded data, ignoring invalid characters in the input.
+   Conforms to `RFC 2045 s.6.8 <https://tools.ietf.org/html/rfc2045#section-6.8>`_.
+   Returns a bytes object.
+
+.. function:: b2a_base64(data)
+
+   Encode binary data in base64 format, as in `RFC 3548
+   <https://tools.ietf.org/html/rfc3548.html>`_. Returns the encoded data
+   followed by a newline character, as a bytes object.

docs/library/ucollections.rst

@@ -0,0 +1,57 @@
+:mod:`ucollections` -- collection and container types
+=====================================================
+
+.. include:: ../templates/unsupported_in_circuitpython.inc
+
+.. module:: ucollections
+   :synopsis: collection and container types
+
+|see_cpython_module| :mod:`cpython:collections`.
+
+This module implements advanced collection and container types to
+hold/accumulate various objects.
+
+Classes
+-------
+
+.. function:: namedtuple(name, fields)
+
+    This is factory function to create a new namedtuple type with a specific
+    name and set of fields. A namedtuple is a subclass of tuple which allows
+    to access its fields not just by numeric index, but also with an attribute
+    access syntax using symbolic field names. Fields is a sequence of strings
+    specifying field names. For compatibility with CPython it can also be a
+    a string with space-separated field named (but this is less efficient).
+    Example of use::
+
+        from ucollections import namedtuple
+
+        MyTuple = namedtuple("MyTuple", ("id", "name"))
+        t1 = MyTuple(1, "foo")
+        t2 = MyTuple(2, "bar")
+        print(t1.name)
+        assert t2.name == t2[1]
+
+.. function:: OrderedDict(...)
+
+    ``dict`` type subclass which remembers and preserves the order of keys
+    added. When ordered dict is iterated over, keys/items are returned in
+    the order they were added::
+
+        from ucollections import OrderedDict
+
+        # To make benefit of ordered keys, OrderedDict should be initialized
+        # from sequence of (key, value) pairs.
+        d = OrderedDict([("z", 1), ("a", 2)])
+        # More items can be added as usual
+        d["w"] = 5
+        d["b"] = 3
+        for k, v in d.items():
+            print(k, v)
+
+    Output::
+
+        z 1
+        a 2
+        w 5
+        b 3

docs/library/uctypes.rst

@@ -10,173 +10,98 @@ This module implements "foreign data interface" for MicroPython. The idea
 behind it is similar to CPython's ``ctypes`` modules, but the actual API is
 different, streamlined and optimized for small size. The basic idea of the
 module is to define data structure layout with about the same power as the
-C language allows, and then access it using familiar dot-syntax to reference
+C language allows, and the access it using familiar dot-syntax to reference
 sub-fields.
 
-.. warning::
-
-    ``uctypes`` module allows access to arbitrary memory addresses of the
-    machine (including I/O and control registers). Uncareful usage of it
-    may lead to crashes, data loss, and even hardware malfunction.
-
 .. seealso::
 
     Module :mod:`struct`
         Standard Python way to access binary data structures (doesn't scale
         well to large and complex structures).
 
-Usage examples::
-
-    import uctypes
-
-    # Example 1: Subset of ELF file header
-    # https://wikipedia.org/wiki/Executable_and_Linkable_Format#File_header
-    ELF_HEADER = {
-        "EI_MAG": (0x0 | uctypes.ARRAY, 4 | uctypes.UINT8),
-        "EI_DATA": 0x5 | uctypes.UINT8,
-        "e_machine": 0x12 | uctypes.UINT16,
-    }
-
-    # "f" is an ELF file opened in binary mode
-    buf = f.read(uctypes.sizeof(ELF_HEADER, uctypes.LITTLE_ENDIAN))
-    header = uctypes.struct(uctypes.addressof(buf), ELF_HEADER, uctypes.LITTLE_ENDIAN)
-    assert header.EI_MAG == b"\x7fELF"
-    assert header.EI_DATA == 1, "Oops, wrong endianness. Could retry with uctypes.BIG_ENDIAN."
-    print("machine:", hex(header.e_machine))
-
-
-    # Example 2: In-memory data structure, with pointers
-    COORD = {
-        "x": 0 | uctypes.FLOAT32,
-        "y": 4 | uctypes.FLOAT32,
-    }
-
-    STRUCT1 = {
-        "data1": 0 | uctypes.UINT8,
-        "data2": 4 | uctypes.UINT32,
-        "ptr": (8 | uctypes.PTR, COORD),
-    }
-
-    # Suppose you have address of a structure of type STRUCT1 in "addr"
-    # uctypes.NATIVE is optional (used by default)
-    struct1 = uctypes.struct(addr, STRUCT1, uctypes.NATIVE)
-    print("x:", struct1.ptr[0].x)
-
-
-    # Example 3: Access to CPU registers. Subset of STM32F4xx WWDG block
-    WWDG_LAYOUT = {
-        "WWDG_CR": (0, {
-            # BFUINT32 here means size of the WWDG_CR register
-            "WDGA": 7 << uctypes.BF_POS | 1 << uctypes.BF_LEN | uctypes.BFUINT32,
-            "T": 0 << uctypes.BF_POS | 7 << uctypes.BF_LEN | uctypes.BFUINT32,
-        }),
-        "WWDG_CFR": (4, {
-            "EWI": 9 << uctypes.BF_POS | 1 << uctypes.BF_LEN | uctypes.BFUINT32,
-            "WDGTB": 7 << uctypes.BF_POS | 2 << uctypes.BF_LEN | uctypes.BFUINT32,
-            "W": 0 << uctypes.BF_POS | 7 << uctypes.BF_LEN | uctypes.BFUINT32,
-        }),
-    }
-
-    WWDG = uctypes.struct(0x40002c00, WWDG_LAYOUT)
-
-    WWDG.WWDG_CFR.WDGTB = 0b10
-    WWDG.WWDG_CR.WDGA = 1
-    print("Current counter:", WWDG.WWDG_CR.T)
-
 Defining structure layout
 -------------------------
 
 Structure layout is defined by a "descriptor" - a Python dictionary which
 encodes field names as keys and other properties required to access them as
-associated values::
-
-    {
-        "field1": <properties>,
-        "field2": <properties>,
-        ...
-    }
-
-Currently, ``uctypes`` requires explicit specification of offsets for each
-field. Offset are given in bytes from the structure start.
+associated values. Currently, uctypes requires explicit specification of
+offsets for each field. Offset are given in bytes from a structure start.
 
 Following are encoding examples for various field types:
 
 * Scalar types::
 
-    "field_name": offset | uctypes.UINT32
+    "field_name": uctypes.UINT32 | 0
 
-  in other words, the value is a scalar type identifier ORed with a field offset
+  in other words, value is scalar type identifier ORed with field offset
   (in bytes) from the start of the structure.
 
 * Recursive structures::
 
-    "sub": (offset, {
-        "b0": 0 | uctypes.UINT8,
-        "b1": 1 | uctypes.UINT8,
+    "sub": (2, {
+        "b0": uctypes.UINT8 | 0,
+        "b1": uctypes.UINT8 | 1,
     })
 
-  i.e. value is a 2-tuple, first element of which is an offset, and second is
+  i.e. value is a 2-tuple, first element of which is offset, and second is
   a structure descriptor dictionary (note: offsets in recursive descriptors
-  are relative to the structure it defines). Of course, recursive structures
-  can be specified not just by a literal dictionary, but by referring to a
-  structure descriptor dictionary (defined earlier) by name.
+  are relative to a structure it defines).
 
 * Arrays of primitive types::
 
-      "arr": (offset | uctypes.ARRAY, size | uctypes.UINT8),
+      "arr": (uctypes.ARRAY | 0, uctypes.UINT8 | 2),
 
   i.e. value is a 2-tuple, first element of which is ARRAY flag ORed
   with offset, and second is scalar element type ORed number of elements
-  in the array.
+  in array.
 
 * Arrays of aggregate types::
 
-    "arr2": (offset | uctypes.ARRAY, size, {"b": 0 | uctypes.UINT8}),
+    "arr2": (uctypes.ARRAY | 0, 2, {"b": uctypes.UINT8 | 0}),
 
   i.e. value is a 3-tuple, first element of which is ARRAY flag ORed
-  with offset, second is a number of elements in the array, and third is
-  a descriptor of element type.
+  with offset, second is a number of elements in array, and third is
+  descriptor of element type.
 
 * Pointer to a primitive type::
 
-    "ptr": (offset | uctypes.PTR, uctypes.UINT8),
+    "ptr": (uctypes.PTR | 0, uctypes.UINT8),
 
   i.e. value is a 2-tuple, first element of which is PTR flag ORed
-  with offset, and second is a scalar element type.
+  with offset, and second is scalar element type.
 
 * Pointer to an aggregate type::
 
-    "ptr2": (offset | uctypes.PTR, {"b": 0 | uctypes.UINT8}),
+    "ptr2": (uctypes.PTR | 0, {"b": uctypes.UINT8 | 0}),
 
   i.e. value is a 2-tuple, first element of which is PTR flag ORed
-  with offset, second is a descriptor of type pointed to.
+  with offset, second is descriptor of type pointed to.
 
 * Bitfields::
 
-    "bitf0": offset | uctypes.BFUINT16 | lsbit << uctypes.BF_POS | bitsize << uctypes.BF_LEN,
+    "bitf0": uctypes.BFUINT16 | 0 | 0 << uctypes.BF_POS | 8 << uctypes.BF_LEN,
 
-  i.e. value is a type of scalar value containing given bitfield (typenames are
-  similar to scalar types, but prefixes with ``BF``), ORed with offset for
+  i.e. value is type of scalar value containing given bitfield (typenames are
+  similar to scalar types, but prefixes with "BF"), ORed with offset for
   scalar value containing the bitfield, and further ORed with values for
-  bit position and bit length of the bitfield within the scalar value, shifted by
-  BF_POS and BF_LEN bits, respectively. A bitfield position is counted
-  from the least significant bit of the scalar (having position of 0), and
-  is the number of right-most bit of a field (in other words, it's a number
-  of bits a scalar needs to be shifted right to extract the bitfield).
+  bit offset and bit length of the bitfield within scalar value, shifted by
+  BF_POS and BF_LEN positions, respectively. Bitfield position is counted
+  from the least significant bit, and is the number of right-most bit of a
+  field (in other words, it's a number of bits a scalar needs to be shifted
+  right to extra the bitfield).
 
-  In the example above, first a UINT16 value will be extracted at offset 0
+  In the example above, first UINT16 value will be extracted at offset 0
   (this detail may be important when accessing hardware registers, where
   particular access size and alignment are required), and then bitfield
-  whose rightmost bit is *lsbit* bit of this UINT16, and length
-  is *bitsize* bits, will be extracted. For example, if *lsbit* is 0 and
-  *bitsize* is 8, then effectively it will access least-significant byte
-  of UINT16.
+  whose rightmost bit is least-significant bit of this UINT16, and length
+  is 8 bits, will be extracted - effectively, this will access
+  least-significant byte of UINT16.
 
   Note that bitfield operations are independent of target byte endianness,
   in particular, example above will access least-significant byte of UINT16
   in both little- and big-endian structures. But it depends on the least
   significant bit being numbered 0. Some targets may use different
-  numbering in their native ABI, but ``uctypes`` always uses the normalized
+  numbering in their native ABI, but ``uctypes`` always uses normalized
   numbering described above.
 
 Module contents
@@ -202,11 +127,10 @@ Module contents
    Layout type for a native structure - with data endianness and alignment
    conforming to the ABI of the system on which MicroPython runs.
 
-.. function:: sizeof(struct, layout_type=NATIVE)
+.. function:: sizeof(struct)
 
-   Return size of data structure in bytes. The *struct* argument can be
-   either a structure class or a specific instantiated structure object
-   (or its aggregate field).
+   Return size of data structure in bytes. Argument can be either structure
+   class or specific instantiated structure object (or its aggregate field).
 
 .. function:: addressof(obj)
 
@@ -228,35 +152,6 @@ Module contents
    so it can be both written too, and you will access current value
    at the given memory address.
 
-.. data:: UINT8
-          INT8
-          UINT16
-          INT16
-          UINT32
-          INT32
-          UINT64
-          INT64
-
-   Integer types for structure descriptors. Constants for 8, 16, 32,
-   and 64 bit types are provided, both signed and unsigned.
-
-.. data:: FLOAT32
-          FLOAT64
-
-   Floating-point types for structure descriptors.
-
-.. data:: VOID
-
-   ``VOID`` is an alias for ``UINT8``, and is provided to conviniently define
-   C's void pointers: ``(uctypes.PTR, uctypes.VOID)``.
-
-.. data:: PTR
-          ARRAY
-
-   Type constants for pointers and arrays. Note that there is no explicit
-   constant for structures, it's implicit: an aggregate type without ``PTR``
-   or ``ARRAY`` flags is a structure.
-
 Structure descriptors and instantiating structure objects
 ---------------------------------------------------------
 
@@ -269,7 +164,7 @@ following sources:
   system. Lookup these addresses in datasheet for a particular MCU/SoC.
 * As a return value from a call to some FFI (Foreign Function Interface)
   function.
-* From `uctypes.addressof()`, when you want to pass arguments to an FFI
+* From uctypes.addressof(), when you want to pass arguments to an FFI
   function, or alternatively, to access some data for I/O (for example,
   data read from a file or network socket).
 
@@ -287,41 +182,30 @@ the standard subscript operator ``[]`` - both read and assigned to.
 
 If a field is a pointer, it can be dereferenced using ``[0]`` syntax
 (corresponding to C ``*`` operator, though ``[0]`` works in C too).
-Subscripting a pointer with other integer values but 0 are also supported,
+Subscripting a pointer with other integer values but 0 are supported too,
 with the same semantics as in C.
 
-Summing up, accessing structure fields generally follows the C syntax,
+Summing up, accessing structure fields generally follows C syntax,
 except for pointer dereference, when you need to use ``[0]`` operator
 instead of ``*``.
 
 Limitations
 -----------
 
-1. Accessing non-scalar fields leads to allocation of intermediate objects
+Accessing non-scalar fields leads to allocation of intermediate objects
 to represent them. This means that special care should be taken to
 layout a structure which needs to be accessed when memory allocation
 is disabled (e.g. from an interrupt). The recommendations are:
 
-* Avoid accessing nested structures. For example, instead of
+* Avoid nested structures. For example, instead of
   ``mcu_registers.peripheral_a.register1``, define separate layout
   descriptors for each peripheral, to be accessed as
-  ``peripheral_a.register1``. Or just cache a particular peripheral:
-  ``peripheral_a = mcu_registers.peripheral_a``. If a register
-  consists of multiple bitfields, you would need to cache references
-  to a particular register: ``reg_a = mcu_registers.peripheral_a.reg_a``.
-* Avoid other non-scalar data, like arrays. For example, instead of
-  ``peripheral_a.register[0]`` use ``peripheral_a.register0``. Again,
-  an alternative is to cache intermediate values, e.g.
-  ``register0 = peripheral_a.register[0]``.
+  ``peripheral_a.register1``.
+* Avoid other non-scalar data, like array. For example, instead of
+  ``peripheral_a.register[0]`` use ``peripheral_a.register0``.
 
-2. Range of offsets supported by the ``uctypes`` module is limited.
-The exact range supported is considered an implementation detail,
-and the general suggestion is to split structure definitions to
-cover from a few kilobytes to a few dozen of kilobytes maximum.
-In most cases, this is a natural situation anyway, e.g. it doesn't make
-sense to define all registers of an MCU (spread over 32-bit address
-space) in one structure, but rather a peripheral block by peripheral
-block. In some extreme cases, you may need to split a structure in
-several parts artificially (e.g. if accessing native data structure
-with multi-megabyte array in the middle, though that would be a very
-synthetic case).
+Note that these recommendations will lead to decreased readability
+and conciseness of layouts, so they should be used only if the need
+to access structure fields without allocation is anticipated (it's
+even possible to define 2 parallel layouts - one for normal usage,
+and a restricted one to use when memory allocation is prohibited).

docs/library/uerrno.rst

@@ -0,0 +1,34 @@
+:mod:`uerrno` -- system error codes
+===================================
+
+.. include:: ../templates/unsupported_in_circuitpython.inc
+
+.. module:: uerrno
+   :synopsis: system error codes
+
+|see_cpython_module| :mod:`cpython:errno`.
+
+This module provides access to symbolic error codes for `OSError` exception.
+
+Constants
+---------
+
+.. data:: EEXIST, EAGAIN, etc.
+
+    Error codes, based on ANSI C/POSIX standard. All error codes start with
+    "E". Errors are usually accessible as ``exc.args[0]``
+    where ``exc`` is an instance of `OSError`. Usage example::
+
+        try:
+            os.mkdir("my_dir")
+        except OSError as exc:
+            if exc.args[0] == uerrno.EEXIST:
+                print("Directory already exists")
+
+.. data:: errorcode
+
+    Dictionary mapping numeric error codes to strings with symbolic error
+    code (see above)::
+
+        >>> print(uerrno.errorcode[uerrno.EEXIST])
+        EEXIST

docs/library/uhashlib.rst

@@ -0,0 +1,59 @@
+:mod:`uhashlib` -- hashing algorithms
+=====================================
+
+.. include:: ../templates/unsupported_in_circuitpython.inc
+
+.. module:: uhashlib
+   :synopsis: hashing algorithms
+
+|see_cpython_module| :mod:`cpython:hashlib`.
+
+This module implements binary data hashing algorithms. The exact inventory
+of available algorithms depends on a board. Among the algorithms which may
+be implemented:
+
+* SHA256 - The current generation, modern hashing algorithm (of SHA2 series).
+  It is suitable for cryptographically-secure purposes. Included in the
+  MicroPython core and any board is recommended to provide this, unless
+  it has particular code size constraints.
+
+* SHA1 - A previous generation algorithm. Not recommended for new usages,
+  but SHA1 is a part of number of Internet standards and existing
+  applications, so boards targeting network connectivity and
+  interoperatiability will try to provide this.
+
+* MD5 - A legacy algorithm, not considered cryptographically secure. Only
+  selected boards, targeting interoperatibility with legacy applications,
+  will offer this.
+
+Constructors
+------------
+
+.. class:: uhashlib.sha256([data])
+
+    Create an SHA256 hasher object and optionally feed ``data`` into it.
+
+.. class:: uhashlib.sha1([data])
+
+    Create an SHA1 hasher object and optionally feed ``data`` into it.
+
+.. class:: uhashlib.md5([data])
+
+    Create an MD5 hasher object and optionally feed ``data`` into it.
+
+Methods
+-------
+
+.. method:: hash.update(data)
+
+   Feed more binary data into hash.
+
+.. method:: hash.digest()
+
+   Return hash for all data passed through hash, as a bytes object. After this
+   method is called, more data cannot be fed into the hash any longer.
+
+.. method:: hash.hexdigest()
+
+   This method is NOT implemented. Use ``ubinascii.hexlify(hash.digest())``
+   to achieve a similar effect.

docs/library/uio.rst

@@ -0,0 +1,116 @@
+:mod:`uio` -- input/output streams
+==================================
+
+.. include:: ../templates/unsupported_in_circuitpython.inc
+
+.. module:: uio
+   :synopsis: input/output streams
+
+|see_cpython_module| :mod:`cpython:io`.
+
+This module contains additional types of stream (file-like) objects
+and helper functions.
+
+Conceptual hierarchy
+--------------------
+
+.. admonition:: Difference to CPython
+   :class: attention
+
+   Conceptual hierarchy of stream base classes is simplified in MicroPython,
+   as described in this section.
+
+(Abstract) base stream classes, which serve as a foundation for behavior
+of all the concrete classes, adhere to few dichotomies (pair-wise
+classifications) in CPython. In MicroPython, they are somewhat simplified
+and made implicit to achieve higher efficiencies and save resources.
+
+An important dichotomy in CPython is unbuffered vs buffered streams. In
+MicroPython, all streams are currently unbuffered. This is because all
+modern OSes, and even many RTOSes and filesystem drivers already perform
+buffering on their side. Adding another layer of buffering is counter-
+productive (an issue known as "bufferbloat") and takes precious memory.
+Note that there still cases where buffering may be useful, so we may
+introduce optional buffering support at a later time.
+
+But in CPython, another important dichotomy is tied with "bufferedness" -
+it's whether a stream may incur short read/writes or not. A short read
+is when a user asks e.g. 10 bytes from a stream, but gets less, similarly
+for writes. In CPython, unbuffered streams are automatically short
+operation susceptible, while buffered are guarantee against them. The
+no short read/writes is an important trait, as it allows to develop
+more concise and efficient programs - something which is highly desirable
+for MicroPython. So, while MicroPython doesn't support buffered streams,
+it still provides for no-short-operations streams. Whether there will
+be short operations or not depends on each particular class' needs, but
+developers are strongly advised to favor no-short-operations behavior
+for the reasons stated above. For example, MicroPython sockets are
+guaranteed to avoid short read/writes. Actually, at this time, there is
+no example of a short-operations stream class in the core, and one would
+be a port-specific class, where such a need is governed by hardware
+peculiarities.
+
+The no-short-operations behavior gets tricky in case of non-blocking
+streams, blocking vs non-blocking behavior being another CPython dichotomy,
+fully supported by MicroPython. Non-blocking streams never wait for
+data either to arrive or be written - they read/write whatever possible,
+or signal lack of data (or ability to write data). Clearly, this conflicts
+with "no-short-operations" policy, and indeed, a case of non-blocking
+buffered (and this no-short-ops) streams is convoluted in CPython - in
+some places, such combination is prohibited, in some it's undefined or
+just not documented, in some cases it raises verbose exceptions. The
+matter is much simpler in MicroPython: non-blocking stream are important
+for efficient asynchronous operations, so this property prevails on
+the "no-short-ops" one. So, while blocking streams will avoid short
+reads/writes whenever possible (the only case to get a short read is
+if end of file is reached, or in case of error (but errors don't
+return short data, but raise exceptions)), non-blocking streams may
+produce short data to avoid blocking the operation.
+
+The final dichotomy is binary vs text streams. MicroPython of course
+supports these, but while in CPython text streams are inherently
+buffered, they aren't in MicroPython. (Indeed, that's one of the cases
+for which we may introduce buffering support.)
+
+Note that for efficiency, MicroPython doesn't provide abstract base
+classes corresponding to the hierarchy above, and it's not possible
+to implement, or subclass, a stream class in pure Python.
+
+Functions
+---------
+
+.. function:: open(name, mode='r', **kwargs)
+
+    Open a file. Builtin ``open()`` function is aliased to this function.
+    All ports (which provide access to file system) are required to support
+    ``mode`` parameter, but support for other arguments vary by port.
+
+Classes
+-------
+
+.. class:: FileIO(...)
+
+    This is type of a file open in binary mode, e.g. using ``open(name, "rb")``.
+    You should not instantiate this class directly.
+
+.. class:: TextIOWrapper(...)
+
+    This is type of a file open in text mode, e.g. using ``open(name, "rt")``.
+    You should not instantiate this class directly.
+
+.. class:: StringIO([string])
+.. class:: BytesIO([string])
+
+    In-memory file-like objects for input/output. `StringIO` is used for
+    text-mode I/O (similar to a normal file opened with "t" modifier).
+    `BytesIO` is used for binary-mode I/O (similar to a normal file
+    opened with "b" modifier). Initial contents of file-like objects
+    can be specified with `string` parameter (should be normal string
+    for `StringIO` or bytes object for `BytesIO`). All the usual file
+    methods like ``read()``, ``write()``, ``seek()``, ``flush()``,
+    ``close()`` are available on these objects, and additionally, a
+    following method:
+
+    .. method:: getvalue()
+
+        Get the current contents of the underlying buffer which holds data.

docs/library/ujson.rst

@@ -0,0 +1,24 @@
+:mod:`ujson` -- JSON encoding and decoding
+==========================================
+
+.. include:: ../templates/unsupported_in_circuitpython.inc
+
+.. module:: ujson
+   :synopsis: JSON encoding and decoding
+
+|see_cpython_module| :mod:`cpython:json`.
+
+This modules allows to convert between Python objects and the JSON
+data format.
+
+Functions
+---------
+
+.. function:: dumps(obj)
+
+   Return ``obj`` represented as a JSON string.
+
+.. function:: loads(str)
+
+   Parse the JSON ``str`` and return an object.  Raises ValueError if the
+   string is not correctly formed.

docs/library/ure.rst

@@ -0,0 +1,101 @@
+:mod:`ure` -- simple regular expressions
+========================================
+
+.. include:: ../templates/unsupported_in_circuitpython.inc
+
+.. module:: ure
+   :synopsis: regular expressions
+
+|see_cpython_module| :mod:`cpython:re`.
+
+This module implements regular expression operations. Regular expression
+syntax supported is a subset of CPython ``re`` module (and actually is
+a subset of POSIX extended regular expressions).
+
+Supported operators are:
+
+``'.'``
+   Match any character.
+
+``'[]'``
+   Match set of characters. Individual characters and ranges are supported.
+
+``'^'``
+
+``'$'``
+
+``'?'``
+
+``'*'``
+
+``'+'``
+
+``'??'``
+
+``'*?'``
+
+``'+?'``
+
+``'|'``
+
+``'()'``
+   Grouping. Each group is capturing (a substring it captures can be accessed
+   with `match.group()` method).
+
+Counted repetitions (``{m,n}``), more advanced assertions, named groups,
+etc. are not supported.
+
+
+Functions
+---------
+
+.. function:: compile(regex_str)
+
+   Compile regular expression, return `regex <regex>` object.
+
+.. function:: match(regex_str, string)
+
+   Compile *regex_str* and match against *string*. Match always happens
+   from starting position in a string.
+
+.. function:: search(regex_str, string)
+
+   Compile *regex_str* and search it in a *string*. Unlike `match`, this will search
+   string for first position which matches regex (which still may be
+   0 if regex is anchored).
+
+.. data:: DEBUG
+
+   Flag value, display debug information about compiled expression.
+
+
+.. _regex:
+
+Regex objects
+-------------
+
+Compiled regular expression. Instances of this class are created using
+`ure.compile()`.
+
+.. method:: regex.match(string)
+            regex.search(string)
+
+   Similar to the module-level functions :meth:`match` and :meth:`search`.
+   Using methods is (much) more efficient if the same regex is applied to
+   multiple strings.
+
+.. method:: regex.split(string, max_split=-1)
+
+   Split a *string* using regex. If *max_split* is given, it specifies
+   maximum number of splits to perform. Returns list of strings (there
+   may be up to *max_split+1* elements if it's specified).
+
+Match objects
+-------------
+
+Match objects as returned by `match()` and `search()` methods.
+
+.. method:: match.group([index])
+
+   Return matching (sub)string. *index* is 0 for entire match,
+   1 and above for each capturing group. Only numeric groups are supported.

docs/library/uselect.rst

@@ -9,7 +9,7 @@
 |see_cpython_module| :mod:`cpython:select`.
 
 This module provides functions to efficiently wait for events on multiple
-``stream`` objects (select streams which are ready for operations).
+streams (select streams which are ready for operations).
 
 Functions
 ---------
@@ -35,21 +35,14 @@ Methods
 
 .. method:: poll.register(obj[, eventmask])
 
-   Register ``stream`` *obj* for polling. *eventmask* is logical OR of:
+   Register *obj* for polling. *eventmask* is logical OR of:
 
-   * ``uselect.POLLIN``  - data available for reading
-   * ``uselect.POLLOUT`` - more data can be written
+   * ``select.POLLIN``  - data available for reading
+   * ``select.POLLOUT`` - more data can be written
+   * ``select.POLLERR`` - error occurred
+   * ``select.POLLHUP`` - end of stream/connection termination detected
 
-   Note that flags like ``uselect.POLLHUP`` and ``uselect.POLLERR`` are
-   *not* valid as input eventmask (these are unsolicited events which
-   will be returned from `poll()` regardless of whether they are asked
-   for). This semantics is per POSIX.
-
-   *eventmask* defaults to ``uselect.POLLIN | uselect.POLLOUT``.
-
-   It is OK to call this function multiple times for the same *obj*.
-   Successive calls will update *obj*'s eventmask to the value of
-   *eventmask* (i.e. will behave as `modify()`).
+   *eventmask* defaults to ``select.POLLIN | select.POLLOUT``.
 
 .. method:: poll.unregister(obj)
 
@@ -57,26 +50,18 @@ Methods
 
 .. method:: poll.modify(obj, eventmask)
 
-   Modify the *eventmask* for *obj*. If *obj* is not registered, `OSError`
-   is raised with error of ENOENT.
+   Modify the *eventmask* for *obj*.
 
-.. method:: poll.poll(timeout=-1)
+.. method:: poll.poll([timeout])
 
-   Wait for at least one of the registered objects to become ready or have an
-   exceptional condition, with optional timeout in milliseconds (if *timeout*
-   arg is not specified or -1, there is no timeout).
+   Wait for at least one of the registered objects to become ready. Returns
+   list of (``obj``, ``event``, ...) tuples, ``event`` element specifies
+   which events happened with a stream and is a combination of ``select.POLL*``
+   constants described above. There may be other elements in tuple, depending
+   on a platform and version, so don't assume that its size is 2. In case of
+   timeout, an empty list is returned.
 
-   Returns list of (``obj``, ``event``, ...) tuples. There may be other elements in
-   tuple, depending on a platform and version, so don't assume that its size is 2.
-   The ``event`` element specifies which events happened with a stream and
-   is a combination of ``uselect.POLL*`` constants described above. Note that
-   flags ``uselect.POLLHUP`` and ``uselect.POLLERR`` can be returned at any time
-   (even if were not asked for), and must be acted on accordingly (the
-   corresponding stream unregistered from poll and likely closed), because
-   otherwise all further invocations of `poll()` may return immediately with
-   these flags set for this stream again.
-
-   In case of timeout, an empty list is returned.
+   Timeout is in milliseconds.
 
    .. admonition:: Difference to CPython
       :class: attention
@@ -85,15 +70,15 @@ Methods
 
 .. method:: poll.ipoll(timeout=-1, flags=0)
 
-   Like :meth:`poll.poll`, but instead returns an iterator which yields a
+   Like :meth:`poll.poll`, but instead returns an iterator which yields
    ``callee-owned tuples``. This function provides efficient, allocation-free
    way to poll on streams.
 
    If *flags* is 1, one-shot behavior for events is employed: streams for
-   which events happened will have their event masks automatically reset
-   (equivalent to ``poll.modify(obj, 0)``), so new events for such a stream
-   won't be processed until new mask is set with `poll.modify()`. This
-   behavior is useful for asynchronous I/O schedulers.
+   which events happened, event mask will be automatically reset (equivalent
+   to ``poll.modify(obj, 0)``), so new events for such a stream won't be
+   processed until new mask is set with `poll.modify()`. This behavior is
+   useful for asynchronous I/O schedulers.
 
    .. admonition:: Difference to CPython
       :class: attention