SerialPort.Write
----------------

Writes text to the serial port.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [SerialPort](component_SerialPort.md) | [3.0](newinversion30.md) | ✅ Yes | ✅ Yes | ❌ No | ✅ Yes, on macOS and Windows | ❌ No |

MBS( "SerialPort.Write"; PortReference; Text { ; Encoding } ) 

**MBS**( **"SerialPort.Write";** /\* Writes text to the serial port. \*/  
**$PortReference**; /\* The reference number of the port. You get this number from [SerialPort.Open](SerialPortOpen.md) when you open the port.e.g. $port \*/   
**$Text**; /\* The text to send.e.g. "Hello World" \*/   
**$Encoding**) /\* Optional; The text encoding for text parameter.   
Default is native.e.g. "UTF8" \*/ 

### Parameters

| Parameter | Description | Example | Flags |
|---|---|---|---|
| PortReference | The reference number of the port. You get this number from [SerialPort.Open](SerialPortOpen.md) when you open the port. | $port |  |
| Text | The text to send. | "Hello World" |  |
| Encoding | The text encoding for text parameter.    Default is native.   Possible encoding names: ANSI, ISO-8859-1, Latin1, Mac, Native, UTF-8, DOS, Hex, Base64 or Windows. More listed in the [FAQ](https://www.monkeybreadsoftware.com/filemaker/faq.shtml). | "UTF8" | Optional |

### Result

Returns the number of bytes written or an error message.

### Description

Writes text to the serial port.  
Be aware that text encoding conversion may result in different bytes than expected, so please verify on other side the text encoding matches the expectations.  
### Examples

Write something:

 MBS ( "SerialPort.Write"; $port ; "Hello World" )  
Write something with DOS text encoding:

 MBS ( "SerialPort.Write"; $port ; "Umlauts: äöü"; "DOS" )  
Send set zero command to scale for MT-SICS (METTLER TOLEDO Standard Interface Command Set):

 MBS ( "SerialPort.Write"; $port ; "Z" &amp; Char(13) &amp; Char(10) )  
Send print weight command to scale for MT-SICS (METTLER TOLEDO Standard Interface Command Set):

 MBS ( "SerialPort.Write"; $port ; "P" &amp; Char(13) &amp; Char(10) )  
### See also

- [SerialPort.Close](SerialPortClose.md)
- [SerialPort.List](SerialPortList.md)
- [SerialPort.Open](SerialPortOpen.md)
- [SerialPort.OpenPath](SerialPortOpenPath.md)
- [SerialPort.Path](SerialPortPath.md)
- [SerialPort.WriteByte](SerialPortWriteByte.md)
- [SerialPort.WriteHex](SerialPortWriteHex.md)

### Example Databases

- [Network/Serial Port](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/Network/Serial%20Port.shtml#1GroupButton198.000000030.0000000223.0000000139.0000000LayoutObjectAnchor_)

### Blog Entries

- [Serial Port functions for MBS Filemaker Plugin](https://www.mbsplugins.de/archive/2012-12-01/Serial_Port_functions_for_MBS_/monkeybreadsoftware_blog_filemaker)

This function is free to use.

Created 18th August 2014 , last changed 19th September 2019

  
[SerialPort.WaitNamedPipe](SerialPortWaitNamedPipe.md) - [SerialPort.WriteByte](SerialPortWriteByte.md)

[HTML Version](SerialPortWrite.shtml)