Changes between Version 20 and Version 21 of expansion/gw16159


Ignore:
Timestamp:
05/14/2025 07:58:18 PM (32 hours ago)
Author:
Tim Harvey
Comment:

removed reliance on 6.6 kernel and updated section about MorseMicro kernel patches

Legend:

Unmodified
Added
Removed
Modified
  • expansion/gw16159

    v20 v21  
    2727  * required CLI app: https://github.com/MorseMicro/morse_cli.git
    2828  * custom version of hostapd/wpa_supplicant: https://github.com/MorseMicro/hostap
    29   * kernel patches: https://github.com/Gateworks/linux-venice/tree/v6.6.8-venice-mm6108
    3029
    3130== M.2 Pinout
     
    7776
    7877=== Pre-built images
    79 Currently the mm6108 driver requires the Linux 6.6 kernel and therefore it is not compatible with our Linux 6.12 pre-built images. Gateworks has pre-built images with the mm6108 driver here:
    80  * [https://dev.gateworks.com/venice/images/noble-venice-mm6108.img.gz noble-venice-mm6108.img.gz] (see [http://trac.gateworks.com/wiki/venice/firmware#disk-images compressed-disk-image])
    81  * [https://dev.gateworks.com/venice/kernel/linux-venice-mm6108.tar.xz linux-venice-mm6108.tar.xz Kernel tarball] (see [http://trac.gateworks.com/wiki/linux/kernel#install kernel-tarball install])
     78The mm6108 driver is supported in our latest pre-built images:
     79 * [https://dev.gateworks.com/venice/images/noble-venice.img.gz noble-venice.img.gz] (see [http://trac.gateworks.com/wiki/venice/firmware#disk-images compressed-disk-image])
     80 * [https://dev.gateworks.com/venice/kernel/linux-venice.tar.xz linux-venice.tar.xz Kernel tarball] (see [http://trac.gateworks.com/wiki/linux/kernel#install kernel-tarball install])
    8281 
    8382=== Driver
     
    8584
    8685building with the Gateworks Venice BSP:
    87   1. change the Linux branch to v6.6.8-venice-mm6108
    88 {{{#!bash
    89 git -C linux remote update
    90 git -C linux checkout v6.6.8-venice-mm6108
    91 }}}
    92   2. add a 'custom_kernel_mm6108' script
     86  1. add a 'custom_kernel_mm6108' script
    9387{{{#!bash
    9488cat <<\EOF > custom_kernel_mm6108
     
    325319}}}
    326320
    327 === Kernel Patches
    328 There is a small set of kernel patches that improve the experience for 802.11ah:
    329  * [https://github.com/MorseMicro/linux MorseMicro Linux patches]
    330   - 6.6.31:
    331    * [https://github.com/MorseMicro/linux/commit/69283c181040406bd9d594e47e38542343983f84 mac80211: implement support for thin LMAC S1G NDP block acknowledgements]
    332    * [https://github.com/MorseMicro/linux/commit/f948c7ac54c73e605791f576067cb11ce229e080 mac80211: Mesh support]
    333    * [https://github.com/MorseMicro/linux/commit/3804ca8ec2675fbfe96c6f7fded7f91918d8887c mac80211: IBSS bridge support]
    334    * [https://github.com/MorseMicro/linux/commit/8d5f1b326eb7c6f4812894c2b362abc245dec949 mac80211: tx s1g AP ecsa support]
    335    * [https://github.com/MorseMicro/linux/commit/77cd2d08f1cec39e3c8b2fea734772a73ac89ca9 mac80211: mlme s1g ecsa support]
    336  * [https://github.com/Gateworks/linux-venice/tree/v6.6.8-venice-mm6108 Linux v6.6 Gateworks v6.6.8-venice-mm6108]
    337 
    338 A basic AP/station !HaLow network without powersave requirements or extended channel switch will function without these patches.
    339 
    340 It has been reported that with these kernel patches have not caused any noticeable obvious issues with other mac80211 radios
    341 
    342321=== hostapd and wpa_supplicant
    343322!MorseMicro has a [https://github.com/MorseMicro/hostap/ custom version of hostapd and wpa_supplicant] with support added for 802.11ah. For most of the added configuration options there is no current way to pass them via ieee80211 APIs with nl80211 so instead the configuration is supplied via vendor-specific commands using the {{{morse_cli}}} userspace application. These are typically built as {{{hostapd_s1g}}} and {{{wpa_supplicant_s1g}}} so that they can coexist with the standard tools.
     
    365344 - note if not specified the interface defaults to wlan0
    366345
     346=#kernel-patches
     347=== Kernel Patches
     348There is a small set of kernel patches from !MorseMicro which may improve the experience for 802.11ah for specific use cases. Gateworks has found these patches to be unnecessary for most use cases including AP, STA, and 802.11S MESH. These patches from !MorseMicro exist for several LTS kernels at https://github.com/MorseMicro/linux
     349
     350Here is an evaluation of the various patches for a 6.6 kernel:
     351 * [https://github.com/MorseMicro/linux/commit/69283c181040406bd9d594e47e38542343983f84 mac80211: implement support for thin LMAC S1G NDP block acknowledgements]
     352  - this is necessary if you are using the think LMAC firmware (which we have found no documentation on)
     353 * [https://github.com/MorseMicro/linux/commit/f948c7ac54c73e605791f576067cb11ce229e080 mac80211: Mesh support]
     354  - MESH improvements
     355 * [https://github.com/MorseMicro/linux/commit/3804ca8ec2675fbfe96c6f7fded7f91918d8887c mac80211: IBSS bridge support]
     356  - this is necessary if you are using the old IBSS/Adhoc mode in a bridge (not required for 802.11S MESH)
     357 * [https://github.com/MorseMicro/linux/commit/8d5f1b326eb7c6f4812894c2b362abc245dec949 mac80211: tx s1g AP ecsa support]
     358  - powersave enhancement
     359 * [https://github.com/MorseMicro/linux/commit/77cd2d08f1cec39e3c8b2fea734772a73ac89ca9 mac80211: mlme s1g ecsa support]
     360  - powersave enhancement
     361
     362A basic AP/station !HaLow network without powersave requirements or extended channel switch will function without these patches.
     363
     364It has been reported that with these kernel patches have not caused any noticeable obvious issues with other mac80211 radios
     365
     366Note that the GW16159 does not support the power-save pins on the mm6108 and that Gateworks disables powersave mode in the driver.
    367367
    368368[=#channels]