Initial upload

Author: ozgurbostan

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,50 @@
+---
+name: Bug report
+about: Create a bug/issue report to contribute and get support
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+It is important to describe your problem clear enough in order to have a more efficient solution process. 
+
+Your description must include hardware info, detailed explanation of your problem,  shortest code block to reproduce the error, expected behavior of the code block, exact error message and screenshots (if applicable). 
+
+------------------------------------------------ remove above ------------------------------------------------
+
+### Hardware:
+Board | : | Deneyap Kart
+----- | - | ------------
+Core version | : | 1.0.0 or ?
+IDE | : | VSCode Pymakr or ?
+Computer OS | : | Win or ?
+
+### Description:
+Describe your problem here.
+
+### Code to reproduce the error:  
+```python
+//Change the code below by your sketch
+import deneyap
+
+while True:
+```
+
+**Steps to reproduce the behavior:**
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+### Expected behavior:
+A clear and concise description of what you expected to happen.
+
+### Debug Messages:
+Copy error messages.
+
+### Screenshots:
+If applicable, add screenshots to help explain your problem.
+
+### Additional context:
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/bug_report_tr.md

@@ -0,0 +1,56 @@
+---
+name: Hata raporu
+about: Katkıda bulunmak ve destek almak için hata/sorun bildiriminde bulunun
+title: ''
+labels: ''
+assignees: ''
+
+---
+
+Daha verimli bir çözüm süreci yönetebilmek adına, karşılaşmış olduğunuz sorunu detaylı bir şekilde tanımlamanız önem arz etmektedir. 
+
+Hazırlayacağınız rapor aşağıda bulunanan temel başlıkları içermelidir:
+- Kullanmış olduğunuz donanım
+- Sorununuza ilişkin detay içerik
+- Sorun yaşamış olduğunuz en temel kod bloğu
+- Bu kod bloğunun beklenen çıktısı
+- Karşılaşılan hata mesajı
+- Ekran görüntüsü (ihtiyaç olması halinde)
+
+------------------------------------------------ buradan yukarısını silin ------------------------------------------------
+
+### Donanım:
+Kart | : | Deneyap Kart
+---- | - | ------------
+Kütüphane versiyonu | : | 1.0.0 ya da ?
+IDE | : | VSCode Pymakr IDE ya da ?
+İşletim sistemi | : | Windows ya da ?
+
+### Hata tanımı:
+Karşılaşmış olduğunu soruna ilişkin detaylı tanımlamayı burada yapın.
+
+### Sorun yaşamış olduğunuz en temel kod bloğu:  
+```python
+//Asagidaki kod blogunu sorun yasamis oldugunuz kod blogu ile degistiriniz
+import deneyap
+
+while True:
+```
+
+**Hata ile karşılaşırken gerçekleştirdiğiniz adımları belirtin:**
+1. Şuraya git '...'
+2. Şurayı tıkla '....'
+3. Aşağı kaydır '....'
+4. Hatayı gözlemle vb.
+
+### Beklenen çıktı:
+Paylaşmış olduğunuz kod bloğunun beklenen davranışı nedir, burada açıklayın. 
+
+### Hata mesajı:
+Derleyici tarafından üretilen hata mesajını paylaşın.
+
+### Ekran görüntüleri:
+Hatanızı tanımlarken size yardımcı olacağını düşündüğünüz ekran görüntülerini buraya ekleyin.
+
+### Ek kaynak:
+Sorunuzu tanımlama için eklemek istediğiniz ek kaynakları burada paylaşın.

.gitignore

@@ -0,0 +1,5 @@
+mpy-cross/build
+mpy-cross/mpy-cross.map
+ports/esp32/build-DENEYAPKART
+ports/esp32/boards/DENEYAPKART/examples
+py/__pycache__/makeqstrdata.cpython-38.pyc

README.md

@@ -1 +1,32 @@
-# deneyapkart-micropython-core
+# Deneyap Kart MicroPython Core 
+[FOR TURKISH VERSION](docs/others/README_tr.md) ![trflag](docs/others/tr.png)
+
+Deneyap Kart, designed and manufactured in Turkey, is a powerful development board with its strong MCU, robust design and flexible GPIOs. It allows the users in all levels (beginners to professionals) to create, design and develop projects in the fields of Electronics, Internet of Things (IoT) and Artificial Intelligence (AI). 
+
+For more information, please visit [Deneyap Kart Technical Guide](https://docs.deneyapkart.org/#deneyap-kart) and [Deneyap Kart Official Website](https://deneyapkart.org).
+
+## Contents
+- [Flashing Instructions](#flashing-instructions)
+- [Troubleshooting](#troubleshooting)
+- [Deneyap Kart Pinout](#deneyap-kart-pinout)
+
+### Flashing Instructions
+- Install [Python 3](https://www.python.org/downloads/).
+- With Python 3 installed, open a Terminal window and install the latest stable **esptool** release with pip3:
+  `pip3 install esptool`
+- Download latest [Deneyap Kart MicroPython firmware](https://github.com/deneyapkart/deneyapkart-micropython-core/releases/download/1.0.0/deneyapkart_micropython_v1.0.0.bin).
+- Find the Serial Port Name (**PORT**). You may get port name via Arduino IDE from **Tools > Port**.
+- Before flashing the MicroPython firmware, Deneyap Kart flash memory needs to be erased with the following command (change the **PORT** name with the one obtained in the previous step):
+```python
+esptool --chip esp32 --port <PORT> erase_flash
+```
+- With flash memory erased, flash the Deneyap Kart MicroPython firmware with the following command (change the **PORT** name and **DIR** based on your details):
+```python
+esptool --chip esp32 --port <PORT> --baud 460800 write_flash -z 0x1000 <DIR (Deneyap Kart MicroPython firmware path)>
+```
+
+### Troubleshooting
+To report any issue/bug/problem etc., please make sure you have searched the similar encountered problems first. After that, if you are sure no on else had the same issue, use the [issue template](.github/ISSUE_TEMPLATE/bug_report.md) while reporting.  
+
+### Deneyap Kart Pinout
+![PinoutENG](docs/others/DeneyapKartPinoutENG_mpv1.0.png)

docs/Makefile

@@ -0,0 +1,191 @@
+# Makefile for Sphinx documentation
+#
+
+# You can set these variables from the command line.
+PYTHON        = python3
+SPHINXOPTS    = -W --keep-going
+SPHINXBUILD   = sphinx-build
+PAPER         =
+BUILDDIR      = build/$(MICROPY_PORT)
+CPYDIFFDIR    = ../tools
+CPYDIFF       = gen-cpydiff.py
+GENRSTDIR     = genrst
+# Run "make FORCE= ..." to avoid rebuilding from scratch (and risk
+# producing incorrect docs).
+FORCE         = -E
+
+# User-friendly check for sphinx-build
+ifeq ($(shell which $(SPHINXBUILD) >/dev/null 2>&1; echo $$?), 1)
+$(error The '$(SPHINXBUILD)' command was not found. Make sure you have Sphinx installed, then set the SPHINXBUILD environment variable to point to the full path of the '$(SPHINXBUILD)' executable. Alternatively you can add the directory with the executable to your PATH. If you don't have Sphinx installed, grab it from http://sphinx-doc.org/)
+endif
+
+# Internal variables.
+PAPEROPT_a4     = -D latex_paper_size=a4
+PAPEROPT_letter = -D latex_paper_size=letter
+ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
+# the i18n builder cannot share the environment and doctrees with the others
+I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) .
+
+.PHONY: help clean html dirhtml singlehtml pickle json htmlhelp qthelp devhelp epub latex latexpdf text man changes linkcheck doctest gettext
+
+help:
+	@echo "Please use \`make <target>' where <target> is one of"
+	@echo "  html       to make standalone HTML files"
+	@echo "  dirhtml    to make HTML files named index.html in directories"
+	@echo "  singlehtml to make a single large HTML file"
+	@echo "  pickle     to make pickle files"
+	@echo "  json       to make JSON files"
+	@echo "  htmlhelp   to make HTML files and a HTML help project"
+	@echo "  qthelp     to make HTML files and a qthelp project"
+	@echo "  devhelp    to make HTML files and a Devhelp project"
+	@echo "  epub       to make an epub"
+	@echo "  latex      to make LaTeX files, you can set PAPER=a4 or PAPER=letter"
+	@echo "  latexpdf   to make LaTeX files and run them through pdflatex"
+	@echo "  latexpdfja to make LaTeX files and run them through platex/dvipdfmx"
+	@echo "  text       to make text files"
+	@echo "  man        to make manual pages"
+	@echo "  texinfo    to make Texinfo files"
+	@echo "  info       to make Texinfo files and run them through makeinfo"
+	@echo "  gettext    to make PO message catalogs"
+	@echo "  changes    to make an overview of all changed/added/deprecated items"
+	@echo "  xml        to make Docutils-native XML files"
+	@echo "  pseudoxml  to make pseudoxml-XML files for display purposes"
+	@echo "  linkcheck  to check all external links for integrity"
+	@echo "  doctest    to run all doctests embedded in the documentation (if enabled)"
+	@echo "  cpydiff    to generate the MicroPython differences from CPython"
+
+clean:
+	rm -rf $(BUILDDIR)/*
+	rm -f $(GENRSTDIR)/*
+
+cpydiff:
+	@echo "Generating MicroPython Differences."
+	rm -f $(GENRSTDIR)/*
+	cd $(CPYDIFFDIR) && $(PYTHON) $(CPYDIFF)
+
+html: cpydiff
+	$(SPHINXBUILD) $(FORCE) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/html."
+
+dirhtml:
+	$(SPHINXBUILD) -b dirhtml $(ALLSPHINXOPTS) $(BUILDDIR)/dirhtml
+	@echo
+	@echo "Build finished. The HTML pages are in $(BUILDDIR)/dirhtml."
+
+singlehtml:
+	$(SPHINXBUILD) -b singlehtml $(ALLSPHINXOPTS) $(BUILDDIR)/singlehtml
+	@echo
+	@echo "Build finished. The HTML page is in $(BUILDDIR)/singlehtml."
+
+pickle:
+	$(SPHINXBUILD) -b pickle $(ALLSPHINXOPTS) $(BUILDDIR)/pickle
+	@echo
+	@echo "Build finished; now you can process the pickle files."
+
+json:
+	$(SPHINXBUILD) -b json $(ALLSPHINXOPTS) $(BUILDDIR)/json
+	@echo
+	@echo "Build finished; now you can process the JSON files."
+
+htmlhelp:
+	$(SPHINXBUILD) -b htmlhelp $(ALLSPHINXOPTS) $(BUILDDIR)/htmlhelp
+	@echo
+	@echo "Build finished; now you can run HTML Help Workshop with the" \
+	      ".hhp project file in $(BUILDDIR)/htmlhelp."
+
+qthelp:
+	$(SPHINXBUILD) -b qthelp $(ALLSPHINXOPTS) $(BUILDDIR)/qthelp
+	@echo
+	@echo "Build finished; now you can run "qcollectiongenerator" with the" \
+	      ".qhcp project file in $(BUILDDIR)/qthelp, like this:"
+	@echo "# qcollectiongenerator $(BUILDDIR)/qthelp/MicroPython.qhcp"
+	@echo "To view the help file:"
+	@echo "# assistant -collectionFile $(BUILDDIR)/qthelp/MicroPython.qhc"
+
+devhelp:
+	$(SPHINXBUILD) -b devhelp $(ALLSPHINXOPTS) $(BUILDDIR)/devhelp
+	@echo
+	@echo "Build finished."
+	@echo "To view the help file:"
+	@echo "# mkdir -p $$HOME/.local/share/devhelp/MicroPython"
+	@echo "# ln -s $(BUILDDIR)/devhelp $$HOME/.local/share/devhelp/MicroPython"
+	@echo "# devhelp"
+
+epub:
+	$(SPHINXBUILD) -b epub $(ALLSPHINXOPTS) $(BUILDDIR)/epub
+	@echo
+	@echo "Build finished. The epub file is in $(BUILDDIR)/epub."
+
+latex: cpydiff
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo
+	@echo "Build finished; the LaTeX files are in $(BUILDDIR)/latex."
+	@echo "Run \`make' in that directory to run these through (pdf)latex" \
+	      "(use \`make latexpdf' here to do that automatically)."
+
+latexpdf: cpydiff
+	$(SPHINXBUILD) $(FORCE) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo "Running LaTeX files through pdflatex..."
+	$(MAKE) -C $(BUILDDIR)/latex all-pdf
+	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
+
+latexpdfja: cpydiff
+	$(SPHINXBUILD) -b latex $(ALLSPHINXOPTS) $(BUILDDIR)/latex
+	@echo "Running LaTeX files through platex and dvipdfmx..."
+	$(MAKE) -C $(BUILDDIR)/latex all-pdf-ja
+	@echo "pdflatex finished; the PDF files are in $(BUILDDIR)/latex."
+
+text:
+	$(SPHINXBUILD) -b text $(ALLSPHINXOPTS) $(BUILDDIR)/text
+	@echo
+	@echo "Build finished. The text files are in $(BUILDDIR)/text."
+
+man:
+	$(SPHINXBUILD) -b man $(ALLSPHINXOPTS) $(BUILDDIR)/man
+	@echo
+	@echo "Build finished. The manual pages are in $(BUILDDIR)/man."
+
+texinfo:
+	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
+	@echo
+	@echo "Build finished. The Texinfo files are in $(BUILDDIR)/texinfo."
+	@echo "Run \`make' in that directory to run these through makeinfo" \
+	      "(use \`make info' here to do that automatically)."
+
+info:
+	$(SPHINXBUILD) -b texinfo $(ALLSPHINXOPTS) $(BUILDDIR)/texinfo
+	@echo "Running Texinfo files through makeinfo..."
+	make -C $(BUILDDIR)/texinfo info
+	@echo "makeinfo finished; the Info files are in $(BUILDDIR)/texinfo."
+
+gettext:
+	$(SPHINXBUILD) -b gettext $(I18NSPHINXOPTS) $(BUILDDIR)/locale
+	@echo
+	@echo "Build finished. The message catalogs are in $(BUILDDIR)/locale."
+
+changes:
+	$(SPHINXBUILD) -b changes $(ALLSPHINXOPTS) $(BUILDDIR)/changes
+	@echo
+	@echo "The overview file is in $(BUILDDIR)/changes."
+
+linkcheck:
+	$(SPHINXBUILD) -b linkcheck $(ALLSPHINXOPTS) $(BUILDDIR)/linkcheck
+	@echo
+	@echo "Link check complete; look for any errors in the above output " \
+	      "or in $(BUILDDIR)/linkcheck/output.txt."
+
+doctest:
+	$(SPHINXBUILD) -b doctest $(ALLSPHINXOPTS) $(BUILDDIR)/doctest
+	@echo "Testing of doctests in the sources finished, look at the " \
+	      "results in $(BUILDDIR)/doctest/output.txt."
+
+xml:
+	$(SPHINXBUILD) -b xml $(ALLSPHINXOPTS) $(BUILDDIR)/xml
+	@echo
+	@echo "Build finished. The XML files are in $(BUILDDIR)/xml."
+
+pseudoxml:
+	$(SPHINXBUILD) -b pseudoxml $(ALLSPHINXOPTS) $(BUILDDIR)/pseudoxml
+	@echo
+	@echo "Build finished. The pseudo-XML files are in $(BUILDDIR)/pseudoxml."

docs/README.md

@@ -0,0 +1,53 @@
+MicroPython Documentation
+=========================
+
+The MicroPython documentation can be found at:
+http://docs.micropython.org/en/latest/
+
+The documentation you see there is generated from the files in the docs tree:
+https://github.com/micropython/micropython/tree/master/docs
+
+Building the documentation locally
+----------------------------------
+
+If you're making changes to the documentation, you may want to build the
+documentation locally so that you can preview your changes.
+
+Install Sphinx, and optionally (for the RTD-styling), sphinx_rtd_theme,
+preferably in a virtualenv:
+
+     pip install sphinx
+     pip install sphinx_rtd_theme
+
+In `micropython/docs`, build the docs:
+
+    make html
+
+You'll find the index page at `micropython/docs/build/html/index.html`.
+
+Having readthedocs.org build the documentation
+----------------------------------------------
+
+If you would like to have docs for forks/branches hosted on GitHub, GitLab or
+BitBucket an alternative to building the docs locally is to sign up for a free
+https://readthedocs.org account. The rough steps to follow are:
+1. sign-up for an account, unless you already have one
+2. in your account settings: add GitHub as a connected service (assuming
+you have forked this repo on github)
+3. in your account projects: import your forked/cloned micropython repository
+into readthedocs
+4. in the project's versions: add the branches you are developing on or
+for which you'd like readthedocs to auto-generate docs whenever you
+push a change
+
+PDF manual generation
+---------------------
+
+This can be achieved with:
+
+    make latexpdf
+
+but require rather complete install of LaTeX with various extensions. On
+Debian/Ubuntu, try (500MB+ download):
+
+    apt-get install texlive-latex-recommended texlive-latex-extra