SwiftSerial.swift 13 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468
  1. import Foundation
  2. #if os(Linux)
  3. public enum BaudRate {
  4. case baud0
  5. case baud50
  6. case baud75
  7. case baud110
  8. case baud134
  9. case baud150
  10. case baud200
  11. case baud300
  12. case baud600
  13. case baud1200
  14. case baud1800
  15. case baud2400
  16. case baud4800
  17. case baud9600
  18. case baud19200
  19. case baud38400
  20. case baud57600
  21. case baud115200
  22. case baud230400
  23. case baud460800
  24. case baud500000
  25. case baud576000
  26. case baud921600
  27. case baud1000000
  28. case baud1152000
  29. case baud1500000
  30. case baud2000000
  31. case baud2500000
  32. case baud3500000
  33. case baud4000000
  34. var speedValue: speed_t {
  35. switch self {
  36. case .baud0:
  37. return speed_t(B0)
  38. case .baud50:
  39. return speed_t(B50)
  40. case .baud75:
  41. return speed_t(B75)
  42. case .baud110:
  43. return speed_t(B110)
  44. case .baud134:
  45. return speed_t(B134)
  46. case .baud150:
  47. return speed_t(B150)
  48. case .baud200:
  49. return speed_t(B200)
  50. case .baud300:
  51. return speed_t(B300)
  52. case .baud600:
  53. return speed_t(B600)
  54. case .baud1200:
  55. return speed_t(B1200)
  56. case .baud1800:
  57. return speed_t(B1800)
  58. case .baud2400:
  59. return speed_t(B2400)
  60. case .baud4800:
  61. return speed_t(B4800)
  62. case .baud9600:
  63. return speed_t(B9600)
  64. case .baud19200:
  65. return speed_t(B19200)
  66. case .baud38400:
  67. return speed_t(B38400)
  68. case .baud57600:
  69. return speed_t(B57600)
  70. case .baud115200:
  71. return speed_t(B115200)
  72. case .baud230400:
  73. return speed_t(B230400)
  74. case .baud460800:
  75. return speed_t(B460800)
  76. case .baud500000:
  77. return speed_t(B500000)
  78. case .baud576000:
  79. return speed_t(B576000)
  80. case .baud921600:
  81. return speed_t(B921600)
  82. case .baud1000000:
  83. return speed_t(B1000000)
  84. case .baud1152000:
  85. return speed_t(B1152000)
  86. case .baud1500000:
  87. return speed_t(B1500000)
  88. case .baud2000000:
  89. return speed_t(B2000000)
  90. case .baud2500000:
  91. return speed_t(B2500000)
  92. case .baud3500000:
  93. return speed_t(B3500000)
  94. case .baud4000000:
  95. return speed_t(B4000000)
  96. }
  97. }
  98. }
  99. #elseif os(OSX)
  100. public enum BaudRate {
  101. case baud0
  102. case baud50
  103. case baud75
  104. case baud110
  105. case baud134
  106. case baud150
  107. case baud200
  108. case baud300
  109. case baud600
  110. case baud1200
  111. case baud1800
  112. case baud2400
  113. case baud4800
  114. case baud9600
  115. case baud19200
  116. case baud38400
  117. case baud57600
  118. case baud115200
  119. case baud230400
  120. var speedValue: speed_t {
  121. switch self {
  122. case .baud0:
  123. return speed_t(B0)
  124. case .baud50:
  125. return speed_t(B50)
  126. case .baud75:
  127. return speed_t(B75)
  128. case .baud110:
  129. return speed_t(B110)
  130. case .baud134:
  131. return speed_t(B134)
  132. case .baud150:
  133. return speed_t(B150)
  134. case .baud200:
  135. return speed_t(B200)
  136. case .baud300:
  137. return speed_t(B300)
  138. case .baud600:
  139. return speed_t(B600)
  140. case .baud1200:
  141. return speed_t(B1200)
  142. case .baud1800:
  143. return speed_t(B1800)
  144. case .baud2400:
  145. return speed_t(B2400)
  146. case .baud4800:
  147. return speed_t(B4800)
  148. case .baud9600:
  149. return speed_t(B9600)
  150. case .baud19200:
  151. return speed_t(B19200)
  152. case .baud38400:
  153. return speed_t(B38400)
  154. case .baud57600:
  155. return speed_t(B57600)
  156. case .baud115200:
  157. return speed_t(B115200)
  158. case .baud230400:
  159. return speed_t(B230400)
  160. }
  161. }
  162. }
  163. #endif
  164. public enum DataBitsSize {
  165. case bits5
  166. case bits6
  167. case bits7
  168. case bits8
  169. var flagValue: tcflag_t {
  170. switch self {
  171. case .bits5:
  172. return tcflag_t(CS5)
  173. case .bits6:
  174. return tcflag_t(CS6)
  175. case .bits7:
  176. return tcflag_t(CS7)
  177. case .bits8:
  178. return tcflag_t(CS8)
  179. }
  180. }
  181. }
  182. public enum ParityType {
  183. case none
  184. case even
  185. case odd
  186. var parityValue: tcflag_t {
  187. switch self {
  188. case .none:
  189. return 0
  190. case .even:
  191. return tcflag_t(PARENB)
  192. case .odd:
  193. return tcflag_t(PARENB | PARODD)
  194. }
  195. }
  196. }
  197. public enum PortError: Int32, Error {
  198. case failedToOpen = -1 // refer to open()
  199. case invalidPath
  200. case mustReceiveOrTransmit
  201. case mustBeOpen
  202. case stringsMustBeUTF8
  203. }
  204. public class SerialPort {
  205. var path: String
  206. var fileDescriptor: Int32?
  207. public init(path: String) {
  208. self.path = path
  209. }
  210. public func openPort() throws {
  211. try openPort(toReceive: true, andTransmit: true)
  212. }
  213. public func openPort(toReceive receive: Bool, andTransmit transmit: Bool) throws {
  214. guard !path.isEmpty else {
  215. throw PortError.invalidPath
  216. }
  217. guard receive || transmit else {
  218. throw PortError.mustReceiveOrTransmit
  219. }
  220. var readWriteParam : Int32
  221. if receive && transmit {
  222. readWriteParam = O_RDWR
  223. } else if receive {
  224. readWriteParam = O_RDONLY
  225. } else if transmit {
  226. readWriteParam = O_WRONLY
  227. } else {
  228. fatalError()
  229. }
  230. #if os(Linux)
  231. fileDescriptor = open(path, readWriteParam | O_NOCTTY)
  232. #elseif os(OSX)
  233. fileDescriptor = open(path, readWriteParam | O_NOCTTY | O_EXLOCK | O_NONBLOCK)
  234. #endif
  235. // Throw error if open() failed
  236. if fileDescriptor == PortError.failedToOpen.rawValue {
  237. throw PortError.failedToOpen
  238. }
  239. }
  240. public func setSettings(receiveRate: BaudRate,
  241. transmitRate: BaudRate,
  242. minimumBytesToRead: Int,
  243. timeout: Int = 0, /* 0 means wait indefinitely */
  244. parityType: ParityType = .none,
  245. sendTwoStopBits: Bool = false, /* 1 stop bit is the default */
  246. dataBitsSize: DataBitsSize = .bits8,
  247. useHardwareFlowControl: Bool = false,
  248. useSoftwareFlowControl: Bool = false,
  249. processOutput: Bool = false) {
  250. print("top")
  251. guard let fileDescriptor = fileDescriptor else {
  252. return
  253. }
  254. // Set up the control structure
  255. var settings = termios()
  256. // Get options structure for the port
  257. tcgetattr(fileDescriptor, &settings)
  258. // Set baud rates
  259. cfsetispeed(&settings, receiveRate.speedValue)
  260. cfsetospeed(&settings, transmitRate.speedValue)
  261. // Enable parity (even/odd) if needed
  262. settings.c_cflag |= parityType.parityValue
  263. // Set stop bit flag
  264. if sendTwoStopBits {
  265. settings.c_cflag |= tcflag_t(CSTOPB)
  266. } else {
  267. settings.c_cflag &= ~tcflag_t(CSTOPB)
  268. }
  269. // Set data bits size flag
  270. settings.c_cflag &= ~tcflag_t(CSIZE)
  271. settings.c_cflag |= dataBitsSize.flagValue
  272. // Set hardware flow control flag
  273. #if os(Linux)
  274. if useHardwareFlowControl {
  275. settings.c_cflag |= tcflag_t(CRTSCTS)
  276. } else {
  277. settings.c_cflag &= ~tcflag_t(CRTSCTS)
  278. }
  279. #elseif os(OSX)
  280. if useHardwareFlowControl {
  281. settings.c_cflag |= tcflag_t(CRTS_IFLOW)
  282. settings.c_cflag |= tcflag_t(CCTS_OFLOW)
  283. } else {
  284. settings.c_cflag &= ~tcflag_t(CRTS_IFLOW)
  285. settings.c_cflag &= ~tcflag_t(CCTS_OFLOW)
  286. }
  287. #endif
  288. // Set software flow control flags
  289. let softwareFlowControlFlags = tcflag_t(IXON | IXOFF | IXANY)
  290. if useSoftwareFlowControl {
  291. settings.c_iflag |= softwareFlowControlFlags
  292. } else {
  293. settings.c_iflag &= ~softwareFlowControlFlags
  294. }
  295. // Turn on the receiver of the serial port, and ignore modem control lines
  296. settings.c_cflag |= tcflag_t(CREAD | CLOCAL)
  297. // Turn off canonical mode
  298. settings.c_lflag &= ~tcflag_t(ICANON | ECHO | ECHOE | ISIG)
  299. // Set output processing flag
  300. if processOutput {
  301. settings.c_oflag |= tcflag_t(OPOST)
  302. } else {
  303. settings.c_oflag &= ~tcflag_t(OPOST)
  304. }
  305. // Special characters
  306. #if os(Linux)
  307. typealias specialCharactersTuple = (VINTR: cc_t, VQUIT: cc_t, VERASE: cc_t, VKILL: cc_t, VEOF: cc_t, VTIME: cc_t, VMIN: cc_t, VSWTC: cc_t, VSTART: cc_t, VSTOP: cc_t, VSUSP: cc_t, VEOL: cc_t, VREPRINT: cc_t, VDISCARD: cc_t, VWERASE: cc_t, VLNEXT: cc_t, VEOL2: cc_t, spare1: cc_t, spare2: cc_t, spare3: cc_t, spare4: cc_t, spare5: cc_t, spare6: cc_t, spare7: cc_t, spare8: cc_t, spare9: cc_t, spare10: cc_t, spare11: cc_t, spare12: cc_t, spare13: cc_t, spare14: cc_t, spare15: cc_t)
  308. var specialCharacters: specialCharactersTuple = (0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0) // NCCS = 32
  309. #elseif os(OSX)
  310. typealias specialCharactersTuple = (VEOF: cc_t, VEOL: cc_t, VEOL2: cc_t, VERASE: cc_t, VWERASE: cc_t, VKILL: cc_t, VREPRINT: cc_t, spare1: cc_t, VINTR: cc_t, VQUIT: cc_t, VSUSP: cc_t, VDSUSP: cc_t, VSTART: cc_t, VSTOP: cc_t, VLNEXT: cc_t, VDISCARD: cc_t, VMIN: cc_t, VTIME: cc_t, VSTATUS: cc_t, spare: cc_t)
  311. var specialCharacters: specialCharactersTuple = (0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0) // NCCS = 20
  312. #endif
  313. specialCharacters.VMIN = cc_t(minimumBytesToRead)
  314. specialCharacters.VTIME = cc_t(timeout)
  315. settings.c_cc = specialCharacters
  316. // Commit settings
  317. tcsetattr(fileDescriptor, TCSANOW, &settings)
  318. }
  319. public func closePort() {
  320. if let fileDescriptor = fileDescriptor {
  321. close(fileDescriptor)
  322. }
  323. fileDescriptor = nil
  324. }
  325. }
  326. // MARK: Receiving
  327. extension SerialPort {
  328. public func readBytes(into buffer: UnsafeMutablePointer<UInt8>, size: Int) throws -> Int {
  329. guard let fileDescriptor = fileDescriptor else {
  330. throw PortError.mustBeOpen
  331. }
  332. let bytesRead = read(fileDescriptor, buffer, size)
  333. return bytesRead
  334. }
  335. public func readData(ofLength length: Int) throws -> Data {
  336. let buffer = UnsafeMutablePointer<UInt8>.allocate(capacity: length)
  337. defer {
  338. buffer.deallocate(capacity: length)
  339. }
  340. let bytesRead = try readBytes(into: buffer, size: length)
  341. let data = Data(bytes: buffer, count: bytesRead)
  342. return data
  343. }
  344. public func readString(ofLength length: Int) throws -> String {
  345. var remainingBytesToRead = length
  346. var result = ""
  347. while remainingBytesToRead > 0 {
  348. let data = try readData(ofLength: remainingBytesToRead)
  349. if let string = String(data: data, encoding: String.Encoding.utf8) {
  350. result += string
  351. remainingBytesToRead -= data.count
  352. } else {
  353. return result
  354. }
  355. }
  356. return result
  357. }
  358. public func readUntilChar(_ terminator: CChar) throws -> String {
  359. var data = Data()
  360. let buffer = UnsafeMutablePointer<UInt8>.allocate(capacity: 1)
  361. defer {
  362. buffer.deallocate(capacity: 1)
  363. }
  364. // Read byte by byte
  365. while try readBytes(into: buffer, size: 1) > 0 {
  366. let character = CChar(buffer[0])
  367. if character != terminator {
  368. data.append(buffer, count: 1)
  369. } else {
  370. break
  371. }
  372. }
  373. if let string = String(data: data, encoding: String.Encoding.utf8) {
  374. return string
  375. } else {
  376. throw PortError.stringsMustBeUTF8
  377. }
  378. }
  379. public func readLine() throws -> String {
  380. let newlineChar = CChar(10) // Newline/Line feed character `\n` is 10
  381. return try readUntilChar(newlineChar)
  382. }
  383. }
  384. // MARK: Transmitting
  385. extension SerialPort {
  386. public func writeBytes(from buffer: UnsafeMutablePointer<UInt8>, size: Int) throws -> Int {
  387. guard let fileDescriptor = fileDescriptor else {
  388. throw PortError.mustBeOpen
  389. }
  390. let bytesWritten = write(fileDescriptor, buffer, size)
  391. return bytesWritten
  392. }
  393. public func writeData(_ data: Data) throws -> Int {
  394. let size = data.count
  395. let buffer = UnsafeMutablePointer<UInt8>.allocate(capacity: size)
  396. defer {
  397. buffer.deallocate(capacity: size)
  398. }
  399. data.copyBytes(to: buffer, count: size)
  400. let bytesWritten = try writeBytes(from: buffer, size: size)
  401. return bytesWritten
  402. }
  403. public func writeString(_ string: String) throws -> Int {
  404. guard let data = string.data(using: String.Encoding.utf8) else {
  405. throw PortError.stringsMustBeUTF8
  406. }
  407. return try writeData(data)
  408. }
  409. }