Merge pull request #10 from wheelos/planning

feat: update

Author: daohu527

.clang-format

@@ -10,7 +10,7 @@ IncludeCategories:
   # Note that the "main" header is priority 0
   # The priority is assigned to first match in the ordered list
   # Miscelaneous system libraries
-  - Regex:       '<(immintrin.h|malloc.h|wait.h|x86intrin.h|cuda.*)>'
+  - Regex:       '<(immintrin.h|malloc.h|wait.h|x86intrin.h|cuda.*|proj.h)>'
     Priority:    3
   # C standard libraries
   - Regex:       '<(arpa/|netinet/|net/if|sys/)?[^\./]*\.h>'

.github/ISSUE_TEMPLATE/01-bug_report.yml

@@ -0,0 +1,52 @@
+name: '🐞 Bug Report'
+description: 'Report a reproducible bug in WheelOS'
+title: '[Bug]: '
+labels: ['bug', 'needs-triage']
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for reporting a bug! Please provide clear and complete information to help us reproduce and fix it.
+
+  - type: textarea
+    id: system_info
+    attributes:
+      label: 'System Information / Logs'
+      description: |
+        Paste `whl-env` output **or** drag-and-drop logs/config files here.
+        GitHub will auto-upload and link them in the issue.
+      placeholder: |
+        Paste content here, or drag files into this box to attach them.
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: 'Steps to Reproduce'
+      description: 'List the minimal steps to reproduce this bug, in order'
+      placeholder: |
+        1.
+        2.
+        3.
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected_vs_actual
+    attributes:
+      label: 'Expected vs Actual Behavior'
+      description: |
+        **Expected:** what you expected
+        **Actual:** what actually happened (include errors/logs)
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional
+    attributes:
+      label: 'Additional Information'
+      description: 'Screenshots, logs, or configuration (optional)'
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/02-feature_request.yml

@@ -0,0 +1,34 @@
+name: '🌟 Feature Request'
+description: 'Suggest a new feature or improvement'
+title: '[Feature]: '
+labels: ['enhancement']
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        💡 Share your ideas on how to improve WheelOS — the more context and use cases, the better!
+
+  - type: textarea
+    id: use_case
+    attributes:
+      label: 'Use Case / Motivation'
+      description: 'Describe the real-world scenario or problem this addresses'
+    validations:
+      required: true
+
+  - type: textarea
+    id: proposal
+    attributes:
+      label: 'Proposed Implementation'
+      description: 'Outline your idea—API, commands, behavior, etc.'
+    validations:
+      required: false
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: 'Alternatives Considered'
+      description: 'Any existing workaround or past discussion'
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/03-question.yml

@@ -0,0 +1,48 @@
+name: '❓ Question / Help'
+description: 'Ask for help with usage, configuration, or docs'
+title: '[Question]: '
+labels: ['question', 'help-wanted']
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Need help? Ask here! Provide details so we can assist quickly.
+
+  - type: textarea
+    id: system_info
+    attributes:
+      label: 'System Information / Logs'
+      description: |
+        Paste `whl-env` output **or** drag-and-drop logs/config files here.
+        GitHub will auto-upload and link them in the issue.
+      placeholder: |
+        Paste content here, or drag files into this box to attach them.
+    validations:
+      required: false
+
+  - type: textarea
+    id: question
+    attributes:
+      label: 'Question'
+      description: 'Please describe your question or problem clearly'
+    validations:
+      required: true
+
+  - type: textarea
+    id: attempted
+    attributes:
+      label: 'What I Tried'
+      description: "Steps you've already taken or looked into (optional)"
+    validations:
+      required: false
+
+  - type: input
+    id: attachments
+    attributes:
+      label: 'Relevant Logs or Links'
+      description: |
+        Optional: Provide URLs to logs, screenshots, or related issues for reference.
+      placeholder: 'https://example.com/log.txt'
+    validations:
+      required: false

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: 'Community Forum'
+    url: 'https://github.com/orgs/wheelos/discussions'
+    about: 'Ask usage questions and discuss ideas with the WheelOS community.'

.github/ISSUE_TEMPLATE/config.yml

@@ -113,12 +113,21 @@ To build a specific module:
 ./apollo.sh build_cpu planning
 ```
 
-**Note:** If the build process is killed due to out-of-memory (OOM), try
-reducing the number of build threads:
+#### Notes and Troubleshooting
 
-```bash
-./apollo.sh build_cpu dreamview --cpus=2
-```
+- **Out of Memory (OOM) Issues:** If the build process is terminated due to
+  insufficient memory, try limiting the number of CPU threads used during the
+  build:
+
+  ```bash
+  ./apollo.sh build_cpu dreamview --cpus=2
+  ```
+
+- **Slow Download Speeds:** If you experience slow downloads, you can manually
+  download the required archive from the following link:
+  [Caiyun Cloud Drive](https://caiyun.139.com/w/i/2oxwFbadL3byc) (Extraction
+  code: `jfwu`). After downloading, place the archive in the `.cache/distdir`
+  directory within your codebase.
 
 ---
 

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,71 @@
+#ARG BASE_IMAGE=nvcr.io/nvidia/l4t-jetpack:r35.4.1
+ARG BASE_IMAGE=nvidia/cuda:11.4.3-cudnn8-devel-ubuntu20.04
+FROM ${BASE_IMAGE}
+
+ARG TENSORRT_VERSION="8.5.2"
+ARG PATCH_SUFFIX="-1+cuda11.4"
+ARG GEOLOC
+ARG DEBIAN_FRONTEND=noninteractive
+
+LABEL maintainer="WheelOS <developer@wheelos.cn>"
+
+# update ca-certificates and gnupg2 for https source first
+RUN apt-get update && \
+    apt-get upgrade -y && \
+    apt-get install -qq -y --no-install-recommends \
+        ca-certificates \
+        gnupg2 && \
+    rm -rf /var/lib/apt/lists/* && apt-get clean
+
+# consistent with the host system, for jetson orin, if not, please modify it manually
+ADD https://repo.download.nvidia.com/jetson/jetson-ota-public.asc /etc/apt/trusted.gpg.d/jetson-ota-public.asc
+RUN chmod +r /etc/apt/trusted.gpg.d/jetson-ota-public.asc
+COPY rcfiles/nvidia-jetson-common-r35.4-main.list /etc/apt/sources.list.d/nvidia-jetson-common-r35.4-main.list
+
+# change source list for cn
+COPY rcfiles/sources.list.tsinghua.aarch64.ubuntu.20.04 /etc/apt/sources.list
+
+# Add NVIDIA Tegra library paths
+RUN echo "/usr/lib/aarch64-linux-gnu/tegra" >> /etc/ld.so.conf.d/nvidia-tegra.conf && \
+    echo "/usr/lib/aarch64-linux-gnu/tegra-egl" >> /etc/ld.so.conf.d/nvidia-tegra.conf
+
+#
+# Install nvidia-cuda-dev for CUDA developer packages
+# Use nvidia-cuda if need CUDA runtime only
+#
+# RUN --mount=type=bind,source=rcfiles/sources.list.local.aarch64.ubuntu.20.04,target=/etc/apt/sources.list \
+#     --mount=type=bind,source=rcfiles/wheelos.cn.public.gpg,target=/opt/apollo/rcfiles/wheelos.cn.public.gpg \
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends \
+        nvidia-cuda-dev && \
+    apt-get clean && \
+    rm -rf /var/lib/apt/lists/*
+
+#
+# Install nvidia-cudnn8-dev for CuDNN developer packages
+# Use nvidia-cudnn8 if need CuDNN runtime only
+#
+# RUN --mount=type=bind,source=rcfiles/sources.list.local.aarch64.ubuntu.20.04,target=/etc/apt/sources.list \
+#     --mount=type=bind,source=rcfiles/wheelos.cn.public.gpg,target=/opt/apollo/rcfiles/wheelos.cn.public.gpg \
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends \
+        nvidia-cudnn8-dev && \
+    apt-get clean && \
+    rm -rf /var/lib/apt/lists/*
+
+#
+# Install nvidia-tensorrt-dev for TensorRT developer packages
+# Use nvidia-tensorrt if need TensorRT runtime only
+#
+# RUN --mount=type=bind,source=rcfiles/sources.list.local.aarch64.ubuntu.20.04,target=/etc/apt/sources.list \
+#     --mount=type=bind,source=rcfiles/wheelos.cn.public.gpg,target=/opt/apollo/rcfiles/wheelos.cn.public.gpg \
+RUN apt-get update && \
+    apt-get install -y --no-install-recommends \
+        nvidia-tensorrt-dev && \
+    apt-get clean && \
+    rm -rf /var/lib/apt/lists/*
+
+ENV NVIDIA_VISIBLE_DEVICES all
+ENV NVIDIA_DRIVER_CAPABILITIES all
+
+ENV TENSORRT_VERSION=${TENSORRT_VERSION}