summaryrefslogtreecommitdiffstats
path: root/examples/simple/README
diff options
context:
space:
mode:
authorPetteri Aimonen <jpa@git.mail.kapsi.fi>2013-09-13 13:35:25 +0300
committerPetteri Aimonen <jpa@git.mail.kapsi.fi>2013-09-13 13:35:25 +0300
commit73142ba082e56b8c5ba75c055a20c200b623da83 (patch)
treeb8d2595cc70ac415bec3cc42eb561ce487696707 /examples/simple/README
parentf47410ea4b8ae43e19facd378be4cf1073e1813b (diff)
Add a new very simple example
Diffstat (limited to 'examples/simple/README')
-rw-r--r--examples/simple/README30
1 files changed, 30 insertions, 0 deletions
diff --git a/examples/simple/README b/examples/simple/README
new file mode 100644
index 00000000..d18c4183
--- /dev/null
+++ b/examples/simple/README
@@ -0,0 +1,30 @@
+Nanopb example "simple"
+=======================
+
+This example demonstrates the very basic use of nanopb. It encodes and
+decodes a simple message.
+
+The code uses four different API functions:
+
+ * pb_ostream_from_buffer() to declare the output buffer that is to be used
+ * pb_encode() to encode a message
+ * pb_istream_from_buffer() to declare the input buffer that is to be used
+ * pb_decode() to decode a message
+
+Example usage
+-------------
+
+On Linux, simply type "make" to build the example. After that, you can
+run it with the command: ./simple
+
+On other platforms, you first have to compile the protocol definition using
+the following two commands::
+
+ protoc -osimple.pb simple.proto
+ python nanopb_generator.py simple.pb
+
+After that, add the following four files to your project and compile:
+
+ simple.c simple.pb.c pb_encode.c pb_decode.c
+
+