/* This file is part of Ingen. Copyright 2007-2017 David Robillard Ingen is free software: you can redistribute it and/or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation, either version 3 of the License, or any later version. Ingen is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for details. You should have received a copy of the GNU Affero General Public License along with Ingen. If not, see . */ #include "ingen_config.h" #include #include #include #ifdef INGEN_JACK_SESSION #include #include #include "ingen/Serialiser.hpp" #endif #ifdef HAVE_JACK_METADATA #include #include "jackey.h" #endif #include "ingen/Configuration.hpp" #include "ingen/LV2Features.hpp" #include "ingen/Log.hpp" #include "ingen/URIMap.hpp" #include "ingen/World.hpp" #include "lv2/lv2plug.in/ns/ext/atom/util.h" #include "Buffer.hpp" #include "DuplexPort.hpp" #include "Engine.hpp" #include "GraphImpl.hpp" #include "JackDriver.hpp" #include "PortImpl.hpp" #include "ThreadManager.hpp" #include "util.hpp" using namespace std; typedef jack_default_audio_sample_t jack_sample_t; namespace Ingen { namespace Server { JackDriver::JackDriver(Engine& engine) : _engine(engine) , _sem(0) , _flag(false) , _client(NULL) , _block_length(0) , _seq_size(0) , _sample_rate(0) , _is_activated(false) , _old_bpm(120.0f) , _old_frame(0) , _old_rolling(false) { _midi_event_type = _engine.world()->uris().midi_MidiEvent; lv2_atom_forge_init( &_forge, &engine.world()->uri_map().urid_map_feature()->urid_map); } JackDriver::~JackDriver() { deactivate(); _ports.clear_and_dispose([](EnginePort* p) { delete p; }); } bool JackDriver::attach(const std::string& server_name, const std::string& client_name, void* jack_client) { assert(!_client); if (!jack_client) { #ifdef INGEN_JACK_SESSION const std::string uuid = _engine.world()->jack_uuid(); if (!uuid.empty()) { _client = jack_client_open(client_name.c_str(), JackSessionID, NULL, uuid.c_str()); _engine.log().info(fmt("Connected to Jack as `%1%' (UUID `%2%')\n") % client_name.c_str() % uuid); } #endif // Try supplied server name if (!_client && !server_name.empty()) { if ((_client = jack_client_open(client_name.c_str(), JackServerName, NULL, server_name.c_str()))) { _engine.log().info(fmt("Connected to Jack server `%1%'\n") % server_name); } } // Either server name not specified, or supplied server name does not exist // Connect to default server if (!_client) { if ((_client = jack_client_open(client_name.c_str(), JackNullOption, NULL))) _engine.log().info("Connected to default Jack server\n"); } // Still failed if (!_client) { _engine.log().error("Unable to connect to Jack\n"); return false; } } else { _client = (jack_client_t*)jack_client; } _sample_rate = jack_get_sample_rate(_client); _block_length = jack_get_buffer_size(_client); _seq_size = jack_port_type_get_buffer_size(_client, JACK_DEFAULT_MIDI_TYPE); jack_on_shutdown(_client, shutdown_cb, this); jack_set_thread_init_callback(_client, thread_init_cb, this); jack_set_buffer_size_callback(_client, block_length_cb, this); #ifdef INGEN_JACK_SESSION jack_set_session_callback(_client, session_cb, this); #endif for (auto& p : _ports) { register_port(p); } return true; } bool JackDriver::activate() { World* world = _engine.world(); if (_is_activated) { _engine.log().warn("Jack driver already activated\n"); return false; } if (!_client) attach(world->conf().option("jack-server").ptr(), world->conf().option("jack-name").ptr(), NULL); if (!_client) { return false; } jack_set_process_callback(_client, process_cb, this); _is_activated = true; if (jack_activate(_client)) { _engine.log().error("Could not activate Jack client, aborting\n"); return false; } else { _engine.log().info(fmt("Activated Jack client `%1%'\n") % world->conf().option("jack-name").ptr()); } return true; } void JackDriver::deactivate() { if (_is_activated) { _flag = true; _is_activated = false; _sem.timed_wait(std::chrono::seconds(1)); for (auto& p : _ports) { unregister_port(p); } if (_client) { jack_deactivate(_client); jack_client_close(_client); _client = NULL; } _engine.log().info("Deactivated Jack client\n"); } } EnginePort* JackDriver::get_port(const Raul::Path& path) { for (auto& p : _ports) { if (p.graph_port()->path() == path) { return &p; } } return NULL; } void JackDriver::add_port(RunContext& context, EnginePort* port) { _ports.push_back(*port); DuplexPort* graph_port = port->graph_port(); if (graph_port->is_a(PortType::AUDIO) || graph_port->is_a(PortType::CV)) { const SampleCount nframes = context.nframes(); jack_port_t* jport = (jack_port_t*)port->handle(); void* jbuf = jack_port_get_buffer(jport, nframes); graph_port->set_driver_buffer(jbuf, nframes * sizeof(float)); } } void JackDriver::remove_port(RunContext& context, EnginePort* port) { _ports.erase(_ports.iterator_to(*port)); } void JackDriver::register_port(EnginePort& port) { jack_port_t* jack_port = jack_port_register( _client, port.graph_port()->path().substr(1).c_str(), ((port.graph_port()->is_a(PortType::AUDIO) || port.graph_port()->is_a(PortType::CV)) ? JACK_DEFAULT_AUDIO_TYPE : JACK_DEFAULT_MIDI_TYPE), (port.graph_port()->is_input() ? JackPortIsInput : JackPortIsOutput), 0); if (!jack_port) { throw JackDriver::PortRegistrationFailedException(); } port.set_handle(jack_port); for (const auto& p : port.graph_port()->properties()) { port_property_internal(jack_port, p.first, p.second); } } void JackDriver::unregister_port(EnginePort& port) { if (jack_port_unregister(_client, (jack_port_t*)port.handle())) { _engine.log().error("Failed to unregister Jack port\n"); } port.set_handle(NULL); } void JackDriver::rename_port(const Raul::Path& old_path, const Raul::Path& new_path) { EnginePort* eport = get_port(old_path); if (eport) { #ifdef HAVE_JACK_PORT_RENAME jack_port_rename( _client, (jack_port_t*)eport->handle(), new_path.substr(1).c_str()); #else jack_port_set_name((jack_port_t*)eport->handle(), new_path.substr(1).c_str()); #endif } } void JackDriver::port_property(const Raul::Path& path, const Raul::URI& uri, const Atom& value) { #ifdef HAVE_JACK_METADATA EnginePort* eport = get_port(path); if (eport) { const jack_port_t* const jport = (const jack_port_t*)eport->handle(); port_property_internal(jport, uri, value); } #endif } void JackDriver::port_property_internal(const jack_port_t* jport, const Raul::URI& uri, const Atom& value) { #ifdef HAVE_JACK_METADATA if (uri == _engine.world()->uris().lv2_name) { jack_set_property(_client, jack_port_uuid(jport), JACK_METADATA_PRETTY_NAME, value.ptr(), "text/plain"); } else if (uri == _engine.world()->uris().lv2_index) { jack_set_property(_client, jack_port_uuid(jport), JACKEY_ORDER, std::to_string(value.get()).c_str(), "http://www.w3.org/2001/XMLSchema#integer"); } else if (uri == _engine.world()->uris().rdf_type) { if (value == _engine.world()->uris().lv2_CVPort) { jack_set_property(_client, jack_port_uuid(jport), JACKEY_SIGNAL_TYPE, "CV", "text/plain"); } } #endif } EnginePort* JackDriver::create_port(DuplexPort* graph_port) { EnginePort* eport = NULL; if (graph_port->is_a(PortType::AUDIO) || graph_port->is_a(PortType::CV)) { // Audio buffer port, use Jack buffer directly eport = new EnginePort(graph_port); graph_port->set_is_driver_port(*_engine.buffer_factory()); } else if (graph_port->is_a(PortType::ATOM) && graph_port->buffer_type() == _engine.world()->uris().atom_Sequence) { // Sequence port, make Jack port but use internal LV2 format buffer eport = new EnginePort(graph_port); } if (eport) { register_port(*eport); } return eport; } void JackDriver::pre_process_port(RunContext& context, EnginePort* port) { const URIs& uris = context.engine().world()->uris(); const SampleCount nframes = context.nframes(); jack_port_t* jack_port = (jack_port_t*)port->handle(); DuplexPort* graph_port = port->graph_port(); Buffer* graph_buf = graph_port->buffer(0).get(); void* jack_buf = jack_port_get_buffer(jack_port, nframes); if (graph_port->is_a(PortType::AUDIO) || graph_port->is_a(PortType::CV)) { graph_port->set_driver_buffer(jack_buf, nframes * sizeof(float)); if (graph_port->is_input()) { graph_port->monitor(context); } else { graph_port->buffer(0)->clear(); // TODO: Avoid when possible } } else if (graph_port->buffer_type() == uris.atom_Sequence) { graph_buf->prepare_write(context); if (graph_port->is_input()) { // Copy events from Jack port buffer into graph port buffer const jack_nframes_t event_count = jack_midi_get_event_count(jack_buf); for (jack_nframes_t i = 0; i < event_count; ++i) { jack_midi_event_t ev; jack_midi_event_get(&ev, jack_buf, i); if (!graph_buf->append_event( ev.time, ev.size, _midi_event_type, ev.buffer)) { _engine.log().rt_error("Failed to write to MIDI buffer, events lost!\n"); } } } graph_port->monitor(context); } } void JackDriver::post_process_port(RunContext& context, EnginePort* port) { const URIs& uris = context.engine().world()->uris(); const SampleCount nframes = context.nframes(); jack_port_t* jack_port = (jack_port_t*)port->handle(); DuplexPort* graph_port = port->graph_port(); void* jack_buf = port->buffer(); if (port->graph_port()->is_output()) { if (!jack_buf) { // First cycle for a new output, so pre_process wasn't called jack_buf = jack_port_get_buffer(jack_port, nframes); port->set_buffer(jack_buf); } if (graph_port->buffer_type() == uris.atom_Sequence) { // Copy LV2 MIDI events to Jack MIDI buffer Buffer* const graph_buf = graph_port->buffer(0).get(); LV2_Atom_Sequence* seq = graph_buf->get(); jack_midi_clear_buffer(jack_buf); LV2_ATOM_SEQUENCE_FOREACH(seq, ev) { const uint8_t* buf = (const uint8_t*)LV2_ATOM_BODY(&ev->body); if (ev->body.type == _midi_event_type) { jack_midi_event_write( jack_buf, ev->time.frames, buf, ev->body.size); } } } } // Reset graph port buffer pointer to no longer point to the Jack buffer if (graph_port->is_driver_port()) { graph_port->set_driver_buffer(NULL, 0); } } void JackDriver::append_time_events(RunContext& context, Buffer& buffer) { const URIs& uris = context.engine().world()->uris(); const jack_position_t* pos = &_position; const bool rolling = (_transport_state == JackTransportRolling); // Do nothing if there is no unexpected time change (other than rolling) if (rolling == _old_rolling && pos->frame == _old_frame && pos->beats_per_minute == _old_bpm) { return; } // Update old time information to detect change next cycle _old_frame = pos->frame; _old_rolling = rolling; _old_bpm = pos->beats_per_minute; // Build an LV2 position object to append to the buffer LV2_Atom pos_buf[16]; LV2_Atom_Forge_Frame frame; lv2_atom_forge_set_buffer(&_forge, (uint8_t*)pos_buf, sizeof(pos_buf)); lv2_atom_forge_object(&_forge, &frame, 0, uris.time_Position); lv2_atom_forge_key(&_forge, uris.time_frame); lv2_atom_forge_long(&_forge, pos->frame); lv2_atom_forge_key(&_forge, uris.time_speed); lv2_atom_forge_float(&_forge, rolling ? 1.0 : 0.0); if (pos->valid & JackPositionBBT) { lv2_atom_forge_key(&_forge, uris.time_barBeat); lv2_atom_forge_float( &_forge, pos->beat - 1 + (pos->tick / pos->ticks_per_beat)); lv2_atom_forge_key(&_forge, uris.time_bar); lv2_atom_forge_long(&_forge, pos->bar - 1); lv2_atom_forge_key(&_forge, uris.time_beatUnit); lv2_atom_forge_int(&_forge, pos->beat_type); lv2_atom_forge_key(&_forge, uris.time_beatsPerBar); lv2_atom_forge_float(&_forge, pos->beats_per_bar); lv2_atom_forge_key(&_forge, uris.time_beatsPerMinute); lv2_atom_forge_float(&_forge, pos->beats_per_minute); } // Append position to buffer at offset 0 (start of this cycle) LV2_Atom* lpos = (LV2_Atom*)pos_buf; buffer.append_event( 0, lpos->size, lpos->type, (const uint8_t*)LV2_ATOM_BODY_CONST(lpos)); } /**** Jack Callbacks ****/ /** Jack process callback, drives entire audio thread. * * \callgraph */ REALTIME int JackDriver::_process_cb(jack_nframes_t nframes) { if (nframes == 0 || ! _is_activated) { if (_flag) { _sem.post(); } return 0; } /* Note that Jack may not call this function for a cycle, if overloaded, so a rolling counter here would not always be correct. */ const jack_nframes_t start_of_current_cycle = jack_last_frame_time(_client); _transport_state = jack_transport_query(_client, &_position); _engine.locate(start_of_current_cycle, nframes); // Read input for (auto& p : _ports) { pre_process_port(_engine.run_context(), &p); } // Process _engine.run(nframes); // Write output for (auto& p : _ports) { post_process_port(_engine.run_context(), &p); } // Update expected transport frame for next cycle to detect changes if (_transport_state == JackTransportRolling) { _old_frame += nframes; } return 0; } void JackDriver::_thread_init_cb() { ThreadManager::set_flag(THREAD_PROCESS); ThreadManager::set_flag(THREAD_IS_REAL_TIME); } void JackDriver::_shutdown_cb() { _engine.log().info("Jack shutdown, exiting\n"); _is_activated = false; _client = NULL; } int JackDriver::_block_length_cb(jack_nframes_t nframes) { if (_engine.root_graph()) { _block_length = nframes; _seq_size = jack_port_type_get_buffer_size(_client, JACK_DEFAULT_MIDI_TYPE); _engine.root_graph()->set_buffer_size( _engine.run_context(), *_engine.buffer_factory(), PortType::AUDIO, _engine.buffer_factory()->audio_buffer_size(nframes)); _engine.root_graph()->set_buffer_size( _engine.run_context(), *_engine.buffer_factory(), PortType::ATOM, _seq_size); } return 0; } #ifdef INGEN_JACK_SESSION void JackDriver::_session_cb(jack_session_event_t* event) { _engine.log().info(fmt("Jack session save to %1%\n") % event->session_dir); const string cmd = (boost::format("ingen -eg -n %1% -u %2% -l ${SESSION_DIR}") % jack_get_client_name(_client) % event->client_uuid).str(); SPtr serialiser = _engine.world()->serialiser(); if (serialiser) { std::lock_guard lock(_engine.world()->rdf_mutex()); SPtr root(_engine.root_graph(), NullDeleter); serialiser->write_bundle(root, string("file://") + event->session_dir); } event->command_line = (char*)malloc(cmd.size() + 1); memcpy(event->command_line, cmd.c_str(), cmd.size() + 1); jack_session_reply(_client, event); switch (event->type) { case JackSessionSave: break; case JackSessionSaveAndQuit: _engine.log().warn("Jack session quit\n"); _engine.quit(); break; case JackSessionSaveTemplate: break; } jack_session_event_free(event); } #endif } // namespace Server } // namespace Ingen