generated from ElectronicCats/Template-Project-KiCAD-CI
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Signed-off-by: Sabas <[email protected]>
- Loading branch information
Showing
1 changed file
with
19 additions
and
199 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,212 +1,32 @@ | ||
| # Badge BugCON 2024 | ||
|
|
||
| # Plantilla para proyectos de ingeniería | ||
| Badge Oficial BugCON 2024 | ||
|
|
||
| Esta plantilla es la base para cualquier proyecto desarrollado en Electronic Cats. | ||
| ## Getting started | ||
|
|
||
| Automáticamente, se generarán todos los archivos necesarios para la compra de material, fabricación y ensamble. | ||
| 1. Connect Badge via USB to your computer. | ||
| 2. Open the serial port indicated for the badge on your computer through a program such as Arduino IDE, Putty or Screen at 115200 bauds. | ||
| 3. The badge text should appear in the terminal. | ||
|
|
||
| Así como documentos complementarios para un proyecto completo. | ||
| ## Tecnologia | ||
|
|
||
|
|
||
| - ESP32C6 | ||
| - Baterias 2 x AAA | ||
| - USB C | ||
|
|
||
| > Este README.md puede ser utilizado como plantilla para documentación, de esta manera se puede incluir generalidades, recomendaciones y todo lo necesario para entender el proyecto. | ||
| ## How to build the firmware | ||
|
|
||
| Check the [Developer guide](./firmware/README.md) to learn how to build the firmware from scratch. | ||
|
|
||
| ## ¿Cómo utilizar esta plantilla? | ||
| ## Gratitude | ||
| Do you want to say thank you? Tag these companies on social networks and show them your badge, thanks to them it is possible | ||
|
|
||
| Para comenzar un nuevo proyecto, presiona el botón de "Use this template". | ||
| - [ElectronicCats](https://electroniccats.com/) | ||
|
|
||
|
|
||
|
|
||
| ### KiCad | ||
|
|
||
| Para esta plantilla, el hardware debe de ser diseñado y/o desarrollado en KiCad 6. | ||
|
|
||
| Al término del diseño del proyecto, KiCad deberá de generar los siguientes archivos: | ||
|
|
||
|
|
||
|
|
||
| - nombre_del_proyecto.kicad_pro | ||
|
|
||
| - nombre_de_la_pcb.kicad_pcb | ||
|
|
||
| - nombre_del_esquematico.kicad_sch | ||
|
|
||
|
|
||
|
|
||
| Además de archivos temporales, los cuales Git ignora al momento de cualquier push. | ||
|
|
||
| [Archivos ignorados](.gitignore) | ||
|
|
||
|
|
||
|
|
||
| Estos archivos deberán ser guardados dentro de la carpeta de [hardware](hardware/). | ||
|
|
||
|
|
||
|
|
||
| ### Configuración de automatización | ||
|
|
||
| Una vez terminado el proyecto, antes de hacer el primer Release, se deberán realizar algunos cambios para la automatización de archivos. | ||
|
|
||
| En la carpeta [.github/workflows](.github/workflows/) se encuentra el archivo kicad_kibot.yml, en donde los siguientes campos deberán ser modificados | ||
|
|
||
|
|
||
|
|
||
| ```yaml | ||
|
|
||
| # optional - schematic file | ||
|
|
||
| schema: 'hardware/Template-KiCAD-Project-CI.kicad_sch' | ||
|
|
||
| # optional - pcb file | ||
|
|
||
| board: 'hardware/Template-KiCAD-Project-CI.kicad_pcb' | ||
|
|
||
| ``` | ||
| Se deberá reemplazar el nombre del archivo "Template-KiCAD-Project-CI" por el nombre del proyecto diseñado. | ||
| Es importante conservar las extensiones de archivo .kicad_sch y .kicad_pcb. | ||
| ### Activar/desactivar DRC y ERC | ||
| Las opciones de DRC y ERC están siempre activas predeterminadamente, para desactivarlas se deberá de eliminar las siguientes líneas del archivo [electroniccats_sch.kibot.yaml](hardware/electroniccats_sch.kibot.yaml). | ||
| ```yaml | ||
|
|
||
| run_erc: true | ||
|
|
||
| run_drc: true | ||
|
|
||
| ``` | ||
| Esta acción solo correrá cada vez que se haga un release. | ||
| Si, además, se busca desactivar el DRC y el ERC cuando se haga push o pull request, es necesario eliminar el archivo [action_drc.yml](.github/workflows/action_drc.yml). | ||
| ## Creación de Release | ||
| Al terminar el proyecto y su revisión, se publicará el primer Release. | ||
| Para crear un nuevo Release, presiona el botón de "Create a new release". | ||
| Una vez creado el Release, podrás ver la creación de los archivos en la sección de Actions. | ||
| Al terminar, los archivos serán generados en el mismo release. | ||
| ## Elementos para mejorar tu `Readme.md` | ||
|
|
||
| Los archivos `Readme.md` se crean con el propósito de hacer visualmente agradable un repositorio para los usuarios que visiten nuestro proyecto, puedes utilizar algunos de los siguientes elementos. | ||
|
|
||
| ### Código | ||
| Quoting code, como lo dice su nombre, se utiliza para añadir código y que se separe del texto plano. Debes de agregar el codigo dentro de ` ``` ```` ` , ademas si agregas el nombre del lenguaje inmediatamente despues de las primeras ` ``` ` las funciones se pondran de color diferenciandolas del resto del codigo. Aquí algunos ejemplos. Puedes encontrar los lenguajes aquí: | ||
| https://github.com/github/linguist/blob/master/vendor/README.md | ||
| ```sh | ||
| 192.168.0.1 | ||
| cd Downloads | ||
| ``` | ||
| ```diff | ||
| - text in red | ||
| + text in green | ||
| ! text in orange | ||
| # text in gray | ||
| @@ text in purple (and bold)@@ | ||
| ``` | ||
|
|
||
| ### Hipervínculos | ||
|
|
||
| Usa hipervínculos o links para redirigir a los usuarios a páginas donde puedan conocer más acerca de algún tema o concepto en concreto, hay dos formas de hacer esto: | ||
|
|
||
| - [Agregando el link en seguida](https://github.com/ElectronicCats/Template-Project-KiCAD-CI) - Con esta forma deberas de seguir el siguiente formato `[Texto](www.url.com)`. El texto que se mostrará en la página principal del Readme será el que se encuentra dentro de los corchetes y el link de la página deberá de ir de manera inmediata a los corchetes dentro de paréntesis. | ||
|
|
||
| - [Agregando el link como referencia] - Al igual que otro tipo de formatos de referencia en este agregas el texto que se mostrará en la página principal del repositorio dentro de corchetes `[Texto]` y al final de tu archivo (de preferencia) agregas la referencia de la siguiente manera: `[Texto]:<www.url.com>`, este no se mostrara en el archivo por lo que es una buena forma de mantener un formato y un orden. | ||
|
|
||
| ### Tablas | ||
|
|
||
| Las tablas que todos conocemos con filas y columnas. El formato para estas tablas se basa en el uso del símbolo `|`, entonces debes de encerrar las palabras como esto: `|Columna1|` (sin la posibilidad de dos | seguidos), para agregar más columnas basta con dar un espacio y repetir el formato, sin embargo, para añadir filas debes de hacer un salto de línea y repetir el formato de columnas, dejándonos una tabla como la siguiente: | ||
|
|
||
| |Columna1|Columna2| | ||
| |-|-| | ||
| |Fila 1 Columna 1|Fila 2 Columna 2| | ||
|
|
||
| Nota: Si agregas en la segunda fila guiones (-) harás que la primera fila se convierta en el encabezado de la tabla. | ||
|
|
||
| ### Imágenes | ||
| Puedes añadir imágenes siempre y cuando estas estén en Internet, si quieres agregar una nueva imagen tambien la puedes arrastrar y soltar en el cuadro de texto (en caso de que edites tu `Readme.md`) directo desde GitHub, esto hará que se guarde tu imagen en una carpeta oculta dentro de tu repositorio. | ||
| El formato para agregar imagenes es: `` | ||
| Si requieres que al hacer click en tu imagen se redirija a otra pagina usa el siguiente formado `[](https://www.urlaredirigir.com)` | ||
| Es importante agregar `https://` , si no te enviara a una página de GitHub que probablemente no exista. | ||
|
|
||
| [](https://www.electroniccats.com) | ||
|
|
||
| ### Referencias | ||
| Es posible que en la wiki hayas visto numeritos como este --->[^1], pero que significan? | ||
|
|
||
| No son más que referencias que puedes hacer para hacer saltos de información e ir directo a la referencia haciendo click en el pequeño número. | ||
| [^1]: Soy la referencia :)))) | ||
|
|
||
| ### Emojis :trollface: :shipit: | ||
| Solo escribe el código del emoji así: `:EMOJICODE:`. | ||
| Aqui la lista de los [EMOJICODEs](https://github.com/ikatyang/emoji-cheat-sheet/blob/master/README.md#github-custom-emoji) | ||
|
|
||
| ### Listas con checkbox | ||
| Usa este formato: | ||
| ``` | ||
| - [x] GFM task list 1 | ||
| - [x] GFM task list 2 | ||
| - [ ] GFM task list 3 | ||
| - [ ] GFM task list 3-1 | ||
| - [ ] GFM task list 3-2 | ||
| - [ ] GFM task list 3-3 | ||
| - [ ] GFM task list 4 | ||
| - [ ] GFM task list 4-1 | ||
| - [ ] GFM task list 4-2 | ||
| ``` | ||
| Y tendras algo asi: | ||
| - [x] GFM task list 1 | ||
| - [x] GFM task list 2 | ||
| - [ ] GFM task list 3 | ||
| - [ ] GFM task list 3-1 | ||
| - [ ] GFM task list 3-2 | ||
| - [ ] GFM task list 3-3 | ||
| - [ ] GFM task list 4 | ||
| - [ ] GFM task list 4-1 | ||
| - [ ] GFM task list 4-2 | ||
|
|
||
| ### Otros Elementos | ||
|
|
||
|  | ||
|  | ||
|
|
||
| Este tipo de indicadores nos pueden ayudar a identificar diferente información relacionada al proyecto, solo los debes de agregar como una imagen y en el URL pegar el link correspondiente. | ||
| Los ejemplos de arriba fueron generados con la pagina: Shields.io , solo debes de asegurarte que son para GitHub y que tienen el formato `MarkDown` | ||
|
|
||
| - Badges, | ||
| En caso de que necesites algun referente a alguna empresa o plataforma puedes usar esta pagina: https://dev.to/envoy_/150-badges-for-github-pnk | ||
|
|
||
| [](https://www.linkedin.com/company/electroniccats/?originalSubdomain=mx) | ||
|
|
||
| - Estadísticas | ||
| Utilizando el projecto de este usuario puedes agregar estadísticas del proyecto como estas: | ||
|
|
||
|  | ||
|
|
||
| https://github.com/anuraghazra/github-readme-stats | ||
|
|
||
| **NOTA**:Son pocas las tarjetas que puedes utilizar con el proyecto de este usuario para repositorios ya que son más dirigidos a perfiles de GitHub. | ||
|
|
||
| ## Maintainer | ||
|
|
||
| <a | ||
| href="https://github.com/sponsors/ElectronicCats"> | ||
|
|
||
| <img src="https://electroniccats.com/wp-content/uploads/2020/07/Badge_GHS.png" height="104" /> | ||
|
|
||
| </a> | ||
| ## License | ||
|
|
||
| Electronic Cats invests time and resources providing this open source design, please support Electronic Cats and open-source hardware by purchasing products from Electronic Cats! | ||
|
|
||
| [Agregando el link como referencia]: <https://github.com/ElectronicCats/Template-Project-KiCAD-CI> | ||
| Designed by Electronic Cats. | ||
|
|
||
| Hardware released under an CERN Open Hardware Licence v1.2. See the LICENSE_HARDWARE file for more information. |