Radxa Wiki - User contributions [en]

Mraa

2022-10-10T03:12:40Z

Curry: /* Install example: Install Mraa on CM3 IO Debian11 system */

{{Languages|rockpiN10}}

=== Mraa on ROCK Pi boards ===
This document describes how to build and use mraa for ROCK Pi boards.

==== List of ROCK Pi Boards supported ====
* ROCK Pi 4 A/B/C
* ROCK Pi E
* ROCK Pi N10
* ROCK Pi S
* ROCK Pi X

==== List of Linux Distributions ====
* Ubuntu
* Debian
* Yocto (mraa-radxa_git.bb)

==== Install example: Install Mraa on ROCK Pi N10 Debian system ====
For Debian Distribution the below commands install the essential set:
<pre>
root@rockpin10bc:/home/rock# apt-get install -y git build-essential swig3.0 python-dev cmake libjson-c-dev libnode-dev
root@rockpin10bc:/home/rock# apt-get install -y libc6 libjson-c3 libgcc1 libstdc++6 python2.7 libpython2.7 python3.7 libpython3.7 python3-dev
root@rockpin10bc:/home/rock# apt-get install -y libgtest-dev pkg-config cmake-data
</pre>

Get source code.
<pre>
root@rockpin10bc:/home/rock# git clone -b master https://github.com/radxa/mraa.git
root@rockpin10bc:/home/rock# cd mraa
</pre>

Patch the source code for building mraa with Python.
<pre>
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 250d910..f1880e1 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -145,7 +145,7 @@ include_directories (${SYSTEM_USR_DIR})
option (BUILDDOC "Build all doc." OFF)
option (BUILDSWIG "Build swig modules." ON)
option (BUILDSWIGPYTHON "Build swig python modules." ON)
-option (BUILDSWIGNODE "Build swig node modules." ON)
+option (BUILDSWIGNODE "Build swig node modules." OFF)
option (BUILDSWIGJAVA "Build Java API." OFF)
option (USBPLAT "Detection USB platform." OFF)
option (FIRMATA "Add Firmata support to mraa." OFF)
@@ -156,7 +156,7 @@ option (FTDI4222 "Build with FTDI FT4222 subplatform support." OFF)
option (ENABLEEXAMPLES "Disable building of examples" ON)
option (INSTALLTOOLS "Install all tools" ON)
option (BUILDTESTS "Override the addition of tests" ON)
-option (USEPYTHON3TESTS "Force tests to run with python3" OFF)
+option (USEPYTHON3TESTS "Force tests to run with python3" ON)

set (BUILDARCH "" CACHE STRING "Override architecture to build for")
</pre>

Build and install mraa.

<pre>
root@rockpin10bc:/home/rock/mraa# mkdir build
root@rockpin10bc:/home/rock/mraa# cd build/
root@rockpin10bc:/home/rock/mraa/build# cmake ..
root@rockpin10bc:/home/rock/mraa/build# make
root@rockpin10bc:/home/rock/mraa/build# make install
root@rockpin10bc:/home/rock/mraa/build# ldconfig
root@rockpin10bc:/home/rock/mraa/build# mraa-gpio version
Version v2.1.0-11-g06b2be2 on Radxa ROCK Pi N10
</pre>

==== Install example: Install Mraa on CM3 IO Debian11 system ====
For Debian11 Distribution the below commands install the essential set:

<pre>
root@radxa-cm3-io:/home/rock# apt-get install -y git build-essential swig4.0 python-dev cmake libnode-dev python3-dev pkg-config
</pre>

Get source code.
<pre>
root@radxa-cm3-io:/home/rock# git clone -b master https://github.com/radxa/mraa.git
root@radxa-cm3-io:/home/rock# cd mraa
</pre>

Patch the source code for building mraa with Python.
<pre>
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 250d910..f1880e1 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -145,7 +145,7 @@ include_directories (${SYSTEM_USR_DIR})
option (BUILDDOC "Build all doc." OFF)
option (BUILDSWIG "Build swig modules." ON)
option (BUILDSWIGPYTHON "Build swig python modules." ON)
-option (BUILDSWIGNODE "Build swig node modules." ON)
+option (BUILDSWIGNODE "Build swig node modules." OFF)
option (BUILDSWIGJAVA "Build Java API." OFF)
option (USBPLAT "Detection USB platform." OFF)
option (FIRMATA "Add Firmata support to mraa." OFF)
@@ -156,7 +156,7 @@ option (FTDI4222 "Build with FTDI FT4222 subplatform support." OFF)
option (ENABLEEXAMPLES "Disable building of examples" ON)
option (INSTALLTOOLS "Install all tools" ON)
option (BUILDTESTS "Override the addition of tests" ON)
-option (USEPYTHON3TESTS "Force tests to run with python3" OFF)
+option (USEPYTHON3TESTS "Force tests to run with python3" ON)

set (BUILDARCH "" CACHE STRING "Override architecture to build for")
</pre>

Patch for later compilation with make
<pre>
diff --git a/include/version.h b/include/version.h
index 47366ef..3a567a1 100644
--- a/include/version.h
+++ b/include/version.h
@@ -11,8 +11,8 @@
extern "C" {
#endif

-const char* gVERSION;
-const char* gVERSION_SHORT;
+extern const char* gVERSION;
+extern const char* gVERSION_SHORT;

#ifdef __cplusplus
}
</pre>

Build and install mraa.

<pre>
root@radxa-cm3-io:/home/rock/mraa# mkdir build
root@radxa-cm3-io:/home/rock/mraa# cd build/
root@radxa-cm3-io:/home/rock/mraa/build# cmake ..
root@radxa-cm3-io:/home/rock/mraa/build# make
root@radxa-cm3-io:/home/rock/mraa/build# make install
root@radxa-cm3-io:/home/rock/mraa/build# ldconfig
root@radxa-cm3-io:/home/rock/mraa/build# mraa-gpio version
Version v2.1.0-23-gfc8c906 on Radxa CM3 IO
</pre>

==== Install example: Install Mraa on ROCK Pi 4C Ubuntu Focal system ====
For Ubuntu Distribution the below commands install the essential set:

<pre>
root@rockpin10bc:/home/rock# apt-get install -y git build-essential swig3.0 python-dev cmake libjson-c-dev libnode-dev
root@rockpin10bc:/home/rock# apt-get install -y libc6 libgcc1 libstdc++6 python python2.7 libpython2.7 python3.8 libpython3.8 python3-dev python3
root@rockpin10bc:/home/rock# apt-get install -y libgtest-dev pkg-config cmake-data
</pre>
Get source code.
<pre>
root@rockpin10bc:/home/rock# git clone -b master https://github.com/radxa/mraa.git
root@rockpin10bc:/home/rock# cd mraa
</pre>

Patch the source code for building mraa with Python.
<pre>
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 250d910..f1880e1 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -145,7 +145,7 @@ include_directories (${SYSTEM_USR_DIR})
option (BUILDDOC "Build all doc." OFF)
option (BUILDSWIG "Build swig modules." ON)
option (BUILDSWIGPYTHON "Build swig python modules." ON)
-option (BUILDSWIGNODE "Build swig node modules." ON)
+option (BUILDSWIGNODE "Build swig node modules." OFF)
option (BUILDSWIGJAVA "Build Java API." OFF)
option (USBPLAT "Detection USB platform." OFF)
option (FIRMATA "Add Firmata support to mraa." OFF)
@@ -156,7 +156,7 @@ option (FTDI4222 "Build with FTDI FT4222 subplatform support." OFF)
option (ENABLEEXAMPLES "Disable building of examples" ON)
option (INSTALLTOOLS "Install all tools" ON)
option (BUILDTESTS "Override the addition of tests" ON)
-option (USEPYTHON3TESTS "Force tests to run with python3" OFF)
+option (USEPYTHON3TESTS "Force tests to run with python3" ON)

set (BUILDARCH "" CACHE STRING "Override architecture to build for")
</pre>

Build and install mraa.

<pre>
root@rockpin10bc:/home/rock/mraa# mkdir build
root@rockpin10bc:/home/rock/mraa# cd build/
root@rockpin10bc:/home/rock/mraa/build# cmake ..
root@rockpin10bc:/home/rock/mraa/build# make
root@rockpin10bc:/home/rock/mraa/build# make install
root@rockpin10bc:/home/rock/mraa/build# ldconfig
root@rockpin10bc:/home/rock/mraa/build# mraa-gpio version
Version v2.1.0-11-g06b2be2 on ROCK Pi 4
</pre>

==== Use mraa ====
Since we have installed mraa successfully, now we start to use it. At this part, you can check out the following guides.

* [[rockpi4/dev/libmraa | mraa on ROCK Pi 4 ]]
* [[rockpiE/dev/libmraa | mraa on ROCK Pi E ]]
* [[rockpiN10/dev/libmraa | mraa on ROCK Pi N10 ]]
* [[rockpiS/dev/libmraa | mraa on ROCK Pi S ]]

==== Troubleshooting ====
* If you have an issue, start a new post on the forum. https://forum.radxa.com/.

Mraa

2022-10-10T03:06:17Z

Curry: /* Install example: Install Mraa on CM3 IO Debian11 system */

{{Languages|rockpiN10}}

=== Mraa on ROCK Pi boards ===
This document describes how to build and use mraa for ROCK Pi boards.

==== List of ROCK Pi Boards supported ====
* ROCK Pi 4 A/B/C
* ROCK Pi E
* ROCK Pi N10
* ROCK Pi S
* ROCK Pi X

==== List of Linux Distributions ====
* Ubuntu
* Debian
* Yocto (mraa-radxa_git.bb)

==== Install example: Install Mraa on ROCK Pi N10 Debian system ====
For Debian Distribution the below commands install the essential set:
<pre>
root@rockpin10bc:/home/rock# apt-get install -y git build-essential swig3.0 python-dev cmake libjson-c-dev libnode-dev
root@rockpin10bc:/home/rock# apt-get install -y libc6 libjson-c3 libgcc1 libstdc++6 python2.7 libpython2.7 python3.7 libpython3.7 python3-dev
root@rockpin10bc:/home/rock# apt-get install -y libgtest-dev pkg-config cmake-data
</pre>

Get source code.
<pre>
root@rockpin10bc:/home/rock# git clone -b master https://github.com/radxa/mraa.git
root@rockpin10bc:/home/rock# cd mraa
</pre>

Patch the source code for building mraa with Python.
<pre>
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 250d910..f1880e1 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -145,7 +145,7 @@ include_directories (${SYSTEM_USR_DIR})
option (BUILDDOC "Build all doc." OFF)
option (BUILDSWIG "Build swig modules." ON)
option (BUILDSWIGPYTHON "Build swig python modules." ON)
-option (BUILDSWIGNODE "Build swig node modules." ON)
+option (BUILDSWIGNODE "Build swig node modules." OFF)
option (BUILDSWIGJAVA "Build Java API." OFF)
option (USBPLAT "Detection USB platform." OFF)
option (FIRMATA "Add Firmata support to mraa." OFF)
@@ -156,7 +156,7 @@ option (FTDI4222 "Build with FTDI FT4222 subplatform support." OFF)
option (ENABLEEXAMPLES "Disable building of examples" ON)
option (INSTALLTOOLS "Install all tools" ON)
option (BUILDTESTS "Override the addition of tests" ON)
-option (USEPYTHON3TESTS "Force tests to run with python3" OFF)
+option (USEPYTHON3TESTS "Force tests to run with python3" ON)

set (BUILDARCH "" CACHE STRING "Override architecture to build for")
</pre>

Build and install mraa.

<pre>
root@rockpin10bc:/home/rock/mraa# mkdir build
root@rockpin10bc:/home/rock/mraa# cd build/
root@rockpin10bc:/home/rock/mraa/build# cmake ..
root@rockpin10bc:/home/rock/mraa/build# make
root@rockpin10bc:/home/rock/mraa/build# make install
root@rockpin10bc:/home/rock/mraa/build# ldconfig
root@rockpin10bc:/home/rock/mraa/build# mraa-gpio version
Version v2.1.0-11-g06b2be2 on Radxa ROCK Pi N10
</pre>

==== Install example: Install Mraa on CM3 IO Debian11 system ====
For Debian11 Distribution the below commands install the essential set:

<pre>
root@radxa-cm3-io:/home/rock# apt-get install -y git build-essential swig4.0 python-dev cmake libnode-dev python3-dev pkg-config
</pre>

Get source code.
<pre>
root@radxa-cm3-io:/home/rock# git clone -b master https://github.com/radxa/mraa.git
root@radxa-cm3-io:/home/rock# cd mraa
</pre>

Patch the source code for building mraa with Python.
<pre>
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 250d910..f1880e1 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -145,7 +145,7 @@ include_directories (${SYSTEM_USR_DIR})
option (BUILDDOC "Build all doc." OFF)
option (BUILDSWIG "Build swig modules." ON)
option (BUILDSWIGPYTHON "Build swig python modules." ON)
-option (BUILDSWIGNODE "Build swig node modules." ON)
+option (BUILDSWIGNODE "Build swig node modules." OFF)
option (BUILDSWIGJAVA "Build Java API." OFF)
option (USBPLAT "Detection USB platform." OFF)
option (FIRMATA "Add Firmata support to mraa." OFF)
@@ -156,7 +156,7 @@ option (FTDI4222 "Build with FTDI FT4222 subplatform support." OFF)
option (ENABLEEXAMPLES "Disable building of examples" ON)
option (INSTALLTOOLS "Install all tools" ON)
option (BUILDTESTS "Override the addition of tests" ON)
-option (USEPYTHON3TESTS "Force tests to run with python3" OFF)
+option (USEPYTHON3TESTS "Force tests to run with python3" ON)

set (BUILDARCH "" CACHE STRING "Override architecture to build for")
</pre>

Add the keyword extern.
<pre>
diff --git a/include/version.h b/include/version.h
index 47366ef..3a567a1 100644
--- a/include/version.h
+++ b/include/version.h
@@ -11,8 +11,8 @@
extern "C" {
#endif

-const char* gVERSION;
-const char* gVERSION_SHORT;
+extern const char* gVERSION;
+extern const char* gVERSION_SHORT;

#ifdef __cplusplus
}
</pre>

Build and install mraa.

<pre>
root@radxa-cm3-io:/home/rock/mraa# mkdir build
root@radxa-cm3-io:/home/rock/mraa# cd build/
root@radxa-cm3-io:/home/rock/mraa/build# cmake ..
root@radxa-cm3-io:/home/rock/mraa/build# make
root@radxa-cm3-io:/home/rock/mraa/build# make install
root@radxa-cm3-io:/home/rock/mraa/build# ldconfig
root@radxa-cm3-io:/home/rock/mraa/build# mraa-gpio version
Version v2.1.0-23-gfc8c906 on Radxa CM3 IO
</pre>

==== Install example: Install Mraa on ROCK Pi 4C Ubuntu Focal system ====
For Ubuntu Distribution the below commands install the essential set:

<pre>
root@rockpin10bc:/home/rock# apt-get install -y git build-essential swig3.0 python-dev cmake libjson-c-dev libnode-dev
root@rockpin10bc:/home/rock# apt-get install -y libc6 libgcc1 libstdc++6 python python2.7 libpython2.7 python3.8 libpython3.8 python3-dev python3
root@rockpin10bc:/home/rock# apt-get install -y libgtest-dev pkg-config cmake-data
</pre>
Get source code.
<pre>
root@rockpin10bc:/home/rock# git clone -b master https://github.com/radxa/mraa.git
root@rockpin10bc:/home/rock# cd mraa
</pre>

Patch the source code for building mraa with Python.
<pre>
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 250d910..f1880e1 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -145,7 +145,7 @@ include_directories (${SYSTEM_USR_DIR})
option (BUILDDOC "Build all doc." OFF)
option (BUILDSWIG "Build swig modules." ON)
option (BUILDSWIGPYTHON "Build swig python modules." ON)
-option (BUILDSWIGNODE "Build swig node modules." ON)
+option (BUILDSWIGNODE "Build swig node modules." OFF)
option (BUILDSWIGJAVA "Build Java API." OFF)
option (USBPLAT "Detection USB platform." OFF)
option (FIRMATA "Add Firmata support to mraa." OFF)
@@ -156,7 +156,7 @@ option (FTDI4222 "Build with FTDI FT4222 subplatform support." OFF)
option (ENABLEEXAMPLES "Disable building of examples" ON)
option (INSTALLTOOLS "Install all tools" ON)
option (BUILDTESTS "Override the addition of tests" ON)
-option (USEPYTHON3TESTS "Force tests to run with python3" OFF)
+option (USEPYTHON3TESTS "Force tests to run with python3" ON)

set (BUILDARCH "" CACHE STRING "Override architecture to build for")
</pre>

Build and install mraa.

<pre>
root@rockpin10bc:/home/rock/mraa# mkdir build
root@rockpin10bc:/home/rock/mraa# cd build/
root@rockpin10bc:/home/rock/mraa/build# cmake ..
root@rockpin10bc:/home/rock/mraa/build# make
root@rockpin10bc:/home/rock/mraa/build# make install
root@rockpin10bc:/home/rock/mraa/build# ldconfig
root@rockpin10bc:/home/rock/mraa/build# mraa-gpio version
Version v2.1.0-11-g06b2be2 on ROCK Pi 4
</pre>

==== Use mraa ====
Since we have installed mraa successfully, now we start to use it. At this part, you can check out the following guides.

* [[rockpi4/dev/libmraa | mraa on ROCK Pi 4 ]]
* [[rockpiE/dev/libmraa | mraa on ROCK Pi E ]]
* [[rockpiN10/dev/libmraa | mraa on ROCK Pi N10 ]]
* [[rockpiS/dev/libmraa | mraa on ROCK Pi S ]]

==== Troubleshooting ====
* If you have an issue, start a new post on the forum. https://forum.radxa.com/.

Mraa

2022-10-10T02:01:26Z

Curry: /* Install example: Install Mraa on CM3 IO Debian11 system */

{{Languages|rockpiN10}}

=== Mraa on ROCK Pi boards ===
This document describes how to build and use mraa for ROCK Pi boards.

==== List of ROCK Pi Boards supported ====
* ROCK Pi 4 A/B/C
* ROCK Pi E
* ROCK Pi N10
* ROCK Pi S
* ROCK Pi X

==== List of Linux Distributions ====
* Ubuntu
* Debian
* Yocto (mraa-radxa_git.bb)

==== Install example: Install Mraa on ROCK Pi N10 Debian system ====
For Debian Distribution the below commands install the essential set:
<pre>
root@rockpin10bc:/home/rock# apt-get install -y git build-essential swig3.0 python-dev cmake libjson-c-dev libnode-dev
root@rockpin10bc:/home/rock# apt-get install -y libc6 libjson-c3 libgcc1 libstdc++6 python2.7 libpython2.7 python3.7 libpython3.7 python3-dev
root@rockpin10bc:/home/rock# apt-get install -y libgtest-dev pkg-config cmake-data
</pre>

Get source code.
<pre>
root@rockpin10bc:/home/rock# git clone -b master https://github.com/radxa/mraa.git
root@rockpin10bc:/home/rock# cd mraa
</pre>

Patch the source code for building mraa with Python.
<pre>
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 250d910..f1880e1 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -145,7 +145,7 @@ include_directories (${SYSTEM_USR_DIR})
option (BUILDDOC "Build all doc." OFF)
option (BUILDSWIG "Build swig modules." ON)
option (BUILDSWIGPYTHON "Build swig python modules." ON)
-option (BUILDSWIGNODE "Build swig node modules." ON)
+option (BUILDSWIGNODE "Build swig node modules." OFF)
option (BUILDSWIGJAVA "Build Java API." OFF)
option (USBPLAT "Detection USB platform." OFF)
option (FIRMATA "Add Firmata support to mraa." OFF)
@@ -156,7 +156,7 @@ option (FTDI4222 "Build with FTDI FT4222 subplatform support." OFF)
option (ENABLEEXAMPLES "Disable building of examples" ON)
option (INSTALLTOOLS "Install all tools" ON)
option (BUILDTESTS "Override the addition of tests" ON)
-option (USEPYTHON3TESTS "Force tests to run with python3" OFF)
+option (USEPYTHON3TESTS "Force tests to run with python3" ON)

set (BUILDARCH "" CACHE STRING "Override architecture to build for")
</pre>

Build and install mraa.

<pre>
root@rockpin10bc:/home/rock/mraa# mkdir build
root@rockpin10bc:/home/rock/mraa# cd build/
root@rockpin10bc:/home/rock/mraa/build# cmake ..
root@rockpin10bc:/home/rock/mraa/build# make
root@rockpin10bc:/home/rock/mraa/build# make install
root@rockpin10bc:/home/rock/mraa/build# ldconfig
root@rockpin10bc:/home/rock/mraa/build# mraa-gpio version
Version v2.1.0-11-g06b2be2 on Radxa ROCK Pi N10
</pre>

==== Install example: Install Mraa on CM3 IO Debian11 system ====
For Debian11 Distribution the below commands install the essential set:

<pre>
root@radxa-cm3-io:/home/rock# apt-get install -y git build-essential swig4.0 python-dev cmake libnode-dev python3-dev pkg-config
</pre>

Get source code.
<pre>
root@radxa-cm3-io:/home/rock# git clone -b master https://github.com/radxa/mraa.git
root@radxa-cm3-io:/home/rock# cd mraa
</pre>

Patch the source code for building mraa with Python.
<pre>
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 250d910..f1880e1 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -145,7 +145,7 @@ include_directories (${SYSTEM_USR_DIR})
option (BUILDDOC "Build all doc." OFF)
option (BUILDSWIG "Build swig modules." ON)
option (BUILDSWIGPYTHON "Build swig python modules." ON)
-option (BUILDSWIGNODE "Build swig node modules." ON)
+option (BUILDSWIGNODE "Build swig node modules." OFF)
option (BUILDSWIGJAVA "Build Java API." OFF)
option (USBPLAT "Detection USB platform." OFF)
option (FIRMATA "Add Firmata support to mraa." OFF)
@@ -156,7 +156,7 @@ option (FTDI4222 "Build with FTDI FT4222 subplatform support." OFF)
option (ENABLEEXAMPLES "Disable building of examples" ON)
option (INSTALLTOOLS "Install all tools" ON)
option (BUILDTESTS "Override the addition of tests" ON)
-option (USEPYTHON3TESTS "Force tests to run with python3" OFF)
+option (USEPYTHON3TESTS "Force tests to run with python3" ON)

set (BUILDARCH "" CACHE STRING "Override architecture to build for")
</pre>

Add the keyword extern.
<pre>
root@radxa-cm3-io:/home/rock/mraa/include# vi version.h

extern const char* gVERSION;
extern const char* gVERSION_SHORT;
</pre>

Build and install mraa.

<pre>
root@radxa-cm3-io:/home/rock/mraa# mkdir build
root@radxa-cm3-io:/home/rock/mraa# cd build/
root@radxa-cm3-io:/home/rock/mraa/build# cmake ..
root@radxa-cm3-io:/home/rock/mraa/build# make
root@radxa-cm3-io:/home/rock/mraa/build# make install
root@radxa-cm3-io:/home/rock/mraa/build# ldconfig
root@radxa-cm3-io:/home/rock/mraa/build# mraa-gpio version
Version v2.1.0-23-gfc8c906 on Radxa CM3 IO
</pre>

==== Install example: Install Mraa on ROCK Pi 4C Ubuntu Focal system ====
For Ubuntu Distribution the below commands install the essential set:

<pre>
root@rockpin10bc:/home/rock# apt-get install -y git build-essential swig3.0 python-dev cmake libjson-c-dev libnode-dev
root@rockpin10bc:/home/rock# apt-get install -y libc6 libgcc1 libstdc++6 python python2.7 libpython2.7 python3.8 libpython3.8 python3-dev python3
root@rockpin10bc:/home/rock# apt-get install -y libgtest-dev pkg-config cmake-data
</pre>
Get source code.
<pre>
root@rockpin10bc:/home/rock# git clone -b master https://github.com/radxa/mraa.git
root@rockpin10bc:/home/rock# cd mraa
</pre>

Patch the source code for building mraa with Python.
<pre>
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 250d910..f1880e1 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -145,7 +145,7 @@ include_directories (${SYSTEM_USR_DIR})
option (BUILDDOC "Build all doc." OFF)
option (BUILDSWIG "Build swig modules." ON)
option (BUILDSWIGPYTHON "Build swig python modules." ON)
-option (BUILDSWIGNODE "Build swig node modules." ON)
+option (BUILDSWIGNODE "Build swig node modules." OFF)
option (BUILDSWIGJAVA "Build Java API." OFF)
option (USBPLAT "Detection USB platform." OFF)
option (FIRMATA "Add Firmata support to mraa." OFF)
@@ -156,7 +156,7 @@ option (FTDI4222 "Build with FTDI FT4222 subplatform support." OFF)
option (ENABLEEXAMPLES "Disable building of examples" ON)
option (INSTALLTOOLS "Install all tools" ON)
option (BUILDTESTS "Override the addition of tests" ON)
-option (USEPYTHON3TESTS "Force tests to run with python3" OFF)
+option (USEPYTHON3TESTS "Force tests to run with python3" ON)

set (BUILDARCH "" CACHE STRING "Override architecture to build for")
</pre>

Build and install mraa.

<pre>
root@rockpin10bc:/home/rock/mraa# mkdir build
root@rockpin10bc:/home/rock/mraa# cd build/
root@rockpin10bc:/home/rock/mraa/build# cmake ..
root@rockpin10bc:/home/rock/mraa/build# make
root@rockpin10bc:/home/rock/mraa/build# make install
root@rockpin10bc:/home/rock/mraa/build# ldconfig
root@rockpin10bc:/home/rock/mraa/build# mraa-gpio version
Version v2.1.0-11-g06b2be2 on ROCK Pi 4
</pre>

==== Use mraa ====
Since we have installed mraa successfully, now we start to use it. At this part, you can check out the following guides.

* [[rockpi4/dev/libmraa | mraa on ROCK Pi 4 ]]
* [[rockpiE/dev/libmraa | mraa on ROCK Pi E ]]
* [[rockpiN10/dev/libmraa | mraa on ROCK Pi N10 ]]
* [[rockpiS/dev/libmraa | mraa on ROCK Pi S ]]

==== Troubleshooting ====
* If you have an issue, start a new post on the forum. https://forum.radxa.com/.

Mraa

2022-10-08T10:08:06Z

Curry: /* Mraa on ROCK Pi boards */

{{Languages|rockpiN10}}

=== Mraa on ROCK Pi boards ===
This document describes how to build and use mraa for ROCK Pi boards.

==== List of ROCK Pi Boards supported ====
* ROCK Pi 4 A/B/C
* ROCK Pi E
* ROCK Pi N10
* ROCK Pi S
* ROCK Pi X

==== List of Linux Distributions ====
* Ubuntu
* Debian
* Yocto (mraa-radxa_git.bb)

==== Install example: Install Mraa on ROCK Pi N10 Debian system ====
For Debian Distribution the below commands install the essential set:
<pre>
root@rockpin10bc:/home/rock# apt-get install -y git build-essential swig3.0 python-dev cmake libjson-c-dev libnode-dev
root@rockpin10bc:/home/rock# apt-get install -y libc6 libjson-c3 libgcc1 libstdc++6 python2.7 libpython2.7 python3.7 libpython3.7 python3-dev
root@rockpin10bc:/home/rock# apt-get install -y libgtest-dev pkg-config cmake-data
</pre>

Get source code.
<pre>
root@rockpin10bc:/home/rock# git clone -b master https://github.com/radxa/mraa.git
root@rockpin10bc:/home/rock# cd mraa
</pre>

Patch the source code for building mraa with Python.
<pre>
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 250d910..f1880e1 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -145,7 +145,7 @@ include_directories (${SYSTEM_USR_DIR})
option (BUILDDOC "Build all doc." OFF)
option (BUILDSWIG "Build swig modules." ON)
option (BUILDSWIGPYTHON "Build swig python modules." ON)
-option (BUILDSWIGNODE "Build swig node modules." ON)
+option (BUILDSWIGNODE "Build swig node modules." OFF)
option (BUILDSWIGJAVA "Build Java API." OFF)
option (USBPLAT "Detection USB platform." OFF)
option (FIRMATA "Add Firmata support to mraa." OFF)
@@ -156,7 +156,7 @@ option (FTDI4222 "Build with FTDI FT4222 subplatform support." OFF)
option (ENABLEEXAMPLES "Disable building of examples" ON)
option (INSTALLTOOLS "Install all tools" ON)
option (BUILDTESTS "Override the addition of tests" ON)
-option (USEPYTHON3TESTS "Force tests to run with python3" OFF)
+option (USEPYTHON3TESTS "Force tests to run with python3" ON)

set (BUILDARCH "" CACHE STRING "Override architecture to build for")
</pre>

Build and install mraa.

<pre>
root@rockpin10bc:/home/rock/mraa# mkdir build
root@rockpin10bc:/home/rock/mraa# cd build/
root@rockpin10bc:/home/rock/mraa/build# cmake ..
root@rockpin10bc:/home/rock/mraa/build# make
root@rockpin10bc:/home/rock/mraa/build# make install
root@rockpin10bc:/home/rock/mraa/build# ldconfig
root@rockpin10bc:/home/rock/mraa/build# mraa-gpio version
Version v2.1.0-11-g06b2be2 on Radxa ROCK Pi N10
</pre>

==== Install example: Install Mraa on CM3 IO Debian11 system ====
For Debian11 Distribution the below commands install the essential set:

<pre>
root@radxa-cm3-io:/home/rock# apt-get install -y git build-essential swig4.0 python-dev cmake libjson-c-dev libnode-dev
root@radxa-cm3-io:/home/rock# apt-get install -y libc6 libjson-c5 libgcc1 libstdc++6 python2.7 libpython2.7 python3.7 libpython3.7 python3-dev
root@radxa-cm3-io:/home/rock# apt-get install -y libgtest-dev pkg-config cmake-data
</pre>

Get source code.
<pre>
root@radxa-cm3-io:/home/rock# git clone -b master https://github.com/radxa/mraa.git
root@radxa-cm3-io:/home/rock# cd mraa
</pre>

Patch the source code for building mraa with Python.
<pre>
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 250d910..f1880e1 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -145,7 +145,7 @@ include_directories (${SYSTEM_USR_DIR})
option (BUILDDOC "Build all doc." OFF)
option (BUILDSWIG "Build swig modules." ON)
option (BUILDSWIGPYTHON "Build swig python modules." ON)
-option (BUILDSWIGNODE "Build swig node modules." ON)
+option (BUILDSWIGNODE "Build swig node modules." OFF)
option (BUILDSWIGJAVA "Build Java API." OFF)
option (USBPLAT "Detection USB platform." OFF)
option (FIRMATA "Add Firmata support to mraa." OFF)
@@ -156,7 +156,7 @@ option (FTDI4222 "Build with FTDI FT4222 subplatform support." OFF)
option (ENABLEEXAMPLES "Disable building of examples" ON)
option (INSTALLTOOLS "Install all tools" ON)
option (BUILDTESTS "Override the addition of tests" ON)
-option (USEPYTHON3TESTS "Force tests to run with python3" OFF)
+option (USEPYTHON3TESTS "Force tests to run with python3" ON)

set (BUILDARCH "" CACHE STRING "Override architecture to build for")
</pre>

Add the keyword extern.
<pre>
root@radxa-cm3-io:/home/rock/mraa/include# vi version.h

extern const char* gVERSION;
extern const char* gVERSION_SHORT;
</pre>

Build and install mraa.

<pre>
root@radxa-cm3-io:/home/rock/mraa# mkdir build
root@radxa-cm3-io:/home/rock/mraa# cd build/
root@radxa-cm3-io:/home/rock/mraa/build# cmake ..
root@radxa-cm3-io:/home/rock/mraa/build# make
root@radxa-cm3-io:/home/rock/mraa/build# make install
root@radxa-cm3-io:/home/rock/mraa/build# ldconfig
root@radxa-cm3-io:/home/rock/mraa/build# mraa-gpio version
Version v2.1.0-23-gfc8c906 on Radxa CM3 IO
</pre>

==== Install example: Install Mraa on ROCK Pi 4C Ubuntu Focal system ====
For Ubuntu Distribution the below commands install the essential set:

<pre>
root@rockpin10bc:/home/rock# apt-get install -y git build-essential swig3.0 python-dev cmake libjson-c-dev libnode-dev
root@rockpin10bc:/home/rock# apt-get install -y libc6 libgcc1 libstdc++6 python python2.7 libpython2.7 python3.8 libpython3.8 python3-dev python3
root@rockpin10bc:/home/rock# apt-get install -y libgtest-dev pkg-config cmake-data
</pre>
Get source code.
<pre>
root@rockpin10bc:/home/rock# git clone -b master https://github.com/radxa/mraa.git
root@rockpin10bc:/home/rock# cd mraa
</pre>

Patch the source code for building mraa with Python.
<pre>
diff --git a/CMakeLists.txt b/CMakeLists.txt
index 250d910..f1880e1 100644
--- a/CMakeLists.txt
+++ b/CMakeLists.txt
@@ -145,7 +145,7 @@ include_directories (${SYSTEM_USR_DIR})
option (BUILDDOC "Build all doc." OFF)
option (BUILDSWIG "Build swig modules." ON)
option (BUILDSWIGPYTHON "Build swig python modules." ON)
-option (BUILDSWIGNODE "Build swig node modules." ON)
+option (BUILDSWIGNODE "Build swig node modules." OFF)
option (BUILDSWIGJAVA "Build Java API." OFF)
option (USBPLAT "Detection USB platform." OFF)
option (FIRMATA "Add Firmata support to mraa." OFF)
@@ -156,7 +156,7 @@ option (FTDI4222 "Build with FTDI FT4222 subplatform support." OFF)
option (ENABLEEXAMPLES "Disable building of examples" ON)
option (INSTALLTOOLS "Install all tools" ON)
option (BUILDTESTS "Override the addition of tests" ON)
-option (USEPYTHON3TESTS "Force tests to run with python3" OFF)
+option (USEPYTHON3TESTS "Force tests to run with python3" ON)

set (BUILDARCH "" CACHE STRING "Override architecture to build for")
</pre>

Build and install mraa.

<pre>
root@rockpin10bc:/home/rock/mraa# mkdir build
root@rockpin10bc:/home/rock/mraa# cd build/
root@rockpin10bc:/home/rock/mraa/build# cmake ..
root@rockpin10bc:/home/rock/mraa/build# make
root@rockpin10bc:/home/rock/mraa/build# make install
root@rockpin10bc:/home/rock/mraa/build# ldconfig
root@rockpin10bc:/home/rock/mraa/build# mraa-gpio version
Version v2.1.0-11-g06b2be2 on ROCK Pi 4
</pre>

==== Use mraa ====
Since we have installed mraa successfully, now we start to use it. At this part, you can check out the following guides.

* [[rockpi4/dev/libmraa | mraa on ROCK Pi 4 ]]
* [[rockpiE/dev/libmraa | mraa on ROCK Pi E ]]
* [[rockpiN10/dev/libmraa | mraa on ROCK Pi N10 ]]
* [[rockpiS/dev/libmraa | mraa on ROCK Pi S ]]

==== Troubleshooting ====
* If you have an issue, start a new post on the forum. https://forum.radxa.com/.

Rock3/3c/getting started

2022-09-26T12:34:07Z

Curry: /* 9.GPIO */

{{rock3_header}}
{{Languages|rock3/3c/getting_started}}

[[rock3 | ROCK 3]] > [[Rock3/3c | ROCK 3 Model C]] > [[Rock3/3c/getting_started | Getting started]]

__TOC__

= Getting Started =

This guide is designed for ROCK 3C enthusiast. The purpose is to learn about ROCK 3C as well as how to prepare and set up for basic use.
When you get a board, you need to know what model it is and which hardware version it is.
The information is printed in the top side of the board.
We will introduce the board information as much as possible.

== What you need ==

=== Necessary ===
* ROCK 3C main board

* One of the Storage media below:
** microSD, larger than 8GB or
** eMMC module, larger than 8GB

* Power supply
** The ROCK 3 is powered by Type-C port and support 5V input only. The suggested power adapter is 5V/3A when using without SSD, 5V/5A when using with SSD.

* USB Keyboard and Mouse
** With four USB-A connectors, ROCK 3C can be equipped with a full sized keyboard and mouse.

* Monitor and HDMI Cable
** ROCK 3C is equipped with a full sized HDMI connector. HDMI capable monitor is recommended.
** HDMI EDID display data is used to determine the best display resolution. On monitors and TVs that support 1080p (or 4K) this resolution will be selected. If 1080p is not supported the next available resolution reported by EDID will be used. This selected mode will work with MOST but not all monitors/TVs.

* microSD Card Reader
** For flashing the image into microSD Card

=== Optional ===
* USB type A to type A cable
** This is needed for fastboot/adb commands.

* USB to TTL serial cable
** This is needed for serial console.

* Ethernet cable
** ROCK 3C supports Internet access via WIFI or Ethernet.
** An Ethernet cable is used to connect your ROCK 3 to a local network and the Internet.

* Camera Module
** ROCK 3C supports camera function.

* LCD Module
** ROCK 3C supports 2-lanes MIPI DSI display function.

* Audio cable
** Audio can be played through speaker or headphones using a standard 3.5mm jack.

== Starting the board for the first time ==

ROCK 3C can be started with eMMC Module or microSD Card. Now, you are presented with three options when installing your new operating system onto your ROCK 3C.

=== Prepare ===
* When starting system with eMMC Module
(Option a) Insert the eMMC Module into ROCK Pi eMMC USB Reader. Then plug the Radxa eMMC USB Reader into host PC.

(Option b) Insert eMMC Module into eMMC to μSD card converter board. Insert the converter board into microSD Card Reader. Then plug the Card Reader into host PC.

* When starting system with microSD Card
(Option c) Insert the microSD Card into microSD Card Reader. Then plug the Card Reader into host PC.

=== Write Image ===

* Download the official Ubuntu/Debian system image from [[rock3/downloads | Downloads]]. Make sure choose the right image for ROCK 3C.

* Download the flash tool, etcher, from [[rock3/downloads | Downloads]]. Choose the right version for your host operation system. Here we operate on host Ubuntu 16.04.

* After unpacking the package, we run the tool by executing the command

$ ./etcher-etcher-electron-1.4.5-x86_64.AppImage

If you get an error message: "No polkit authentication agent found" you can try and start it with sudo, but do know that this is running the tool as '''root'''.

* In the etcher window, click '''Select image'''.

[[File:linux_etcher_select_image.png]]

* In the etcher window, click '''Select Drive'''.

[[File:linux_etcher_select_driver.png]]

* In the etcher window, click '''Flash'''.

[[File:linux_etcher_select_flash_button.png]]

* In the etcher window, once it shows us Flash Complete! It is done and can be put into the RockPi.

[[File:linux_etcher_show_complete.png]]

=== 3. Boot the board ===

* Now insert the system storage media, uSD Card or eMMC Module into the socket on the board.

* (Optional) Use the USB to TTL serial cable to setup a connection between PC and ROCK 3C board. See [[rock3/dev/serial-console | Serial Console]].

* Power on ROCK 3C by adapter with type C port.

* ROCK 3C will boot with the green power Led on. And after a while, the other blue Led starts blinking.

=== 4. Access from the Host PC/Laptop ===

==== Option 1: Serial console ====

Check [[rock3/dev/serial-console | Serial Console]]

==== Option 2: SSH ====
SSH server is enabled on port 22 of ROCK 3C default image.

Please use [https://angryip.org/ angryip] to find your board IP address.

To access ROCK 3C by SSH, try

ping rock3c.local
ssh rock@rock3c.local

or if your router/network doesn't support Local Domain, you need to check your network/router administrator page and look for the ROCK 3A ip address.

ping ip-of-device
ssh rock@ip-of-device

Note: You can also get the IP of ROCK 3C from option 1 if you can not access network administrator page.

=== 5.Network state ===

*Look at network configure:

$ sudo ifconfig

*Test network:

$ ping -c 5 www.google.com

=== 6.WIFI Connection ===

Check [[rock3/Debian#WIFI Connection| WIFI Connection]].

=== 7.Bluetooth ===

Check [[rock3/Debian#Bluetooth| Bluetooth]].

=== 8.LED ===

ROCK 3C has Power LED and User LED.

* Power LED

The power LED is green. It is always on when ROCK 3C is given power by default,

* User LED

The user LED is blue. By default, its blink status shows the running kernel.

=== 9.GPIO ===

ROCK 3C has one 40-pin expansion headers. Each pin is distinguished by color, more information click [https://wiki.radxa.com/Rock3/hardware/3c/gpio here]

Development for GPIO. ROCK 3C supports libmraa GPIO library, click [[Rock3/dev/libmraa | here]] to get more information.

== Next Step ==

* [[Rock3/Debian | More Debian image usage and tips]]
* [[Rock3/Ubuntu | More Ubuntu image usage and tips]]
* [[Rock3/hardware/3a | Checkout the hardware details]]
* Join the [https://forum.radxa.com/c/rock3 community] and the [https://rock.sh/go Discord discussion group]

Rock5/hardware/camera/

2022-09-08T06:14:15Z

Curry: /* Radxa Camera 4K */

{{rock5_header}}
{{Languages|rock5/hardware/camera}}

[[rock5 | ROCK 5]] > [[rock5/hardware | Hardware]] > [[rock5/hardware/camera/ | Camera module]]

== MIPI Camera ==

=== Radxa Camera 4K ===

==== Hardware connection ====

[[File:Rock-5b-radxa-camera-4k.jpeg | 400px]]

==== Software configuration ====

Find rock-5ab-camera-imx415.dtbo according to the following path
root@rock-5b:/boot/dtbs/5.10.66-20-rockchip-g0cdf37b755fe/rockchip/overlay#

Edit extlinux.conf in root mode
root@rock-5b:/boot/extlinux# vi extlinux.conf

Mount rock-5ab-camera-imx415.dtbo to fdtoverlays
fdtoverlays /dtbs/5.10.66-20-rockchip-g0cdf37b755fe/rockchip/overlay/rock-5ab-camera-imx415.dtbo

==== Verify command（Reference） ====
Camera capture command
gst-launch-1.0 v4l2src device=/dev/video0 io-mode=4 ! videoconvert ! video/x-raw,format=NV12,width=1920,height=1080 ! jpegenc ! multifilesink location=%d.jpg

== USB Camera ==

== Troubleshooting ==

* Post your issue on the forum: https://forum.radxa.com/c/rock5