diff --git a/_templates/forum.html b/_templates/forum.html new file mode 100644 index 0000000000000000000000000000000000000000..e18ed0f275a9a6178068f65e143c477191393e57 --- /dev/null +++ b/_templates/forum.html @@ -0,0 +1,16 @@ +{% if pagename == "ideas/index" %} + <a role="button" href="https://bbb.io/gsocml"> + <i class="fa-brands fa-discourse"></i> More Ideas on Forum + </a> +{% else %} + <a role="button" href="https://forum.beagleboard.org/new-topic?category=gsoc&tags=gsoc"> + <i class="fa-brands fa-discourse"></i> Discuss on Forum + </a> +{% endif %} + +<div class="card bg-light mt-4 text-center"> + <div class="card-body"> + <p class="card-text text-dark"> + <a href="https://www.beagleboard.org/">BeagleBoard.org</a> is all about being open, please discuss in public on our <a href="https://bbb.io/gsocml">forum</a>!</p> + </div> +</div> \ No newline at end of file diff --git a/_templates/pdf.html b/_templates/pdf.html index 6f6e190e89063bde94b715278b4d2e25194dc8f1..28a3c30997286acf3665b67027d263cbb699f4a4 100644 --- a/_templates/pdf.html +++ b/_templates/pdf.html @@ -1,8 +1,8 @@ {% if pages_slug != "index" %} {% for proposal_name in proposals %} {% if pagename == "proposals/"+proposal_name %} - <a class="btn btn-danger btn-sm btn-block text-light" role="button" href="{{proposal_name}}.pdf"> - <i class="fa-solid fa-download"></i> {{proposal_name}}.pdf + <a role="button" href="{{proposal_name}}.pdf"> + <i class="fa-solid fa-download"></i> Download PDF </a> {% endif %} {% endfor %} diff --git a/conf.py b/conf.py index e88b28ed36ae592e6002adb62e4cb057ea9ad43c..ec38d9ea9fbab6543f9cf76118700cc3c85e0514 100644 --- a/conf.py +++ b/conf.py @@ -117,7 +117,7 @@ html_theme_options = { "footer_end": ["last-updated"], # "content_footer_items": ["last-updated"], "secondary_sidebar_items": { - "**": ["page-toc", "edit-this-page", "sourcelink","pdf"] + "**": ["page-toc", "edit-this-page", "sourcelink","pdf","forum"] } } diff --git a/guides/contributor.rst b/guides/contributor.rst index 7f6dcb7271880a48db8060e717069eb12cdb2089..b6699e75e67876c73248dc935ea4aae3767feb7e 100644 --- a/guides/contributor.rst +++ b/guides/contributor.rst @@ -7,6 +7,12 @@ Contributor Guide :width: 100% :align: center +.. admonition:: What is the mission? + + We don't want to just make more things. We want to enable individuals to make the things that dominate their lives, + rather than leaving it up to someone else. Google Summer of a Code with BeagleBoard.org is a great way to learn + skills highly in demand while making a difference in the world. + General requirements ******************** diff --git a/guides/index.rst b/guides/index.rst index fef9612c9d85186cfe13047d1c0e3d1e587ae12b..9892c280411a40cde96ee12813f4a49fa196fe43 100644 --- a/guides/index.rst +++ b/guides/index.rst @@ -8,6 +8,11 @@ in GSoC 2024 with `BeagleBoard.org <www.beagleboard.org>`_. It's highly recommen <https://developers.google.com/open-source/gsoc/faq>`_. For anyone who just want to contribute to this site we also have a step by step :ref:`contribution guide <gsoc-site-editing-guide>`. +.. admonition:: Did you know? + + BeagleBoard.org has been accepted to be a mentoring organization in the + Google Summer of Code (GSoC) for twelve previous years! + .. card:: :link: gsoc-contributor-guide :link-type: ref diff --git a/guides/proposal.rst b/guides/proposal.rst index 3aff3238713ea454fb1c85bb96d9bacfadce777f..418819ab3f6530604863a7576addbddb87d0c83b 100644 --- a/guides/proposal.rst +++ b/guides/proposal.rst @@ -65,9 +65,8 @@ You can either open your cloned `gsoc.beagleboard.io repo <https://openbeagle.or .. raw:: html - <br> - <a class="btn btn-danger btn-sm btn-block text-light" role="button" href="/proposals/template.pdf"> - <i class="fa-solid fa-download"></i> template.pdf + <a role="button" href=""> + <i class="fa-solid fa-download"></i> Download PDF </a> diff --git a/ideas/index.rst b/ideas/index.rst index 4fb9fffaee4237764f71f9b3310dfd334e153a5a..ddd74a2faff464dbb61f33f662123449e71cf913 100644 --- a/ideas/index.rst +++ b/ideas/index.rst @@ -5,161 +5,137 @@ Ideas ###### -.. sidebar:: Welcome +Welcome to the project ideas page for `GSoC 2024 <https://developers.google.com/open-source/gsoc/timeline>`_. The +BeagleBoard.org community is loaded with experts on building open source embedded systems. An embedded +system is built using a computer dedicated to a specific purpose, like a toaster, coffee machine, dish washer, thermostat +or anti-lock brakes. You can think of an embedded system as a computer designed to not look like a computer +and to automate things in the physical world. - Welcome to the project ideas page for `GSoC 2024 <https://developers.google.com/open-source/gsoc/timeline>`_. The - BeagleBoard.org community is loaded with experts on building open source embedded systems. An embedded - system is built using a computer dedicated to a specific purpose, like a toaster, coffee machine, dish washer, thermostat - or anti-lock brakes. You can think of an embedded system as a computer designed to not look like a computer - and to automate things in the physical world. +.. image:: ../_static/images/ideas-below.webp + :align: center -.. sidebar:: Did you know? +.. admonition:: How to participate? - BeagleBoard.org has been accepted to be a mentoring organization in the Google Summer of Code (GSoC) for twelve previous years! - -.. sidebar:: How to participate? - - Contributors are expected to go through the list of ideas below and join the discussion by clicking on the + Contributors are expected to go through the list of ideas dropdown below and join the discussion by clicking on the ``Discuss on forum`` button. All ideas have colorful badges for ``Complexity`` and ``Size`` for making the selection process easier for contributors. Anyone is welcome to introduce new ideas via the `forum gsoc-ideas tag <https://forum.beagleboard.org/tag/gsoc-ideas>`_. Only ideas with sufficiently experienced mentor backing as deemed by the administrators will be added here. - .. table:: - - +------------------------------------+-------------------------------+ - | Complexity | Size | - +====================================+===============================+ - | :bdg-danger:`High complexity` | :bdg-danger-line:`350 hours` | - +------------------------------------+-------------------------------+ - | :bdg-success:`Medium complexity` | :bdg-success-line:`175 hours` | - +------------------------------------+-------------------------------+ - | :bdg-info:`Low complexity` | :bdg-info-line:`90 hours` | - +------------------------------------+-------------------------------+ - -.. sidebar:: Looking for more? - - Please visit `our forum <https://forum.beagleboard.org/t/gsoc-ideas>`_ to see newer ideas being discussed! - - You can also check our our :ref:`gsoc-old-ideas` and :ref:`Past_Projects` for inspiration. - -.. sidebar:: What is the mission? - - We don't want to just make more things. We want to enable individuals to make the things that dominate their lives, - rather than leaving it up to someone else. Google Summer of a Code with BeagleBoard.org is a great way to learn - skills highly in demand while making a difference in the world. + +------------------------------------+-------------------------------+ + | Complexity | Size | + +====================================+===============================+ + | :bdg-danger:`High complexity` | :bdg-danger-line:`350 hours` | + +------------------------------------+-------------------------------+ + | :bdg-success:`Medium complexity` | :bdg-success-line:`175 hours` | + +------------------------------------+-------------------------------+ + | :bdg-info:`Low complexity` | :bdg-info-line:`90 hours` | + +------------------------------------+-------------------------------+ -.. grid:: 1 1 1 1 - :margin: 4 4 0 0 - :gutter: 1 +.. card:: Low-latency I/O RISC-V CPU core in FPGA fabric - .. grid-item:: + :fas:`microchip;pst-color-primary` FPGA gateware improvements :bdg-success:`Medium complexity` :bdg-success-line:`175 hours` - .. image:: ../_static/images/ideas-below.webp - :align: center + ^^^^ - .. grid-item-card:: + BeagleV-Fire features RISC-V 64-bit CPU cores and FPGA fabric. In that FPGA fabric, we'd like to + implement a RISC-V 32-bit CPU core with operations optimized for low-latency GPIO. This is similar + to the programmable real-time unit (PRU) RISC cores popularized on BeagleBone Black. - :fas:`exclamation;pst-color-danger` Important: **No direct messages** - ^^^ + | **Goal:** RISC-V-based CPU on BeagleV-Fire FPGA fabric with GPIO + | **Hardware Skills:** Verilog, Verification, FPGA + | **Software Skills:** RISC-V ISA, assembly, `Linux`_ + | **Possible Mentors:** `Cyril Jean <https://forum.beagleboard.org/u/vauban>`_, `Jason Kridner <https://forum.beagleboard.org/u/jkridner>`_ - BeagleBoard.org is all about being open. Please keep discussion in public - on `our forum <https://bbb.io/gsocml>`_. + ++++ - .. grid-item-card:: Low-latency I/O RISC-V CPU core in FPGA fabric + .. button-link:: https://forum.beagleboard.org/t/low-latency-risc-v-i-o-cpu-core/37156 + :color: danger + :expand: - | :fas:`microchip;pst-color-primary` FPGA gateware improvements - | :bdg-success:`Medium complexity` :bdg-success-line:`175 hours` - ^^^ + :fab:`discourse;pst-color-light` Discuss on forum - BeagleV-Fire features RISC-V 64-bit CPU cores and FPGA fabric. In that FPGA fabric, we'd like to - implement a RISC-V 32-bit CPU core with operations optimized for low-latency GPIO. This is similar - to the programmable real-time unit (PRU) RISC cores popularized on BeagleBone Black. - | **Goal:** RISC-V-based CPU on BeagleV-Fire FPGA fabric with GPIO - | **Hardware Skills:** Verilog, Verification, FPGA - | **Software Skills:** RISC-V ISA, assembly, `Linux`_ - | **Possible Mentors:** `Cyril Jean <https://forum.beagleboard.org/u/vauban>`_, `Jason Kridner <https://forum.beagleboard.org/u/jkridner>`_ +.. card:: Update beagle-tester for mainline testing - +++ - .. button-link:: https://forum.beagleboard.org/t/low-latency-risc-v-i-o-cpu-core/37156 - :color: danger - :expand: + :fab:`linux;pst-color-primary` Linux kernel improvements :bdg-success:`Medium complexity` :bdg-danger-line:`350 hours` - :fab:`discourse;pst-color-light` Discuss on forum + ^^^^ + Utilize the ``beagle-tester`` application and ``Buildroot`` along with device-tree and udev symlink concepts within + the OpenBeagle continuous integration server context to create a regression test suite for the Linux kernel + and device-tree overlays on various Beagle computers. - .. grid-item-card:: Update beagle-tester for mainline testing + | **Goal:** Execution on Beagle test farm with over 30 mikroBUS boards testing all mikroBUS enabled cape interfaces (PWM, ADC, UART, I2C, SPI, GPIO and interrupt) performing weekly mainline Linux regression verification + | **Hardware Skills:** basic wiring, familiarity with embedded serial interfaces + | **Software Skills:** device-tree, `Linux`_, `C`_, continuous integration with GitLab, Buildroot + | **Possible Mentors:** `Deepak Khatri <https://forum.beagleboard.org/u/lorforlinux>`_, `Anuj Deshpande <https://forum.beagleboard.org/u/Anuj_Deshpande>`_, `Dhruva Gole <https://forum.beagleboard.org/u/dhruvag2000>`_ - | :fab:`linux;pst-color-primary` Linux kernel improvements - | :bdg-success:`Medium complexity` :bdg-danger-line:`350 hours` - ^^^ + ++++ - Utilize the ``beagle-tester`` application and ``Buildroot`` along with device-tree and udev symlink concepts within - the OpenBeagle continuous integration server context to create a regression test suite for the Linux kernel - and device-tree overlays on various Beagle computers. + .. button-link:: https://forum.beagleboard.org/t/update-beagle-tester-for-cape-mikrobus-new-board-and-upstream-testing/37279 + :color: danger + :expand: - | **Goal:** Execution on Beagle test farm with over 30 mikroBUS boards testing all mikroBUS enabled cape interfaces (PWM, ADC, UART, I2C, SPI, GPIO and interrupt) performing weekly mainline Linux regression verification - | **Hardware Skills:** basic wiring, familiarity with embedded serial interfaces - | **Software Skills:** device-tree, `Linux`_, `C`_, continuous integration with GitLab, Buildroot - | **Possible Mentors:** `Deepak Khatri <https://forum.beagleboard.org/u/lorforlinux>`_, `Anuj Deshpande <https://forum.beagleboard.org/u/Anuj_Deshpande>`_, `Dhruva Gole <https://forum.beagleboard.org/u/dhruvag2000>`_ + :fab:`discourse;pst-color-light` Discuss on forum - +++ - .. button-link:: https://forum.beagleboard.org/t/update-beagle-tester-for-cape-mikrobus-new-board-and-upstream-testing/37279 - :color: danger - :expand: +.. card:: Upstream wpanusb and bcfserial - :fab:`discourse;pst-color-light` Discuss on forum + :fab:`linux;pst-color-primary` Linux kernel improvements :bdg-success:`Medium complexity` :bdg-success-line:`175 hours` + + ^^^^ - .. grid-item-card:: Upstream wpanusb and bcfserial + These are the drivers that are used to enable Linux to use a BeagleConnect Freedom as a SubGHz IEEE802.15.4 radio (gateway). + They need to be part of upstream Linux to simplify on-going support. There are several gaps that are known before they are + acceptable upstream. - | :fab:`linux;pst-color-primary` Linux kernel improvements - | :bdg-success:`Medium complexity` :bdg-success-line:`175 hours` - ^^^ + | **Goal:** Add functional gaps, submit upstream patches for these drivers and respond to feedback + | **Hardware Skills:** Familiarity with wireless communication + | **Software Skills:** `C`_, `Linux`_ + | **Possible Mentors:** `Ayush Singh <https://forum.beagleboard.org/u/ayush1325>`_, `Jason Kridner <https://forum.beagleboard.org/u/jkridner>`_ - These are the drivers that are used to enable Linux to use a BeagleConnect Freedom as a SubGHz IEEE802.15.4 radio (gateway). - They need to be part of upstream Linux to simplify on-going support. There are several gaps that are known before they are - acceptable upstream. + ++++ - | **Goal:** Add functional gaps, submit upstream patches for these drivers and respond to feedback - | **Hardware Skills:** Familiarity with wireless communication - | **Software Skills:** `C`_, `Linux`_ - | **Possible Mentors:** `Ayush Singh <https://forum.beagleboard.org/u/ayush1325>`_, `Jason Kridner <https://forum.beagleboard.org/u/jkridner>`_ + .. button-link:: https://forum.beagleboard.org/t/upstream-wpanusb-and-bcfserial/37186 + :color: danger + :expand: - +++ - .. button-link:: https://forum.beagleboard.org/t/upstream-wpanusb-and-bcfserial/37186 - :color: danger - :expand: + :fab:`discourse;pst-color-light` Discuss on forum - :fab:`discourse;pst-color-light` Discuss on forum +.. card:: ``librobotcontrol`` support for newer boards - .. grid-item-card:: ``librobotcontrol`` support for newer boards + :fas:`wand-sparkles;pst-color-danger` Automation and industrial I/O :bdg-success:`Medium complexity` :bdg-success-line:`175 hours` - | :fas:`wand-sparkles;pst-color-danger` Automation and industrial I/O - | :bdg-success:`Medium complexity` :bdg-success-line:`175 hours` - ^^^ + ^^^^ - Preliminary librobotcontrol support for BeagleBone AI, BeagleBone AI-64 and BeagleV-Fire has been drafted, but it - needs to be cleaned up. We can also work on support for Raspberry Pi if UCSD releases their Hat for it. + Preliminary librobotcontrol support for BeagleBone AI, BeagleBone AI-64 and BeagleV-Fire has been drafted, but it + needs to be cleaned up. We can also work on support for Raspberry Pi if UCSD releases their Hat for it. - | **Goal:** Update librobotcontrol for Robotics Cape on BeagleBone AI, BeagleBone AI-64 and BeagleV-Fire - | **Hardware Skills:** Basic wiring, some DC motor familiarity - | **Software Skills:** `C`_, `Linux`_ - | **Possible Mentors:** `Deepak Khatri <https://forum.beagleboard.org/u/lorforlinux>`_, `Jason Kridner <https://forum.beagleboard.org/u/jkridner>`_ + | **Goal:** Update librobotcontrol for Robotics Cape on BeagleBone AI, BeagleBone AI-64 and BeagleV-Fire + | **Hardware Skills:** Basic wiring, some DC motor familiarity + | **Software Skills:** `C`_, `Linux`_ + | **Possible Mentors:** `Deepak Khatri <https://forum.beagleboard.org/u/lorforlinux>`_, `Jason Kridner <https://forum.beagleboard.org/u/jkridner>`_ + + ++++ - +++ - .. button-link:: https://forum.beagleboard.org/t/librobotcontrol-support-for-newer-boards/37187 - :color: danger - :expand: + .. button-link:: https://forum.beagleboard.org/t/librobotcontrol-support-for-newer-boards/37187 + :color: danger + :expand: - :fab:`discourse;pst-color-light` Discuss on forum + :fab:`discourse;pst-color-light` Discuss on forum .. button-link:: https://forum.beagleboard.org/tag/gsoc-ideas - :color: light + :color: danger :expand: + :outline: - :fab:`discourse;pst-color-light` Visit our forum for more ideas + :fab:`discourse;pst-color-light` Visit our forum to see newer ideas being discussed! + + +.. tip:: + + You can also check our our :ref:`gsoc-old-ideas` and :ref:`Past_Projects` for inspiration. .. _Linux: https://docs.beagleboard.org/latest/intro/beagle101/linux.html diff --git a/ideas/old/index.rst b/ideas/old/index.rst index a8c48fa3c3eb1ea09e12db4c97596068f897a3eb..d61e4d2de001aedab3287f782ff3c1ff7967e380 100644 --- a/ideas/old/index.rst +++ b/ideas/old/index.rst @@ -1,3 +1,5 @@ +:orphan: + .. _gsoc-old-ideas: Old GSoC Ideas diff --git a/proposals/template.rst b/proposals/template.rst index 1fd3c35857f694cc8319b1b3519483090817919f..1a9101611ceff3a78aaf85cace2308e653677583 100644 --- a/proposals/template.rst +++ b/proposals/template.rst @@ -29,7 +29,7 @@ and fill out this template. About ===== -- **Forum:** :fab:`discourse` `ayush1325 (Ayush Singh) <https://forum.beagleboard.org/u/ayush1325>`_ +- **Forum:** :fab:`discourse` `u/ayush1325 (Ayush Singh) <https://forum.beagleboard.org/u/ayush1325>`_ - **OpenBeagle:** :fab:`gitlab` `ayush1325 (Ayush Singh) <https://openbeagle.org/ayush1325>`_ - **IRC:** :fas:`comments` `jkridner (Jason Kridner) <https://web.libera.chat/gamja/#beagle>`_ - **Github:** :fab:`github` `jadonk (Jason Kridner) <https://github.com/jadonk>`_