# License Information
This project uses multiple licenses for different components:
## Hardware (PCB, Schematics, CAD files)
CERN Open Hardware Licence Version 2 - Strongly Reciprocal (CERN-OHL-S-2.0)
Copyright (c) 2024 [Your Name/Organization]
Full license text: https://ohwr.org/cern_ohl_s_v2.txt
---
## Documentation (Markdown files, Images, Tutorials)
Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)
Copyright (c) 2024 [Your Name/Organization]
Full license text: https://creativecommons.org/licenses/by-sa/4.0/legalcode
---
## Software (Firmware, Code Examples)
MIT License
Copyright (c) 2024 [Your Name/Organization]
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.
```
### Opțiunea B: Fișiere separate pentru fiecare licență
```markdown:LICENSE-HARDWARE.txt
CERN Open Hardware Licence Version 2 - Strongly Reciprocal
Copyright (c) 2024 [Your Name/Organization]
This hardware design is licensed under the CERN-OHL-S v2.
You may redistribute and modify this design under the terms of the
CERN-OHL-S v2 (https://ohwr.org/cern_ohl_s_v2.txt).
This design is distributed WITHOUT ANY EXPRESS OR IMPLIED WARRANTY,
INCLUDING OF MERCHANTABILITY, SATISFACTORY QUALITY AND FITNESS FOR A
PARTICULAR PURPOSE. Please see the CERN-OHL-S v2 for applicable conditions.
Full license text: https://ohwr.org/cern_ohl_s_v2.txt
```
```markdown:LICENSE-DOCUMENTATION.txt
Creative Commons Attribution-ShareAlike 4.0 International
Copyright (c) 2024 [Your Name/Organization]
This documentation is licensed under CC BY-SA 4.0.
You are free to:
- Share — copy and redistribute the material in any medium or format
- Adapt — remix, transform, and build upon the material for any purpose
Under the following terms:
- Attribution — You must give appropriate credit
- ShareAlike — If you remix, transform, or build upon the material, you must
distribute your contributions under the same license as the original
Full license text: https://creativecommons.org/licenses/by-sa/4.0/legalcode
```
```markdown:LICENSE-SOFTWARE.txt
MIT License
Copyright (c) 2024 [Your Name/Organization]
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.
```
## 2. Adaugă header-e de licență în fișierele sursă
### Pentru fișiere hardware (KiCad, Gerber, etc.)
```
SPDX-License-Identifier: CERN-OHL-S-2.0
Copyright (c) 2024 [Your Name/Organization]
```
### Pentru fișiere de documentație (.md)
```markdown
<!--
SPDX-License-Identifier: CC-BY-SA-4.0
Copyright (c) 2024 [Your Name/Organization]
-->
```
### Pentru fișiere de cod (.c, .h)
```c
/*
* SPDX-License-Identifier: MIT
* Copyright (c) 2024 [Your Name/Organization]
*/
```
## 3. Adaugă badge-uri în README
```markdown:README.md
# NXP Cup Line Follower - Complete Documentation
[](LICENSE-HARDWARE.txt)
[](LICENSE-DOCUMENTATION.txt)
[](LICENSE-SOFTWARE.txt)
<div align="center">
<img src="images/nxpcup-shield.jpg" width="600" alt="NXP Cup Shield">
</div>
```
## 4. Creează fișier NOTICE (opțional dar recomandat)
```markdown:NOTICE
NXP Cup Line Follower Project
Copyright (c) 2024 [Your Name/Organization]
This project contains components under different licenses:
1. Hardware designs (PCB, schematics, CAD files):
Licensed under CERN-OHL-S-2.0
See LICENSE-HARDWARE.txt
2. Documentation (markdown, images, tutorials):
Licensed under CC-BY-SA-4.0
See LICENSE-DOCUMENTATION.txt
3. Software (firmware, code examples):
Licensed under MIT
See LICENSE-SOFTWARE.txt
Third-party components:
- FRDM-MCXN947 SDK: Copyright NXP Semiconductors (BSD-3-Clause)
- DRV8833 example code: Copyright Texas Instruments
```
## 5. Structura de directoare recomandată
```
NXP_Linefollower/
├── LICENSE # Fișier principal cu toate licențele
├── LICENSE-HARDWARE.txt # (opțional) Licență separată hardware
├── LICENSE-DOCUMENTATION.txt # (opțional) Licență separată docs
├── LICENSE-SOFTWARE.txt # (opțional) Licență separată software
├── NOTICE # Informații despre licențe și copyright
├── README.md
├── hardware/
│ ├── pcb/ # Fișiere KiCad cu header CERN-OHL-S
│ ├── gerber/
│ └── bom/
├── docs/ # Fișiere .md cu header CC-BY-SA
│ ├── components.md
│ ├── shield-assembly.md
│ └── ...
├── software/ # Fișiere .c/.h cu header MIT
│ ├── src/
│ └── include/
└── images/ # Imagini cu licență CC-BY-SA
```
## 6. Pe GitHub
### Setează licența în repository settings:
1. Du-te la **Settings** → **General**
2. Scroll la **License**
3. Selectează **MIT License** (pentru software)
4. Adaugă în descriere: "Multi-licensed: CERN-OHL-S (hardware), CC-BY-SA-4.0 (docs), MIT (software)"
### Adaugă în `.gitattributes`:
```gitattributes:.gitattributes
# Hardware files
*.kicad_pcb linguist-detectable=false
*.kicad_sch linguist-detectable=false
# Documentation
*.md linguist-documentation
# Software
*.c linguist-language=C
*.h linguist-language=C
```
## 7. Exemplu complet de README actualizat:
```markdown:README.md
# NXP Cup Line Follower - Complete Documentation
[](https://ohwr.org/cern_ohl_s_v2.txt)
[](https://creativecommons.org/licenses/by-sa/4.0/)
[](https://opensource.org/licenses/MIT)
## 📄 License
This project is open source and available under multiple licenses:
### Hardware (PCB, Schematics, CAD files)
**CERN Open Hardware Licence v2 - Strongly Reciprocal (CERN-OHL-S-2.0)**
The hardware designs in this project are licensed under CERN-OHL-S-2.0. This means you can:
- ✅ Use the design commercially
- ✅ Modify the design
- ✅ Distribute the design
- ⚠️ Must share modifications under the same license
- ⚠️ Must provide design files with manufactured products
[Full license text](https://ohwr.org/cern_ohl_s_v2.txt)
### Documentation (Markdown, Images, Tutorials)
**Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0)**
The documentation is licensed under CC BY-SA 4.0. This means you can:
- ✅ Share and redistribute
- ✅ Adapt and remix
- ⚠️ Must give appropriate credit
- ⚠️ Must share adaptations under the same license
[Full license text](https://creativecommons.org/licenses/by-sa/4.0/legalcode)
### Software (Firmware, Code Examples)
**MIT License**
The software is licensed under MIT. This means you can:
- ✅ Use commercially
- ✅ Modify
- ✅ Distribute
- ✅ Sublicense
- ⚠️ Must include copyright notice
[Full license text](https://opensource.org/licenses/MIT)
---
See [LICENSE](LICENSE) for complete license texts and [NOTICE](NOTICE) for third-party components.