Merge pull request #514 from benkuly/master

added matrix-sms-bridge

docs/configuring-playbook-matrix-bridge-sms.md

@@ -0,0 +1,30 @@
+# Setting up matrix-sms-bridge (optional)
+
+The playbook can install and configure
+[matrix-sms-bridge](https://github.com/benkuly/matrix-sms-bridge) for you.
+
+See the project page to learn what it does and why it might be useful to you.
+
+First you need to ensure, that the bridge has unix read and write rights to your modem. On debian based distributions there is nothing to do. On others distributions you either add a group `dialout` to your host and assign it to your modem or you give the matrix user or group access to your modem.
+
+To enable the bridge just use the following
+playbook configuration:
+
+
+```yaml
+matrix_sms_bridge_enabled: true
+matrix_sms_bridge_gammu_modem: "/dev/serial/by-id/myDeviceId"
+# generate a secret passwort e.g. with pwgen -s 64 1
+matrix_sms_bridge_database_password: ""
+# (optional) a room id to a default room
+matrix_sms_bridge_default_room: "" 
+# (optional) gammu reset frequency (see https://wammu.eu/docs/manual/smsd/config.html#option-ResetFrequency)
+matrix_sms_bridge_gammu_reset_frequency: 3600
+# (optional) group with unix read and write rights to modem
+matrix_sms_bridge_modem_group: 'dialout'
+```
+
+
+## Usage
+
+Read the [user guide](https://github.com/benkuly/matrix-sms-bridge/blob/master/README.md#user-guide) to see how this bridge works.

docs/configuring-playbook.md

@@ -102,3 +102,5 @@ When you're done with all the configuration you'd like to do, continue with [Ins
 - [Setting up MX Puppet Slack bridging](configuring-playbook-bridge-mx-puppet-slack.md) (optional)
 
 - [Setting up Email2Matrix](configuring-playbook-email2matrix.md) (optional)
+
+- [Setting up Matrix SMS bridging](configuring-playbook-matrix-bridge-sms.md) (optional)