From d3aad3f089b86f2bef2546e89b91b3191b448e37 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Thomas=20G=C3=B6ttgens?= Date: Sun, 11 Dec 2022 21:44:52 +0100 Subject: [PATCH 1/2] add RAK GPIO mapping --- docs/configuration/rak-gpio-mapping.mdx | 32 +++++++++++++++++++++++++ docs/configuration/remote-admin.mdx | 1 + 2 files changed, 33 insertions(+) create mode 100644 docs/configuration/rak-gpio-mapping.mdx diff --git a/docs/configuration/rak-gpio-mapping.mdx b/docs/configuration/rak-gpio-mapping.mdx new file mode 100644 index 00000000..528392e3 --- /dev/null +++ b/docs/configuration/rak-gpio-mapping.mdx @@ -0,0 +1,32 @@ +--- +id: rak-gpio-mapping +title: RAK GPIO Pin Mapping +sidebar_label: RAK GPIO Mapping +sidebar_position: 5 +--- + +## RAK GPIO Pin Mapping + +The RAK4631 uses symbolic labes for its I/O Pins on the module and baseboard silk screens. The following table shows the mapping of the RAK4631 GPIO pins to the corresponding Arduino pins and the MCU Port numbers. + +| RAK Pin | nRF52840 Pin | Arduino GPIO | Remark | +| ------- | ------------ | ------------ | ------ | +| IO1 | P0.17 | 17 | used for GPS PPM signal if GPS module is connected | +| IO2 | P1.02 | 34 | used to power all peripheral modules, not available for user application | +| IO3 | P0.21 | 21 | +| IO4 | P0.04 | 4 | +| IO5 | P0.09 | 9 | The 'User Button' is mapped here. | +| IO6 | P0.10 | 10 | +| IO7 | P0.28 | 28 | +| SW1 | P0.01 | 1 | +| A0 | P0.04/AIN2 | A2 | +| A1 | P0.31/AIN7 | A7 | +| SPI_CS | P0.26 | 26 | + +When configuring GPIO pins in your device settings, the Arduino GPIO numbers should be used. + +```shell title="Example" +meshtastic --set external_notification.output 10 +``` +This will use IO6 on a RAK4631 + diff --git a/docs/configuration/remote-admin.mdx b/docs/configuration/remote-admin.mdx index 03c12270..2ba4050d 100644 --- a/docs/configuration/remote-admin.mdx +++ b/docs/configuration/remote-admin.mdx @@ -2,6 +2,7 @@ id: remote-admin title: Remote Node Administration sidebar_label: Remote Nodes +sidebar_position: 4 --- :::caution Disclaimer From 7c747b7c8cdbb563912be4d8d7d6fa58c7ac2100 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Thomas=20G=C3=B6ttgens?= Date: Sun, 11 Dec 2022 22:31:36 +0100 Subject: [PATCH 2/2] Add a clarification about the need for an IO board. --- docs/configuration/rak-gpio-mapping.mdx | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/configuration/rak-gpio-mapping.mdx b/docs/configuration/rak-gpio-mapping.mdx index 528392e3..e5280c7b 100644 --- a/docs/configuration/rak-gpio-mapping.mdx +++ b/docs/configuration/rak-gpio-mapping.mdx @@ -30,3 +30,7 @@ meshtastic --set external_notification.output 10 ``` This will use IO6 on a RAK4631 +:::caution Note +There is no usable GPIO pin on any RAK base board except the 'big' baseboard RAK19001 without adding a RAK13002 IO module or a third party IO sensor breakout. +::: +