summaryrefslogtreecommitdiffstatshomepage
path: root/zephyr
diff options
context:
space:
mode:
authorPaul Sokolovsky <pfalcon@users.sourceforge.net>2017-02-01 21:23:29 +0300
committerPaul Sokolovsky <pfalcon@users.sourceforge.net>2017-02-01 21:28:11 +0300
commit00bd14539823a40cf98cabd826b0585f37732689 (patch)
tree4386d5b021f55a9c5431377d90594dd786d69bef /zephyr
parent28185bb81bc3340b5c84bfd8c974488c6ccb3dbd (diff)
downloadmicropython-00bd14539823a40cf98cabd826b0585f37732689.tar.gz
micropython-00bd14539823a40cf98cabd826b0585f37732689.zip
zephyr/README: Describe many gotchas of networked builds.
Diffstat (limited to 'zephyr')
-rw-r--r--zephyr/Makefile3
-rw-r--r--zephyr/README.md19
2 files changed, 21 insertions, 1 deletions
diff --git a/zephyr/Makefile b/zephyr/Makefile
index 4c28e4da85..3779765fb5 100644
--- a/zephyr/Makefile
+++ b/zephyr/Makefile
@@ -90,6 +90,9 @@ $(Z_SYSGEN_H):
minimal:
$(MAKE) BOARD=$(BOARD) CONF_FILE=prj_minimal.conf CFLAGS_EXTRA='-DMP_CONFIGFILE="<mpconfigport_minimal.h>"' FROZEN_DIR=
+qemu-minimal:
+ $(MAKE) -f Makefile.zephyr BOARD=$(BOARD) CONF_FILE=prj_minimal.conf QEMU_NET=0 run
+
# Clean Zephyr things too
clean: z_clean
diff --git a/zephyr/README.md b/zephyr/README.md
index 30f668bb4a..65729df5b9 100644
--- a/zephyr/README.md
+++ b/zephyr/README.md
@@ -49,8 +49,20 @@ qemu_cortex_m3):
make qemu
+With the default configuration, networking is now enabled, so you need to
+follow instructions in https://wiki.zephyrproject.org/view/Networking-with-Qemu
+to setup host side of TAP/SLIP networking. If you get error like:
+
+ could not connect serial device to character backend 'unix:/tmp/slip.sock'
+
+it's a sign that you didn't followed instructions above. If you would like
+to just run it quickly without extra setup, see "minimal" build below.
+
For deploying/flashing a firmware on a real board, follow Zephyr
-documentation for a given board.
+documentation for a given board (mind again that networking is enabled
+for the build, so you should be aware of known issues for a particular
+board; for example, frdm_k64f requires Ethernet cable connected to both
+board and host or it will hang/crash on startup).
Quick example
@@ -93,3 +105,8 @@ default over time.
To make a minimal build:
make BOARD=<board> minimal
+
+To run a minimal build in QEMU without requiring TAP networking setup
+run the following after you built image with the previous command:
+
+ make BOARD=<qemu_x86|qemu_cortex_m3> qemu-minimal