{"id":16146122,"url":"https://github.com/libdriver/wm8978","last_synced_at":"2025-04-28T14:09:10.334Z","repository":{"id":191015071,"uuid":"683695746","full_name":"libdriver/wm8978","owner":"libdriver","description":"WM8978 full-featured driver library for general MCU and Linux.","archived":false,"fork":false,"pushed_at":"2025-04-19T06:36:36.000Z","size":69544,"stargazers_count":46,"open_issues_count":0,"forks_count":8,"subscribers_count":9,"default_branch":"main","last_synced_at":"2025-04-28T14:08:56.591Z","etag":null,"topics":["audio","audio-codec","full-featured-driver","iic","iis","linux","mcu","wm8978"],"latest_commit_sha":null,"homepage":"https://www.libdriver.com","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/libdriver.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-08-27T12:14:26.000Z","updated_at":"2025-04-19T06:36:17.000Z","dependencies_parsed_at":"2024-09-05T21:37:44.760Z","dependency_job_id":"8c86f6d5-ecd7-44fb-b647-13bb32b87137","html_url":"https://github.com/libdriver/wm8978","commit_stats":{"total_commits":9,"total_committers":1,"mean_commits":9.0,"dds":0.0,"last_synced_commit":"956983621a1d2d75d5c34be9a944bc0b2fbde6a8"},"previous_names":["hepingood/wm8978","libdriver/wm8978"],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/libdriver%2Fwm8978","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/libdriver%2Fwm8978/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/libdriver%2Fwm8978/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/libdriver%2Fwm8978/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/libdriver","download_url":"https://codeload.github.com/libdriver/wm8978/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251326839,"owners_count":21571636,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["audio","audio-codec","full-featured-driver","iic","iis","linux","mcu","wm8978"],"created_at":"2024-10-10T00:18:57.334Z","updated_at":"2025-04-28T14:09:10.322Z","avatar_url":"https://github.com/libdriver.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"[English](/README.md) | [ 简体中文](/README_zh-Hans.md) | [繁體中文](/README_zh-Hant.md) | [日本語](/README_ja.md) | [Deutsch](/README_de.md) | [한국어](/README_ko.md)\n\n\u003cdiv align=center\u003e\n\u003cimg src=\"/doc/image/logo.svg\" width=\"400\" height=\"150\"/\u003e\n\u003c/div\u003e\n\n## LibDriver WM8978\n\n[![MISRA](https://img.shields.io/badge/misra-compliant-brightgreen.svg)](/misra/README.md) [![API](https://img.shields.io/badge/api-reference-blue.svg)](https://www.libdriver.com/docs/wm8978/index.html) [![License](https://img.shields.io/badge/license-MIT-brightgreen.svg)](/LICENSE)\n\nThe WM8978 is a low power, high quality stereo CODEC designed for portable applications such as multimedia phone, digital still camera or digital camcorder.The device integrates preamps for stereo differential mics, and includes drivers for speakers, headphone and differential or stereo line output. External component requirements are reduced as no separate microphone or headphone amplifiers are required.Advanced on-chip digital signal processing includes a 5-band equaliser, a mixed signal Automatic Level Control for the microphone or line input through the ADC as well as a purely digital limiter function for record or playback. Additional digital filtering options are available in the ADC path, to cater for application filtering such as ‘wind noise reduction’.The WM8978 digital audio interface can operate as a master or a slave. An internal PLL can generate all required audio clocks for the CODEC from common reference clock frequencies, such as 12MHz and 13MHz.The WM8978 operates at analogue supply voltages from 2.5V to 3.3V, although the digital core can operate at voltages down to 1.71V to save power. The speaker outputs and OUT3/4 line outputs can run from a 5V supply if increased output power is required. Individual sections of the chip can also be powered down under software control.\n\nLibDriver WM8978 is a full-featured driver of WM8978 launched by LibDriver.It provides audio playing, audio recording and other functions. LibDriver is MISRA compliant.\n\n### Table of Contents\n\n  - [Instruction](#Instruction)\n  - [Install](#Install)\n  - [Usage](#Usage)\n    - [example play](#example-play)\n    - [example record](#example-record)\n  - [Document](#Document)\n  - [Contributing](#Contributing)\n  - [License](#License)\n  - [Contact Us](#Contact-Us)\n\n### Instruction\n\n/src includes LibDriver WM8978 source files.\n\n/interface includes LibDriver WM8978 IIC, IIS platform independent template.\n\n/test includes LibDriver WM8978 driver test code and this code can test the chip necessary function simply.\n\n/example includes LibDriver WM8978 sample code.\n\n/doc includes LibDriver WM8978 offline document.\n\n/datasheet includes WM8978 datasheet.\n\n/project includes the common Linux and MCU development board sample code. All projects use the shell script to debug the driver and the detail instruction can be found in each project's README.md.\n\n/misra includes the LibDriver MISRA code scanning results.\n\n### Install\n\nReference /interface IIC, IIS platform independent template and finish your platform IIC, IIS driver.\n\nAdd the /src directory, the interface driver for your platform, and your own drivers to your project, if you want to use the default example drivers, add the /example directory to your project.\n\n### Usage\n\nYou can refer to the examples in the /example directory to complete your own driver. If you want to use the default programming examples, here's how to use them.\n\n#### example play\n\n```C\n#include \"driver_wm8978_basic.h\"\n\nuint8_t res;\nwm8978_companding_t companding = WM8978_COMPANDING_LINEAR;\nwm8978_channel_t channel = WM8978_CHANNEL_STEREO;\nwm8978_word_length_t length = WM8978_WORD_LENGTH_16_BITS;\n\n/* link interface function */\nWAV_LINK_INIT(wm8978_play_get_handle(), wav_handle_t);\nWAV_LINK_AUDIO_INIT(wm8978_play_get_handle(), wav_audio_init);\nWAV_LINK_AUDIO_DEINIT(wm8978_play_get_handle(), wav_audio_deinit);\nWAV_LINK_AUDIO_READ(wm8978_play_get_handle(), wav_audio_read);\nWAV_LINK_AUDIO_WRITE(wm8978_play_get_handle(), wav_audio_write);\nWAV_LINK_IIS_INIT(wm8978_play_get_handle(), wav_iis_init);\nWAV_LINK_IIS_DEINIT(wm8978_play_get_handle(), wav_iis_deinit);\nWAV_LINK_IIS_STOP(wm8978_play_get_handle(), wav_iis_stop);\nWAV_LINK_IIS_PAUSE(wm8978_play_get_handle(), wav_iis_pause);\nWAV_LINK_IIS_RESUME(wm8978_play_get_handle(), wav_iis_resume);\nWAV_LINK_IIS_SET_FREQ(wm8978_play_get_handle(), wav_iis_set_freq);\nWAV_LINK_IIS_WRITE(wm8978_play_get_handle(), wav_iis_write);\nWAV_LINK_IIS_READ(wm8978_play_get_handle(), wav_iis_read);\nWAV_LINK_DELAY_MS(wm8978_play_get_handle(), wav_delay_ms);\nWAV_LINK_DEBUG_PRINT(wm8978_play_get_handle(), wav_debug_print);\n\n/* wm8978 basic init */\nres = wm8978_basic_init(WM8978_BASIC_MODE_PLAY);\nif (res != 0)\n{\n    wm8978_interface_debug_print(\"wm8978: basic init failed.\\n\");\n\n    return 1;\n}\n\n/* wav init */\nres = wav_init(wm8978_play_get_handle());\nif (res != 0)\n{\n    wm8978_interface_debug_print(\"wm8978: wav init failed.\\n\");\n    (void)wm8978_basic_deinit();\n\n    return 1;\n}\n\n...\n    \n/* wav player init */\nres = wav_player_init(wm8978_play_get_handle(), path);\nif (res != 0)\n{\n    wm8978_interface_debug_print(\"wm8978: wav player init failed.\\n\");\n    (void)wav_deinit(wm8978_play_get_handle());\n    (void)wm8978_basic_deinit();\n\n    return 1;\n}\n\n/* set num channel */\nif (wm8978_play_get_handle()-\u003ewav.num_channel == 1)\n{\n    channel = WM8978_CHANNEL_MONO;\n}\nelse if (wm8978_play_get_handle()-\u003ewav.num_channel == 2)\n{\n    channel = WM8978_CHANNEL_STEREO;\n}\nelse\n{\n    wm8978_interface_debug_print(\"wm8978: num channel is invalid.\\n\");\n    (void)wav_deinit(wm8978_play_get_handle());\n    (void)wm8978_basic_deinit();\n\n    return 1;\n}\n\n/* set bit per sample */\nif (wm8978_play_get_handle()-\u003ewav.bit_per_sample == 16)\n{\n    length = WM8978_WORD_LENGTH_16_BITS;\n}\nelse if (wm8978_play_get_handle()-\u003ewav.bit_per_sample == 24)\n{\n    length = WM8978_WORD_LENGTH_24_BITS;\n}\nelse\n{\n    wm8978_interface_debug_print(\"wm8978: bit per sample is invalid.\\n\");\n    (void)wav_deinit(wm8978_play_get_handle());\n    (void)wm8978_basic_deinit();\n\n    return 1;\n}\n\n/* set audio format */\nif (wm8978_play_get_handle()-\u003ewav.audio_format == 1)\n{\n    companding = WM8978_COMPANDING_LINEAR;\n}\nelse\n{\n    wm8978_interface_debug_print(\"wm8978: audio format is invalid.\\n\");\n    (void)wav_deinit(wm8978_play_get_handle());\n    (void)wm8978_basic_deinit();\n\n    return 1;\n}\n\n/* wm8978 config */\nif (wm8978_basic_config(companding, channel, length) != 0)\n{\n    wm8978_interface_debug_print(\"wm8978: basic config failed.\\n\");\n    (void)wav_deinit(wm8978_play_get_handle());\n    (void)wm8978_basic_deinit();\n\n    return 1;\n}\n\n/* wav player config */\nres = wav_player_config(wm8978_play_get_handle(), I2S_STANDARD_PHILIPS, \n                        I2S_MODE_MASTER_TX, I2S_CPOL_LOW, \n                        I2S_DATAFORMAT_16B_EXTENDED, I2S_MCLKOUTPUT_ENABLE, wm8978_play_get_handle()-\u003ewav.sample_rate);\nif (res != 0)\n{\n    wm8978_interface_debug_print(\"wm8978: wav player config failed.\\n\");\n    (void)wav_deinit(wm8978_play_get_handle());\n    (void)wm8978_basic_deinit();\n\n    return 1;\n}\n\n/* wav player start */\nres = wav_player_start(wm8978_play_get_handle());\nif (res != 0)\n{\n    wm8978_interface_debug_print(\"wm8978: wav player start failed.\\n\");\n    (void)wav_deinit(wm8978_play_get_handle());\n    (void)wm8978_basic_deinit();\n\n    return 1;\n}\n\n...\n    \n/* loop */\nwhile (1)\n{\n    wav_status_t status;\n\n    /* get status */\n    res = wav_player_get_status(wm8978_play_get_handle(), \u0026status);\n    if (res != 0)\n    {\n        wm8978_interface_debug_print(\"wm8978: wav player get status failed.\\n\");\n        (void)wav_player_stop(wm8978_play_get_handle());\n        (void)wav_deinit(wm8978_play_get_handle());\n        (void)wm8978_basic_deinit();\n\n        return 1;\n    }\n\n    /* check status */\n    if (status == WAV_STATUS_STOP)\n    {\n        break;\n    }\n\n    wav_delay_ms(1000);\n    wav_debug_print(\"wav: playing %d/%d.\\n\", wm8978_play_get_handle()-\u003epos, wm8978_play_get_handle()-\u003esize);\n    \n    ...\n}\n\n...\n    \n/* wav deinit */\n(void)wav_deinit(wm8978_play_get_handle());\n\n/* deinit */\n(void)wm8978_basic_deinit();\n\nreturn 0;\n```\n\n#### example record\n\n```C\n#include \"driver_wm8978_basic.h\"\n\nuint8_t res;\nuint32_t timeout;\nwm8978_companding_t companding = WM8978_COMPANDING_LINEAR;\nwm8978_channel_t channel = WM8978_CHANNEL_STEREO;\nwm8978_word_length_t length = WM8978_WORD_LENGTH_16_BITS;\n\n/* link interface function */\nWAV_LINK_INIT(wm8978_record_get_handle(), wav_handle_t);\nWAV_LINK_AUDIO_INIT(wm8978_record_get_handle(), wav_audio_init);\nWAV_LINK_AUDIO_DEINIT(wm8978_record_get_handle(), wav_audio_deinit);\nWAV_LINK_AUDIO_READ(wm8978_record_get_handle(), wav_audio_read);\nWAV_LINK_AUDIO_WRITE(wm8978_record_get_handle(), wav_audio_write);\nWAV_LINK_IIS_INIT(wm8978_record_get_handle(), wav_iis_init);\nWAV_LINK_IIS_DEINIT(wm8978_record_get_handle(), wav_iis_deinit);\nWAV_LINK_IIS_STOP(wm8978_record_get_handle(), wav_iis_stop);\nWAV_LINK_IIS_PAUSE(wm8978_record_get_handle(), wav_iis_pause);\nWAV_LINK_IIS_RESUME(wm8978_record_get_handle(), wav_iis_resume);\nWAV_LINK_IIS_SET_FREQ(wm8978_record_get_handle(), wav_iis_set_freq);\nWAV_LINK_IIS_WRITE(wm8978_record_get_handle(), wav_iis_write);\nWAV_LINK_IIS_READ(wm8978_record_get_handle(), wav_iis_read);\nWAV_LINK_DELAY_MS(wm8978_record_get_handle(), wav_delay_ms);\nWAV_LINK_DEBUG_PRINT(wm8978_record_get_handle(), wav_debug_print);\n\n/* wm8978 init */\nres = wm8978_basic_init(WM8978_BASIC_MODE_RECORD);\nif (res != 0)\n{\n    wm8978_interface_debug_print(\"wm8978: basic init failed.\\n\");\n\n    return 1;\n}\n\n/* wav init */\nres = wav_init(wm8978_record_get_handle());\nif (res != 0)\n{\n    wm8978_interface_debug_print(\"wm8978: wav init failed.\\n\");\n    (void)wm8978_basic_deinit();\n\n    return 1;\n}\n\n...\n    \n/* config */\nres = wm8978_basic_config(companding, channel, length);\nif (res != 0)\n{\n    wm8978_interface_debug_print(\"wm8978: wav config failed.\\n\");\n    (void)wav_deinit(wm8978_record_get_handle());\n    (void)wm8978_basic_deinit();\n\n    return 1;\n}\n\n/* wav player config */\nres = wav_player_config(wm8978_record_get_handle(), I2S_STANDARD_PHILIPS, \n                        I2S_MODE_MASTER_TX, I2S_CPOL_LOW, \n                        I2S_DATAFORMAT_16B, I2S_MCLKOUTPUT_ENABLE, 22050);\nif (res != 0)\n{\n    wm8978_interface_debug_print(\"wm8978: wav record config failed.\\n\");\n    (void)wav_deinit(wm8978_record_get_handle());\n    (void)wm8978_basic_deinit();\n\n    return 1;\n}\n\n/* record start */\nres = wav_record_start(wm8978_record_get_handle(), 22050, path);\nif (res != 0)\n{\n    wm8978_interface_debug_print(\"wm8978: wav record start failed.\\n\");\n    (void)wav_deinit(wm8978_record_get_handle());\n    (void)wm8978_basic_deinit();\n\n    return 1;\n}\n\n...\n    \n/* set timeout */\ntimeout = time;\n\n/* loop */\nwhile (timeout != 0)\n{\n    wav_delay_ms(1000);\n    timeout--;\n    wav_debug_print(\"wav: record %d bytes time %d/%ds.\\n\", wm8978_record_get_handle()-\u003epos, time - timeout, time);\n    \n    ...\n}\n\n/* record stop */\nres = wav_record_stop(wm8978_record_get_handle());\nif (res != 0)\n{\n    wm8978_interface_debug_print(\"wm8978: wav record stop failed.\\n\");\n    (void)wav_deinit(wm8978_record_get_handle());\n    (void)wm8978_basic_deinit();\n\n    return 1;\n}\n\n...\n\n/* wav deinit */\n(void)wav_deinit(wm8978_record_get_handle());\n\n/* deinit */\n(void)wm8978_basic_deinit();\n\nreturn 0;\n```\n\n### Document\n\nOnline documents: [https://www.libdriver.com/docs/wm8978/index.html](https://www.libdriver.com/docs/wm8978/index.html).\n\nOffline documents: /doc/html/index.html.\n\n### Contributing\n\nPlease refer to CONTRIBUTING.md.\n\n### License\n\nCopyright (c) 2015 - present LibDriver All rights reserved\n\n\n\nThe MIT License (MIT) \n\n\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\n\nof this software and associated documentation files (the \"Software\"), to deal\n\nin the Software without restriction, including without limitation the rights\n\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\n\ncopies of the Software, and to permit persons to whom the Software is\n\nfurnished to do so, subject to the following conditions: \n\n\n\nThe above copyright notice and this permission notice shall be included in all\n\ncopies or substantial portions of the Software. \n\n\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\n\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\n\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\n\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\n\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\n\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\n\nSOFTWARE. \n\n### Contact Us\n\nPlease send an e-mail to lishifenging@outlook.com.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flibdriver%2Fwm8978","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flibdriver%2Fwm8978","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flibdriver%2Fwm8978/lists"}